Installing on Tomcat

Integrator ETL Server is supported on Apache Tomcat version 6.0.x.

Integrator ETL Server must be installed on a standalone Apache Tomcat. Do not install Integrator ETL Server on a Tomcat server that is being used to host other applications. For example, do not install Integrator ETL Server on the Tomcat that is hosting Studio.

Java SDK version 7 or 8 is required.

Set the following environment variables:
  • JAVA_HOME
  • JRE_HOME
    Note: If JRE_HOME is not set, the value defaults to the value of the JAVA_HOME environment variable.

To install Integrator ETL Server:

  1. If you have not already installed Apache Tomcat 6.0.x:
    1. Download the binary distribution from: http://tomcat.apache.org/download-60.cgi.
    2. Unpack the ZIP file to a directory of your choosing.
    3. By default, Tomcat starts up on HTTP connector 8080. If another application on the install machine is already using port 8080 (for example, if you have another instance of Tomcat on the machine), then change the default startup port by modifying the conf/server.xml file.
    4. Run Tomcat with the startup.sh (for Linux) or startup.bat (for Windows) program file in the Tomcat bin directory.
    5. Use a browser to check whether Tomcat is running on URL http://localhost:8080, where 8080 is the Tomcat port specified in conf/server.xml.
      If Tomcat is running properly and you specified the correct port, the browser displays the Tomcat homepage.

    For more detailed installation instructions, go to: http://tomcat.apache.org/tomcat-6.0-doc/setup.html

    For instructions on installing Tomcat as a Windows service, go to: http://tomcat.apache.org/tomcat-6.0-doc/windows-service-howto.html

  2. Shut down Tomcat.
  3. Extract the Integrator ETL installation package for Tomcat (EID_3.2.0_IntegratorETL_server_tomcat.zip) to a convenient location.
  4. Go to the directory you extracted the installation package to and copy the clover-license.war and clover.war files to the Tomcat webapps directory.
  5. Create a setenv file and configure the Tomcat memory settings appropriate for your needs.

    For details on creating this file, see Creating a setenv file.

  6. Restart Tomcat.
  7. To verify that the Integrator ETL Server license was successfully deployed, start a browser and enter the URL http://localhost:8080/clover-license, where 8080 is the Tomcat port specified in conf/server.xml.
    The browser should show this light-weight page: 
    This webapp runs on context /clover-license, which is correct.
  8. Start a browser, and then enter the Integrator ETL Server home page URL: http://localhost:8080/clover.

    The browser should return the Integrator ETL Server home page.

  9. To log in to the Integrator ETL Server:
    1. Click Log in to Server Administration.
    2. At the Access Server GUI page, enter clover as both the Username and Password, and then click the Login button.
When the Integrator ETL Server is running, you can access the Reference Manual from either the Integrator ETL Server home page or via this URL: 
http://localhost:8080/clover/docs/index.html
where 8080 is the Tomcat port specified in conf/server.xml.

The Integrator ETL Server Guide provides comprehensive documentation on the operations available in Integrator ETL Server.