forksand
/
forksand-it-manual
1
1
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Updated ethernet wiring diagram, shrink 6 pages -> 1 page,

Browse Source 
updates to glossary, toc fixes, minor fixes
master
Linreigns 6 years ago
parent ae7398ffc3
commit 2a072ca25a
5 changed files with 141 additions and 108 deletions
Show Stats Download Patch File Download Diff File

194
source/Hardware.tex
Unescape View File

@ -17,7 +17,7 @@
\begin{figure}[!htb]
\includegraphics[width=210mm,trim=20mm 20mm 20mm 20mm]
{sharkfork-cabling-4-final-colocation.pdf} \\ %
\caption{\Gls{sharkfork} \Gls{colocation} \gls{cluster} cabling diagram}
\caption{Sharkfork Colocation Cluster cabling diagram}
\end{figure}
\Gls{colocation} \Gls{cabinet} buffered only with a \gls{firewall}.
@ -40,6 +40,7 @@ The \gls{cluster} will require rackmountable equipment.
\includegraphics[keepaspectratio=true,height=0.75\textheight,width=150mm,angle=0]
{sharkfork-21U.png}
\label{fig:sharkfork-21U}
\textcolor{white}{\caption{Colocation Cabinet it Denver, Colorado}}
\end{figure}
%\subsubsection{\Gls{sharkfork} 21U detail hardware description} \label{sec:hardware-description-sharkfork-21U}
@ -49,25 +50,30 @@ The \gls{cluster} will require rackmountable equipment.
\rowcolor{#3}\vspace{-1pt}
{{\grenewcommand{\currentColor}{#3}}}
{{\grenewcommand{\currentTextColor}{#4}}}
\Large{\textcolor{#4}{#1}} & \rule[-0.5em]{0pt}{1.8em} \Large{\textcolor{#4}{#2}} \\
\Large{\textcolor{#4}{#1}} & \rule[-0.5em]{0pt}{1.8em} \Large{\textcolor{#4}{#2}}
\\\noalign{\penalty+5000}
\rowcolor{#3}\vspace{-1pt}
}
\newcommand{\nodeUnitParameter}[1]{
\rule[1.0em]{0pt}{-1em} & \small{\textcolor{\currentTextColor}{ - #1}} \\
\rule[1.0em]{0pt}{-1em} & \small{\textcolor{\currentTextColor}{ - #1}}
\\\noalign{\penalty+5000}
\rowcolor{\currentColor}\vspace{-1pt}
}
\newcommand{\nodeUnitLastParameter}[1]{
\rule[-0.5em]{0pt}{0em} & \small{\textcolor{\currentTextColor}{ - #1}} \\
\rule[-0.5em]{0pt}{0em} & \small{\textcolor{\currentTextColor}{ - #1}}
\\\noalign{\penalty+5000}
\tabucline[0.2pt]{1-2}
}
\newcommand{\nodeUnitSetItem}[2]{
\rowcolor{\currentColor}\vspace{-1pt}
\rule[-0.3em]{0pt}{0em}\small{\textcolor{\currentTextColor}{ ~#1}} & \small{\textcolor{\currentTextColor}{#2}} \\
\rule[-0.3em]{0pt}{0em}\small{\textcolor{\currentTextColor}{ ~#1}} & \small{\textcolor{\currentTextColor}{#2}}
\\\noalign{\penalty+5000}
\tabucline[0.2pt]{1-2}
}
\newcommand{\nodeUnitSetLastItem}[2]{
\rowcolor{\currentColor}\vspace{-1pt}
\rule[-0.3em]{0pt}{0em}\small{\textcolor{\currentTextColor}{ ~#1}} & \small{\textcolor{\currentTextColor}{#2}} \\
\rule[-0.3em]{0pt}{0em}\small{\textcolor{\currentTextColor}{ ~#1}} & \small{\textcolor{\currentTextColor}{#2}}
\\\noalign{\penalty-5000}
\tabucline[2pt]{1-2}
}
%\newcommand{\nodeUnitSetNotes}[2]{
@ -78,126 +84,134 @@ The \gls{cluster} will require rackmountable equipment.
\newcommand{\currentColor}{secondary-brown}
\newcommand{\currentTextColor}{secondary-brown}
\begin{table}[!htb]
\begin{longtabu}{|[2pt]l|[2pt]p{14.5cm}|[2pt]}
%\caption{IP configs of nodes} \label{tab:sharkNodeIPConfig}
\begin{tabu}{|[2pt]l|[2pt]p{14.5cm}|[2pt]}
\tabucline[2pt]{1-2}
\multicolumn {1}{|[2pt]l|[2pt]}{\rule[-0.7em]{0pt}{2em} Qty}&
\multicolumn {1}{p{13cm}|[2pt]}{ Description} \\ \tabucline[2pt]{1-2}
\tabucline[2pt]{1-2}
\multicolumn {1}{|[2pt]l|[2pt]}{\rule[-0.7em]{0pt}{2em} Qty}&
\multicolumn {1}{p{14.5cm}|[2pt]}{ Description} \\ \tabucline[2pt]{1-2}
\endhead
%%% UNIT %%%
% Unit name
\nodeUnitName{2}{Iris FW1100 - \Gls{firewall} System}{secondary-brown}{ao-black}
\nodeUnitName{2}{Iris FW1100 - \Gls{firewall} System}{secondary-brown}{ao-black}
% Unit configuration parameters
\nodeUnitParameter{ 1U Form Factor ~~- Single Intel Xeon D-1587 CPU }
\nodeUnitParameter{ Up to 128GB DDR4 ECC Reg Memory }
\nodeUnitParameter{ Dual 10G SFP+ and Six Gigabit Ethernet }
\nodeUnitLastParameter{ 400W Platinum Level Redundant Power Supply }
\nodeUnitParameter{ 1U Form Factor ~~- Single Intel Xeon D-1587 CPU }
\nodeUnitParameter{ Up to 128GB DDR4 ECC Reg Memory }
\nodeUnitParameter{ Dual 10G SFP+ and Six Gigabit Ethernet }
\nodeUnitLastParameter{ 400W Platinum Level Redundant Power Supply }
% Unit has a set of components parameters
\nodeUnitSetItem {2}{ 8GB DDR4 2666MHz ECC Registered DIMM }
%\nodeUnitSetItem {1}{ No Operating System. Include testing%
% and customer OS preference in notes. }
%\nodeUnitSetItem {1}{ Return to Depot Warranty (3 Year Hardware%
% Warranty with Standard Advance Parts Replacement) }
\nodeUnitSetItem {1}{ 128GB SATA DOM }
\nodeUnitSetLastItem {1}{ Intel 10G Dual Port RJ45 Ethernet Adapter }
\nodeUnitSetItem {2}{ 8GB DDR4 2666MHz ECC Registered DIMM }
\nodeUnitSetItem {1}{ No Operating System. Include testing%
and customer OS preference in notes. }
\nodeUnitSetItem {1}{ Return to Depot Warranty (3 Year Hardware%
Warranty with Standard Advance Parts Replacement) }
\nodeUnitSetItem {1}{ 128GB SATA DOM }
\nodeUnitSetLastItem {1}{ Intel 10G Dual Port RJ45 Ethernet Adapter }
% Unit ends with notes, pass "none" parameter if no notes
%\nodeUnitSetNotes { none }
%\nodeUnitSetNotes { none }
%%% END UNIT %%%
% Unit name
\nodeUnitName{2}{Netgear XS716T - 16-Port 10G Smart Managed Plus Switch}{secondary-brown}{ao-black}
\nodeUnitName{2}{Netgear XS716T - 16-Port 10G Smart Managed Plus Switch}{secondary-brown}{ao-black}
% Unit configuration parameters
\nodeUnitParameter{ 1U Form Factor ~~- 600 MHz Cortex-A9 Single Core }
\nodeUnitParameter{ 1U Form Factor ~~- 600 MHz Cortex-A9 Single Core }
\nodeUnitParameter{ 512MB RAM }
\nodeUnitParameter{ 16-Port RJ45 10G SFP+ and Six Gigabit Ethernet }
\nodeUnitLastParameter{ 100W Power Supply }
\nodeUnitParameter{ 512MB RAM }
\nodeUnitParameter{ 16-Port RJ45 10G SFP+ and Six Gigabit Ethernet }
\nodeUnitLastParameter{ 100W Power Supply }
% Unit has a set of components parameters
\nodeUnitSetItem {1}{ 8MB SPI + 256 NAND FLASH }
\nodeUnitSetLastItem {1}{ 2 shared (combo) 1G/10G Copper/SFP+ (fiber) ports }
\nodeUnitSetItem {1}{ 8MB SPI + 256 NAND FLASH }
\nodeUnitSetLastItem {1}{ 2 shared (combo) 1G/10G Copper/SFP+ (fiber) ports }
% Unit ends with notes, pass "none" parameter if no notes
%\nodeUnitSetNotes { none }
%\nodeUnitSetNotes { none }
%%% END UNIT %%%
%%% UNIT %%%
% Unit name
\nodeUnitName{1}{Iris NV2225}{primary-blue}{ao-black}
\nodeUnitName{1}{Iris NV2225}{primary-blue}{ao-black}
% Unit configuration parameters
\nodeUnitParameter{ 2U Form Factor ~~- Dual Intel Xeon SP Processor }
\nodeUnitParameter{ Up to 768GB DDR4 2133MHz ECC Registered Memory }
\nodeUnitParameter{ Integrated IPMI 2.0 + KVM with dedicated LAN }
\nodeUnitParameter{ Intel x550 Quad port 10G Ethernet }
\nodeUnitLastParameter{ 1600W Redundant High-efficiency Power Supply }
\nodeUnitParameter{ 2U Form Factor ~~- Dual Intel Xeon SP Processor }
\nodeUnitParameter{ Up to 768GB DDR4 2133MHz ECC Registered Memory }
\nodeUnitParameter{ Integrated IPMI 2.0 + KVM with dedicated LAN }
\nodeUnitParameter{ Intel x550 Quad port 10G Ethernet }
\nodeUnitLastParameter{ 1600W Redundant High-efficiency Power Supply }
% Unit has a set of components parameters
\nodeUnitSetItem{2}{ Intel Xeon Gold 5115 10C 2.4GHz 13.75MB Cache }
\nodeUnitSetItem{1}{ 128GB DDR4 2666MHz ECC Reg (4 x 32GB) }
\nodeUnitSetItem{1}{ Samsung 960 EVO M.2 NVME SSD 500GB }
\nodeUnitSetItem{4}{ Ultrastar SN200 800GB NVMe SSD }
%\nodeUnitSetItem{1}{ No Operating System. Include testing and customer%
% OS preference in notes. }
%\nodeUnitSetItem{1}{ Return to Depot Warranty (3 Year Hardware Warranty%
% with Standard Advance Parts Replacement) }
\nodeUnitSetLastItem{1}{ Intel 10G Dual Port RJ45 Ethernet Adapter }
\nodeUnitSetItem{2}{ Intel Xeon Gold 5115 10C 2.4GHz 13.75MB Cache }
\nodeUnitSetItem{1}{ 128GB DDR4 2666MHz ECC Reg (4 x 32GB) }
\nodeUnitSetItem{1}{ Samsung 960 EVO M.2 NVME SSD 500GB }
\nodeUnitSetItem{4}{ Ultrastar SN200 800GB NVMe SSD }
\nodeUnitSetItem{1}{ No Operating System. Include testing and customer%
OS preference in notes. }
\nodeUnitSetItem{1}{ Return to Depot Warranty (3 Year Hardware Warranty%
with Standard Advance Parts Replacement) }
\nodeUnitSetLastItem{1}{ Intel 10G Dual Port RJ45 Ethernet Adapter }
% Unit ends with notes, pass "none" parameter if no notes
%\nodeUnitSetNotes { none }
%\nodeUnitSetNotes { none }
%%% END UNIT %%%
%%% UNIT %%%
% Unit name
\nodeUnitName{2}{Iris 1292-R4T}{primary-brown}{ao-black}
\nodeUnitName{2}{Iris 1292-R4T}{primary-brown}{ao-black}
% Unit configuration parameters
\nodeUnitParameter{ 1U Form Factor ~~- Dual Intel Xeon SP Processors }
\nodeUnitParameter{ Intel C620 Chipset with QPI up to 9.6GT/sec }
\nodeUnitParameter{ Up to 768GB DDR4 2666MHz ECC Registered Memory }
\nodeUnitParameter{ Integrated IPMI 2.0 + KVM with dedicated LAN }
\nodeUnitParameter{ Intel Quad-port 10GBaseT Ethernet Controller }
\nodeUnitParameter{ 4 x 3.5'' Hot-swap Drive Bays For customizable Storage }
\nodeUnitLastParameter{ 750W Redundant Power Supply }
\nodeUnitParameter{ 1U Form Factor ~~- Dual Intel Xeon SP Processors }
\nodeUnitParameter{ Intel C620 Chipset with QPI up to 9.6GT/sec }
\nodeUnitParameter{ Up to 768GB DDR4 2666MHz ECC Registered Memory }
\nodeUnitParameter{ Integrated IPMI 2.0 + KVM with dedicated LAN }
\nodeUnitParameter{ Intel Quad-port 10GBaseT Ethernet Controller }
\nodeUnitParameter{ 4 x 3.5'' Hot-swap Drive Bays For customizable Storage }
\nodeUnitLastParameter{ 750W Redundant Power Supply }
% Unit has a set of components parameters
\nodeUnitSetItem{2}{ Intel Xeon Silver 4110 8C 2.1GHz 11MB Cache }
\nodeUnitSetItem{1}{ 128GB DDR4 2666MHz ECC Reg (8 x 16GB) }
\nodeUnitSetItem{4}{ HGST Ultrastar 6TB 7200RPM SATA 6Gb/s }
%\nodeUnitSetItem{1}{ No Operating System. Include testing and customer%
% OS preference in notes. }
%\nodeUnitSetItem{1}{ Return to Depot Warranty (3 Year Hardware Warranty%
% with Standard Advance Parts Replacement) }
\nodeUnitSetLastItem{1}{ Intel 10G Dual Port RJ45 Ethernet Adapter }
\nodeUnitSetItem{2}{ Intel Xeon Silver 4110 8C 2.1GHz 11MB Cache }
\nodeUnitSetItem{1}{ 128GB DDR4 2666MHz ECC Reg (8 x 16GB) }
\nodeUnitSetItem{4}{ HGST Ultrastar 6TB 7200RPM SATA 6Gb/s }
\nodeUnitSetItem{1}{ No Operating System. Include testing and customer%
OS preference in notes. }
\nodeUnitSetItem{1}{ Return to Depot Warranty (3 Year Hardware Warranty%
with Standard Advance Parts Replacement) }
\nodeUnitSetLastItem{1}{ Intel 10G Dual Port RJ45 Ethernet Adapter }
% Unit ends with notes, pass "none" parameter if no notes
%\nodeUnitSetNotes { none }
%\nodeUnitSetNotes { none }
%%% END UNIT %%%
%%% UNIT %%%
% Unit name
\nodeUnitName{2}{Iris NV1211}{nonbrand-dark-blue}{ao-white}
\nodeUnitName{2}{Iris NV1211}{nonbrand-dark-blue}{ao-white}
% Unit configuration parameters
\nodeUnitParameter{ 1U Form Factor ~~- Dual Intel Xeon SP Processor }
\nodeUnitParameter{ Up to 1534GB DDR4 2400MHz ECC Registered Memory }
\nodeUnitParameter{ Integrated IPMI 2.0 + KVM with dedicated LAN }
\nodeUnitParameter{ Intel x540 Dual-port 10Gigabit Ethernet }
\nodeUnitParameter{ 10 x 2.5'' Solid State NVMe Disks }
\nodeUnitLastParameter{ 1000W Redundant High-efficiency Power Supply }
\nodeUnitParameter{ 1U Form Factor ~~- Dual Intel Xeon SP Processor }
\nodeUnitParameter{ Up to 1534GB DDR4 2400MHz ECC Registered Memory }
\nodeUnitParameter{ Integrated IPMI 2.0 + KVM with dedicated LAN }
\nodeUnitParameter{ Intel x540 Dual-port 10Gigabit Ethernet }
\nodeUnitParameter{ 10 x 2.5'' Solid State NVMe Disks }
\nodeUnitLastParameter{ 1000W Redundant High-efficiency Power Supply }
% Unit has a set of components parameters
\nodeUnitSetItem{2}{ Intel Xeon Silver 4114 10C 2.2GHz 13.75MB Cache }
\nodeUnitSetItem{1}{ 64GB DDR4 2666MHz ECC Reg (4 x 16GB) }
\nodeUnitSetItem{1}{ Samsung 960 EVO M.2 NVME SSD 500GB }
\nodeUnitSetItem{6}{ Ultrastar SN200 800GB NVMe SSD }
% \nodeUnitSetItem{1}{ No Operating System. Include testing and customer%
% OS preference in notes. }
% \nodeUnitSetItem{1}{ Return to Depot Warranty (3 Year Hardware Warranty%
% with Standard Advance Parts Replacement) }
\nodeUnitSetLastItem{1}{ Intel X710 Converged Network Adapter Quad-port 10GBaseT }
\nodeUnitSetItem{2}{ Intel Xeon Silver 4114 10C 2.2GHz 13.75MB Cache }
\nodeUnitSetItem{1}{ 64GB DDR4 2666MHz ECC Reg (4 x 16GB) }
\nodeUnitSetItem{1}{ Samsung 960 EVO M.2 NVME SSD 500GB }
\nodeUnitSetItem{6}{ Ultrastar SN200 800GB NVMe SSD }
\nodeUnitSetItem{1}{ No Operating System. Include testing and customer%
OS preference in notes. }
\nodeUnitSetItem{1}{ Return to Depot Warranty (3 Year Hardware Warranty%
with Standard Advance Parts Replacement) }
\nodeUnitSetLastItem{1}{ Intel X710 Converged Network Adapter Quad-port 10GBaseT }
% Unit ends with notes, pass "none" parameter if no notes
%\nodeUnitSetNotes { none }
%\nodeUnitSetNotes { none }
%%% END UNIT %%%
\end{longtabu}
\end{tabu}
\end{table}
Notes applicable to all units:
{ 1. No Operating System. Include testing and customer OS preference in notes. }
{ 2. Return to Depot Warranty (3 Year Hardware Warranty with Standard Advance Parts Replacement) }
\newpage
\begin{picture}(0,0)\put(-10000,0){
\gls{sharkfork}
\gls{backbone}
\gls{firewall}
\gls{corosynk}
\gls{migration}
%\gls{ipmi}
%\gls{upstream}
}\end{picture}
\begin{figure}[!htb]
\includepdf[width=200mm,height=277mm,offset=0 -8mm]
{sharkfork-wire-alt.pdf}
\setbox0=\vbox{\caption{Sharktech Ethernet Wiring Diagram}}
\end{figure}
\newpage

2
source/History.tex
Unescape View File

@ -53,7 +53,7 @@ Forksand started deployment on \glspl{dedicatedserver}.
%
\vspace{0.2cm}
\raggedright
Final stage. \Gls{Firewall} discarded. Single \Gls{colocation} \Gls{cabinet}. (in process)
Final stage. \Gls{firewall} discarded. Single \Gls{colocation} \Gls{cabinet}. (in process)
\vspace{0.4cm}
\centering
%\includegraphics[width=115mm,trim=10mm 10mm 10mm 10mm]

51
source/forksand-it-manual.tex
Unescape View File

@ -270,34 +270,53 @@ leftmargin=1cm,rightmargin=1cm
%\typeoutstandardlayout
%%% END DEBUG %%%
\newglossaryentry{cluster}{name={cluster},plural={clusters},
\newglossaryentry{cluster}{name={Cluster},plural={Clusters},
description={, computer cluster is a set of loosely or
tightly connected computers that work together so that, in
many respects, they can be viewed as a single system.}}
\newglossaryentry{dedicatedserver}{
name={dedicated server},plural={dedicated servers},
name={Dedicated Server},plural={Dedicated Servers},
description={, or managed hosting service
is a type of Internet hosting in which the client leases
an entire server not shared with anyone else.}}
\newglossaryentry{sharkfork}{
name={SharkFork},
description={is a SharkTech provided \Gls{colocation} for a
\gls{cluster} with Fork Sand \Gls{colocation} \Gls{cabinet}}}
\newglossaryentry{colocation}{name={colocation},plural={colocations},
description={is a SharkTech provided Colocation for a
Cluster with Fork Sand Colocation Cabinet}}
\newglossaryentry{colocation}{
name={Colocation},plural={Colocations},
description={ centre (also spelled co-location, or colo) or "carrier
hotel", is a type of data centre where equipment, space,
and bandwidth are available for rental to retail customers.}}
\newglossaryentry{cabinet}{name={cabinet},plural={cabinets},
\newglossaryentry{cabinet}{
name={Cabinet},plural={Cabinets},
description={, inside a data center, is a locking unit
that holds a server rack.}}
\newglossaryentry{backbone}{
name={Backbone},plural={Backbones},
description={ is a part of computer network that interconnects
various pieces of network, providing a path for the exchange
of information between different LANs or subnetworks.}}
\newglossaryentry{corosynk}{
name={Corosynk},
description={ is what Proxmox uses to keep the cluster nodes in sync.
It is used for clustering besides proxmox too:
\url{https://en.wikipedia.org/wiki/Corosync_Cluster_Engine}.
Proxmox recommends applying two Corosynk instances if available.
And also a third one for migrating from host to host.
}}
\newglossaryentry{migration}{
name={Migration},
description={ see Corosynk description for details}}
\newglossaryentry{gnulinux}{name={GNU/Linux},
description={ is a term promoted by the Free Software Foundation
(FSF) and its founder Richard Stallman.[6] Proponents call for
the correction of the more extended term, on the grounds that it
doesn't give credit to the major contributor and the associated
free software philosophy.}}
\newglossaryentry{firewall}{name={firewall},plural={firewalls},
description={ In computing, a firewall is a network security system
\newglossaryentry{firewall}{
name={Firewall},plural={Firewalls},
description={ (in computing) is a network security system
that monitors and controls incoming and outgoing network traffic
based on predetermined security rules.[1] A firewall typically
establishes a barrier between a trusted internal network and
@ -433,14 +452,14 @@ leftmargin=1cm,rightmargin=1cm
\chapterconf{Firewall-opnsense}{OPNSense Firewall}{Use OPNSense}
\chapterconf{Proxmox}{Proxmox}{Virtual Machines}
\chapterconf{Ansible}{Ansible}{Cluster Administration}
%\chapterconf{DNS}{Domain Name Service (DNS)}{Who Names You?}
%\chapterconf{NTP}{Network Time Protocol}{A Hole in Time}
%\chapterconf{Firmware}{Firmware}{Embedded Software}
%\chapterconf{History}{History}{Evolution History}
%%%% Appendix %%%
%%\part{Appendix} % XXX
%\appendix
%\chapterconf{Source}{Free Software}{Free Software and Configurations}
\chapterconf{DNS}{Domain Name Service (DNS)}{Who Names You?}
\chapterconf{NTP}{Network Time Protocol}{A Hole in Time}
\chapterconf{Firmware}{Firmware}{Embedded Software}
\chapterconf{History}{History}{Evolution History}
%%% Appendix %%%
%\part{Appendix} % XXX
\appendix
\chapterconf{Source}{Free Software}{Free Software and Configurations}
%% END MAINMATTER CHAPTERS %%%

BIN
source/resources/drawings/sharkfork-wire-alt.pdf
View File

Binary file not shown.

2
source/resources/drawings/sharkfork-wire-alt.xml
View File

File diff suppressed because one or more lines are too long
Write Preview
Loading…
Cancel
Save