Summary

The following details the recommended steps for migrating your Moxie Data Server to a new server.  If you want to upgrade Moxie on the same server, please see KB268: Recommended upgrade Path for Moxie.

Solution

1. Back up Moxie, either by:
   1. creating a snapshot of the VM, if you are running Moxie on a VM or
   2. backing up Moxie as described here
2. Ensure there will be no changes to the content while you are in the process of migrating to a new server.  Advise all Moxie users that there is a freeze on any content changes during the migration process.
3. Contact Omnivex Registration to advise them your intention to move your licensed copy of Moxie to a new server.  This new server will require a new license file so you will have a temporary key for the new server until you have completed your migration and decommissioned the old server.  Registration can be contacted by email at registration@omnivex.com.
4. Install and license the same version of Moxie on the new server.  Because you are copying over the Moxie cache and the Moxie database from the old server, the new server must match the same version as the old server.
5. Stop Omnivex and Moxie services on both the old and new servers.
6. Copy the Moxie cache from the old server to the new server.  Use the MDSPC to confirm where the cache is located on the old server.  If the cache is not in the default location, create the exact same folder on the new server.
7. Copy the Moxie database from the old server to the new server.  Use the MDSPC to confirm where the database is located on the old server.  
   1. If full SQL Server, you can point the new server to the same database as long as the old server stays offline.
   2. If SQLLite, you can copy it over to the same location as the old server.
   3. If SQL CE, you can copy it over to the same location as the old server.
8. Copy over the DataPipe.dat file from the old server to the new server.  The default location for the file is C:\ProgramData\Omnivex\DataPipe Server.
9. Copy over any relevant Linking product data.  Default locations vary by product but will be located in the folder C:\ProgramData\Omnivex\ .
10. Once everything has been copied over to the new server, start all Omnivex and Moxie services.
11. Run through the Data Server Configuration wizard.
12. Run through the Data Server Connection wizard.
13. Open a Studio on the new server and confirm the content matches the old server.
14. Upgrade Moxie if required.  Refer to KB268 for steps on the suggestion upgrade path.
15. Point all Players from the old server to the new server.  Be sure to upgrade your Players (using the System Manager) if the Data Server was also upgraded.
16. Contact Omnivex Registration to obtain a replacement license key for the new server once you have completed your migration.