Upgrade Process for In-Place Identity Bridge Agents
- 04 Dec 2024
- 3 Minutes to read
- Print
- DarkLight
Upgrade Process for In-Place Identity Bridge Agents
- Updated on 04 Dec 2024
- 3 Minutes to read
- Print
- DarkLight
Article summary
Did you find this summary helpful?
Thank you for your feedback!
Identity Bridge Agent 2024.10.1 Requirements
Recommended Best Practices for Upgrade Process
- It is best practice to backup, or take a hypervisor snapshot of your Windows server before attempting any upgrade.
- Prior to starting an upgrade of an Identity Bridge Agent to 2024.10.1 be sure the host meets the revised requirements.
| System Element | Requirement |
|---|---|
| OS | Windows Server 2016 or higher |
| .NET 8 | ASP.NET Core and .NET Desktop Runtime |
Where to get the latest Identity Bridge Agent Installer?
You can download the Installer via the link below.
Where to get the .NET 8 framework?
All downloadables can be viewed at Microsoft .NET 8 download page.
- Download ASP.NET Core Runtime x64 installer.
- Download NET Desktop Runtime x64 installer.
Steps for In-Place Agent Upgrade to 2024.10.1
| Steps | Details |
|---|---|
| Get .NET 8 Installers | Download two Microsoft .NET 8 packages from the .NET 8 download page. You will need both the ASP.NET Core Runtime x64, and .NET Desktop Runtime x64. |
| Install .NET 8 | Install both .NET 8 packages and if prompted reboot the Windows server. |
| Get Id Bridge Agent | Download the new Agent Installer to the IDB host. NOTE: The storage location may require antivirus exclusion for the folder where installation executable will be saved. For more details on this process, click here. |
| Stop Id Bridge Agent | Stop the IDB Windows service from Services.msc or command line. Service display name is Identity Automation Bridge Manager and service name is IDAutoBridgeManager. |
| Backup Key Id Bridge Files | Get a backup copy of CognitoState.bin and AgentState.json files from the IDB installation directory, default path is "C:\Program Files\Identity Automation\Identity Bridge Agent". |
| Update Id Bridge Agent | Install the new IDB agent. Do NOT uninstall current version, allowing installer to update IBA in-place. |
| Check Service and Process Status | On the Windows host confirm the Windows IBA service is running and via Task Manager confirm chisel.exe processes are started again. |
| Check RI Cloud Agents | In the RI Cloud portal >> Configuration >> Identity Bridge >> check Agent heartbeat time and ensure active post upgrade. |
| Test RI Cloud bridges | In the RI Cloud portal >> Configuration >> Identity Bridge >> open details on agent, select a bridge and “Test bridge” and for some or all bridges ensure they are operational post upgrade. |
Steps for New Agent Install of 2024.10.1
| Steps | Detail |
|---|---|
| Get .NET 8 | Download two Microsoft .NET 8 packages from the .NET 8 download page. Need both the ASP.NET Core Runtime x64, and .NET Desktop Runtime x64. |
| Install .NET 8 | Install both .NET 8 packages and if prompted reboot the server. |
| Get Id Bridge Agent | Download the new Agent installer to the IDB host. Note: The storage location may require antivirus exclusion for the folder where installation executable will be saved. For more details on this process, click here. |
| Install IBA normally | Per normal instructions install the IBA, ensuring any antivirus exceptions are in place for the chisel.exe process. Then create any needed bridges. |
Recovery Re-Install of 2024.10.1
| Steps | Details |
|---|---|
| Service Bridge Intact | Ensure the service-side bridge IS NOT uninstalled and left intact by checking the RI Cloud portal >> Configuration >> Identity Bridge for the Agent. |
| Backup Key Id Bridge Files | Get a backup copy of cognito.bin and agentstate.json files from the IDB installation directory, default path is "C:\Program Files\Identity Automation\Identity Bridge Agent" |
| Uninstall of 2024.10.1 | Uninstall IBA 2024.10.1 Windows and BE SURE to leave the “preserve settings so product can be reinstalled?” checkbox checked |
| Install IBA normally | Install again and the settings files are reused and all files are reinstalled to the same path. |
| Check Service and Process Status | On the Windows host confirm the Windows IBA service is running and via Task Manager confirm chisel.exe processes are started again. |
| Check RI Cloud Agents | In the RI Cloud portal >> Configuration >> Identity Bridge >> check Agent heartbeat time and ensure active post upgrade. |
| Test RI Cloud bridges | In the RI Cloud portal >> Configuration >> Identity Bridge >> open details on agent, select a bridge and “Test bridge” and for some or all bridges ensure they are operational post upgrade. |
Steps to exclude Identity Bridge Folder from Antivirus for download:
1. Open Windows security setting and then click on 'Virus & Threat Protection'
2. Click on 'Add or Remove Exclusions'
3. Click on 'Add an Exclusion'
4. Browse to 'C:\Program Files\Identity Automation\Identity Bridge Agent' and add it to exclusions.
Was this article helpful?