Upgrading a PingAccess cluster using the incremental update package
Upgrade a PingAccess cluster to a newer version using the incremental update package.
Before you begin
-
Make a backup copy of the PingAccess home directory. If the upgrade fails, use the backup copy to restore PingAccess.
-
Review the release notes for every version between your current version and the target version.
-
Verify that each node is using the same PingAccess version. You can check the version by viewing the
PA_HOME/lib/pingaccess-admin-ui-version number.jar
file. -
Verify that the PingAccess administrative node is running.
-
Verify that basic authentication is configured and enabled for the running PingAccess administrative node.
-
Download the PingAccess incremental update
.zip
file for the target version.
About this task
Use the PingAccess incremental update bundle to upgrade a cluster from PingAccess 6.3 or later, the source version, to the most recent maintenance release for that version of PingAccess, the target version. For example, upgrade PingAccess 6.3 to the most recent maintenance release for 6.3.
This upgrade procedure causes some downtime. To upgrade a cluster with no downtime, see the Zero Downtime Upgrade guide. |
Steps
-
Upgrade the administrative node.
-
Extract the
.zip
file for the target version of PingAccess. -
Open the
readme
file included in the extracted.zip
bundle. -
Make the file changes specified in the
readme
file.
-
-
Upgrade the replica administrative node.
-
Extract the
.zip
file for the target version of PingAccess. -
Open the
readme
file included in the extracted.zip
bundle. -
Make the file changes specified in the
readme
file.
-
-
Upgrade each engine node.
-
Extract the
.zip
file for the target version of PingAccess. -
Open the
readme
file included in the extracted.zip
bundle. -
Make the file changes specified in the
readme
file.
-
-
Shut down the entire cluster.
-
Start the upgraded administrative node.
-
Start the upgraded replica administrative node.
-
Start each upgraded engine node.
Next steps
After you complete the upgrade, see Performing post-upgrade tasks.