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 7 years ago
parent ae7398ffc3
commit 2a072ca25a
5 changed files with 141 additions and 108 deletions
Show Stats Download Patch File Download Diff File

80
source/Hardware.tex
Unescape View File

@ -17,7 +17,7 @@
\begin{figure}[!htb] \begin{figure}[!htb]
\includegraphics[width=210mm,trim=20mm 20mm 20mm 20mm] \includegraphics[width=210mm,trim=20mm 20mm 20mm 20mm]
{sharkfork-cabling-4-final-colocation.pdf} \\ % {sharkfork-cabling-4-final-colocation.pdf} \\ %
\caption{\Gls{sharkfork} \Gls{colocation} \gls{cluster} cabling diagram} \caption{Sharkfork Colocation Cluster cabling diagram}
\end{figure} \end{figure}
\Gls{colocation} \Gls{cabinet} buffered only with a \gls{firewall}. \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] \includegraphics[keepaspectratio=true,height=0.75\textheight,width=150mm,angle=0]
{sharkfork-21U.png} {sharkfork-21U.png}
\label{fig:sharkfork-21U} \label{fig:sharkfork-21U}
\textcolor{white}{\caption{Colocation Cabinet it Denver, Colorado}}
\end{figure} \end{figure}
%\subsubsection{\Gls{sharkfork} 21U detail hardware description} \label{sec:hardware-description-sharkfork-21U} %\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} \rowcolor{#3}\vspace{-1pt}
{{\grenewcommand{\currentColor}{#3}}} {{\grenewcommand{\currentColor}{#3}}}
{{\grenewcommand{\currentTextColor}{#4}}} {{\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} \rowcolor{#3}\vspace{-1pt}
} }
\newcommand{\nodeUnitParameter}[1]{ \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} \rowcolor{\currentColor}\vspace{-1pt}
} }
\newcommand{\nodeUnitLastParameter}[1]{ \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} \tabucline[0.2pt]{1-2}
} }
\newcommand{\nodeUnitSetItem}[2]{ \newcommand{\nodeUnitSetItem}[2]{
\rowcolor{\currentColor}\vspace{-1pt} \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} \tabucline[0.2pt]{1-2}
} }
\newcommand{\nodeUnitSetLastItem}[2]{ \newcommand{\nodeUnitSetLastItem}[2]{
\rowcolor{\currentColor}\vspace{-1pt} \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} \tabucline[2pt]{1-2}
} }
%\newcommand{\nodeUnitSetNotes}[2]{ %\newcommand{\nodeUnitSetNotes}[2]{
@ -78,12 +84,12 @@ The \gls{cluster} will require rackmountable equipment.
\newcommand{\currentColor}{secondary-brown} \newcommand{\currentColor}{secondary-brown}
\newcommand{\currentTextColor}{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} %\caption{IP configs of nodes} \label{tab:sharkNodeIPConfig}
\begin{tabu}{|[2pt]l|[2pt]p{14.5cm}|[2pt]}
\tabucline[2pt]{1-2} \tabucline[2pt]{1-2}
\multicolumn {1}{|[2pt]l|[2pt]}{\rule[-0.7em]{0pt}{2em} Qty}& \multicolumn {1}{|[2pt]l|[2pt]}{\rule[-0.7em]{0pt}{2em} Qty}&
\multicolumn {1}{p{13cm}|[2pt]}{ Description} \\ \tabucline[2pt]{1-2} \multicolumn {1}{p{14.5cm}|[2pt]}{ Description} \\ \tabucline[2pt]{1-2}
\endhead
%%% UNIT %%% %%% UNIT %%%
% Unit name % Unit name
\nodeUnitName{2}{Iris FW1100 - \Gls{firewall} System}{secondary-brown}{ao-black} \nodeUnitName{2}{Iris FW1100 - \Gls{firewall} System}{secondary-brown}{ao-black}
@ -94,10 +100,10 @@ The \gls{cluster} will require rackmountable equipment.
\nodeUnitLastParameter{ 400W Platinum Level Redundant Power Supply } \nodeUnitLastParameter{ 400W Platinum Level Redundant Power Supply }
% Unit has a set of components parameters % Unit has a set of components parameters
\nodeUnitSetItem {2}{ 8GB DDR4 2666MHz ECC Registered DIMM } \nodeUnitSetItem {2}{ 8GB DDR4 2666MHz ECC Registered DIMM }
%\nodeUnitSetItem {1}{ No Operating System. Include testing% \nodeUnitSetItem {1}{ No Operating System. Include testing%
% and customer OS preference in notes. } and customer OS preference in notes. }
%\nodeUnitSetItem {1}{ Return to Depot Warranty (3 Year Hardware% \nodeUnitSetItem {1}{ Return to Depot Warranty (3 Year Hardware%
% Warranty with Standard Advance Parts Replacement) } Warranty with Standard Advance Parts Replacement) }
\nodeUnitSetItem {1}{ 128GB SATA DOM } \nodeUnitSetItem {1}{ 128GB SATA DOM }
\nodeUnitSetLastItem {1}{ Intel 10G Dual Port RJ45 Ethernet Adapter } \nodeUnitSetLastItem {1}{ Intel 10G Dual Port RJ45 Ethernet Adapter }
% Unit ends with notes, pass "none" parameter if no notes % Unit ends with notes, pass "none" parameter if no notes
@ -133,10 +139,10 @@ The \gls{cluster} will require rackmountable equipment.
\nodeUnitSetItem{1}{ 128GB DDR4 2666MHz ECC Reg (4 x 32GB) } \nodeUnitSetItem{1}{ 128GB DDR4 2666MHz ECC Reg (4 x 32GB) }
\nodeUnitSetItem{1}{ Samsung 960 EVO M.2 NVME SSD 500GB } \nodeUnitSetItem{1}{ Samsung 960 EVO M.2 NVME SSD 500GB }
\nodeUnitSetItem{4}{ Ultrastar SN200 800GB NVMe SSD } \nodeUnitSetItem{4}{ Ultrastar SN200 800GB NVMe SSD }
%\nodeUnitSetItem{1}{ No Operating System. Include testing and customer% \nodeUnitSetItem{1}{ No Operating System. Include testing and customer%
% OS preference in notes. } OS preference in notes. }
%\nodeUnitSetItem{1}{ Return to Depot Warranty (3 Year Hardware Warranty% \nodeUnitSetItem{1}{ Return to Depot Warranty (3 Year Hardware Warranty%
% with Standard Advance Parts Replacement) } with Standard Advance Parts Replacement) }
\nodeUnitSetLastItem{1}{ Intel 10G Dual Port RJ45 Ethernet Adapter } \nodeUnitSetLastItem{1}{ Intel 10G Dual Port RJ45 Ethernet Adapter }
% Unit ends with notes, pass "none" parameter if no notes % Unit ends with notes, pass "none" parameter if no notes
%\nodeUnitSetNotes { none } %\nodeUnitSetNotes { none }
@ -157,10 +163,10 @@ The \gls{cluster} will require rackmountable equipment.
\nodeUnitSetItem{2}{ Intel Xeon Silver 4110 8C 2.1GHz 11MB Cache } \nodeUnitSetItem{2}{ Intel Xeon Silver 4110 8C 2.1GHz 11MB Cache }
\nodeUnitSetItem{1}{ 128GB DDR4 2666MHz ECC Reg (8 x 16GB) } \nodeUnitSetItem{1}{ 128GB DDR4 2666MHz ECC Reg (8 x 16GB) }
\nodeUnitSetItem{4}{ HGST Ultrastar 6TB 7200RPM SATA 6Gb/s } \nodeUnitSetItem{4}{ HGST Ultrastar 6TB 7200RPM SATA 6Gb/s }
%\nodeUnitSetItem{1}{ No Operating System. Include testing and customer% \nodeUnitSetItem{1}{ No Operating System. Include testing and customer%
% OS preference in notes. } OS preference in notes. }
%\nodeUnitSetItem{1}{ Return to Depot Warranty (3 Year Hardware Warranty% \nodeUnitSetItem{1}{ Return to Depot Warranty (3 Year Hardware Warranty%
% with Standard Advance Parts Replacement) } with Standard Advance Parts Replacement) }
\nodeUnitSetLastItem{1}{ Intel 10G Dual Port RJ45 Ethernet Adapter } \nodeUnitSetLastItem{1}{ Intel 10G Dual Port RJ45 Ethernet Adapter }
% Unit ends with notes, pass "none" parameter if no notes % Unit ends with notes, pass "none" parameter if no notes
%\nodeUnitSetNotes { none } %\nodeUnitSetNotes { none }
@ -181,23 +187,31 @@ The \gls{cluster} will require rackmountable equipment.
\nodeUnitSetItem{1}{ 64GB DDR4 2666MHz ECC Reg (4 x 16GB) } \nodeUnitSetItem{1}{ 64GB DDR4 2666MHz ECC Reg (4 x 16GB) }
\nodeUnitSetItem{1}{ Samsung 960 EVO M.2 NVME SSD 500GB } \nodeUnitSetItem{1}{ Samsung 960 EVO M.2 NVME SSD 500GB }
\nodeUnitSetItem{6}{ Ultrastar SN200 800GB NVMe SSD } \nodeUnitSetItem{6}{ Ultrastar SN200 800GB NVMe SSD }
% \nodeUnitSetItem{1}{ No Operating System. Include testing and customer% \nodeUnitSetItem{1}{ No Operating System. Include testing and customer%
% OS preference in notes. } OS preference in notes. }
% \nodeUnitSetItem{1}{ Return to Depot Warranty (3 Year Hardware Warranty% \nodeUnitSetItem{1}{ Return to Depot Warranty (3 Year Hardware Warranty%
% with Standard Advance Parts Replacement) } with Standard Advance Parts Replacement) }
\nodeUnitSetLastItem{1}{ Intel X710 Converged Network Adapter Quad-port 10GBaseT } \nodeUnitSetLastItem{1}{ Intel X710 Converged Network Adapter Quad-port 10GBaseT }
% Unit ends with notes, pass "none" parameter if no notes % Unit ends with notes, pass "none" parameter if no notes
%\nodeUnitSetNotes { none } %\nodeUnitSetNotes { none }
%%% END UNIT %%% %%% END UNIT %%%
\end{longtabu}
\end{tabu} \newpage
\end{table} \begin{picture}(0,0)\put(-10000,0){
\gls{sharkfork}
Notes applicable to all units: \gls{backbone}
\gls{firewall}
{ 1. No Operating System. Include testing and customer OS preference in notes. } \gls{corosynk}
\gls{migration}
{ 2. Return to Depot Warranty (3 Year Hardware Warranty with Standard Advance Parts Replacement) } %\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 \newpage

2
source/History.tex
Unescape View File

@ -53,7 +53,7 @@ Forksand started deployment on \glspl{dedicatedserver}.
% %
\vspace{0.2cm} \vspace{0.2cm}
\raggedright \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} \vspace{0.4cm}
\centering \centering
%\includegraphics[width=115mm,trim=10mm 10mm 10mm 10mm] %\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 %\typeoutstandardlayout
%%% END DEBUG %%% %%% END DEBUG %%%
\newglossaryentry{cluster}{name={cluster},plural={clusters}, \newglossaryentry{cluster}{name={Cluster},plural={Clusters},
description={, computer cluster is a set of loosely or description={, computer cluster is a set of loosely or
tightly connected computers that work together so that, in tightly connected computers that work together so that, in
many respects, they can be viewed as a single system.}} many respects, they can be viewed as a single system.}}
\newglossaryentry{dedicatedserver}{ \newglossaryentry{dedicatedserver}{
name={dedicated server},plural={dedicated servers}, name={Dedicated Server},plural={Dedicated Servers},
description={, or managed hosting service description={, or managed hosting service
is a type of Internet hosting in which the client leases is a type of Internet hosting in which the client leases
an entire server not shared with anyone else.}} an entire server not shared with anyone else.}}
\newglossaryentry{sharkfork}{ \newglossaryentry{sharkfork}{
name={SharkFork}, name={SharkFork},
description={is a SharkTech provided \Gls{colocation} for a description={is a SharkTech provided Colocation for a
\gls{cluster} with Fork Sand \Gls{colocation} \Gls{cabinet}}} Cluster with Fork Sand Colocation Cabinet}}
\newglossaryentry{colocation}{name={colocation},plural={colocations}, \newglossaryentry{colocation}{
name={Colocation},plural={Colocations},
description={ centre (also spelled co-location, or colo) or "carrier description={ centre (also spelled co-location, or colo) or "carrier
hotel", is a type of data centre where equipment, space, hotel", is a type of data centre where equipment, space,
and bandwidth are available for rental to retail customers.}} 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 description={, inside a data center, is a locking unit
that holds a server rack.}} 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}, \newglossaryentry{gnulinux}{name={GNU/Linux},
description={ is a term promoted by the Free Software Foundation description={ is a term promoted by the Free Software Foundation
(FSF) and its founder Richard Stallman.[6] Proponents call for (FSF) and its founder Richard Stallman.[6] Proponents call for
the correction of the more extended term, on the grounds that it the correction of the more extended term, on the grounds that it
doesn't give credit to the major contributor and the associated doesn't give credit to the major contributor and the associated
free software philosophy.}} free software philosophy.}}
\newglossaryentry{firewall}{name={firewall},plural={firewalls}, \newglossaryentry{firewall}{
description={ In computing, a firewall is a network security system name={Firewall},plural={Firewalls},
description={ (in computing) is a network security system
that monitors and controls incoming and outgoing network traffic that monitors and controls incoming and outgoing network traffic
based on predetermined security rules.[1] A firewall typically based on predetermined security rules.[1] A firewall typically
establishes a barrier between a trusted internal network and 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{Firewall-opnsense}{OPNSense Firewall}{Use OPNSense}
\chapterconf{Proxmox}{Proxmox}{Virtual Machines} \chapterconf{Proxmox}{Proxmox}{Virtual Machines}
\chapterconf{Ansible}{Ansible}{Cluster Administration} \chapterconf{Ansible}{Ansible}{Cluster Administration}
%\chapterconf{DNS}{Domain Name Service (DNS)}{Who Names You?} \chapterconf{DNS}{Domain Name Service (DNS)}{Who Names You?}
%\chapterconf{NTP}{Network Time Protocol}{A Hole in Time} \chapterconf{NTP}{Network Time Protocol}{A Hole in Time}
%\chapterconf{Firmware}{Firmware}{Embedded Software} \chapterconf{Firmware}{Firmware}{Embedded Software}
%\chapterconf{History}{History}{Evolution History} \chapterconf{History}{History}{Evolution History}
%%%% Appendix %%% %%% Appendix %%%
%%\part{Appendix} % XXX %\part{Appendix} % XXX
%\appendix \appendix
%\chapterconf{Source}{Free Software}{Free Software and Configurations} \chapterconf{Source}{Free Software}{Free Software and Configurations}
%% END MAINMATTER CHAPTERS %%% %% 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