Configuring IP addresses

You can perform network configuration by configuring IP addresses for grid nodes using the Change IP tool.

About this task

You must use the Change IP tool to make most changes to the networking configuration that was initially set during grid deployment. Manual changes using standard Linux networking commands and files might not propagate to all StorageGRID Webscale services, and might not persist across upgrades, reboots, or node recovery procedures.

Note: If you are making changes to the Grid Network Subnet List only, use the Grid Management Interface to add or change the network configuration. Otherwise, use the Change IP tool if the Grid Management Interface is inaccessible due to a network configuration issue, or you are performing both a Grid Network routing change and other network changes at the same time.
Important: The IP change procedure can be a disruptive procedure. Parts of the grid might be unavailable until the new configuration is applied.

Ethernet interfaces

The IP address assigned to eth0 is always the grid node's Grid Network IP address. The IP address assigned to eth1 is always the grid node's Admin Network IP address. The IP address assigned to eth2 is always the grid node's Client Network IP address.

Note that on some platforms, such as the StorageGRID Webscale Appliance, eth0, eth1, and eth2 might be aggregate interfaces composed of subordinate bridges or bonds of physical or VLAN interfaces. On these platforms, the SSM > Resources tab might show the Grid, Admin, and Client network IP address assigned to other interfaces in addition to eth0, eth1, or eth2.


You cannot use DHCP to change IP addresses after your StorageGRID Webscale system is installed. If DHCP was used to automatically assign IP addresses during installation, the assigned IP addresses must have permanent leases assigned by the DHCP server. The IP address, subnet mask, and default gateway values cannot change unless they are explicitly changed using an IP address change procedure. If any changes are detected in the DHCP configuration of a grid node (for example, a lease expires), the change is logged on the primary Admin Node and the grid node with the IP address change is shut down and removed from the grid. An alarm is displayed in the StorageGRID Webscale system.

Using the stage option of the Change IP tool

After using the menu selections to make changes, you can view your changes in a staged configuration before committing the changes. When you select the stage option, some of the changes are not applied until the next time the nodes are rebooted. Staging is required if you need to make physical or virtual networking configuration changes for the new network configuration to function. You can select stage, shut down the affected nodes, make the necessary physical networking changes, and restart the affected nodes.

After the nodes restart, you must go back to the Change IP tool and select Apply Changes to complete the procedure.

Important: If you use the stage option, reboot the affected nodes as soon as possible after staging to minimize disruptions.