# 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.