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 Admin or Client Networks.

Before you begin

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:


  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 screen 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.
    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
    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.


    In this example, validation returned errors.
    screenshot described by surrounding text

    In this example, validation passed.
    screenshot described by surrounding text

  8. Optionally select option 8 to save unapplied changes.
    This option allows you to quit the Change IP tool and start it again later, without losing any unapplied changes.
  9. To apply the new network configuration, select 10.
    This option provisions the networking changes, and then gives you the option to stage, cancel, or apply the changes. You may choose to cancel (and save) because nodes are automatically restarted if you select apply, and must be restarted manually if you stage, and you may want to schedule the restart for a time that minimizes user impact.
    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 provisioning is complete, you can select your action.
  10. Select stage to apply the changes the next time the nodes are rebooted.

    This option allows you to make the physical or virtual networking configuration changes that are required before the new network configuration can function. If you select apply without making first making these networking changes, the changes will usually fail.

    Important: If you use the stage option, you must reboot the node as soon as possible after staging to minimize disruptions.
    Note: If any action requires that you exit from Change IP tool, you can restart it later and continue where you left off.
    1. Make the physical or virtual networking changes that are required.

      Physical networking changes: Log in to the affected node, and safely shut it down. Make the necessary physical networking changes.

      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. Reboot the affected nodes.
    3. Return to the Change IP tool and select Apply Changes to complete the procedure.
      Tip: If you start the Change IP tool and the main menu includes only two items and indicates that an IP change procedure is in progress, you haven't completed the procedure yet. Select Apply Changes to continue applying the new IP networking configuration. When the full main menu is displayed, including the Edit options, you have successfully completed the procedure.
  11. If the new network configuration does not require any physical networking changes, you can select apply to apply the changes immediately and automatically restart each node.

    Choose this option if the new network configuration will function simultaneously with the old network configuration without any external changes, for a fully automated configuration change.

  12. Select 0 to exit the Change IP tool after your changes are complete.
  13. Ensure you are at the command line of the primary Admin Node, then enter the following command: update-prometheus-targets
    This command updates Prometheus with the networking changes, enabling metrics collection to continue.
  14. Download the new Recovery Package by going to the Grid Management Interface at Maintenance > Recovery package , and entering the provisioning passphrase.