Modifying a node's network configuration

You can modify the network configuration of one or more nodes using the Change IP tool. You can modify the configuration of the Grid Network, or add, modify, or remove the Admin or Client Networks.

Before you begin

Linux: If you are adding a grid node to the Admin Network or Client Network for the first time, and you did not previously configure ADMIN_NETWORK_TARGET or CLIENT_NETWORK_TARGET in the node configuration file, you must do so now.

See the StorageGRID Webscale installation instructions for your Linux operating system.

Appliances: On StorageGRID Webscale appliances, if the Client or Admin Network was not configured during the initial installation, it cannot be added by using only the Change IP tool. First, you must place the appliance's compute controller in maintenance mode, configure the links, return the appliance to normal operating mode, and then use the Change IP tool to modify the network configuration. For instructions for configuring network links, see the installation and maintenance instructions for your appliance model.

About this task

You can modify the IP address, mask, or gateway for one or more nodes on any network. You can also add or remove a node from a Client Network or from an Admin Network:

Steps

  1. 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 #.
  2. Start the Change IP tool by entering the following command: change-ip
  3. Enter the provisioning passphrase at the prompt.
    The main menu appears.


    screenshot showing welcome screen of change IP tool

  4. Optionally select 1 to choose which nodes to update. Then select one of the following options:
    • 1: Single node — select by name
    • 2: Single node — select by site, then by name
    • 3: Single node — select by current IP
    • 4: All nodes at a site
    • 5: All nodes in the grid
    Note: If you want to update all nodes, allow "all" to remain selected.
    After you make your selection, the main menu screen appears, with the Selected nodes field updated to reflect your choice. All subsequent actions are performed only on those nodes.
  5. On the main menu screen, select option 2 to edit IP/mask and gateway information for the selected nodes.
    1. Select the network where you want to make changes:
      • 1: Grid network
      • 2: Admin network
      • 3: Client network
      • 4: All networks
      After you make your selection, the prompt shows the node name, network name (Grid, Admin, or Client), data type (IP/mask or Gateway), and current value.

      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. To leave the current value unchanged, press Enter.
    4. If the data type is IP/mask, you can delete the Admin or Client Network from the node by entering d or 0.0.0.0/0.
    5. 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, Admin, and Client Networks, such as not using overlapping subnets, are not violated.

    Example

    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, choose one of the following options:
    • 8: Save unapplied changes.

      This option allows you to quit the Change IP tool and start it again later, without losing any unapplied changes.

    • 10: Apply the new network configuration.
  9. If you selected option 10, choose one of the following options:
    • apply: Apply the changes immediately and automatically restart each node if necessary.

      If the new network configuration does not require any physical networking changes, you can select apply to apply the changes immediately. Nodes will be restarted automatically, if necessary. Nodes that need to be restarted will be displayed.

    • stage: Apply the changes the next time the nodes are restarted manually.
      If you need to make physical or virtual networking configuration changes for the new network configuration to function, you must use the stage option, shut down the affected nodes, make the necessary physical networking changes, and restart the affected nodes. If you select apply without first making these networking changes, the changes will usually fail.
      Attention: If you use the stage option, you must restart the node as soon as possible after staging to minimize disruptions.
    • cancel: Do not make any network changes at this time.

      If you were unaware that the proposed changes require nodes to be restarted, you can defer the changes to minimize user impact. Selecting cancel returns you to the main menu and preserves your changes so you can apply them later.

    When you select apply or stage, a new network configuration file is generated, provisioning is performed, and nodes are updated with new working information.

    During provisioning, the output displays the status as updates are applied.
    Generating new grid networking description file...
    Running provisioning...
    Updating grid network configuration on Name

    After applying or staging changes, a new Recovery Package is generated as a result of the grid configuration change.

  10. If you selected stage, follow these steps after provisioning is complete:
    1. Make the physical or virtual networking changes that are required.

      Physical networking changes: Make the necessary physical networking changes, safely shutting down the node if necessary.

      Linux: If you are adding the node to an Admin Network or Client Network for the first time, ensure that you have added the interface as described in "Adding interfaces to an existing node."

    2. Restart the affected nodes.
  11. Select 0 to exit the Change IP tool after your changes are complete.
  12. Download the new Recovery Package from the Grid Manager. Select Maintenance > Recovery Package and enter the provisioning passphrase.