Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


titleAbout this Article

This article does not cover the steps to provisioning a server. This article assumes that your server is ready to install ET. See the System Requirements article for information on the supported operating systems, required applications and the recommended specifications. This article assumes that these requirements have been met.

Before You Begin

  • Back up your ET database and your ET installation directory including all child folders. These will include the web.config file, logging.config file and attachment directory among other files. If you are also exporting your baselines, then we recommend that you also back up this folder.

  • The Server Key will change. The server key depends on the following details;

    1. Machine Name
    2. Processor Count
    3. Operating System Name
    4. Operating System Version (Major and Minor)


  • If you are moving your production system, we recommend contacting Catch Support in advance to arrange assistance with providing a new license text.

The Migration

  1. After setting up your new ET server, run the ET installer matching the version you are currently running on the ET server you are moving from. You can find the latest version of Enterprise Tester on our website or contact the Support team for older installation files.

  2. Copy across to the new server a copy of the backup copy of your original web.config file to the Enterprise Tester Web folder.

  3. Copy across to the new server a copy of the backup copy of your attachment folder to your Enterprise Tester Data folder or if you have changed the storage of attachments to a non default location (default storage is …\Data\Attachments) then you will need to copy over your attachment directory to the new location on the new ET server and update your web.config file.

  4. Start IIS.

  5. In the browser, navigate to the ET website. A new server key should be displayed. You will need to add a new license text in order to access ET. Email the server key to Catch Support requesting a new license and indicate whether the license is for a production or development environment.

  6. Apply the license text. You should be able to access Enterprise Tester now.

Updating the site.root.url

If the URL for ET is changing, then you will need to update the site.root.url setting in the web.config file. The site.root.url setting configures the URL that will be specified in links back to ET in external systems like JIRA.


If you are synchronizing with an external system you may wish to update your links by initiating a Synchronize All from the project link screen. As noted above, you may wish to consider batching entities for synchronization to reduce the load on ET and your external system if you expect a lot of data to be synchronized.

Updating the Attachment Storage Location

By default, Enterprise Tester stores all attachments in the Data directory of the ET installation files (\Data\Attachments). If you are storing your attachments in a non default location, you will need to update the web.config file to specify the storage location for all attachments.