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.
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
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.
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.