Upgrade
Product names changed when ForgeRock became part of Ping Identity. Learn more about the name changes from New names for ForgeRock products in the Knowledge Base. |
Web Agent supports the following types of upgrade:
-
Usually, an update from a version of Web Agent to a newer minor version, as defined in Release naming. For example, update from 2024.6 to 2024.9 can be a drop-in software update.
Drop-in software updates can introduce additional functionality and fix bugs or security issues. Consider the following restrictions for drop-in software updates:
-
Don’t require any update to the configuration
-
Can’t cause feature regression
-
Can change default or previously configured behavior only for bug fixes and security issues
-
Can deprecate but not remove existing functionality
-
-
Usually, an upgrade from a version of Web Agent to a newer major version, as defined in Release naming. For example, upgrade from 5.10 to 2023.3 is a major upgrade.
Major upgrades can introduce additional functionality and fix bugs or security issues. Major upgrades do not have the restrictions of drop-in software update. Consider the following features of major upgrades:
-
Can require code or configuration changes
-
Can cause feature regression
-
Can change default or previously configured behavior
-
Can deprecate and remove existing functionality
-
This guide describes how to upgrade a single Web Agent instance. To upgrade sites with multiple Web Agent instances, one by one, stop, upgrade, and then restart each server individually, leaving the service running during the upgrade.
For information about upgrade between supported versions of Web Agent, refer to Ping Identity Product Support Lifecycle Policy | PingGateway and Agents.
Example installation for this guide
Unless otherwise stated, the examples in this guide assume the following installation:
-
Web Agent installed on
https://agent.example.com:443
. -
AM installed on
https://am.example.com:8443/am
. -
Work in the top-level realm
/
.
If you use a different configuration, substitute in the procedures accordingly.