Installing the Linux Tomcat bundle

This topic provides the steps for installing the Discovery Framework Linux Tomcat bundle on your development server. In this version, Tomcat 6 is embedded.

Note: Among the data sources in your Discovery Framework 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. For details, see the topic "Specifying a default data source," located in the chapter "About data source configuration."

To install the Discovery Framework Tomcat bundle:

  1. Extract endeca-portal-<version>.tgz to the directory of your choice.
  2. Extract the .war files from components-<version>.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 components-<version>.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. Install the Liferay license. The instructions for obtaining and installing the license are provided later in this section.
  6. Start the portal's Tomcat instance by running 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.
  7. Go to the portal (http://localhost:8080/) in your browser, and log in using the following default credentials:
    Option Description
    Email address test@endeca.com
    Password test
  8. Optionally, you can set up log4j logging. log4j provides configurable, Java-based logging in an open-source utility.
    Note: For more information about Discovery Framework logging, see the Power User's Guide.