Setting up the JSP application on Windows

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

The JSP application depends on several paths related to the Tomcat Web server and Java SDK. This section assumes the following paths in your environment:

The location of the Tomcat installation

C:\jakarta-tomcat-version

The location of the Java SDK installation

C:\j2sdk-version

In the following procedures, adjust the paths as needed for your environment.

To set up the JSP application:

  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 file from the PresentationAPI\<version>\java\lib directory to C:\jakarta-tomcat-version\webapps\endeca_jspref\WEB-INF\lib:

  5. Copy the following file from the $ENDECA_ROOT/lib/java/ directory to C:\jakarta-tomcat-version\webapps\endeca_jspref\WEB-INF\lib:

  6. Copy the following Report Generator file from the %ENDECA_ROOT%\lib\java directory to C:\jakarta-tomcat-version\webapps\endeca_jspref\WEB-INF\lib:

  7. Start the Tomcat server. See the Tomcat documentation for specific instructions.

The JSP application is set up and you can now use it for diagnostics and debugging.

Copyright © Legal Notices