Deploying a StorageGRID node as a virtual machine

You use VMware vSphere Web Client to deploy each grid node as a virtual machine. During deployment, each grid node is created and connected to one or more StorageGRID networks. Optionally, you can remap node ports or increase CPU or memory settings for the node before powering it on.

Before you begin

About this task

Follow these instructions to initially deploy VMware nodes, add a new VMware node in an expansion, or replace a VMware node as part of a recovery operation. Except as noted in the steps, the node deployment procedure is the same for all node types, including Admin Nodes, Storage Nodes, Gateway Nodes, and Archive Nodes.

If you are installing a new StorageGRID system:
  • You must deploy the primary Admin Node before you deploy any other grid node.
  • You must ensure that each virtual machine can connect to the primary Admin Node over the Grid Network.
  • You must deploy all grid nodes before configuring the grid.
If you are performing an expansion or recovery operation:
  • You must ensure that the new virtual machine can connect to the primary Admin Node over the Grid Network.

If you need to remap any of the node's ports, do not power on the new node until the port remap configuration is complete.

Procedure

  1. Using VCenter, deploy an OVF template.
    If you specify a URL, point to a folder containing the following files. Otherwise, select each of these files from a local directory.
    • NetApp-SG-version-SHA.vmdk
    • vsphere-node.ovf
    • vsphere-node.mf
    For example, if this is the first node you are deploying, use these files to deploy the primary Admin Node for your StorageGRID system:
    • NetApp-SG-version-SHA.vmdk
    • vsphere-primary-admin.ovf
    • vsphere-primary-admin.mf
  2. Provide a name for the virtual machine.
    The standard practice is to use the same name for both the virtual machine and the grid node.
  3. Place the virtual machine in the appropriate vApp or resource pool.
  4. If you are deploying the primary Admin Node, read and accept the End User License Agreement.
    Note: Depending on your version of vCenter, the order of the steps will vary for accepting the End User License Agreement, specifying the name of the virtual machine, and selecting a datastore
  5. Select storage for the virtual machine.
    Note: If you are deploying a node as part of recovery operation, perform the instructions in step 10 to add new virtual disks, reattach virtual hard disks from the failed grid node, or both.
    When deploying a Storage Node, use 3 or more storage volumes, with each storage volume being 4 TB or larger. You must assign at least 4 TB to volume 0.
    Attention: The Storage Node .ovf file defines several VMDKs for storage. Unless these VMDKs meet your storage requirements, you should remove them and assign appropriate VMDKs or RDMs for storage before powering up the node. VMDKs are more commonly used in VMware environments and are easier to manage, while RDMs may provide better performance for workloads that use larger object sizes (for example, greater than 100 MB).
  6. Select networks.
    Determine which StorageGRID networks the node will use by selecting a destination network for each source network.
    • The Grid Network is required. You must select a destination network in the vSphere environment.
    • If you use the Admin Network, select a different destination network in the vSphere environment. If you do not use the Admin Network, select the same destination you selected for the Grid Network.
    • If you use the Client Network, select a different destination network in the vSphere environment. If you do not use the Client Network, select the same destination you selected for the Grid Network.
  7. Under Customize Template, configure the required StorageGRID node properties.
    1. Enter the Node name.
      Attention: If you are recovering a grid node, you must enter the name of the node you are recovering.
    2. In the Grid Network (eth0) section, select STATIC or DHCP for the Grid network IP configuration.
      • If you select STATIC, enter the Grid network IP, Grid network mask, Grid network gateway, and Grid network MTU.
      • If you select DHCP, the Grid network IP, Grid network mask, and Grid network gateway are automatically assigned.
    3. In the Primary Admin IP field, enter the IP address of the primary Admin Node for the Grid Network.
      Note: This step does not apply if the node you are deploying is the primary Admin Node.

      If you omit the primary Admin Node IP address, the IP address will be automatically discovered if the primary Admin Node, or at least one other grid node with ADMIN_IP configured, is present on the same subnet. However, it is recommended to set the primary Admin Node IP address here.

    4. In the Admin Network (eth1) section, select STATIC, DHCP, or DISABLED for the Admin network IP configuration.
      • If you do not want to use the Admin Network, select DISABLED and enter 0.0.0.0 for the Admin Network IP. You can leave the other fields blank.
      • If you select STATIC, enter the Admin network IP, Admin network mask, Admin network gateway, and Admin network MTU.
      • If you select STATIC, enter the Admin network external subnet list. You must also configure a gateway.
      • If you select DHCP, the Admin network IP, Admin network mask, and Admin network gateway are automatically assigned.
    5. In the Client Network (eth2) section, select STATIC, DHCP, or DISABLED for the Client network IP configuration.
      • If you do not want to use the Client Network, select DISABLED and enter 0.0.0.0 for the Client network IP. You can leave the other fields blank.
      • If you select STATIC, enter the Client network IP, Client network mask, Client network gateway, and Client network MTU.
      • If you select DHCP, the Client network IP, Client network mask, and Client network gateway are automatically assigned.
  8. Review the virtual machine configuration and make any changes necessary.
  9. When you are ready to complete, select Finish to start the upload of the virtual machine.
  10. If you deployed this node as part of recovery operation and this is not a full-node recovery, perform these steps after deployment is complete:
    1. Right-click the virtual machine, and select Edit Settings.
    2. Select each default virtual hard disk that has been designated for storage, and select Remove.
    3. Depending on your data recovery circumstances, add new virtual disks according to your storage requirements, reattach any virtual hard disks preserved from the previously removed failed grid node, or both.
      Note the following important guidelines:
      • If you are adding new disks you should use the same type of storage device that was in use before node recovery.
      • The Storage Node .ovf file defines several VMDKs for storage. Unless these VMDKs meet your storage requirements, you should remove them and assign appropriate VMDKs or RDMs for storage before powering up the node. VMDKs are more commonly used in VMware environments and are easier to manage, while RDMs may provide better performance for workloads that use larger object sizes (for example, greater than 100 MB).
  11. If you need to remap the ports used by this node, follow these steps.
    You might need to remap a port if your enterprise networking policies restrict access to one or more ports that are used by StorageGRID. See the networking guidelines for the ports used by StorageGRID.

    StorageGRID networking guidelines

    Attention: Do not remap the ports used in load balancer endpoints.
    1. Select the new VM.
    2. From the Configure tab, select Settings > vApp Options.
      Note: The location of vApp Options depends on the version of vCenter.
    3. In the Properties table, locate PORT_REMAP_INBOUND and PORT_REMAP.
    4. To symmetrically map both inbound and outbound communications for a port, select PORT_REMAP.
      Note: If only PORT_REMAP is set, the mapping that you specify applies to both inbound and outbound communications. If PORT_REMAP_INBOUND is also specified, PORT_REMAP applies only to outbound communications.
      1. Scroll back to the top of the table, and select Edit.
      2. On the Type tab, select User configurable, and select Save.
      3. Select Set Value.
      4. Enter the port mapping:
        <network type>/<protocol>/<default port used by grid node>/<new port>

        <network type> is grid, admin, or client, and <protocol> is tcp or udp.

        For example, to remap ssh traffic from port 22 to port 3022, enter:

        client/tcp/22/3022
      5. Select OK.
    5. To specify the port used for inbound communications to the node, select PORT_REMAP_INBOUND.
      Note: If you specify PORT_REMAP_INBOUND and do not specify a value for PORT_REMAP, outbound communications for the port are unchanged.
      1. Scroll back to the top of the table, and select Edit.
      2. On the Type tab, select User configurable, and select Save.
      3. Select Set Value.
      4. Enter the port mapping:
        <network type>/<protocol>/<remapped inbound port>/<default inbound port used by grid node>

        <network type> is grid, admin, or client, and <protocol> is tcp or udp.

        For example, to remap inbound SSH traffic that is sent to port 3022 so that it is received at port 22 by the grid node, enter the following:
        client/tcp/3022/22
      5. Select OK
  12. If you want to increase the CPU or memory for the node from the default settings:
    1. Right-click the virtual machine, and select Edit Settings.
    2. Change the number of CPUs or the amount of memory as required.
      Set the Memory Reservation to the same size as the Memory allocated to the virtual machine.
    3. Select OK.
  13. Power on the virtual machine.

After you finish

If you deployed this node as part of an expansion or recovery procedure, return to those instructions to complete the procedure.