Skip to main content

Copying the Admin Node database

Contributors

When adding Admin Nodes through an expansion procedure, you can optionally copy the database from the primary Admin Node to the new Admin Node. Copying the database allows you to retain historical information about attributes, alerts, and alerts.

What you'll need
  • You must have completed the required expansion steps to add an Admin Node.

  • You must have the Passwords.txt file.

  • You must have the provisioning passphrase.

About this task

The StorageGRID software activation process creates an empty database for the NMS service on the expansion Admin Node. When the NMS service starts on the expansion Admin Node, it records information for servers and services that are currently part of the system or added later. This Admin Node database includes the following information:

  • Alert history

  • Alarm history

  • Historical attribute data, which is used in the charts and text reports available from the Support > Tools > Grid Topology page

To ensure that the Admin Node database is consistent between nodes, you can copy the database from the primary Admin Node to the expansion Admin Node.

Note Copying the database from the primary Admin Node (thesource Admin Node) to an expansion Admin Node can take up to several hours to complete. During this period, the Grid Manager is inaccessible.

Use these steps to stop the MI service and the Management API service on both the primary Admin Node and the expansion Admin Node before copying the database.

Steps
  1. Complete the following steps on the primary Admin Node:

    1. Log in to the 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: recover-access-points

    3. Enter the provisioning passphrase.

    4. Stop the MI service: service mi stop

    5. Stop the Management Application Program Interface (mgmt-api) service: service mgmt-api stop

  2. Complete the following steps on the expansion Admin Node:

    1. Log in to the expansion 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. Stop the mgmt-api service: service mgmt-api stop

    4. Add the SSH private key to the SSH agent. Enter:ssh-add

    5. Enter the SSH Access Password listed in the Passwords.txt file.

    6. Copy the database from the source Admin Node to the expansion Admin Node: /usr/local/mi/bin/mi-clone-db.sh Source_Admin_Node_IP

    7. When prompted, confirm that you want to overwrite the MI database on the expansion Admin Node.

      The database and its historical data are copied to the expansion Admin Node. When the copy operation is done, the script starts the expansion Admin Node.

    8. When you no longer require passwordless access to other servers, remove the private key from the SSH agent. Enter:ssh-add -D

  3. Restart the services on the primary Admin Node: service servermanager start