Skip to main content

Start StorageGRID software installation on a services appliance

Contributors netapp-maireadn netapp-lhalbert netapp-pcarriga netapp-perveilerk
PDFs

To install a Gateway Node or Admin Node on a services appliance, you use the StorageGRID Appliance Installer, which is included on the appliance.

Before you begin

  • The appliance is installed in a rack, connected to your networks, and powered on.

  • Network links and IP addresses are configured for the appliance using the StorageGRID Appliance Installer.

  • If you are installing a Gateway Node or a non-primary Admin Node, you know the IP address for either of the following Admin Nodes:

    • The primary Admin Node for the StorageGRID grid

    • A non-primary Admin Node, if one is available and if it's being used to recover the node

  • If you are recovering a node (including the Primary Admin Node) by using a non-primary Admin Node, you can specify that Admin Node's IP address.

  • All Grid Network subnets listed on the IP Configuration page of the StorageGRID Appliance Installer are defined in the Grid Network Subnet List on the primary Admin Node.

    See Quick start for hardware installation.

  • You are using a supported web browser.

  • You have one of the IP addresses assigned to the appliance. You can use the IP address for the Admin Network, the Grid Network, or the Client Network.

  • If you are installing a primary Admin Node, you have the Ubuntu or Debian install files for this version of StorageGRID available.

    Note A recent version of StorageGRID software is preloaded onto the services appliance during manufacturing. If the preloaded version of software matches the version being used in your StorageGRID deployment, you don't need the installation files.
About this task

To install StorageGRID software on a services appliance:

  • For a primary Admin Node, you specify the name of the node and then upload the appropriate software packages (if required). If you are recovering the primary Admin Node and you have a non-primary Admin Node in your grid, you have the option of either recovering the node using a non-primary Admin Node and specifying the IP of that Admin Node or you can install or recover the node using your current configuration.

  • For a non-primary Admin Node or a Gateway Node, you specify or confirm the IP address of the primary Admin Node and the name of the node.

  • You start the installation and wait as volumes are configured and the software is installed.

  • Partway through the process, the installation pauses. To resume the installation, you must sign into the Grid Manager and configure the pending node as a replacement for the failed node.

  • After you have configured the node, the appliance installation process completes, and the appliance is rebooted.

Steps

  1. Open a browser and enter one of the IP addresses for the services appliance.

    https://Controller_IP:8443

    The StorageGRID Appliance Installer Home page appears.

  2. To install a primary Admin Node:

    1. In the This Node section, for Node Type, select Primary Admin.

    2. In the Node name field, enter the same name that was used for the node you are recovering, and select Save.

    3. Select an appropriate mode from the two that are available in the Installation Mode section. You can select either the Install a node or recover this node using current configuration method or the Recover this node using a non-primary Admin Node method.

      Current configuration method

      Install a node or recover this node using the current configuration.

      1. In the Installation section, check the software version listed under Current state. If the version of software that is ready to install is correct, skip ahead to the Installation step.

      2. If you need to upload a different version of software, under the Advanced menu, select Upload StorageGRID software. The Upload StorageGRID Software page appears.

      3. Select Browse to upload the Software package and Checksum file for StorageGRID software. The files are automatically uploaded after you select them.

      4. Select Home to return to the StorageGRID Appliance Installer Home page.

      Non-primary Admin Node method

      Recover this node using a non-primary Admin Node.

      1. In the non-primary Admin Node IP field, enter the grid network IP address of the non-primary Admin Node you want to use for the recovery, and select Save.

      2. If the version of software that is ready to install is correct, skip ahead to the Installation step.

  3. To install a Gateway Node or non-primary Admin Node:

    1. In the This Node section, for Node Type, select Gateway or Non-Primary Admin, depending on the type of node you are restoring.

    2. In the Node name field, enter the same name that was used for the node you are recovering, and select Save.

    3. In the Primary Admin Node connection section, determine whether you need to specify the IP address for the primary Admin Node.

      The StorageGRID Appliance Installer can discover this IP address automatically, assuming the primary Admin Node, or at least one other grid node with ADMIN_IP configured, is present on the same subnet.

    4. If this IP address isn't shown or you need to change it, specify the address:

    Option Description

    Manual IP entry

    1. Clear the Enable Admin Node discovery checkbox.

    2. Enter the IP address manually.

    3. Select Save.

    4. Wait while the connection state for the new IP address becomes "ready."

    Automatic discovery of all connected primary Admin Nodes

    1. Select the Enable Admin Node discovery checkbox.

    2. From the list of discovered IP addresses, select the primary Admin Node for the grid where this services appliance will be deployed.

    3. Select Save.

    4. Wait while the connection state for the new IP address becomes "ready."

  4. In the Installation section, confirm that the current state is Ready to start installation of node name and that the Start Installation button is enabled.

    If the Start Installation button isn't enabled, you might need to change the network configuration or port settings. Refer to the maintenance instructions for your appliance.

  5. From the StorageGRID Appliance Installer home page, select Start installation.

    The Current state changes to "Installation is in progress," and the Monitor installation page is displayed.

    Note If you need to access the Monitor installation page manually, select Monitor installation from the menu bar.