System menu

The System menu allows you to change the hostname, install or remove a package, perform an update, reboot, shutdown, or reset the Access Gateway instance.

Select 5 to open the System submenu.

System commands

  1. Change Hostname: Change the hostame of the Access Gateway instance.
  2. Configure High Availability: Configure and manage Access Gateway high availability.
  3. Install Package: Install a named packaged.
  4. Remove Package: Remove a named package.
  5. Update: Update the system.
  6. Reboot: Reboot the system.
  7. Shutdown: Shut down the system.
  8. Reset: Reset the system to its original default settings.

Change Hostname

  1. Press 1 to change the hostname.
    The current hostname is displayed.
  2. Enter the new hostname, and press Enter.
  3. Press y to confirm.
  4. Press Enter to return to the System menu.

Configure High Availability

The High Availability Configuration menu displays the current role of a Access Gateway node:

  • Single: The node hasn't been configured as either a worker or an admin.
  • Admin: The node has been configured as an administrator for High Availability.
  • Worker: The node has been configured as a worker for High Availability.

  1. Press 1 to reset the node keys.
  2. Press 2 to prepare an administration node to connect to a new worker node.
  3. Press 3 to prepare a node to become a worker node.
  4. Press 4 to list all known worker nodes. This is only applicable on the admin node.
  5. Press 5 to remove a known Worker node. Only applicable on the Admin node.
  6. Press 6 to check High Availability status.
  7. Press 7 to perform a rolling upgrade using the Cluster manager.

For complete details of configuring high availability, see Configure and manage high availability.

For a reference on performing rolling upgrades see Perform admin renomination.

Cluster manager

The cluster management menu appears:

Copy 
Access Gateway Cluster Manager (Worker)
1 - Authorize Node Nomination
2 - Authorize Node as Admin node

X- Exit
Choice:

Selecting 1-Authorize Node Nomination on a worker node results in an error: Operation not supported on worker node, press any key to continue.

Attempting to run the Authorize Node Nomination process while another authorization process is in progress results in an error: Admin Nomination in progress for node - <nominatedNode Hostname>.

  1. Authorize node nomination.
    1. Select 1 - Authorize Node Nomination.

      Selecting 2-Authorize Node as Admin node on an admin node results in an error: Operation not supported on admin node, press any key to continue.

      Attempting to run the Authorize Node as Admin node process when another authorization is in progress results in this error: Admin Nomination in progress.

    2. The current admin node displays this message:

      Copy
      NOTE: Please ensure that the admin node is ready for setup and you have the authorization 
      token displayed on the on the worker node. 

      Enter the authorization token displayed on the nominated admin node:

      Press the Enter key when complete.

      The renomination process begins.

  2. Authorize node as Admin node.

    1. Select 2 - Authorize Node as Admin node.

    2. The worker node then presents a confirmation dialog box. Enter Y to continue or N to abort.

      If the Cluster manager package isn't installed or supported on the admin node, an error message appears:

      Copy
      Cluster Manager package was not found on Admin Node - OAG Version - 2020.7.0

      Upgrade the admin node before continuing.

    3. The worker node generates and displays an authorization code, which you must provide to the admin node.

      Copy the following authorization code:

      Copy

      The authorization token required to initiate setup for nominated admin node: worker-c:8ba1c123-715d-4b70-ab5d-0e41493bef73
      Copy the token and paste it on the admin node when prompted.
      Press enter to continue

Install Package

  1. Press 2 to install a new package.
  2. Enter a package name, and press Enter.
  3. Press y to confirm.
  4. Press Enter to return to the System menu.

Remove Package

  1. Press 3 to remove an existing package.
  2. Enter a package name, and press Enter.
  3. Press y to confirm.
  4. Press Enter to return to the System menu.

Update

See Upgrade Access Gateway to the latest version for instructions on updating Access Gateway to the latest version.

See Upgrade Access Gateway to a specific version for instruction on updating Access Gateway to a specific version.

Reboot

  1. Press 5 to reboot.

  2. Enter y to proceed or n to cancel.

  3. The system reboots.

Shutdown

  1. Press 6 to shut down.

  2. Enter y to proceed or n to cancel.

  3. The system shuts down.

Reset

  1. Press 7 to reset.

  2. Enter y to proceed or n to cancel.

  3. The system returns all settings to their default values.

The gateway appliance shuts down after being reset and must be restarted.