How To
Archived

How do I perform a multi-server upgrade from OpenAM 12.0.0 to 12.0.x (External Configuration)?

Last updated Jan 5, 2021

The purpose of this article is to provide information on performing a multiple server upgrade (cluster) from OpenAM 12.0.0 to 12.0.x with an OpenDJ external configuration store (replicated), where one server is running a full installation and the other servers are running a server-only or full installations.


Archived

This article has been archived and is no longer maintained by ForgeRock.

Performing a multi-server upgrade

In the following scenario:

  • One server (AM1) has a full installation of OpenAM 12.0.0 (including Console) and two servers (AM2 and AM3) have a server-only installation of OpenAM 12.0.0 (although the steps to follow are the same even if the other servers also have full installations).
  • Each OpenAM server points to a single external OpenDJ configuration store (DJ1), which is replicating across all instances (DJ1, DJ2 and DJ3).
Note

As with any software upgrade, we strongly recommend testing the procedure in your own development environment first and ensuring you have up to date backups and recovery plans in case you encounter any issues. You should also make sure you read the release notes relating to the new version of OpenAM so that you are fully aware of all the changes.

You can upgrade as follows:

  1. Stop the AM1, AM2 and AM3 servers (leave the three OpenDJ servers running).
  2. Deploy the full OpenAM 12.0.x war (OpenAM-12.0.x.war) on AM1. For Apache Tomcat™, you should ensure you remove the unzipped war folder and replace the old openam.war file with the new one, as follows, before proceeding: $ cd /path/to/tomcat/webapps $ rm -rf openam $ rm openam.war $ cp /path/to/expanded-openam-war/upgrade-war/openam.war ./openam.war
  3. Start the AM1 server.
  4. Run the upgrade wizard on the AM1 server.
  5. Restart the AM1 server.
  6. Deploy the server-only OpenAM 12.0.x war (OpenAM-ServerOnly-12.0.x.war) on AM2 and AM3. For Apache Tomcat, you should ensure you remove the unzipped war folders and replace the old openam.war files with the new ones for each server (as described in step 2) before proceeding.
  7. Start the AM2 and AM3 servers - the upgrade wizard is not shown but the upgrade has been performed.

See Also

How do I upgrade AM (All versions) with minimal downtime when replication is used?

How do I upgrade AM 5.x or 6.x if I am using a site configuration?

How do I make a backup of configuration data in AM 5.x or 6.x?

FAQ: Backing up AM

FAQ: Upgrading AM

OpenAM 12.0.4 Release Notes

OpenAM 12.0.4 Upgrade Guide

Related Training

ForgeRock Access Management Core Concepts (AM-400)

Related Issue Tracker IDs

N/A


Copyright and Trademarks Copyright © 2021 ForgeRock, all rights reserved.