Reconfiguring Your Agents for Use with a Different Edge DX Tenant

Edge DX allows companies to quickly remediate common issues and find less common ones. This enables users to get back to workers quicker and freeing up support personnel to accomplish more.

Most companies have a single Edge DX tenant; however, I recently had a case where a customer had multiple tenants and needed to identify which tenant-specific devices were attached to and move them to different tenants. Granted, this is a niche case, but the process for doing this could be more explicit.

There are a couple of ways to change tenants: uninstall and reinstall the Edge DX agent, or you can stop the Edge DX agent and change the registry value that holds the Tenant’s name and device registration code. As the first method is intuitive, in this blog, I will show you how to see what Tenant a device is attached to and then how to manually move it to a different tenant if needed.

Viewing the Tenant

On the system that you want to view the tenant, enter Regedit in Windows Start. In the Registry Editor, navigate to Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Avacee\SIP (Figure 1) and view the values in the Tenant and the DeviceRegistrationCode.

Figure 1: Registry Location

Alternatively, you can run the following command in PowerShell (Figure 2) to see these values:

reg query HKLM\SOFTWARE\Avacee\SIP

Figure 2: Seeing Values Using PowerShell

Manually Changing the Tenant

On the system that you want to change the tenant, enter Services.msc in the Windows Start search box. Then, in the Services menu (Figure 3), right-click ControlUp SIP Agent and select Stop.

Figure 3: Services

Use the Register Editor on the device to change the Tenant and the DeviceRegistrationCode values to match the value of the tenant, and then restart the ControlUp SIP agent. The registration code and tenant name can be found in the Edge DX portal by selecting Downloads from within the Configuration drop-down menu (Figure 4).

Figure 4: Downloads

Usually, the device does not need to be restarted for the changes to take effect, but if you don’t see the device within a few minutes, you may want to do so.

A Script to Change Tenants

Marcel Calef (ControlUp SE) had a customer who had to move a bunch of devices from one tenant to another, so he came up with the below script to automate the process. Note: You will need to change the devRegCode and tenant values to your own.

reg query HKLM\SOFTWARE\Avacee\SIP
reg query HKLM\SOFTWARE\Avacee\SIP -v tenant
reg query HKLM\SOFTWARE\Avacee\SIP -v DeviceRegistrationCode
::DeviceRegistrationCode    REG_SZ
SET devRegCode=blahblahblah
::tenant    REG_SZ
SET tenant=blah.sip.controlup.com
reg add HKLM\SOFTWARE\Avacee\SIP -v DeviceRegistrationCode -d %devRegCode% /f
reg add HKLM\SOFTWARE\Avacee\SIP -v tenant -d %tenant% /f
reg query HKLM\SOFTWARE\Avacee\SIP -v tenant
reg query HKLM\SOFTWARE\Avacee\SIP -v DeviceRegistrationCode
net stop "ControlUp SIP Agent” && net start "ControlUp SIP Agent"

As mentioned above, having to change a device’s tenant is a rare occurrence that most Edge DX customers will never have to do, but it is a relatively easy process to do either manually or by using the script above if the need arises.

To see a video of this in action, click here. For more information on Edge DX be sure to visit our Edge DX page or schedule a demo with a ControlUp sales engineer.