Overview of High Availability Configuration Workflow

Configuring High Availability

Configuring high availability includes the following overall process:

  1. Configuring an admin node.
    During this step, the administration node is configured normally.
  2. Configuring a worker node.
    During this step, worker nodes are configured without any applications.
  3. Preparing the admin node.
    During this step, the command line interface is used on the admin node to alert or prepare the admin node for the addition of one or more worker nodes.
  4. Preparing the worker node.
    During this step, the command line interface is used on the worker node to prepare the worker for becoming a part of the Access Gateway cluster.
  5. Worker integration into cluster.
    After the previous steps, the worker is automatically integrated into the cluster. During this phase, the worker admin UI is disabled and worker exchanges keys and the admin node provides the configuration.
Access Gateway High Availability add worker node sequence diagram

The High Availability menu displays the current role of an 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.

The High Availability menu includes these options:
  1. Reset: Reset the node keys.
  2. Prepare Admin: Prepare an administration node to connect to a new worker node.
  3. Prepare Worker: Prepare a node to become a worker node.
  4. List Nodes: List all worker nodes. This option only appears on the admin node.
  5. Remove Node: Remove a known worker node. This option only appears on the admin node.
  6. Check Status: Check high-availability status.
  7. Cluster Manager: Perform a rolling upgrade of a worker node to an admin node using the Cluster Manager.

You can perform the following high availability management operations:

  1. Reset the key associated with an Access Gateway node
  2. Add a worker node to an Access Gateway cluster
  3. List all worker nodes in an Access Gateway cluster
  4. Remove a worker node from an Access Gateway cluster
  5. Check the cluster configuration
  6. Perform a rolling upgrade of a worker node to an admin node
  7. Sync a worker node with an admin node

When you initially configure a high availability cluster, cluster members communicate using HTTPS over port 443. Use caution when configuring high availability where proxies are in use. See Proxy configuration in the Network section of Command Line Management Console reference for information on configuring proxies and proxy bypass lists.

Reset the key associated with an Access Gateway node

Access Gateway nodes use various keys to intercommunicate. You must regenerate keys if you want to use an instance as a part of an Access Gateway high availability cluster. You only need to regenerate keys once per instance.

  1. Connect to the Access Gateway Management console. ssh oag-mgmt@[admin or worker]
  2. Select 5 - System.
  3. Select 8 - High Availability.
  4. Select 1 - Reset Key.
  5. Enter y to reset the keys being used by the high availability sync process or N to end the reset process.
  6. Enter x to exit or any other menu item to continue.

Add a worker node to an Access Gateway cluster

When you add a worker node, both the administration and the worker node must meet the following conditions:

When you prepare workers, ensure that you're connected to a worker node and not an admin. Running the prepare worker operation on the cluster admin renders the Access Gateway Admin UI console inoperable. Access Gateway version 2021.11.2 and later prohibit this operation. Reset nodes previously used as admins before you reuse them as workers. See Reset Access Gateway: command line

  1. Perform these tasks on the admin node:

    1. Connect to the Access Gateway Management console.ssh oag-mgmt@[admin.tld]
    2. Select 5 - System.
    3. Select 8 - High Availability.
    4. Select 2 - Prepare Admin.

      When you configure an admin node for high availability for the first time, select 1 - Reset Keys to reset the instance's SSH keys. You only need to reset keys once per instance. See Command Line Management Console reference.

      Access Gateway Replication uses the hostname setting from the command line console. Ensure that you update the hostname for both the admin and worker nodes using the menu items System (5)Change Hostname (1).

    5. The admin node generates and displays an authorization token, which you provide to the worker node. Copy the authorization token to a secure location, such as a secure notes app.
    6. The admin node waits for connections from worker nodes. Leave the window open until all worker nodes have been added. Entering X prematurely cause the admin node to end the process and stop listing worker node additions. Enter X only after all worker nodes have appeared in the window.
    1. Return to the command prompt on the worker node that you're attaching.
  2. Perform these tasks on each worker node:
    1. Connect to the Access Gateway Management console.ssh oag-mgmt@[worker.tld]
    2. Select 5 - System.
    3. Select 8 - High Availability.
    4. Select 3 - Prepare Worker.

      When you configure a worker node for high availability for the first time, select 1 - Reset Keys to reset the instance's SSH keys. You only need to reset keys once per instance. See Command Line Management Console reference.

    5. Paste the token into the Access Gateway Management console window. The worker node connects to the admin node and completes the authorization.
    6. Press any key to continue. The worker instance is ready for use.
    7. Enter x to exit or any other menu item to continue.
  1. Perform these tasks on the admin node:
    1. Return to the admin instance Access Gateway Management console and view the results of adding the new worker node.
    2. Enter x to exit or any other menu item to continue.

