diff --git a/docs/recipes/install/centos7/x86_64/warewulf/slurm/steps.tex b/docs/recipes/install/centos7/x86_64/warewulf/slurm/steps.tex index ec07652b37..373dd2894d 100644 --- a/docs/recipes/install/centos7/x86_64/warewulf/slurm/steps.tex +++ b/docs/recipes/install/centos7/x86_64/warewulf/slurm/steps.tex @@ -464,6 +464,13 @@ \subsubsection{Import files} \label{sec:file_import} \end{lstlisting} % end_ohpc_run +\begin{lstlisting}[language=bash,keywords={},upquote=true,basicstyle=\footnotesize\ttfamily,literate={BOSVER}{\baseos{}}1] +# Additional step required if desiring to use predictable network interface +# naming schemes (e.g. en4s0f0). Skip if using eth# style names. +[sms](*\#*) wwsh provision set "${compute_regex}" --kargs "net.ifnames=1,biosdevname=1" +[sms](*\#*) wwsh provision set --postnetdown=1 "${compute_regex}" +\end{lstlisting} + % begin_ohpc_run % ohpc_validation_comment Add hosts to cluster (Cont.) \begin{lstlisting}[language=bash,keywords={},upquote=true,basicstyle=\footnotesize\ttfamily,literate={BOSVER}{\baseos{}}1] diff --git a/docs/recipes/install/common/finalize_provisioning.tex b/docs/recipes/install/common/finalize_provisioning.tex index 1d53e24065..7a0bb819e0 100644 --- a/docs/recipes/install/common/finalize_provisioning.tex +++ b/docs/recipes/install/common/finalize_provisioning.tex @@ -43,8 +43,18 @@ \subsubsection{Register nodes for provisioning} In preparation for provisioning, we can now define the desired network settings for four example compute nodes with the underlying provisioning system and restart the \texttt{dhcp} service. Note the use of variable names for the -desired compute hostnames, node IPs, and MAC addresses which should be modified to -accommodate local settings and hardware. Included in these steps are commands +desired compute hostnames, node IPs, and MAC addresses which should be modified +to accommodate local settings and hardware. By default, \Warewulf{} uses +network interface names of the \texttt{eth\#} variety and adds kernel boot +arguments to maintain this scheme on newer kernels. Consequently, when specifying +the desired provisioning interface via the \texttt{\$eth\_provision} variable, +it should follow this convention. Alternatively, if you prefer to use the +predictable network interface naming scheme (e.g. names like \texttt{en4s0f0}), +additional steps are included to alter the default kernel boot arguments and take +the \texttt{eth\#} named interface down after bootrapping so the normal init +process can bring it up again using the desired name. + +Also included in these steps are commands to enable \Warewulf{} to manage IPoIB settings and corresponding definitions of IPoIB addresses for the compute nodes. This is typically optional unless you are planning to include a \Lustre{} client mount over \InfiniBand{}. The final step