How can AMS data (artifacts) be migrated to a new machine where we will have a new installation of AMS?

Describes how to migrate AMS data to a new machine/installation.

Steps:

1. Backup your AMS data folder, which is specified in your AMS configuration file (AMS.conf). For example..
 

filePath = "${amsDatabaseFilePath:-data/ams-h2-persistence}"

Copy the contents of this data folder to a temporary folder to create the backup copy.

2. If you have installed a newer version of AMS on the new machine, you should first upgrade your existing installation. This is accomplished by running..
 

ams-server --upgrade

Execute this command from the folder where your data folder is stored.

If you will be installing the same version of AMS on the new machine, you may skip this step.

3. Still on the old machine, run the backup command (again from the directory where your data folder is stored):
 

ams-server --backup .

This will produce the *.json backup file in the current folder.

4. Install Streaming and AMS on the new machine, and create a new folder for AMS data.

5. Copy your *.json backup file to the new folder you created in the previous step.

6. Run the restore command to complete the migration:
 

ams-server --restore AMS-2023-05-24-09-20-12.json

7. Start AMS on the new machine.