By placing the CVM in maintenance mode, it instructs the cluster to redirect traffic storage traffic from the host hypervisor to other CVMs in the cluster. It also performs a graceful stop of CVM services. It is recommended to enable maintenance mode before a cvm is shutdown.

  1. Connect using SSH to the Cluster IP or any CVM.
  2. Run the host list command:
nutanix@cvm$ ncli host list
    Id                        : 0005a2e1-4eaa-8b68-5558-aaaaaacd64d6::8
    Uuid                      : 4f06c7ad-05e6-4088-9612-aaaaaadcffd8
    Name                      : HOSTNAME
    IPMI Address              : 10.29.2.181
    Controller VM Address     : 10.26.2.31
    Controller VM NAT Address : 
    Controller VM NAT PORT    : 
    Hypervisor Address        : 10.26.2.51
    Hypervisor Version        : Nutanix 20190916.253
    Host Status               : NORMAL
    Oplog Disk Size           : 230 GiB (246,960,619,520 bytes) (0.3%)
    Under Maintenance Mode    : false (life_cycle_management)
    Metadata store status     : Metadata store enabled on the node
    Node Position             : Node physical position can't be displayed for this model. Please refer to Prism UI for this information.
    Node Serial (UUID)        : OM1XXXXXXXXX
    Block Serial (Model)      : 20FXXXXXXXXX (NX-8155-G7)
example of the ncli host list output for one cvm

3. Identify the Id for the CVM that you'd like to place in maintenance mode, then execute the enable-maintenance-mode command. Only the numbers to the right of the two colons are required for <host_id>. 

nutanix@cvm$ ncli host edit id=<host_id> enable-maintenance-mode=true
Example of command: ncli host edit id=8 enable-maintenance-mode=true

4. After the CVM has successfully been placed in maintenance mode, ncli will output the host information. Note, the under maintenance mode status has been updated to true. 

    Id                        : 0005a2e1-4eaa-8b68-5558-aaaaaacd64d6::8
    Uuid                      : 4f06c7ad-05e6-4088-9612-aaaaaadcffd8
    Name                      : HOSTNAME
    IPMI Address              : 10.29.2.181
    Controller VM Address     : 10.26.2.31
    Controller VM NAT Address : 
    Controller VM NAT PORT    : 
    Hypervisor Address        : 10.26.2.51
    Hypervisor Version        : Nutanix 20190916.253
    Host Status               : NORMAL
    Oplog Disk Size           : 230 GiB (246,960,619,520 bytes) (0.3%)
    Under Maintenance Mode    : true (life_cycle_management)
    Metadata store status     : Metadata store enabled on the node
    Node Position             : Node physical position can't be displayed for this model. Please refer to Prism UI for this information.
    Node Serial (UUID)        : OM1XXXXXXXXX
    Block Serial (Model)      : 20FXXXXXXXXX (NX-8155-G7)
Example Output of ncli host edit enable-maintenance-mode=true

To exit Maintenance mode, execute the reverse command. 

nutanix@cvm$ ncli host edit id=<host_id> enable-maintenance-mode=false
Example of command: ncli host edit id=8 enable-maintenance-mode=false

Nutanix has created KB 5639 for CVM/AHV maintenance modes.