Changing the link configuration of the StorageGRID Webscale appliance

You can change the Ethernet link configuration of the StorageGRID Webscale appliance. To change any configuration option, you must place the appliance into maintenance mode.

About this task

Options for changing the Ethernet link configuration of the StorageGRID Webscale appliance include:

Before changing the link configuration of the StorageGRID Webscale appliance, you will place it into maintenance mode.

Steps

  1. If the StorageGRID Webscale appliance is running in a StorageGRID Webscale system, place the appliance into maintenance mode.
    1. From the service laptop, log in to the grid node:
      1. Enter the following command: ssh admin@grid_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. Stop all StorageGRID Webscale services:service servermanager stop
    3. Place the appliance into maintenance mode:sgamaintenance
      The following messages are displayed on the service laptop:
      WARNING: All StorageGRID Webscale services on this node will be shut down.
      
      WARNING: You will have to manually exit maintenance mode before this node will resume normal operation.
      
      After running this command and waiting a few minutes for the node to reboot, browse to one of the following URLs to perform any
      maintenance actions, then exit maintenance mode:
      
      http://192.168.4.138:8080
      http://10.224.4.138:8080
      http://47.47.4.138:8080
      http://169.254.0.1:8080
      
      Are you sure you want to continue (y/n)?
  2. Enter y to continue, or n to cancel maintenance mode.
    When you press y, the appliance reboots, which takes two or three minutes to complete.
  3. Browse to any of the URLs displayed in the output of the sgamaintenance command to access the StorageGRID Webscale Appliance Installer.
    Note: Accessing http://169.254.0.1:8080 requires a direct connection from the service laptop to management port 2 on the appliance (the RJ-45 port on the right).
    Note: When you complete this maintenance procedure, you must use the StorageGRID Webscale Appliance Installer to return the appliance to its normal operating mode. Make sure that access to the installer is not prevented by your network firewall or other network issues. If necessary, contact your system administrator for assistance.
  4. Confirm that the appliance is in maintenance mode by noting the maintenance mode message on the StorageGRID Webscale Appliance Installer home page.

    maintenance mode message
  5. Select Configure Networking > Link Configuration from the menu bar at the top of the page.

    Link Configuration
  6. Make the desired changes to the link configuration.
    For more information on the options, see "Configuring network links."
  7. When you are satisfied with your selections, click Save.
    Note: You might lose your connection if you made changes to the network or link you are connected through. If you are not reconnected within 1 minute, re-enter the URL for theStorageGRID Webscale Appliance Installer using one of the other IP addresses assigned to the appliance: http://E5700SG_Controller_IP:8080
  8. Select Configure Networking > Ping test from the menu bar at the top of the page.
  9. Use the Ping Test tool to check connectivity to IP addresses on any networks that may have been affected by the link configuration changes you applied in Step 6.
    In addition to any other tests you choose to perform, confirm that you can ping the grid IP address of the primary Admin Node, and the grid IP address of at least one other Storage Node. If necessary, return to Step 6 and correct any link configuration issues.
  10. Once you are satisfied that your link configuration changes are working, return the StorageGRID Webscale appliance to normal operating mode:
    1. Select Advanced > Reboot Controller.

      reboot controller
    2. Click Reboot Controller.
      The appliance reboots and rejoins the grid. This process can take up to 15 minutes.
  11. Monitor the status of the upgraded appliance Storage Node in the Grid Manager.
    Verify that the appliance returns to “green” status. For example:
    nodes page