Application Installation

There are 3 options for installing Enterprise Tester:

1. With and SQL Server Express Database ( User Attached Instance)
2. With a production database
3. Manual installation (zip file installation)

Installation Steps Using the SQL Express Database (2008)

Before Installing Enterprise Tester

1. Install the .Net Framework 4 on the server.
2. IIS 6 or 7 must be installed on the server.

For trial customer and customers with small installations, Enterprise Tester provides a set of installation files which will install a SQL Server Express database.

Download Enterprise Tester from www.enterprisetester.com/download . Select the EnterpriseTester-X.X.XXXX-Sql-Bundle-Setup file and run the .exe file.

Ensure the pre-requisites have already been installed and the various components configured, you can then download and install the Enterprise Tester application.

1. Click on the download button and save the file.
2. Open the zip file and double click on the Windows Installer Package and select run.
3. Select ‘Next’ from the 1^st screen displayed.
4. Accept the terms of the license and click ‘Next’.
5. Select the installation directory and click ‘Next’.
6. Then select ‘Install’.
7. Click ‘Finish’ to close the installer.

For larger installations such as 30 user and the 30+ user licenses, we recommend SQL Server 2008 R2 Database.

Installation Steps Using Another Database Server

From V4.6, a new install file for Enterprise Tester is available if you are planning to configure your own production database on another server.  Download the Enterprise Tester installation Files labelled " EnterpriseTester-X.X.XXXX-Standard-Setup.zip"   Before attempting to install Enterprise Tester for use with another database ensure that you follow the steps below.

Before Installing Enterprise Tester

1. Install the .Net Framework 4 on the server.
2. IIS 6 or 7 must be installed on the server.
3. Create an empty database on your SQL server.
4. Ensure that the user you intend Enterprise Tester to use when accessing the database has been given correct permissions to create and remove tables, columns, indexes, constraints etc.

Installing Enterprise Tester Using the Standard Setup

The following steps must be completed before you access the Enterprise Tester:

1. This set of installation files do not install a database. Run the .exe file to initiate the installation of all the require files ( the .exe file may elevate permission levels so that all components can be installed). 
2. Open the web.config file in notepad or a similar text editor.

By default this file is located: 

c:\Program Files\Catch Limited\Enterprise Tester\Web\web.config

1. Locate the following section in the web config: <connectionStrings>. Change the connection string to point to the server that contains the database Enterprise Tester will use. See Section Example Connection String section below.
2. Save the web.config file.
3. For Windows 7 & Windows Server 2008 R2 Installations see the next section.
4. Access the Enterprise Tester site via Start -> All Programs -> Enterprise Tester -> Enterprise Tester.

There will be a small delay as the application creates all the tables in the target database, before starting the First-Use Wizard which will guide you through adding a new organization, license etc. Once this has completed, you can access Enterprise Tester and complete the initial setup. If an error occurs upon starting due to an incorrect connection string, if you edit the web.config file it should then trigger the application to start again. Once restarted, refresh the page for the Enterprise Tester website, and have it attempt to create all the tables again. If the error occurred for another reason i.e. insufficient permissions, you will need to restart IIS / the default website, so you can attempt to run the installation process again.

Example Connection String

The following shows a typical connection string for MS SQL server.  If you want to configure Enterprise Tester to use a database called "EnterpriseTesterProd" on the SQL server with the host name "SQLCORP01", using the SQL login "etapp", and password "pas$w0rD1" you would use the following connection string ( without the line breaks):

<connectionStrings>
<add name="Default" connectionString="Data Source=SQLCORP01;
Initial Catalog=EnterpriseTesterProd;MultipleActiveResultSets=true;
User Id=etapp;
Password=pas$w0rD1;"/>
</connectionStrings>

For further detail on SQL server connections string you can refer to: http://www.connectionstrings.com/sql-server-2008#p1

Database Configuration

To change which database is being targeted, the web.config file must be edited, and at a minimum there are 3 options which must be changed to support each database - as per the table below:

Each database also uses a slightly different connection string format - the http://connectionstrings.com/ website provides useful details of each connection string format.

Oracle Database Configuration Notes when using Windows Server 2008r2

Enterprise Tester no longer ships with Oracle drivers. To use Enterprise Tester with an Oracle database you must download and install the Oracle ODP.Net drivers from the Oracle website (part of ODAC). You can install either 32bit:

http://www.oracle.com/technetwork/database/windows/downloads/index-101290.html

Or 64bit:

http://www.oracle.com/technetwork/database/windows/downloads/index-090165.html

We suggest using the XCopy deployment release.

Once the XCopy release is downloaded, you can unzip the xcopy file into a folder, then run the following command:

    install.bat odp.net2 c:\oracle odac

Which will install the ODP.Net drivers into the GAC (Global Assembly Cache)

(see the readme.txt in the root of the ODAC xcopy zip file for further details).

At this point you will be able to configure Enterprise Tester to connect to an Oracle database.