Azure-docs: Need to explain how to reconfigure a Self-Hosted IR installation

[riserrad]

After you have it installed, it would be good to make it clear how to reconfigure it.

For example:

• If I regenerated the key I was using, how do I update it on my Self-Hosted IR installation? or
• If I wanted to remove that Integration Runtime and I want to reuse the VM/Node on another IR, how do I do it?

I figured out that we just need to use dmgcmd.exe -Key [AuthenticationKey] and then restart the service, but I found it myself. It should be documented.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 32785d15-8202-6e44-f1d2-420ef0600f3f
• Version Independent ID: 3af5fa49-7bd4-18ce-f8dc-aa4a2b8c6478
• Content: Create a self-hosted integration runtime in Azure Data Factory
• Content Source: articles/data-factory/create-self-hosted-integration-runtime.md
• Service: data-factory
• GitHub Login: @nabhishek
• Microsoft Alias: abnarain

[MartinJaffer-MSFT]

Thank you for your question/comment @ricardoserradas . We will review the document and get back to you.

[MartinJaffer-MSFT]

I understand your first point, and including in documentation makes sense to me.
However I am having trouble with your second point. Could you please clarify, @ricardoserradas ?
You want to remove your integration run time, and then put it back on? An Integration Runtime allows Data Factory to access the local data sources. How is one IR different from another?

[riserrad]

Hi Martin.

Thank you for considering my feedback. Sure, let me try to clarify the scenario.

Imagine that I have a VM and I configure the Self-Hosted IR on it, pointing to a IR called MyFirstIR.

Time goes by and, for some reason, I need to use this VM on a different IR, called MySecondIR.

It would be nice to have instructions on how we should proceed to point this VM's Self-Hosted IR to MySecondIR.

Let me know if you need more information from me.

P.S.: I'd love to contribute to the doc by adding a suggestion for these instructions if these days were not so crazy. If things go calmer and this is still open, I will be more than happy to contribute.

[MartinJaffer-MSFT]

@ricardoserradas , would a shared IR be more useful than redirecting the IR?

[MartinJaffer-MSFT]

@nabhishek , what do you think about adding mention of dmgcmd.exe to the doc? People do regenerate their keys.

[MartinJaffer-MSFT]

@ricardoserradas , I have assigned this issue to author @nabhishek .

[riserrad]

@ricardoserradas , would a shared IR be more useful than redirecting the IR?

I acknowledge the possibility but I also understand that the user may not understand that he/she could work this around by sharing the IR. I'm trying to help addressing the actual reconfiguration of the IR.

@nabhishek , what do you think about adding mention of dmgcmd.exe to the doc? People do regenerate their keys.

Yes, that would be great. Reassigning the key would actually reassign the host to the IR that owns the key. Perfect.

Thanks for all the help, Martin!

[CTsiaras]

@ricardoserradas, Thanks a lot the dmgcmd.exe -Key [AuthenticationKey] dit the job. Thsi is clearly missing from the documentation.

[NowinskiK]

hey folks. I've just tried to reconfigure my existing Self-hosted node with a new AuthenticationKey, instead of uninstalling the whole app and install it manually. Works great. Small issue though. When I use option with NodeName it doesn't work and giving a name is "Node_1" always. How to grant the required name to the node?

[nabhishek]

The command-line's are documented here.

Though you can reconfigure SHIR using the above command-lines, it is suggested to do a clean uninstall/install. This would wipe out all other configurations/ customizations/ encrypted credentials.

[nabhishek]

please-close