Upgrade Process for In-Place Agents
- 10 Mar 2023
- 3 Minutes to read
- Print
- DarkLight
Upgrade Process for In-Place Agents
- Updated on 10 Mar 2023
- 3 Minutes to read
- Print
- DarkLight
Article summary
Did you find this summary helpful?
Thank you for your feedback
Identity Bridge Agent 2023.3.1 or Higher Requirements
Prior to starting an upgrade of an Identity Bridge Agent to 2023.3.1 or higher be sure the host meets the revised requirements.
| System Element | Requirement |
|---|---|
| OS | Windows Server 2016 or higher |
| .NET 6 | ASP.NET Core and .NET Desktop Runtime |
Where to get the .NET 6 framework?
- From the local server go to the Microsoft .NET 6 download page to see all downloadables.
- Download ASP.NET Core Runtime x64 installer.
- Download NET Desktop Runtime x64 installer.
Steps for In-Place Agent Upgrade to 2023.3.1
| Steps | Details |
|---|---|
| Get .NET 6 Installers | Download two Microsoft .NET 6 packages from the .NET 6 download page. Need both the ASP.NET Core Runtime x64, and .NET Desktop Runtime x64 (currently: dotnet-hosting-6.0.14-win.exe and windowsdesktop-runtime-6.0.14-win-x64.exe). |
| Install .NET 6 | Install both .NET 6 packages and if prompted reboot the Windows server. |
| Get Id Bridge Agent | Download the new Agent installer to the IDB host. Note that storage location may require antivirus exclusion for the folder where installation executable will be saved. |
| 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 cognito.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 2023.3.1
| Steps | Detail |
|---|---|
| Get .NET 6 | Download two Microsoft .NET 6 packages from the .NET 6 download page. Need both the ASP.NET Core Runtime x64, and .NET Desktop Runtime x64 (currently: dotnet-hosting-6.0.14-win.exe and windowsdesktop-runtime-6.0.14-win-x64.exe). |
| Install .NET 6 | Install both .NET 6 packages and if prompted reboot the server. |
| Get Id Bridge Agent | Download the new Agent installer to the IDB host. Note that storage location may require antivirus exclusion for the folder where installation executable will be saved. |
| 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 2023.3.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 2023.3.1 | Uninstall IBA 2023.3.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. |
Was this article helpful?