Adding to or changing subnet lists on the Grid Network

You can use the Change IP tool to add or change subnets on the Grid network.

Before you begin

About this task

You can add, delete, or change subnets in the Grid Network Subnet List. Changes will affect routing on all nodes in the grid.
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.

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


    screenshot showing welcome screen of change IP tool

  4. On the main menu, select the option to edit subnets for the Grid network (option 4).
  5. Choose one of the following:
    • Add a subnet by entering this command: add CIDR
    • Delete a subnet by entering this command: del CIDR
    • Set the list of subnets by entering this command: set CIDR
      Note: For all commands, you can enter multiple addresses using this format: add CIDR, CIDR

      Example: add 172.14.0.0/16, 172.15.0.0/16, 172.16.0.0/16

      Tip: You can reduce the amount of typing required by using “up arrow” to recall previously typed values to the current input prompt, and then edit them if necessary.
    The sample input below shows setting subnets for the Grid Network Subnet List:


    screenshot described by surrounding text

  6. When ready, enter q to go back to the main menu screen. Your changes are held until cleared or applied.
  7. Choose one of the following:
    • Select option 5 to show 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 sample output below:


      screenshot described by surrounding text

    • Select option 6 to show edits in output that displays the full configuration. Changes are highlighted in green (additions) or red (deletions).
    Note: Certain command line interfaces might show additions and deletions using strikethrough formatting.
  8. Select option 7 to validate all staged changes. This validation ensures that the rules for the Grid, Admin, and Client networks are followed, such as using overlapping subnets. In the sample output below, an invalid Gateway IP failed validation.
  9. (Optional) Select option 8 to save all staged changes and return later to continue making changes. This option allows you to quit the Change IP tool and start it again later, without losing any unapplied changes.
  10. Do one of the following:
    • Select option 9 if you want to clear all changes without saving or applying the new network configuration.
    • Select option 10 if you are ready to apply changes and provision the new network configuration. During provisioning, the output displays the status as updates are applied as shown in the following sample output:
      Generating new grid networking description file...
      Running provisioning...
      Updating grid network configuration on Name
  11. If you selected option 10 when making Grid network changes, select one of the following options:
    • apply: Apply the changes immediately and automatically restart each node.

      If the new network configuration will function simultaneously with the old network configuration without any external changes, you can use the apply option for a fully automated configuration change.

    • stage: Apply the changes the next time the nodes are rebooted.
      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.
      Important: If you use the stage option, you must reboot 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.

    Note: After applying or staging changes, a new Recovery Package is generated as a result of the grid configuration change.
  12. If configuration is stopped due to errors, the following options are available:
    • To abort the IP change procedure and return to the main menu, enter a.
    • To retry the operation that failed, enter r.
    • To continue to the next operation, enter c.

      The failed operation can be retried later by selecting option 10 (Apply Changes) from the main menu. The IP change procedure will not be complete until all operations have completed successfully.

    • If you had to manually intervene (to reboot a node, for example) and are confident that the action the tool thinks has failed was actually completed successfully, enter f to mark it as successful and move to the next operation.
  13. After successfully applying the changes, download the new provisioning repository by accessing the new package on the Maintenance > Recovery package page.