Using Tomcat as Web Server for Netcool/Portal

Technote (FAQ)


Question

How do I configure Netcool/Portal to use Tomcat as the primary Web Server and eliminate the need for Apache?

Cause

Under various circumstances it may be necessary to disable or remove the dependency on Apache as the Web Server.

Answer

The default configuration of Netcool/Portal is to use Apache as the web server. Since Netcool/Portal already uses Tomcat as a JSP server, you can use Tomcat instead of Apache as the web server by reconfiguring as per the instructions below:

1. Edit The Server Host Configuration File


    1.1. Open the file [PORTAL_HOME]/config/hosts.properties in a text editor.


    1.2. Comment out the lines that define the host and port of the web server.

      Example:
        #hosts.web.0.host=localhost
        #hosts.web.0.port=8100

2. Edit The Tomcat Configuration

    2.1. Open the file [PORTAL_HOME]/httpd/jakarta-tomcat/conf/server-template.xml in a text editor.


    2.2. Comment out the following block of code in server-template.xml:

      <!--
        <Connector port="${hosts.jsp.${hosts.server.myindex}.port}"
        maxThreads="256" backlog="256"
        enableLookups="false" URIEncoding="UTF-8" protocol="AJP/1.3" />
      -->

    2.3. Determine the appropriate section of the file to activate based on the following questions:

      Is the Portal system using the HTTP or HTTPS protocol?

      Is Tomcat going to use the Http11Protocol connector or the Http11NioProtocol connector?


    2.4. Un-comment the appropriate section in server-template.xml

      There are 4 blocks of code, which you can locate by searching for "Connector port=". Un-comment one of the four blocks of code based on the protocol (HTTP/HTTPS) and Tomcat connector you identified above.


      Example (un-comment the following block for portal with HTTPS and Http11NioProtocol connector):


        <Connector port="8443"
          protocol="com.edgetech.eportal.connector.Http11NioProtocol"
          maxThreads="256" acceptCount="256" acceptorThreadCount="2"
          enableLookups="false" disableUploadTimeout="true"
          scheme="https" secure="true"
          keystoreFile="conf/ssl.crt/tomcat.crt"
          clientAuth="false" sslProtocol="TLS" />


    2.5. Replace the port number in the uncommented block with a variable that will insert the port number from the hosts.properties file.

      Example:
        <Connector port="8443"


      Change to:
        <Connector port="${hosts.jsp.${hosts.server.myindex}.port}"

    2.6. Note that the portal login page URL uses the JSP port number from the hosts.properties file.

      Example:
        Hosts.properties:
          hosts.jsp.0.host=localhost
          hosts.jsp.0.port=8200


        URL for Portal:
          [https]://hostname:8200


    2.7. Installing the SSL Certificate

      If the Portal system is using the HTTPS protocol, you must install a valid SSL certificate and make one additional configuration change.


      Perform the following steps to use Tomcat with the HTTPS protocol:


      a) Place the server certificate in the following location:

        [PORTAL_HOME]/httpd/jakarta-tomcat/conf/ssl.crt

        For information on generating and installing an SSL certificate, see the 'Related information' section below.


      b) Add the attribute SSLEnabled="true" to the Tomcat connector element.

        Example:

          <Connector port="8443"
            protocol="com.edgetech.eportal.connector.Http11NioProtocol"
            maxThreads="256" acceptCount="256" acceptorThreadCount="2"
            enableLookups="false" disableUploadTimeout="true"
            scheme="https" secure="true" SSLEnabled="true"
            keystoreFile="conf/ssl.crt/tomcat.crt"
            clientAuth="false" sslProtocol="TLS" />

Related information

Certify tomcat for SSL

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Netcool/Portal

Software version:

2.1.2

Operating system(s):

AIX, HP-UX, Linux, Solaris, Windows, Windows 2003 server

Software edition:

All Editions

Reference #:

1636847

Modified date:

2014-04-08

Translate my page

Machine Translation

Content navigation