Recovering a management node

You can manually recover and redeploy the management node for your cluster running NetApp Element software if your previous management node used persistent volumes. You can deploy a new OVA and run a redeploy script to pull configuration data from a previously installed management node running version 11.3 and later.

Before you begin

Steps

  1. Download the OVA or ISO for your installation from the NetApp Support Site:
    1. Select the version number of the software to download.
    2. Click Go.
    3. Read and click through the required prompts, accept the EULA, and select the management node image you want to download.
  2. If you downloaded the OVA, follow these steps:
    1. Deploy the OVA.
    2. If your storage cluster is on a separate subnet from your management node (eth0) and you want to use persistent volumes, add a second network interface controller (NIC) to the VM on the storage subnet (eth1).
  3. If you downloaded the ISO, follow these steps:
    1. Create a new 64-bit virtual machine from your hypervisor with the following configuration:
      • Six virtual CPUs
      • 12GB RAM
      • 400GB virtual disk, thin provisioned
      • One virtual network interface with internet access and access to the storage MVIP.
      • (Optional for SolidFire all-flash storage) One virtual network interface with management network access to the storage cluster. If your storage cluster is on a separate subnet from your management node (eth0) and you want to use persistent volumes, add a second network interface controller (NIC) to the VM on the storage subnet (eth1) or ensure that the management network can route to the storage network.
      Attention: Do not power on the virtual machine prior to the step indicating to do so later in this procedure.
    2. Attach the ISO to the virtual machine and boot to the .iso install image.
      Note: Installing a management node using the image might result in 30-second delay before the splash screen appears.
  4. Power on the virtual machine for the management node after the installation completes.
  5. Using the terminal user interface (TUI), create a management node admin user.
    Tip: To enter text, press Enter three times on the keyboard to open edit mode. After you enter text, press Enter again to close the edit mode. To navigate between fields, use the arrow keys.
  6. Configure the management node network (eth0).
    Note: If you have a second NIC on eth1, see instructions on configuring a second NIC.

    Configuring a storage NIC (eth1)

  7. SSH into the management node or use the console provided by your hypervisor.
  8. Using SSH, run the following command to gain root privileges. Enter your password when prompted:
    sudo su
  9. Ensure time is synced (NTP) between the management node and the storage cluster.
    Note: In vSphere, the Synchronize guest time with host box should be checked in the VM options. Do not disable this option if you make future changes to the VM.
  10. Configure the management node redeploy command to reconnect to persistent volumes hosted on the cluster and start services with previous management node configuration data:
    Note: You will be prompted to enter passwords if you do not include them in the command.
    /sf/packages/mnode/redeploy-mnode --mnode_admin_user [username] --storage_username [username] --storage_mvip [mvip] --storage_svip [svip] --persistent_volumes_account [account-name] 
    
    1. Replace the values in [ ] brackets for each of the following required parameters:
      Note: The abbreviated form of the command name is in parentheses ( ) and can be substituted for the full name.
      --mnode_admin_user (-mu) [username]
      The user name for the management node administrator account. This is likely to be the user name for the user account you used to log into the management node.
      --storage_username (-su) [username]
      The storage cluster administrator user name for the cluster specified by the --storage_mvip parameter.
      --storage_mvip (-sm) [MVIP address]
      The MVIP (management virtual IP address) of the storage cluster running Element software with the persistent volumes that contain management node data for recovery.
      --storage_svip (-ss) [svip]
      The SVIP (storage virtual IP address) of the storage cluster running Element software with the persistent volumes that contain management node data for recovery.
      --persistent_volumes_account (-pva) [account_name]
      Enter the storage account name from the cluster containing the persistent volumes. This is the exact name of the storage user account that owns the volumes in the cluster.
    2. (Optional): Add administrator and storage credential parameters to the command. You will be prompted to enter these passwords in a secure prompt if you do not include them in the command:
      --mnode_admin_password (-mp) [password]
      The password of the management node administrator account. This is likely to be the password for the user account you used to log into the management node.
      --storage_password (-sp) [password]
      The password of the storage cluster administrator specified by the --storage_username parameter.
    3. (Optional) Use parameter help if you need additional information about each parameter:
      --help (-h)
      Returns information about each parameter. Parameters are defined as required or optional based on initial deployment. Upgrade and redeployment parameter requirements might vary.
    4. Run the redeploy-mnode command.