3.2 Install Web Server

Retain requires a webserver to be installed for tomcat to function. Select the webserver based on the OS the server will be running.

For Linux: Install Apache 2.2.x for SLES 11 or Apache 2.5.x for SLES 12, including:

  • apache2-mod_jk - Connectors between Apache and Tomcat Servlet Container

  • apache2-prefork - Apache 2 "prefork" MPM (Multi-Processing Module)

  • apache2-worker - Apache 2 worker MPM (Multi-Processing Module)

For Windows Server: Install IIS, including:

  • ISAPI Extensions

  • ISAPI Filters

3.2.1 IIS Install

For Windows, we recommend installing IIS, but apache can be used, see the apache web site for installation instructions.

If using IIS, use the appropriate version for the platform.

Installing ISAPI extensions and filters with IIS

ISAPI filters allow the gathering and manipulation of, and information about Internet traffic on the system. The following are instructions to install ISAPI filters to an existing IIS installation. If IIS is not installed yet, the Web Server (IIS) should be installed as well.

  1. Open the Server Manager.

  2. In Server Manager, click the Manage menu, and then click Add Roles and Features.

  3. In the Add Roles and Features wizard, click Next. Select the installation type and click Next. Select the destination server and click Next.

  4. On the Server Roles page, expand Web Server (IIS), expand Web Server, expand Application Development, and then select ISAPI Filters and ISAPI Extensions. Click Next.

  5. On the Select features page, click Next.

  6. On the Confirm installation selections page, click Install.

  7. On the Results page, click Close.

If using Apache, download the 2.2.x binary for Windows from apache.org, (choose HTTP Server from left side). Install normally, accepting all prompts. Retain only supports version 2.2.x.

Once Apache and a SQL server are installed, the system is prepared to install Retain’s core components.

The install will complete the following tasks:

  • Java Development Kit 1.8 (JDK) will be checked/installed.

  • Retain Tomcat 7/8 and any existing Retain installation will be stopped.

  • Retain will be installed.

  • Retain Tomcat 8 is restarted and set to run as a system service.