Skip to main content

Start software installation on services appliance

Contributors 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 non-primary Admin Node, you know the IP address of the primary Admin Node for the StorageGRID grid.

  • 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).

  • 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.

    Appliance Installer Home Page

  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 click Save.

    3. 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.

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

      TheUpload StorageGRID Software page appears.

      Screenshot described by surrounding text

    5. Click Browse to upload the Software Package and Checksum File for StorageGRID software.

      The files are automatically uploaded after you select them.

    6. Click Home to return to the StorageGRID Appliance Installer Home page.

  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 click 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 is not 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. Click 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. Click 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 is not enabled, you might need to change the network configuration or port settings. For instructions, see the maintenance instructions for your appliance.

  5. From the StorageGRID Appliance Installer home page, click 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, click Monitor Installation from the menu bar.