Upgrades using the Bin Zip file

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.

3) Enterprise Tester 6.1 and above requires .NET framework 4.6.

4) Always check external system compatibility before upgrades.

Enterprise Tester, by default, is installed in your C:\Program Files\ or C:\Program Files (x86)\ directory, alongside any other programs you have installed. The folder can be configured to reside on a different drive if you should choose; throughout this document we refer to this folder using the word %ProgramFiles% to avoid confusion.

Manual Upgrade (Bin Zip Installer)
Manual upgrades require you to be aware of framework upgrades, please refer to the Important Upgrade information at the top of this page.

To upgrade Enterprise Tester manually perform the following steps:

1) Download the Enterprise Tester installation files from http://catchsoftware.com/support#DownloadCentre

2) Back Up the following elements of your existing Enterprise Tester installation:

 a) Enterprise Tester Database 
    For downloaded trial users this can typically be found in %ProgramFiles%\Catch Limited\Enterprise Tester\Data

 b) Enterprise Tester File Structure 
    Typically located in %ProgramFiles%\Catch Limited\Enterprise Tester\

If you wish to be a little more selective with the backup, the following files and folders should be included
       i) Logging.config & Web.config Files
          Typically located in %ProgramFiles%\Catch Limited\Enterprise Tester\Web

      ii) Attachments
          Typically located in %ProgramFiles%\Catch Limited\Enterprise Tester\Data\Attachments\ 

   iii) Avatars
        Typically located in %ProgramFiles%\Catch Limited\Enterprise Tester\Data\Avatars\ 

    iv) Optional: Indexes
              Typically located in %ProgramFiles%\Catch Limited\Enterprise Tester\Data\Indexes\ 
          If you do not back this up and need to roll back the upgrade you will need to perform a full reindex of the ET instance

3) Extract the files from the downloaded bin.zip file and copy all of the contents from the “\Web\ folder EXCLUDING
the following:

  \App_Data\ folder
  Web.config file
  Logging.config file

4) Navigate to %ProgramFiles%\Catch Limited\Enterprise Tester\Web folder and delete the existing files and folders of the same
names as those copied above

5) Paste in the content copied in Step 3, choose to overwrite any files when prompted.

6) Using the command line navigate to the %ProgramFiles%\Catch Limited\Enterprise Tester\Web\Bin\ folder and run
“Postinstalltasks.exe ziprelease”. Administrator permissions may be required.

7) Make sure the identity that runs Enterprise Tester (as seen in the IIS application pool configured during installation)
still has write permissions to the “\data” and “\web\app_data\” directories.

8) Restart IIS

9) Start Enterprise Tester. Enterprise Tester may take a few minutes to start up as any necessary database schema changes are made.

NOTE: If Enterprise Tester does not start you may need to remove the System.Data.SQLite.dll in the Web\Bin folder.

If any errors occur during the migration process you should see an error message display on screen. If this error message does not provide enough information to resolve the issue, please contact support and supply the following details:

  • A copy/paste of the entire error message.
  • A zip file containig all the log files within the \Web\App_Data\ folder.
  • A copy of your web.config file.
  • The version/type of database being used.

Support requests can be emailed to support@catchsoftware.com

Future upgrades
When upgrading in the future always check the upgrade.txt file first, as it may contain additional instructions specific to upgrading to the latest version such as manual modifications which must be made to the web.config file.