Skip to main content
StorageGRID Appliances

Deploy services appliance node

Contributors netapp-perveilerk netapp-pcarriga

You can deploy a services appliance as a primary Admin Node, a non-primary Admin Node, or a Gateway Node. All services appliances can operate as Gateway Nodes and Admin Nodes (primary or non-primary) at the same time.

Deploy services appliance as primary Admin Node

When you deploy a services appliance as a primary Admin Node, you use the StorageGRID Appliance Installer included on the appliance to install the StorageGRID software, or you upload the software version you want to install. You must install and configure the primary Admin Node before you install any other appliance node types. A primary Admin Node can connect to the Grid Network, and to the optional Admin Network and Client Network, if one or both are configured.

Before you begin
  • The appliance has been installed in a rack or cabinet, connected to your networks, and powered on.

  • Network links, IP addresses, and port remapping (if necessary) have been configured for the appliance using the StorageGRID Appliance Installer.

  • You have a service laptop with a supported web browser.

  • You know one of the IP addresses assigned to the appliance. You can use the IP address for any attached StorageGRID network.

About this task

To install StorageGRID on an appliance primary Admin Node:

  • You use the StorageGRID Appliance Installer to install the StorageGRID software. If you want to install a different version of the software, you first upload it using the StorageGRID Appliance Installer.

  • You wait as the software is installed.

  • When the software has been installed, the appliance is rebooted automatically.

Steps
  1. Open a browser, and enter the IP address for the appliance.
    https://services_appliance_IP:8443

    The StorageGRID Appliance Installer Home page appears.

  2. In the This Node section, select Primary Admin.

  3. In the Node name field, enter the name you want to use for this appliance node, and click Save.

    The node name is assigned to this appliance node in the StorageGRID system. It is shown on the Grid Nodes page in the Grid Manager.

  4. Optionally, to install a different version of the StorageGRID software, follow these steps:

    1. Download the installation archive:

    2. Extract the archive.

    3. From the StorageGRID Appliance Installer, select Advanced > Upload StorageGRID Software.

    4. Click Remove to remove the current software package.

      Appliance Installer - Remove Current Software
    5. Click Browse for the software package you downloaded and extracted. Select the storagegrid-webscale-images-version.deb package.

    6. Select Home to return to the Home page.

  5. Confirm that the current state is “Ready to start installation of primary Admin Node name with software version x.y” and that the Start Installation button is enabled.

    Note If you are deploying the Admin Node appliance as a node cloning target, stop the deployment process here and continue the node cloning procedure.
  6. From the StorageGRID Appliance Installer home page, click Start Installation.

    Appliance Primary Admin Node 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.

Deploy services appliance as Gateway or non-primary Admin Node

When you deploy a services appliance as a Gateway Node or non-primary Admin Node, you use the StorageGRID Appliance Installer included on the appliance.

Before you begin
  • The appliance has been installed in a rack or cabinet, connected to your networks, and powered on.

  • Network links, IP addresses, and port remapping (if necessary) have been configured for the appliance using the StorageGRID Appliance Installer.

  • The primary Admin Node for the StorageGRID system has been deployed.

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

  • You have a service laptop with a supported web browser.

  • You know the IP address assigned to the appliance. You can use the IP address for any attached StorageGRID network.

About this task

To install StorageGRID on a services appliance node:

  • You specify or confirm the IP address of the primary Admin Node and the name of the appliance node.

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

    Partway through the appliance Gateway Node installation tasks, the installation pauses. To resume the installation, you sign into the Grid Manager, approve all grid nodes, and complete the StorageGRID installation process.

Important Mixing services appliances with different levels of performance in the same site, such as an SG100 or SG110 with an SG1000 or SG1100, can cause unpredictable and inconsistent results when using multiple nodes in a high-availability group or when balancing client load across multiple services appliances.
Note If you need to deploy multiple appliance nodes at one time, you can automate the installation process. See Automate appliance installation and configuration.
Steps
  1. Open a browser, and enter the IP address for the appliance.

    https://Controller_IP:8443

    The StorageGRID Appliance Installer Home page appears.

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

    If you have previously installed other nodes in this data center, 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.

  3. 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 for the connection state for the new IP address to become ready.

    Automatic discovery of all connected primary Admin Nodes

    1. Select the Enable Admin Node discovery checkbox.

    2. Wait for the list of discovered IP addresses to be displayed.

    3. Select the primary Admin Node for the grid where this appliance Storage Node will be deployed.

    4. Click Save.

    5. Wait for the connection state for the new IP address to become ready.

  4. In the Node name field, provide the system name you want to use for this appliance node, and click Save.

    The name that appears here will be the appliance node's system name. System names are required for internal StorageGRID operations and can't be changed.

  5. Optionally, to install a different version of the StorageGRID software, follow these steps:

    1. Download the installation archive:

    2. Extract the archive.

    3. From the StorageGRID Appliance Installer, select Advanced > Upload StorageGRID Software.

    4. Click Remove to remove the current software package.

      Appliance Installer - Remove Current Software
    5. Click Browse for the software package you downloaded and extracted. Select the storagegrid-webscale-images-version.deb package.

    6. Select Home to return to the Home page.

  6. In the Installation section, confirm that the current state is "Ready to start installation of node name into grid with primary Admin Node admin_ip " 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.

  7. 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.
  8. If your grid includes multiple appliance nodes, repeat the previous steps for each appliance.