Migrate Eggplant DAI to Another Server

You can migrate a working version of a Windows, on-prem, Eggplant DAI Server installation from one Windows system to another. Keysight provides a script you can use to help you perform this type of migration along with instructions for using it, which are provided below.

Important

The Windows DAI Server started storing passwords in the Windows operating system Credentials Manager in version 25.3. Starting in version 25.4, Keysight includes a script you can use to migrate DAI Servers from one Windows system to another, including the data from the Windows Credentials Manager. The script is called the dai_secrets.py script. Its location along with instructions for running it are provided below.

Note that you can migrate DAI version 25.3 as well, but the script to migrate data from the Credentials Manager is not included with the 25.3 installation. See Migrate Eggplant DAI to Another Server in the Version 25.3 documentation for instructions about migrating DAI 25.3.

For information about migrating servers from versions prior to 25.3, please see the "Migrate Eggplant DAI to Another Server" page in the documentation for the DAI version you want to migrate.

Migrating a DAI Server to Another System

These instructions are for Windows, on-prem DAI Server versions 25.4 and later.

1. On the system that DAI will be migrated to (the destination system), perform a clean installation of DAI 25.4 or later. Then confirm that the DAI home page loads successfully and that you can log in to DAI.

2. On the system where the DAI Server you want to migrate is running (the source system), do the following:

   • Stop the DAI Server Windows service.
   • Go to C:\ProgramData\Eggplant\Digital Automation Intelligence directory and copy the following files and folders to the destination system:
     • The data folder
     • The files folder for DAI versions 26.2.1 and higher or minio folder for DAI versions 26.2.0 and older (Note that the 26.2.1 and higher Setup programs on Windows will migrate the data from the minio folder if it exists to the files folder)
     • The config.yml file
     • The settings.ini files
   • Start the DAI Server service again.

3. On the destination system, do the following:

   • Stop the DAI Server Windows service and go to C:\ProgramData\Eggplant\Digital Automation Intelligence.
   • Replace the existing data and files (or minio) folders, and config.yml and settings.ini files with the copies from the source system.
   • Delete the rabbitmq folder.

4. On the source system, do the following:

   • Open a command prompt window with "Run as Administrator" and run the following command read the DAI secrets from the Windows Credential Manager and write them to a file:

     "C:\Program Files\Digital Automation Intelligence\python\tools\python.exe" "C:\Program Files\Digital Automation Intelligence\python\tools\Lib\site-packages\eggplant\win_dai_service\dai_secrets.py" read C:\<path_to_file>\dai_source_secrets.txt

     Where the <path_to_file> is the location on the C: drive where DAI will create the dai_source_secrets.txt file. (You can use a different file name instead if you want).

   • Copy the dai_source_secrets.txt file to the destination machine.

5. On the destination system, do the following:

   • Copy the DAI credentials from the dai_source_secrets.txt file to the Windows Credentials Manager by opening a command prompt window with "Run as Administrator" and running the following command:

     "C:\Program Files\Digital Automation Intelligence\python\tools\python.exe" "C:\Program Files\Digital Automation Intelligence\python\tools\Lib\site-packages\eggplant\win_dai_service\dai_secrets.py" write C:\<path_to_file>\dai_source_secrets.txt

   • Start the DAI Server service on the destination machine.

   • Open http://localhost:4652/auth in a browser and log in using the DAI System administrator credentials from the source machine, and which are now in the destination machine Windows Credential Manager.

   • Go to Manage Realms and click Eggplant to change the realm to Eggplant.

   • In menu Clients, search for web and click client:dai:user_agent:web.

   • In Settings → Valid Redirect URIs, change the hostname to the hostname of the destination machine, and click Save.

Deleting Secrets from the Original DAI Server Host System

If you need to delete the DAI secrets from the Windows Credentials Manager on the original DAI host system (called the source system in the instructions above) use the following command:

"C:\Program Files\Digital Automation Intelligence\python\tools\python.exe" "C:\Program Files\Digital Automation Intelligence\python\tools\Lib\site-packages\eggplant\win_dai_service\dai_secrets.py" delete