Installing the Windows Tomcat bundle

This topic provides the steps for installing the Discovery Framework Windows 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. Unzip endeca-portal-<version>.zip to the directory of your choice. The Discovery Framework creates a directory called endeca-portal. For example, if you unzip into C:, the Discovery Framework installs into C:\endeca-portal.
  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. For example, set CATALINA_HOME=C:\path\to\endeca-portal\tomcat-6.0.18. (If you do not have these environment variables set, you can leave them un-set. )
  4. Install the Liferay license. The instructions for obtaining and installing the license are provided later in this section.
  5. Start the portal's Tomcat instance by running endeca-portal\tomcat-6.0.18\bin\startup.bat.
    Note: Server startup can take several minutes. You can follow the log messages to ascertain when the process is complete. Do not shut down the Tomcat window while the Discovery Framework is running.
  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 Chapter 4.