--- title: "Upgrade Process for In-Place Identity Bridge Agents" slug: "upgrade-process-for-in-place-agents" description: "Upgrade RapidIdentity Identity Bridge used by IAM provisioning from SaaS to on premise systems." tags: ["In-Place Agent Upgrade", "Administrator", "Identity Bridge", "Recovery Re-Install"] updated: 2024-12-04T17:08:13Z published: 2024-12-04T17:08:13Z canonical: "help.rapididentity.com/upgrade-process-for-in-place-agents" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.rapididentity.com/llms.txt > Use this file to discover all available pages before exploring further. # Upgrade Process for In-Place Identity Bridge Agents ## 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. [IdentityBridgeAgent_2024.10.1.exe](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/IdentityBridgeAgent_2024.10.1.exe) ### Where to get the .NET 8 framework? All downloadables can be viewed at Microsoft [.NET 8 download](https://dotnet.microsoft.com/en-us/download/dotnet/8.0) page. 1. Download [ASP.NET Core Runtime x64 installer](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-8.0.11-windows-x64-installer). 2. Download [NET Desktop Runtime x64 installer](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-desktop-8.0.11-windows-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.](/v1/docs/upgrade-process-for-in-place-agents#steps-to-exclude-identity-bridge-folder-from-antivirus-for-download) | | 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](/v1/docs/upgrade-process-for-in-place-agents#steps-to-exclude-identity-bridge-folder-from-antivirus-for-download). | | Install IBA normally | [Per normal instructions install the IBA](/v1/docs/identity-bridge-quick-start-guide), 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' ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXeoA5fuqRdDbHGbTpWZ-X9WMEoDJaBn_Nxiq9SaLMw7TjFznJjgoNHo4zgelRAV8ECfUUxoJAPtTjybESA2iCFoDU13UGlz1eiX-LSyDU_IWEYVnZTtzxXtbFwawzapF2-EiEbEIA?key=75tMfdHqFieOsjKu2NIjDa7C) 2. Click on 'Add or Remove Exclusions' ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdPERA7e52whjeq7iNuK9cyoYc8YLeZBamSChj9p-vuJmaKCQSnyAWaqP7OPPsZzKiK-EdEjoID5wlH5YMEG3Fs3d3-qd8DmC_sJeIpR-1Mx-MwPo-Y74hTQOy4IuZFTCOkzMVrZQ?key=75tMfdHqFieOsjKu2NIjDa7C) 3. Click on 'Add an Exclusion' ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcce93PP8g9MP3R8ffVuNcJCGACp5Ko9awu8b95nynqYYRLn5J8csEettFzQ8MgpuASHBwHjimpxnYmGXZ9JL2moiiw8nub0TDFP48yvE6LeMa-fqLg8O2J1ST4zt-sixvkyppo?key=75tMfdHqFieOsjKu2NIjDa7C) 4. Browse to 'C:\Program Files\Identity Automation\Identity Bridge Agent' and add it to exclusions. ## Related - [Identity Bridge Webinar](/identity-bridge-webinar-1.md) - [Identity Bridge](/identity-bridge-combining-cloud-and-on-prem.md) - [Identity Bridge Connection Troubleshooting](/identity-bridge-connection-troubleshooting.md) - [Identity Bridge Quick Start Guide](/identity-bridge-quick-start-guide.md) - [Using an Identity Bridge in Connect](/using-an-identity-bridge-in-connect.md) - [Setting up a Windows File Share with Identity Bridge](/setting-up-a-windows-file-share-with-identity-bridge.md)