Clarify node login

SUSE · Aug 29, 2024 · ff3de2a · ff3de2a
1 parent bf3cbbf
commit ff3de2a
Show file tree

Hide file tree

Showing 2 changed files with 23 additions and 13 deletions.
diff --git a/xml/ha_bootstrap_install.xml b/xml/ha_bootstrap_install.xml
@@ -144,11 +144,17 @@
     </para>
     <procedure xml:id="pro-ha-bootstrap-install-first-node">
     <title>Setting up the first node with <command>crm cluster init</command></title>
+    <step>
+      <para>
+        Log in to the first cluster node as &rootuser;, or as a user with <command>sudo</command>
+        privileges.
+      </para>
+    </step>
     <step>
       <para>
       Start the bootstrap script:
       </para>
-      <screen>&prompt.root;<command>crm cluster init --name <replaceable>CLUSTERNAME</replaceable></command></screen>
+      <screen>&prompt.root;<command>crm cluster init</command></screen>
       <para>Replace the <replaceable>CLUSTERNAME</replaceable>
       placeholder with a meaningful name, like the geographical location of your
       cluster (for example, <literal>&cluster1;</literal>).
@@ -306,6 +312,11 @@
     </para>
     <procedure xml:id="pro-ha-install-node-join-bootstrap">
     <title>Adding nodes with <command>crm cluster join</command></title>
+    <step>
+      <para>
+        Log in to this node as the same user you set up the first node with.
+      </para>
+    </step>
     <step>
       <para>
         Start the bootstrap script:

diff --git a/xml/ha_log_in.xml b/xml/ha_log_in.xml
@@ -46,9 +46,9 @@
           (or be generated) locally on the node, not on a remote system.
         </para>
         <para>
-          To log in to the first cluster node as the &rootuser; user, run the following command:
+          To log in to a node as the &rootuser; user, run the following command:
         </para>
-<screen><prompt>user@local&gt; </prompt><command>ssh root@<replaceable>NODE1</replaceable></command></screen>
+<screen><prompt>user@local&gt; </prompt><command>ssh root@<replaceable>NODE</replaceable></command></screen>
       </listitem>
     </varlistentry>
     <varlistentry>
@@ -60,10 +60,9 @@
          locally on the node, not on a remote system.
         </para>
         <para>
-          To log in to the first cluster node as a <command>sudo</command> user, run the
-          following command:
+          To log in to a node as a <command>sudo</command> user, run the following command:
         </para>
-<screen><prompt>user@local&gt; </prompt><command>ssh <replaceable>USER@NODE1</replaceable></command></screen>
+<screen><prompt>user@local&gt; </prompt><command>ssh <replaceable>USER@NODE</replaceable></command></screen>
       </listitem>
     </varlistentry>
     <varlistentry>
@@ -75,8 +74,7 @@
           additional configuration on your local machine and on the cluster nodes.
         </para>
         <para>
-          To log in to the first cluster node with SSH agent forwarding enabled,
-          perform the following steps:
+          To log in to a node with SSH agent forwarding enabled, perform the following steps:
         </para>
         <orderedlist>
         <listitem>
@@ -89,21 +87,22 @@
         </listitem>
         <listitem>
           <para>
-            Log in to the first node with the <option>-A</option> option to enable
-            SSH agent forwarding:
+            Log in to the node with the <option>-A</option> option to enable SSH agent forwarding:
           </para>
-<screen><prompt>user@local&gt; </prompt><command>ssh -A <replaceable>USER@NODE1</replaceable></command></screen>
+<screen><prompt>user@local&gt; </prompt><command>ssh -A <replaceable>USER@NODE</replaceable></command></screen>
         </listitem>
       </orderedlist>
       </listitem>
     </varlistentry>
   </variablelist>
   <para>
-    When you add nodes to the cluster, you must log in to each node as the same user you set up the first node with.
+    When you add nodes to the cluster, you must log in to each node as the same user you set
+    up the first node with.
   </para>
   <important role="compact">
     <para>
-      For simplicity, the commands in this guide assume you are logged in as the &rootuser; user. If you logged in as a <command>sudo</command> user, adjust the commands accordingly.
+      For simplicity, the commands in this guide assume you are logged in as the &rootuser; user.
+      If you logged in as a <command>sudo</command> user, adjust the commands accordingly.
     </para>
   </important>
 </chapter>