Installing the Linux Tomcat bundle

In the Latitude Studio Linux Tomcat bundle version of Latitude Studio, Tomcat 6 is embedded.

Note: Among the data sources in your Latitude Studio application, you must always include a default data source. This data source is automatically assigned to all data-source-backed components when they are initially added to a page. Latitude Studio comes with a default.json file.

For details on configuring this data source to point to your server, see "Updating default.json and default-schema.json to point to your server".

To install the Latitude Studio Tomcat bundle:

  1. Extract Latitude_2.2.x_Endeca-portal.tgz to the directory of your choice.
  2. Extract the .war files from Latitude_2.2.x_Components.zip and place them into the endeca-portal/deploy directory. The .war files go in the root of endeca-portal/deploy. There should be no subdirectories.
    Note: This directory already contains themes, hooks, and layouts required by the portal. It is safe to overwrite these files with the versions in Latitude_2.2.x_Components.zip.
  3. If the environment variable CATALINA_HOME is already set, update it to point to your newly installed Tomcat directory.
  4. Make sure that the JAVA_HOME environment variable is set to point to a valid 1.6 JRE.
  5. To start the portal's Tomcat instance, run endeca-portal/tomcat-6.0.29/bin/startup.sh.
    Note: Server startup can take several minutes. You can follow the log messages to ascertain when the process is complete.
  6. To test that the application is running, go to the portal (http://localhost:8080/) in your browser. Log in using the following default credentials:
    Login: test@endeca.com
    Password: test
  7. Optionally, you can set up log4j logging. log4j provides configurable, Java-based logging in an open-source utility.
    Note: For more information about Latitude Studio logging, see the Latitude Studio User's Guide.
Related concepts
Getting Started with Latitude Studio
Other Latitude Studio Installation Tasks