Okta Access Gateway: How to Upgrade OAG From Versions 2024.6.1 or Below
Last Updated:
Overview
Upgrading Okta Access Gateway (OAG) from version 2024.6.1 or earlier requires a two-step sequential upgrade to prevent package dependency conflicts. Administrators must first upgrade the appliance to version 2025.10 before updating to the latest release.
Applies To
- Okta Access Gateway (OAG) Versions 2024.6.1 or below
- Operating System (OS)
- Upgrade
- Okta Classic Engine
- Okta Identity Engine (OIE)
Solution
What are the prerequisites for the upgrade?
Review the operating system requirements, time estimates, and initial preparation steps before beginning the upgrade process.
- Ensure the operating system version is 8.4 or greater. Review Determine the Access Gateway version for verification steps.
- NOTE: Appliances running an operating system version lower than 8.4 are on an unsupported platform and require additional manual configuration before starting the upgrade process. Review Major Okta Access Gateway Upgrade for more information.
- Allocate approximately 15 minutes per node for the upgrade, noting that times vary by environment.
- Complete the "Before you begin" section in the OAG Install Instructions.
Upgrade the Okta Access Gateway appliance to the latest release.
Perform a sequential upgrade by first updating the appliance to version 2025.10, resolving any package failures, and then proceeding to the latest release.
- Complete steps 1 through 3 in the OAG Install Instructions to prepare the appliance for the 2025.10 upgrade. Omit steps 4, 5, and 6.
- Upgrade the system to 2025.10
- Select 5 - System.
- Select 4 - Update.
- Select 2 - View list of available Access Gateway versions to update to.
- Select the 2025.10 version.
- The upgrade status may report a failure for
admin-uipackage as shown in the screenshot below. If it does, follow step 3 to apply the workaround; else, proceed to step 4.
- This step is required if
admin-uipackage showed a failure during the upgrade above.- Go to the system menu and Select 2 - Install Package.
- When the installer prompts for a package name, enter
okta-admin-ui-2025.10.0and press Enter. - After the
okta-admin-ui-2025.0package is installed, go to the system menu and select 3 - Remove Package - When prompted for a package name, enter the platform-specific okta-deps package name.
-
AWS/VMware: okta-deps-ova OCI: okta-deps-oci Azure: okta-deps-azure Nutanix: okta-deps-nutanix GCP: okta-deps-gcp
-
- Follow steps 7-9 of the install instructions to complete the 2025.10 install.
- Follow the install instructions to upgrade to the latest release.
