Merge pull request #239421 from JAC0BSMITH/jac0bsmithNexusDocs

Refinement to BMM actions

Author: JamesJBarnett

articles/operator-nexus/howto-baremetal-functions.md

@@ -5,7 +5,7 @@ author: harish6724
 ms.author: harishrao
 ms.service: azure-operator-nexus 
 ms.topic: how-to
-ms.date: 03/06/2023
+ms.date: 05/26/2023
 ms.custom: template-how-to
 ---
 
@@ -15,40 +15,56 @@ This article describes how to perform lifecycle management operations on Bare Me
 
 - Power off the BMM
 - Start the BMM
+- Restart the BMM
 - Make the BMM unschedulable or schedulable
-- Reinstall the BMM image
-- Replace BMM
+- Reimage the BMM 
+- Replace the BMM
 
 ## Prerequisites
 
 1. Install the latest version of the
   [appropriate CLI extensions](./howto-install-cli-extensions.md)
-1. Ensure that the target bare metal machine (server) must have its `poweredState` set to `On` and have its `readyState` set to `True`
-1. Get the Resource group name that you created for `Cluster` resource
+1. Get the name of the resource group for the BMM
+1. Get the name of the bare metal machine  that requires a lifecycle management operation
+1. Ensure that the target bare metal machine `poweredState` set to `On` and `readyState` set to `True`
+    1. This prerequisite is not applicable for the `start` command
+
 
 ## Power off the BMM
 
 This command will `power-off` the specified `bareMetalMachineName`.
 
 ```azurecli
-  az networkcloud baremetalmachine power-off --name "bareMetalMachineName"  \
-        --resource-group "resourceGroupName"
+  az networkcloud baremetalmachine power-off \
+    --name "bareMetalMachineName"  \
+    --resource-group "resourceGroupName"
 ```
 
 ## Start the BMM
 
 This command will `start` the specified `bareMetalMachineName`.
 
 ```azurecli
- az networkcloud baremetalmachine start --name "bareMetalMachineName" \
+ az networkcloud baremetalmachine start \
+   --name "bareMetalMachineName" \
+   --resource-group "resourceGroupName"
+```
+
+## Restart the BMM
+
+This command will `restart` the specified `bareMetalMachineName`.
+
+```azurecli
+ az networkcloud baremetalmachine restart \
+    --name "bareMetalMachineName" \
     --resource-group "resourceGroupName"
 ```
 
 ## Make a BMM unschedulable (cordon)
 
 You can make a BMM unschedulable by executing the [`cordon`](#make-a-bmm-unschedulable-cordon) command.
 On the execution of the `cordon` command,
-Operator Nexus workloads are not scheduled on the BMM when cordon is set; any attempt to create a workload on a `cordoned`
+Operator Nexus workloads aren't scheduled on the BMM when cordon is set; any attempt to create a workload on a `cordoned`
 BMM results in the workload being set to `pending` state. Existing workloads continue to run.
 The cordon command supports an `evacuate` parameter with the default `False` value.
 On executing the `cordon` command, with the value `True` for the `evacuate`
@@ -74,26 +90,29 @@ state on the BMM are `restarted` when the BMM is `uncordoned`.
     --resource-group "resourceGroupName"
 ```
 
-## Reimage a BMM (reinstall a BMM image)
+## Reimage a BMM
 
-An existing BMM image is **reinstalled** using the `reimage` command. This command doesn't install a new image.
-Make sure the BMM's workloads are drained using the [`cordon`](#make-a-bmm-unschedulable-cordon)
+You can restore the runtime version on a BMM by executing `reimage` command. This process **redeploys** the runtime image on the target BMM and executes the steps to rejoin the cluster with the same identifiers. This action doesn't impact the tenant workload files on this BMM.
+As a best practice, make sure the BMM's workloads are drained using the [`cordon`](#make-a-bmm-unschedulable-cordon)
 command, with `evacuate "True"`, prior to executing the `reimage` command.
 
 ```azurecli
-az networkcloud baremetalmachine reimage –-name "bareMetalMachineName"  \
+az networkcloud baremetalmachine reimage \
+  –-name "bareMetalMachineName"  \
   --resource-group "resourceGroupName"
 ```
 
-The reimage command restarts the BMM and uncordons it. The re-imaged BMM will have an IP address.You can start deploying workloads on the reimaged BMM.
-
 ## Replace BMM
 
-Use `Replace BMM` command whenever a BareMetal machine has encountered hardware issues requiring a complete or partial hardware replacement. After replace the MAC address of Baremetal Host will change, however the IDrac IP address and hostname will remain the same.
+Use `Replace BMM` command when a server has encountered hardware issues requiring a complete or partial hardware replacement. After replacement of components such as motherboard or NIC replacement, the MAC address of BMM will change, however the IDrac IP address and hostname will remain the same.
 
 ```azurecli
-az networkcloud baremetalmachine replace --name "bareMetalMachineName" \
-    --bmc-credentials password="{password}" username="bmcuser" --bmc-mac-address "00:00:4f:00:57:ad" \
-    --boot-mac-address "00:00:4e:00:58:af" --machine-name "name" --serial-number "BM1219XXX" \
-    --resource-group "resourceGroupName" 
+az networkcloud baremetalmachine replace \
+  --name "bareMetalMachineName" \
+  --resource-group "resourceGroupName" \
+  --bmc-credentials password="{password}" username="{user}" \
+  --bmc-mac-address "00:00:4f:00:57:ad" \
+  --boot-mac-address "00:00:4e:00:58:af" \
+  --machine-name "name" \
+  --serial-number "BM1219XXX"
 ```