Installing Integrator Server on Tomcat

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

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

Sun Java SDK Version 1.6.x 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.

Download the Oracle Endeca Integrator Server for Tomcat package from the Oracle Software Delivery Cloud.

To install Integrator 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. Copy the clover-license.war and clover.war files to the Tomcat webapps directory.
  4. 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.

  5. Restart Tomcat.
  6. To verify that the Integrator 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.
  7. Start a browser, and then enter the Integrator Server home page URL: http://localhost:8080/clover.

    The browser should return the Integrator Server home page.

  8. To log in to the Integrator 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 Server is running, you can access the Reference Manual from either the Integrator 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 Server Guide provides comprehensive documentation on the operations available in Integrator Server.