Merge pull request #60053 from sjhala-ccs/BZ2176838

BZ#2176838: Updated VM SSH procedure

Author: sjhala-ccs

modules/virt-accessing-vmi-ssh.adoc

@@ -6,15 +6,15 @@
 [id="virt-accessing-vmi-ssh_{context}"]
 = Accessing a virtual machine via SSH by using virtctl
 
-You can use the `virtctl ssh` command to forward SSH traffic to a virtual machine (VM) by using your local SSH client.
+You can use the `virtctl ssh` command to forward SSH traffic to a virtual machine (VM) by using your local SSH client. If you have previously configured SSH key authentication with the VM, skip to step 2 of the procedure because step 1 is not required.
 
 [NOTE]
 ====
 Heavy SSH traffic on the control plane can slow down the API server. If you regularly need a large number of connections, use a dedicated Kubernetes `Service` object to access the virtual machine.
 ====
 
+
 .Prerequisites
-* You have access to an {product-title} cluster with `cluster-admin` permissions.
 * You have installed the OpenShift CLI (`oc`).
 * You have installed the `virtctl` client.
 * The virtual machine you want to access is running.
@@ -23,22 +23,23 @@ Heavy SSH traffic on the control plane can slow down the API server. If you regu
 
 .Procedure
 
-. Use the `ssh-keygen` command to generate an SSH public key pair:
+. Configure SSH key authentication:
+.. Use the `ssh-keygen` command to generate an SSH public key pair:
 +
 [source,terminal]
 ----
 $ ssh-keygen -f <key_file> <1>
 ----
 <1> Specify the file in which to store the keys.
 
-. Create an SSH authentication secret which contains the SSH public key to access the VM:
+.. Create an SSH authentication secret which contains the SSH public key to access the VM:
 +
 [source,terminal]
 ----
 $ oc create secret generic my-pub-key --from-file=key1=<key_file>.pub
 ----
 
-. Add a reference to the secret in the `VirtualMachine` manifest. For example:
+.. Add a reference to the secret in the `VirtualMachine` manifest. For example:
 +
 [source,yaml]
 ----
@@ -62,16 +63,17 @@ spec:
 <1> Reference to the SSH authentication `Secret` object.
 <2> The SSH public key is injected into the VM as cloud-init metadata using the `configDrive` provider.
 
-. Restart the VM to apply your changes.
+.. Restart the VM to apply your changes.
 
-. Run the following command to access the VM via SSH:
+. Connect to the VM via SSH: 
+.. Run the following command to access the VM via SSH:
 +
 [source,terminal]
 ----
 $ virtctl ssh -i <key_file> <vm_username>@<vm_name>
 ----
 
-. Optional: To securely transfer files to or from the VM, use the following commands:
+.. Optional: To securely transfer files to or from the VM, use the following commands:
 +
 
 .Copy a file from your machine to the VM