Migrate AIMMS PRO On-Premise Server to Another Machine

This article explains how to migrate your AIMMS PRO On-Premise server to a new machine. We will call these servers the original machine (source host) and the new machine (target host).

This can be broken down into five stages, discussed in detail below.

  1. Stop the AIMMS PRO On-Premise services.

  2. Backup the AIMMS PRO On-Premise configuration on the original machine.

  3. Install AIMMS PRO On-Premise on the new machine.

  4. Configure AIMMS PRO On-Premise on the new machine.

  5. Restart the AIMMS PRO On-Premise services.

Note

For instructions to migrate the license server, please see Migrate AIMMS Network License Server.

Stop the Services

Stop the AIMMS PRO On-Premise Services from within the AIMMS PRO Configurator.

../../_images/1_img.png

Backup the Configuration

  1. Go to Backup Management and click Backup Now.

../../_images/2_img.png

  1. Go to the tab PRO Configuration and copy all settings in a text document, so that during PRO configuration on the new machine you can enter these settings again.

../../_images/3_img.png

Install PRO on the New Machine

  1. On the new machine, create the AIMMS PRO On-Premise data folder at the desired target location; by default, the AIMMS PRO On-Premise data folder is at C:\ProgramData\AimmsPRO.

  2. Copy the subfolders Backup and Data from the original machine to the new machine.

  3. Install the same version of AIMMS PRO On-Premise onto the new machine.

Important

It is very important that you install exactly the same version, because normal upgrades are likely to fail when migrating. After the migration is successful you can upgrade to another version of AIMMS PRO On-Premise.

Configuring the New Installation

  1. Once the installation is done, you should be redirected to the page AIMMS PRO On-Premise Configurator. If you changed the username/password/schema for the database user, please enter the same here.

../../_images/4_img.png

  1. Go to the tab PRO Configuration and enter the values that you saved from the original configuration, as detailed above.

  2. Go to the tab Backup Management, select the backup you made earlier, and click Restore Now.

Restarting the Services

Go to Start/Stop Services and start the service.

You have now migrated your AIMMS PRO On-Premise server!

See also