Upgrading Enterprise Tester


This section outlines the process to upgrade Enterprise Tester.

An Enterprise Tester license allows for a development license.  We strongly advise you upgrade your Development or Test environments prior to upgrading your Production installation of Enterprise Tester.


Important Upgrade Path Information

1) Always upgrade your DEV/TEST Environment before PROD to verify your upgrade process. 

2) If you are using Enterprise Tester 4.10 or below, you must upgrade to Enterprise Tester version 5.1 in the first instance, then upgrade to Enterprise Tester version 6.0. You can then upgrade to the latest version of Enterprise Tester. 

The upgrade path must be followed to support environmental stability.

(warning) The below instructions are only applicable when upgrading to 5.1 and above.

Download the Enterprise Tester installation files from EnterpriseTester-5.1.1907-Standard-Setup

This set of installation files does not provide a database installation.  Run the .exe file when upgrading this will elevate permission to "Run as Administrator" when required to ensure all upgrade files can be installed.


Enterprise Tester by default is installed in your x86 Program files directory, alongside any other programs you have installed.  For 32bit editions of Windows operating systems, this is typically C:\Program Files\ and for 64bit editions of Windows operating systems it is C:\Program Files (x86)\.   The folder can be configured to reside on a different drive depending on your system configuration; therefore throughout this document we refer to this folder using the word %ProgramFiles% to avoid confusion.

To Upgrade Enterprise Tester, perform the following steps:

  1. Stop IIS

  2. Back Up the following:

    • ET Database 
      • For trial users this can typically be found in %ProgramFiles%\Catch Limited\Enterprise Tester\Data (backup the entire folder) 
      • Otherwise consult with your database administrator or database specific documentation provided by the vendor
    • Logging.config & Web.config Files
      • Typically located in %ProgramFiles%\Catch Limited\Enterprise Tester\Web
    • Search Index folder
      • Typically located in %ProgramFiles%\Catch Limited\Enterprise Tester\Web\app_data\Index
    • Attachments if you store these in your File System
      • The default location for storing attachments is %ProgramFiles%\Catch Limited\Enterprise Tester\Data\Attachments\ 
  3. Verify IIS Settings

    If you have changed these settings you may need to reapply defaults to upgrade via the installer and then reapply the settings after the upgrading:

    IP Address: All unassigned
    Port 80
    No host header configured
    Virtual directory named "EnterpriseTester" 

  4. Run the .exe file of the EnterpriseTester-X.X.XXXX-Standard-Setup.zip installation files.  These files will not install a database.  The .exe file will elevate permission to allow the installation of all files. 

  5. If you made any changes to IIS settings, reset these back to the original settings

  6. Restart IIS
  7. Start Enterprise Tester

Enterprise Tester may take some time to start up because it will be applying database schema migrations to update the database structure.  But this process should take no longer then a couple of minutes.


If you are upgrading a trial environment which uses the SQL Express database, you may get a “Named Pipes Error – Cannot Connect To SQL Database” on startup.  To rectify this you can restart the SQL Server (SQLEXPRESS) service as pictured below.

Upgrade Issues

Should a problem occur, please e-mail support@catchsoftware.com with the following information:

  • Operating System

  • Browser

  • Old ET Version being replaced

  • New ET Version being upgraded to

  • Screen shot of error

  • Log.txt file  - typically located in %ProgramFiles%\Catch Limited\Enterprise Tester\Web\App_Data