List all worker nodes in an Access Gateway cluster

  1. Connect to the Access Gateway Management console.ssh oag-mgmt@[admin.tld]
  2. Select 8 - High Availability.
  3. Select 4 - List Nodes. A list of all currently enabled worker nodes appears.
  4. Enter x to exit or any other menu item to continue.

Remove a worker node from an Access Gateway cluster

When you remove a worker node from an Access Gateway cluster, the node still exists but no longer receives updates from the admin instance. In addition, the Access Gateway UI is disabled. Be sure to remove these nodes from any load balancer as well.

  1. Connect to the Access Gateway Management console. ssh oag-mgmt@[admin.tld]
  2. Select 5 - System.
  3. Select 8 - High Availability.
  4. Select 5 - Remove.
  5. Enter the name of the worker node that you want to remove and press Enter.
  6. Confirm the removal of the node.
  7. Enter x to exit or any other menu item to continue.

Check the cluster configuration

  1. Connect to the Access Gateway Management console.ssh oag-mgmt@[admin or worker]
  2. Select 5 - System.
  3. Select 8 - High Availability.
  4. Select 6 - Check Status. This option shows the latest status of the cluster only after there's a configuration change or when the NGINX engine is restarted. If newly added nodes don't appear, perform any Access Gateway Admin UI console function or restart the NGINX engine. See the NGINX sub-menu in the Access Gateway Management consoleServices section. A list of cluster instances appears. Pass indicates that the node is reachable and functioning. Fail indicates that the node is non-functional. See the node log for more information.
  5. Enter x to exit.

Perform a rolling upgrade of a worker node to an admin node

You can perform a rolling upgrade of a node from worker to admin using the Cluster Manager. See Configure and manage high availability for information on high-availability configurations.

  1. Connect to the Access Gateway Management console.ssh oag-mgmt@[admin or worker]
  2. Verify that you're in a worker node.
  3. Select 5 - System.
  4. Select 8 - High Availability.
  5. Press 7 - Cluster Manager.
  6. Press 2 - Authorize Node as Admin node. You can't select this option from an admin node or when another authorization process is in progress.
  7. Press Y to continue or N to stop in the confirmation dialog.
  8. The worker node generates an authorization code. Copy this code to a secure place, such as a secure note app.
    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
  9. Press Enter to continue.
  10. Switch to an admin node.
  11. Press 1 - Authorize Node Nomination. You can't select this option from a worker node or when another authorization process is in progress.
  12. Copy and paste the authorization code from your secure note app into the terminal, and then press Enter. The renomination process starts. See Perform admin renomination.
  13. Delete the authorization code from your note app.

Sync a worker node with an admin node

If a worker node is out of sync because of downtime or network issues, you can synchronize the changes from an admin node to a specific worker node.

This option is only available on worker instances.

  1. Connect to the Access Gateway Management console on the worker that you want to sync.ssh oag-mgmt@[<worker>]
  2. Select 5 - System.
  3. Select 8 - High Availability.
  4. Select 8 - Synch from admin.
  5. Press Enter to continue.
  6. Enter x to exit.

Related topics

High availability concepts

Configure and manage high availability