Upgrade Access Gateway nodes

This page describes the process of upgrading Okta Access Gateway nodes from their current version to the current released version.

Before you begin

Verify that:

  • Access Gateway has been backed up.
    For more information see About backup and restore.
  • You have access to the Access Gateway Command Line console.

    • Access Gateway can reach yum.oag.okta.com.
      You can test connectivity to the Access Gateway yum repository using the Access Gateway Management console.  
      To test connectivity:

      1. Use SSH to connect to the Access Gateway Management console.
        ssh oag-mgmt@admin
      2. Select 1-Network.
      3. Select 7- Connectivity test.
      4. When prompted enter host: yum.oag.okta.com .
      5. When prompted enter port: 443.

      You should review a connection successful to yum.oag.okta.com message. In case of an error, ensure that the host yum.oag.okta.com is reachable using port 443 from the network where Access Gateway is deployed.


Upgrading Access Gateway

To update Access Gateway:



During the upgrade process, Access Gateway goes offline and is unavailable for three to five minutes. Plan accordingly.



To perform an upgrade from 2019.2.0 to 2019.4.2:
  1. Sign in to Access Gateway Management console
  2. Select the System menu.
  3. Select Remove Package.
  4. Remove oracle-instantclient18.3-basic .
  5. Return to the System menu and select Update.
  6. Proceed with the update normally.
  1. Use SSH to connect to the Access Gateway command line console.

  2. Enter 5 to enter the System sub-menu.

  3. Enter 4 to enter the Update sub-menu.

  4. Enter one of the Upgrade sub-menu commands:
    1. 1 - View - Display a list of available updates
    2. 2 - Update
    3. x - Exit.

View upgrade contents

  1. Enter 1 to view the elements of the upgrade.
    The system displays a scrollable list of all packages, which are part of the upgrade.
    The listing resembles:
    UP/DOWN/HOME/END - scroll list   x - exit
    okta-access-gateway.x86_64			2019.1.2.20190924.12345-00001
    okta-access-gateway-core.x86_64		2019.1.2.20190924.12345-00001
    okta-access-gateway-core-apps.x86_64		2019.1.2.20190924.12345-00001
    okta-access-gateway-core-events.x86_64		2019.1.2.20190924.12345-00001
    . . . 
  2. Use the UP/DOWN/HOME and END keys to move around the listing.
  3. Enter x to exit and return to the upgrade menu.

Perform upgrade

  1. Enter 2 to begin the upgrade.
    The system displays a list of update information as the update runs.
    The list resembles:
    Update in progress
    . . .
    . . . 
    Transaction Summary
    Install	2 Packages
    Upgrade	28 Packages
    Total download size:	152M
    Downloading packages
    . . . 
    Update Successful.

    When complete, the upgrade displays Upgrade Successful.

  2. Enter any key to complete the upgrade and return to the System menu.



    The upgrade report screen appears.
    Examine the yum log and transaction summary report for upgrade information and details.

Related topics