System administrators sometimes need to move the node that hosts the MID server ("old system") to another node ("new system") while preserving the MID Server configuration. One example is moving the server node from a physical to a virtual server node or upgrading the Windows operating system.


  1. Log in as the administrator.

  2. On the old system, stop the MID Server via the Windows Services.

  3. Copy the original config.xml and wrapper-override.conf files from the agent directory.

    • \agent\config.xml
    • \agent\conf\wrapper-override.conf
  4. Uninstall the MID server by running the \agent\bin\UninstallMID-NT.bat script to remove the MID Server service from your system so you don't accidentally start it. Alternatively, you can set the startup type as disabled in the Windows service of that service.

  5. On the new system, download the new MID Server from the instance.

  6. Unzip the zip file to a directory of your choice.

  7. Copy the files you saved in step 3 and replace them into the following directories:

    • \agent\config.xml
    • \agent\conf\wrapper-override.conf
  8. Run the \agent\installer.bat script.

    This will open up the installer with pre-populated fields because you have replaced the configuration files. The only thing it will ask you for is the MID Server user's password.

  9. Accept all defaults and start the MID Server service.

  10. Go back to the instance that this MID Server was pointing to and validate the MID server.

    1. Go to MID Server > Servers > MID Server.
    2. Select the server and validate.

    The MID Server should be up and running.

Other useful resources

KB0597552, Resolve local environment issues of the MID Server host

KB0535145, Best practice on setting up your MID Server

Article Information

Last Updated:2019-08-02 21:17:03