Documentation Center

Configuring Apache Tomcat for an IETM

LiveContent S1000D provides its own custom HTTP server that can serve content across the Web, but you may want to use an application server such as Apache Tomcat for larger implementations with multiple concurrent viewers.

About this task

In the steps and code samples below, read the following italicized strings as follows:
  • For LiveContent\, read your LiveContent directory, which defaults to either %ProgramFiles%\XyEnterprise\LiveContent\ (on Windows) or to /opt/XyEnterprise/LiveContent/ (on Linux).
  • For LiveContentData\, read your LiveContent data directory, which defaults to either %HomePath%\LiveContentData\ (on Windows) or to /opt/XyEnterprise/LiveContentData/ (on Linux).

Procedure

  1. Open LiveContent\WEB-INF\web.xml for editing and specify the locations of your collection configuration file and your log4j configuration file, as indicated:
    <servlet>
      <servlet-name>wietmsd</servlet-name>
      <servlet-class>server.skxmlsrv</servlet-class>
      <init-param>
      <!-- Location of the configuration file -->
        <param-name>properties</param-name>
        <param-value>
          LiveContentData\collections\default\wietmsd_prg.xml
        </param-value>
        <!-- The <param-value/> value includes the collection name 
             of the sample data (default). You should substitute 
             the name of your collection. -->
      </init-param>
      <init-param>
        <!-- Location of the log4j configuration file -->
        <param-name>log4j-conf</param-name>
        <param-value>
          LiveContent\servlet-log4j.conf
        </param-value>
      </init-param>
    </servlet>
  2. Copy the JAR files.

    Copy all files from here:

    LiveContent\lib

    to here:

    LiveContent\WEB-INF\lib

  3. Map the publication data to a location that Tomcat can access.
    Examine the wietmsd.xml file to ensure that the following code block exists:
    <collection name="default">
      <configitem name="http_name">
        <value>IETMBooks3</value>
      </configitem>
    </collection>
    <!-- The <collection name="default"> element includes the 
         collection name of the sample data (default). 
         You should substitute the name of your collection. -->
  4. Navigate to the conf\ subfolder of your Apache Tomcat root folder, for example, Apache Software Foundation\Tomcat 8.0\conf\
  5. Open server.xml in this location for editing, and modify the docBase parameters:
    <Host>
         <Context docBase="LiveContent\" path="/servlets3"/>
         <Context
         docBase="LiveContent\templates\FullSupport\httpdocs\"
         path="/wietmsd3"/>
         <Context docBase="LiveContentData\publications\"
         path="/IETMBooks3"/>
    </Host>
  6. Stop the LiveContent S1000D server.
  7. Restart the LiveContent S1000D server by accessing the Windows Start menu and navigating to Programs > XyEnterprise > LiveContent > COLLECTION, where COLLECTION is the name of your collection.
  8. Stop and then restart the Apache Tomcat service.