Today, I encountered an issue with the Production Self-Hosted Integration Runtime (SHIR) that involved a version mismatch. In our production environment, we typically utilize multiple nodes of the Integration Runtime to ingest data from various sources. Microsoft frequently releases upgrades for the Integration Runtime, containing fixes and additional functionalities. If you have enabled auto-update for the Integration Runtime version, the upgrades will be automatically applied at the specified time window. However, there are instances where some nodes fail to pick up the latest updates due to technical issues. In such cases, we usually log in to the server where the Integration Runtime is installed, restart the services, and perform the update, after which the node comes back online. Unfortunately, there are scenarios where the version appears to be up-to-date when checked on the server, but the Integration Runtime remains inactive.
Resolving the Issue:
While the common approach is to restart the service to resolve this issue, in some cases, it may not be effective. To overcome this problem, we recommend reinstalling the latest version of Integration Runtime, aligning it with the other nodes in your workspace. Below are the steps to guide you through the reinstallation process:
Steps to Reinstall the Integration Runtime with the Latest Version:
- Log in to the Integration Runtime server that is currently down.
- Ensure that no pipeline runs are ongoing during the downgrade of the SHIR version.
- In your SHIR node, navigate to Microsoft Integration Runtime Configuration Manager > Home > Generate Backup.
4. Set password for backup
5. Save the backup
6. Click on Stop service
7. Uninstall Microsoft Integration Runtime. While you are uninstalling the IR, it will give you a pop-up that will ask whether you want to preserve the credentials and specifications if you are reinstalling a latest version. If you select YES, then it will wipe out; on the other hand, if you select NO, then it will preserve these for you, and when reinstalling, it will automatically take those specifications, making it completely functional.
8. Install version from you would like to have.
9. Follow below link to install SHIR.
Create a self-hosted integration runtime – Azure Data Factory & Azure Synapse | Microsoft Learn
10. After re-install old version, please click Import backup
11. Select backup file and password
If you follow the process exactly, you can achieve the upgrade of the IR. However, if you import the backup, it will ask for the keys and other credentials that you had. It is like completely setting up the IR from scratch.
To overcome this whole process of giving the credentials, adding the security group, and other specifications you had, you can preserve these specifications while you are uninstalling the IR from the server.
Hope this blog gave you some insights into updating the existing IR without changing the existing configuration.
