Skip to main content

Placing an appliance into maintenance mode

Contributors

You must place the appliance into maintenance mode before performing specific maintenance procedures.

What you'll need
  • You must be signed in to the Grid Manager using a supported browser.

  • You must have the Maintenance or Root Access permission. For details, see the instructions for administering StorageGRID.

About this task

Placing a StorageGRID appliance into maintenance mode might make the appliance unavailable for remote access.

Note The password and host key for a StorageGRID appliance in maintenance mode remain the same as they were when the appliance was in service.
Steps
  1. From the Grid Manager, select Nodes.

  2. From the tree view of the Nodes page, select the appliance Storage Node.

  3. Select Tasks.

    Maintenance Mode button for appliance
  4. Select Maintenance Mode.

    A confirmation dialog box appears.

    Maintenance Mode confirmation dialog box
  5. Enter the provisioning passphrase, and select OK.

    A progress bar and a series of messages, including "Request Sent," "Stopping StorageGRID," and "Rebooting," indicate that the appliance is completing the steps for entering maintenance mode.

    Maintenance Mode Progress Bar

    When the appliance is in maintenance mode, a confirmation message lists the URLs you can use to access the StorageGRID Appliance Installer.

    Maintenance Mode URLs
  6. To access the StorageGRID Appliance Installer, browse to any of the URLs displayed.

    If possible, use the URL containing the IP address of the appliance's Admin Network port.

    Note Accessing https://169.254.0.1:8443 requires a direct connection to the local management port.
  7. From the StorageGRID Appliance Installer, confirm that the appliance is in maintenance mode.

    maintenance mode message
  8. Perform any required maintenance tasks.

  9. After completing maintenance tasks, exit maintenance mode and resume normal node operation. From the StorageGRID Appliance Installer, select Advanced > Reboot Controller, and then select Reboot into StorageGRID.

    Reboot controller in maintenance mode

    It can take up to 20 minutes for the appliance to reboot and rejoin the grid. To confirm that the reboot is complete and that the node has rejoined the grid, go back to the Grid Manager. The Nodes tab should display a normal status icon alert green checkmark for the appliance node, indicating that no alerts are active and the node is connected to the grid.

    Appliance node rejoined grid