You must deploy the new VM using the same StorageGRID Webscale version as is currently running on the grid.

Steps

Open VMware vSphere Web Client, and sign in.

Navigate to the vApp or resource pool where you want to deploy the StorageGRID Webscale grid, and select Actions > All vCenter Actions > Deploy OVF Template.

Select
the vsphere-node.ovf and NetApp-SG-version-SHA.vmdk files.

Specify the name of the virtual machine, which is typically the name of the grid node.

The best practice is to name the VM during the initial virtual machine deployment instead of changing it later.

In the Network Mapping page, select the networks to use by associating a network port to each network. The Grid Network is required. The Admin and Client Networks are optional. Select the Grid Network to use, and then choose the following as applicable:

If you are planning to use the Admin Network, assign the Admin Network adapter to a network in the vSphere environment.

If you are planning to use the Client Network, assign the Client Network adapter to a network in the vSphere environment

If you do not plan to use an Admin Network or Client Network, assign their network adapters to the same network as the Grid Network.

Provide the required StorageGRID Webscale information in the Properties page, and click Finish.

Enter the Node Name.

Enter the Primary Admin IP.

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.

In general, if you are adding new disks you should use the same type of storage device that was in use prior to node recovery.

Attention: The Storage Node OVF provided defines several VMDKs for storage. You should remove these 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).

If you want to remap ports used by a node:

If you specified DISABLED for the Client network IP configuration, you must enter 0.0.0.0. for the Client Network IP under the under the Client Network (eth2) section. Completing this field is required.

Right-click on the VM, and select Edit Settings.

Select vApp Options.

In the Authoring section, expand Properties and scroll down until you see PORT_REMAP_INBOUND and PORT_REMAP.

You might need to remap a port if your enterprise networking policies restrict access to one or more ports that is used by StorageGRID Webscale. See "Internal grid node communications" or "External client communications" for the list of ports used by StorageGRID Webscale.

To symmetrically map both inbound and outbound communications for a port, select PORT_REMAP and click Edit.

Enter the port mapping as <network type>/<protocol>/<default port used by grid node>/<new port>, where network type is grid, admin, or client, and protocol is tcp or udp.

Example

To remap ssh traffic from port 22 to port 3022, enter the following:

client/tcp/22/3022

Click OK.

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.

To specify the port used for inbound communications to the node, select PORT_REMAP_INBOUND and click Edit.

Enter the port mapping as <network type>/<protocol>/<remapped inbound port>/<default inbound port used by grid node>, where network type is grid, admin, or client, and protocol is tcp or udp.

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

Click OK.

Note: If you specify PORT_REMAP_INBOUND and do not specify a value for PORT_REMAP, outbound communications for the port are unchanged.

Power on the virtual machine.

After you finish

To complete the recovery, return to the procedure for the failure you are addressing.