Deploying and starting the Discovery Framework application

Once Tomcat configuration is complete, the Discovery Framework application can be deployed and started.

To deploy and start the Discovery Framework application:

  1. Delete the contents of the endeca-portal/apache-tomcat-5.5.x/webapps/ROOT directory. This directory contains the standard Web application that is installed with Tomcat by default. We will replace this standard web application with the Discovery Framework application in the next step.
  2. Unzip endeca-portal-<version>.war.zip into a temporary directory. This zip file contains the endeca-portal-<version>.war file and the copyright.txt file.
  3. Read the copyright.txt file and then save it to the location of your choice.
  4. Unzip the contents of endeca-portal-<version>.war into the endeca-portal/apache-tomcat-5.5.x/webapps/ROOT directory.
  5. Copy the portal-ext.properties file from the temporary directory you created for the endeca-portal-dependencies-<version>.zip file in step 4 to the endeca-portal directory.
  6. Edit the endeca-portal\portal-ext.properties file. Find the portal.ctx property at the beginning of portal-ext.properties. Change the value of this setting to be the same context root value you set earlier. However, do not include a trailing slash in the portal.ctx value. For example, use this value:
    portal.ctx=/mycompany/portal

    Do not use this value:

    portal.ctx=/mycompany/portal/
  7. Under the endeca-portal directory, create a data directory, and then create an endeca-data-sources directory below that.
  8. Create a data source to place in the endeca-portal/data/endeca-data-sources directory. For information about data sources, see the Discovery Framework Extension Guide. In addition, you can reference the sample data source files, which are located in the endeca-data-sources directory in the temporary directory you created for the endeca-portal-dependencies-<version>.zip file in a previous step.
  9. Start the portal's Tomcat instance by running endeca-portal\tomcat-5.5.x\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.
  10. 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
  11. Upon first use, enter the license key, as described in the following topic.