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 Manager to add or change the network configuration. Otherwise, use the Change IP tool if the Grid Manager 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.
Attention: 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 reservations 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 reservation 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.