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 and the JVM 1.6 are 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 variables CATALINA_HOME or JAVA_HOME are already set, update them to point to your newly installed Tomcat directory and a valid 1.6 JRE. (If the JAVA_HOME environment variable is not set, you must set it.)
  4. Start the portal's Tomcat instance by running endeca-portal/tomcat-6.0.18/bin/startup.sh.
    Note: Server startup can take several minutes. You can follow the log messages to ascertain when the process is complete.
  5. Upon first use, enter the license key, as described in the next topic.
  6. 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
  7. 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 Chapter 3.