Moving Devices From One Organization to Another

At times, it is necessary to move a device from one organization (org) to another within the console. This process involves two steps, both of which are performed directly on the target device.

Note: This operation should not be attempted as a Worklet.

Prerequisites: You must have the required permissions to perform this action. See Roles and Permissions Management.

Manually moving a device

Manually moving a device to a new organization requires running just one command directly on the target device. The second step is to restart the device.

Update Agent Key

To move a device from one organization to another, you must update the access key the Automox agent is using to the target organization. This can be done with the help of the --setkey option. This will deregister the device from the previous organization and set the agent key for the new organization.

  • A string needs to be passed to the --setkey argument, even if it is an invalid key.

  • The access key passed cannot be the last one used.

macOS

Copy 
sudo /usr/local/bin/amagent --setkey <NEW_ORG_ACCESS_KEY>

Windows

Copy 
C:\Program Files (x86)\Automox\amagent.exe --setkey <NEW_ORG_ACCESS_KEY>

Linux

Copy 
sudo /opt/amagent/amagent --setkey <NEW_ORG_ACCESS_KEY>

Restart the Automox Agent

After setting the new organization access key, you will need to restart the Automox Agent service on the device using the following commands:

macOS

Copy 
sudo launchctl bootout system/com.automox.agent
sudo launchctl bootstrap system /Library/LaunchDaemons/com.automox.agent.plist

Windows

Copy 
net stop amagent
net start amagent

Linux

Copy 
sudo service amagent restart

Related Topics