Upgrading the Identity Bridge Agent In-Place

RapidIdentity Platform Documentation

Solution

Application

Content Type

Technical Documentation

Utilities & Services

ft:locale

en-US

When upgrading the Identity Bridge Agent, you can run an in-place upgrade to preserve existing bridge settings and data.

Best Practice:

Jamf recommends taking a hypervisor snapshot prior to upgrading your Identity Bridge Agent.

Requirements

To upgrade the Identity Bridge Agent, you must have the following:

A tenant administrator role in your RapidIdentity portal
Certain domains in your safelist, depending on your firewall settings. For a list of required domains, see Allowing Traffic to and from RapidIdentity Cloud.
Antivirus settings configured to exclude the Identity Bridge Agent. For more information, see Excluding Identity Bridge Agent from Windows Security.

You must have the following minimum specifications:

OS: Windows Server 2016 or later
.NET 8.0: ASP.NET Core and .NET Desktop Runtime

Download and install Microsoft .NET 8.0.
For more information, see Installing Microsoft .NET 8.0.
Download the Identity Bridge Agent.
Stop the Identity Bridge Automation service.
1. Press Windows key + R to open the Run window.
2. Enter services.msc to open the Services window.
3. Locate and right-click the Identity Bridge Automation service.
4. Select Stop.
Copy and retain Identity Bridge Agent data.
1. Navigate to C:\Program Files\Identity Automation\Identity Bridge Agent.
2. Copy the CognitoState.bin and AgentState.bin files.
3. Save the CognitoState.bin and AgentState.bin files in a secure location.
Install the current version of the Identity Bridge Agent.
For more information, see Installing the Identity Bridge Agent Service.
Important:
Do not uninstall the previous version of the Identity Bridge Agent.
Confirm that the Identity Bridge Automation service is running.
1. Press Windows key + R to open the Run window.
2. Enter services.msc to open the Services window.
3. Locate the Identity Bridge Automation service and confirm that the status is Running.
Confirm that Chisel processes are running.
1. Press Control + ALT + Delete.
2. Click Task Manager.
3. In Background processes, locate chisel.exe, or enter chisel.exe in the search field.
In your RapidIdentity portal, confirm that the Identity Bridge Agent is connected.
1. In the Dashboard pop-up menu, click Configuration.
2. In the sidebar, navigate to Systems > Identity Bridge > Agents.
3. Locate the Identity Bridge Agent that you installed.
4. In the Heartbeat section, confirm that there is a time stamp for the last heartbeat.
Test any Identity Bridges that you have added to the agent.
For more information, see Testing an Identity Bridge Connection.

A current version of the Identity Bridge Agent is installed and your Identity Bridge settings and data are retained.