Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Note
titleImportant Upgrade Information

 

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.

 

Note
titleImportant 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.0 in the first instance, you can then upgrade to the latest version of Enterprise Tester.

The upgrade path must be followed to support environmental stability.

...

 

From Enterprise Tester version 4.6, a new install file for Enterprise Tester is available when upgrading.  

Download the Enterprise Tester installation files labelled " EnterpriseTester-X.X.XXXX-Standard-Setup.zip" from the Enterprise Tester Website.  

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:

...

Stop IIS

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\ 

...

Verify IIS Settings

Info

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" 

...

From V4.6, 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. When upgrading to V4.5 or earlier, please refer to this upgrade guide

...

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

...

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.

...

titleNote

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.

3) For Enterprise Tester 6.1 and above you must upgrade the .NET framework to 4.6


 

Upgrade Types

Children Display

 

...

Upgrade Issues

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

  • Operating System

  • Browser

  • Old ET Enterprise Tester Version being replaced

  • New ET Enterprise Tester Version being upgraded to

  • Screen shot of error and as much detail as possible

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