Stopping services and shutting down grid nodes

Before you can power off a StorageGRID Webscale system, you must stop all services running on each grid node and then shut down all VMware virtual machines, Docker containers, and StorageGRID Webscale appliances.

About this task

If possible, you should stop services on the grid nodes in this order:
  • Stop services on API Gateway Nodes first.
  • Stop services on the primary Admin Node last.
This approach allows you to use the primary Admin Node to monitor the status of the other grid nodes for as long as possible.
Note: If a single host includes more than one grid node, do not shut down the host until you have stopped all of the services on that host. If the host includes the primary Admin Node, shut down that host last.
Note: If required, you can migrate nodes from one Linux host to another to perform host maintenance without impacting the functionality or availability of your grid.

Linux: Migrating a grid node to a new host

Steps

  1. Stop all client applications from accessing the grid.
  2. Log in to each API Gateway 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.
      When you are logged in as root, the prompt changes from $ to #.
  3. Stop all services running on the grid node: service servermanager stop
    Wait a minimum of 30 minutes for the command to complete.
  4. Repeat steps 2 and 3 to stop the services on all Storage Nodes, Archive Nodes, and non-primary Admin Nodes.
    You can stop the services on these nodes in any order.
    Note: If you issue the service servermanager stop command to stop the services on an appliance Storage Node, you must power cycle the appliance to restart the node.
  5. Repeat steps 2 and 3 to stop the services on the primary Admin Node.
  6. For nodes that are running on Linux hosts:
    1. Log in to the host operating system.
    2. Stop the node: storagegrid node stop
    3. Shut down the host operating system.
  7. For nodes that are running on VMware virtual machines and for appliance Storage Nodes, issue the shutdown command: shutdown -h now
    Perform this step regardless of the outcome of the service servermanager stop command.
    For the appliance, this command shuts down the compute controller, but the appliance is still powered on. You must complete the next step.
  8. If you have appliance Storage Nodes:
    • For the SG6000 appliance
      1. Wait for the green Cache Active LED on the back of the storage controller to turn off.

        This LED is on when cached data needs to be written to the drives. You must wait for this LED to turn off before you turn off power.

      2. Turn off the power to the appliance, and wait for the blue power LED to turn off.
    • For the SG5700 appliance
      1. Wait for the green Cache Active LED on the back of the storage controller to turn off.

        This LED is on when cached data needs to be written to the drives. You must wait for this LED to turn off before you turn off power.

      2. Turn off the power to the appliance, and wait for all LED and seven-segment display activity to stop.
  9. If required, log out of the command shell: exit
    The StorageGRID Webscale grid has now been shut down.