Upgrade Process for In-Place Agents
  • 10 Mar 2023
  • 3 Minutes to read
  • Dark
    Light

Upgrade Process for In-Place Agents

  • Dark
    Light

Article summary

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 ElementRequirement
OSWindows Server 2016 or higher
.NET 6ASP.NET Core and .NET Desktop Runtime

Where to get the .NET 6 framework?

  1. From the local server go to the Microsoft .NET 6 download page to see all downloadables.
  2. Download ASP.NET Core Runtime x64 installer.
  3. Download NET Desktop Runtime x64 installer.

Steps for In-Place Agent Upgrade to 2023.3.1

StepsDetails
Get .NET 6 InstallersDownload 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 6Install both .NET 6 packages and if prompted reboot the Windows server.
Get Id Bridge AgentDownload 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 AgentStop 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 FilesGet 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 AgentInstall the new IDB agent. Do NOT uninstall current version, allowing installer to update IBA in-place.
Check Service and Process StatusOn the Windows host confirm the Windows IBA service is running and via Task Manager confirm chisel.exe processes are started again.
Check RI Cloud AgentsIn the RI Cloud portal >> Configuration >> Identity Bridge >> check Agent heartbeat time and ensure active post upgrade.
Test RI Cloud bridgesIn 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

StepsDetail
Get .NET 6Download 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 6Install both .NET 6 packages and if prompted reboot the server.
Get Id Bridge AgentDownload 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 normallyPer 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

StepsDetails
Service Bridge IntactEnsure 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 FilesGet 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.1Uninstall IBA 2023.3.1 Windows and BE SURE to leave the “preserve settings so product can be reinstalled?” checkbox checked
Install IBA normallyInstall again and the settings files are reused and all files are reinstalled to the same path.
Check Service and Process StatusOn the Windows host confirm the Windows IBA service is running and via Task Manager confirm chisel.exe processes are started again.
Check RI Cloud AgentsIn the RI Cloud portal >> Configuration >> Identity Bridge >> check Agent heartbeat time and ensure active post upgrade.
Test RI Cloud bridgesIn 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?


ESC

Eddy AI, facilitating knowledge discovery through conversational intelligence