Restoring the Admin Node database when recovering a non-primary Admin Node

If you want to retain the historical information about attribute values and alarms on a non-primary Admin Node that has failed, you need to restore the Admin Node database from the primary Admin Node.

Before you begin

About this task

If an Admin Node fails, the historical information about attribute values and alarms that are stored in its Admin Node database are lost. When you recover an Admin Node, the software installation process creates a new database for the NMS service. After the recovered Admin Node is started, it records attribute and audit information for all services as if you had performed a new installation of the StorageGRID Webscale system.

If you restored a non-primary Admin Node, you can restore this historical information by copying the Admin Node database from the primary Admin Node (the source Admin Node) to the recovered Admin Node.

Note: Copying the Admin Node database may take several hours. Some Grid Manager features will be unavailable while services are stopped on the source Admin Node.

Steps

  1. Log in to the source Admin Node:
    1. Enter the following command: ssh admin@grid_node_IP
    2. Enter the password listed in the Passwords.txt file.
    3. Enter the following command to switch to root: su -
    4. Enter the password listed in the Passwords.txt file.
  2. Run the following command from the source Admin Node (that is, the primary Admin Node). Then, enter the provisioning passphrase if prompted. recover-access-points
  3. From the source Admin Node, stop the MI service: service mi stop
  4. Complete the following steps on the recovered Admin Node:
    1. Log in to the recovered Admin Node:
      1. Enter the following command: ssh admin@grid_node_IP
      2. Enter the password listed in the Passwords.txt file.
      3. Enter the following command to switch to root: su -
      4. Enter the password listed in the Passwords.txt file.
    2. Stop the MI service: service mi stop
    3. Add the SSH private key to the SSH agent. Enter:ssh-add
    4. Enter the SSH Access Password listed in the Passwords.txt file.
    5. Copy the database from the source Admin Node to the recovered Admin Node: /usr/local/mi/bin/mi-clone-db.sh Source_Admin_Node_IP
    6. When prompted, confirm that you want to overwrite the MI database on the recovered Admin Node.
      The database and its historical data are copied to the recovered Admin Node. When the copy operation is done, the script starts the recovered Admin Node. The following status appears:

      Database cloned, starting servicesstarting mi ... done

    7. When you no longer require passwordless access to other servers, remove the private key from the SSH agent. Enter:ssh-add -D
  5. Restart the MI service on the source Admin Node.service mi start