Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Migrate Server Database

CAUTION:

If you bring up a new server with the same IP address as your old server without any configuration, when the device agents re-register with the new server they will revert to an unconfigured "Quarantined" state. You must isolate the new server from the network while you change its IP address, restore the database and restart the server.

If you want to maintain the same IP address on the new server, then bring up a new server VM (with the same version as the original server) with a temporary IP address. After migrating an aos_backup to the new server, the original server is shut down and the IP address is changed to the original IP address on the new server. We recommend this process if you're using onbox device system agents.

If you want to use a new IP address on the new server, you must manually reconfigure the aos.conf file for each onbox device system agent. This is not required for offbox device system agents.

To migrate an active instance from one server to another:

  1. Run the command sudo aos_backup to back up the original server.
  2. Copy the snapshot to the new server using a temporary IP address on the new server.
  3. Compress and move the snapshot directory to the new server. This example uses the scp command to copy the file to the new server using a different IP address.
  4. After the snapshot has been removed from the old server, stop service (or completely shut down the server VM) to disconnect the old server.
  5. If you want to use the same IP address, you must manually reconfigure the eth0 interface on the new server to the IP address of the old server. For more information, see the Configuration section of the Installation and Upgrade guide.
  6. On the new server, uncompress the tar.gz file.
  7. Run the command aos_restore to restore the database on the new server. This command automatically starts the service after restoring the database.
  8. Run the command service aos status and verify that the server is running.
  9. From the left navigation menu of the GUI, navigate to Devices > Managed Devices to verify that your devices are online in the "Active" state.