Upgrading the Access Management service

Follow this process to upgrade the Access Management service to 15.1.

Before you begin

Before upgrading the Access Management service, you need to have first upgraded the database.

To run PowerShell scripts for software, you require a machine that meets the following requirements:
PowerShell
You require Microsoft Windows PowerShell 5.1. You can download Microsoft Windows Management Framework 5.1, which includes Microsoft Windows PowerShell 5.1, from this location: http://aka.ms/wmf5download
Operating system
You require an operating system that supports both the required PowerShell software and any software for the database you intend to install. As a general rule, ensure that the latest (security) updates are installed on your operating system.
Microsoft .NET Framework
You require a .NET Framework version. The one to use depends on your Windows Server operating system version:
Security
You need to be logged in as a user with sufficient security clearance. For example, to run a script that installs a database, you must be logged in as a user with rights to create that database.

The steps that follows represent a high-level process, which includes several tasks that are individually explained in other topics. For details on the individual tasks, refer to the related topics.

Procedure

  1. On the machine where the Access Management service is installed, locate the service's appsettings.json file and back it up to a safe location.
  2. Uninstall old Access Management service. Rename it, if needed.
  3. From the Tridion Docs 15.1 installation media, copy the entire root-level folder Access Management\ to a folder of your choice on the target machine.
  4. Locate the new version of appsettings.json and merge in your changes from the backed-up copy. If the backed-up file is encrypted, you will need to decrypt it first.
  5. Install a new Access Management service that uses the upgraded database.

Results

The Access Management service upgrade is now complete.