Changing IP addresses for all nodes on the Grid Network

You can use the Change IP tool to change the IP addresses of all nodes on the Grid Network, across multiple sites.

Before you begin

About this task

To ensure that the grid starts up successfully, you must make all the changes at once.

If you want to change the IP addresses for the nodes at one site only, follow the steps for modifying a node's network configuration.

Note: This procedure applies to the Grid Network only. You cannot use this procedure to change IP addresses on the Admin or Client Networks.

Procedure

  1. Plan ahead for changes that you need to make outside of the Change IP tool, such as changes to DNS or NTP, and changes to the single sign-on (SSO) configuration, if used.
    • If the existing NTP servers will not be accessible to the grid on the new IP addresses, add the new NTP servers before you perform the change-ip procedure.
    • If the existing DNS servers will not be accessible to the grid on the new IP addresses, add the new DNS servers before you perform the change-ip procedure.
    • If SSO is enabled for your StorageGRID system and any relying party trusts were configured using Admin Node IP addresses (instead of fully qualified domain names, as recommended), be prepared to update or recreate these relying party trusts in Active Directory Federation Services (AD FS) immediately after you change IP addresses. See the instructions for administering StorageGRID.
    • If necessary, add the new subnet for the new IP addresses.
  2. From the service laptop, log in to the primary Admin Node:
    1. Enter the following command: ssh admin@primary_Admin_Node_IP
    2. Enter the password listed in the Passwords.txt file.
    3. Enter the following command to switch to root: su -
    4. Enter the password listed in the Passwords.txt file.
      When you are logged in as root, the prompt changes from $ to #.
  3. Start the Change IP tool by entering the following command: change-ip
  4. Enter the provisioning passphrase at the prompt.
    The main menu appears. By default, the Selected nodes field is set to all.

    screenshot showing welcome screen of change IP tool
  5. On the main menu, select 2 to edit IP/mask and gateway information for all the nodes.
    1. Select 1 to make changes to the Grid Network.
      After you make your selection, the prompt shows the node names, Grid Network name, data type (IP/mask or Gateway), and current values.

      Editing the IP address, prefix length, or gateway of a DHCP-configured interface will change the interface to static. A warning is displayed before each interface configured by DHCP.

      Interfaces configured as 'fixed' cannot be edited.

    2. To set a new value, enter it in the format shown for the current value.
    3. After editing all nodes you want to change, enter q to return to the main menu.
      Your changes are held until cleared or applied.
  6. Review your changes by selecting one of the following options:
    • 5: Shows edits in output that is isolated to show only the changed item. Changes are highlighted in green (additions) or red (deletions), as shown in the example output:

      screenshot described by surrounding text
    • 6: Shows edits in output that displays the full configuration. Changes are highlighted in green (additions) or red (deletions).
    Note: Certain command line interfaces may show additions and deletions using strikethrough formatting. Proper display depends on your terminal client supporting the necessary VT100 escape sequences.
  7. Select option 7 to validate all changes.

    This validation ensures that the rules for the Grid Network, such as not using overlapping subnets, are not violated.

    In this example, validation returned errors.
    screenshot described by surrounding text
    In this example, validation passed.
    screenshot described by surrounding text
  8. Once validation passes, select 10 to apply the new network configuration.
  9. Select stage to apply the changes the next time the nodes are restarted.
    Attention: You must select stage. Do not perform a rolling restart, either manually or by selecting apply instead of stage; the grid will not start up successfully.
  10. After your changes are complete, select 0 to exit the Change IP tool.
  11. Shut down all nodes simultaneously.
    Attention: The entire grid must be shut down at once, so that all nodes are down at the same time.
  12. Make the physical or virtual networking changes that are required.
  13. Verify that all grid nodes are down.
  14. Power on all nodes.
  15. Once the grid starts up successfully:
    1. If you added new NTP servers, delete the old NTP server values.
    2. If you added new DNS servers, delete the old DNS server values.
  16. Download the new Recovery Package from the Grid Manager. Select Maintenance > Recovery Package and enter the provisioning passphrase.