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
- Change Hostname: Change the hostame of the Access Gateway instance.
- Configure High Availability: Configure and manage Access Gateway high availability.
- Install Package: Install a named packaged.
- Remove Package: Remove a named package.
- Update: Update the system.
- Reboot: Reboot the system.
- Shutdown: Shut down the system.
- Reset: Reset the system to its original default settings.
Change Hostname
- Press 1 to change the hostname.
The current hostname is displayed. - Enter the new hostname, and press Enter.
- Press y to confirm.
- 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.
- Press 1 to reset the node keys.
- Press 2 to prepare an administration node to connect to a new worker node.
- Press 3 to prepare a node to become a worker node.
- Press 4 to list all known worker nodes. This is only applicable on the admin node.
- Press 5 to remove a known Worker node. Only applicable on the Admin node.
- Press 6 to check High Availability status.
- 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:
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>.
- Authorize node nomination.
- 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.
The current admin node displays this message:
CopyNOTE: 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.
- Select 1 - Authorize Node Nomination.
- Authorize node as Admin node.
Select 2 - Authorize Node as Admin node.
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:
CopyCluster Manager package was not found on Admin Node - OAG Version - 2020.7.0
Upgrade the admin node before continuing.
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
- Press 2 to install a new package.
- Enter a package name, and press Enter.
- Press y to confirm.
- Press Enter to return to the System menu.
Remove Package
- Press 3 to remove an existing package.
- Enter a package name, and press Enter.
- Press y to confirm.
- 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.
Reset
-
Press 7 to reset.
-
Enter y to proceed or n to cancel.
-
The system returns all settings to their default values.
The gateway appliance shuts down after being reset and must be restarted.