Setting up the JSP reference implementation on Windows

While this section assumes that you use the Tomcat server, you can use other application servers.

1. Copy the reference implementation user interface directory %ENDECA_REFERENCE_DIR%\endeca_jspref into the C:\jakarta-tomcat-version\webapps directory. The %ENDECA_REFERENCE_DIR% variable is set as part of the Platform Services installation.
2. (Optional.) Navigate to C:\jakarta-tomcat-version\conf and open the server.xml file in a text editor. You can modify the file as follows:
   1. Change the port that Tomcat listens on for a shutdown command from its default of 8005:

      <Server port="8005" shutdown="SHUTDOWN">

   2. Change the Tomcat HTTP listening port from its default of 8080:

      <!-- Define a non-SSL Coyote HTTP/1.1 Connector on port 8080 --> 
      <Connector port="8080" ...

   3. Save and close the server.xml file.
3. If your version of Java requires it, make sure that the JAVA_HOME environment variable is set to the location of the Java SDK directory. For example, the location might be C:\j2sdk-version.
   Note: See the Tomcat documentation for more information about your version of the Tomcat server to check if it requires a JAVA_HOME environment variable.

   To set the JAVA_HOME environment variable:

   1. From the Windows Control Panel, select System.
   2. Go to the Advanced tab and select Environment Variables.
   3. In the System Properties section, locate and select JAVA_HOME.

      If JAVA_HOME does not exist, select New, and then in the Variable Name field, enter JAVA_HOME

   4. In the Variable Value field, enter the path of the Java SDK directory and click OK.
   5. Click OK to close the Environment Variables window.
   6. Click OK to close the System Properties window.
4. Copy the following Endeca files from the %ENDECA_ROOT%\lib\java directory to C:\jakarta-tomcat-version\webapps\endeca_jspref\WEB-INF\lib:
   • bcprov-jdk-version.jar
   • endeca_logging.jar
   • endeca_navigation.jar
   • rg.jar
   This enables Tomcat to access these files.
5. Start the Tomcat server. See the Tomcat documentation for specific instructions.