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.
   • Copy the data and minio folders, and the config.yml file, and then transfer them to the destination system.
   • 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 minio folders, and the config.yml file 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:

     "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).

     The command reads the DAI secrets from the Windows Credentials Manager and writes them in the dai_source_secrets.txt file.

   • Copy the dai_source_secrets.txt file to the destination machine and run 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

     This command will take the secrets from dai_source_secrets.txt and write them in the Windows Credentials Manager on the destination machine.

5. On the destination system, do the following:

   • 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.
   • 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