Configuring Apache Tomcat servers

After you create a middleware server representation of an Apache Tomcat server in the administrative console, you must update a few configuration settings so that they are defined specifically for your Apache Tomcat installation.

Before you begin

Federate the node that is running the Apache Tomcat server and create a representation of the server in the administrative console.

About this task

If you installed Apache Tomcat in a location other than the default directory, update the WebSphere® variables so that the installation directory is correct. To perform server operations on your server from the administrative console, you must configure the server operations for the Apache Tomcat middleware server representation.

Procedure

  1. Update the WebSphere variables so that they match the settings on the node that is running the Apache Tomcat server. In the administrative console, click Environment > WebSphere Variables. Edit the following variables:
    CATALINA_HOME
    Specifies the home directory of your Apache Tomcat installation.
    Default values are set at the cell scope level:
    [For Windows operating system] C:\Program Files\Apache Software Foundation\Tomcat
    [For Unix operating system] /usr/local/apache-tomcat

    If the home directory is different on different nodes in your configuration, select the node scope and create the CATALINA_HOME variable for the specific node.

    JAVA_HOME
    Specifies the directory of your Java Development Kit (JDK) installation.
    If the JAVA_HOME variable is not set in the environment of the node, define the JAVA_HOME variable in the administrative console at the cell scope or at the node scope.
  2. Update server operations for the Tomcat server to include the user name and password.
    1. In the administrative console, click Servers > Other middleware servers > Apache Tomcat servers > tomcat_server > Server operations.
    2. Edit the start and stop server operations to include the user name and password that is required to run these commands.
  3. Optional: Update the HTTP and HTTPS ports for your servers. The default port is 8080. If you use a value other than the default, you must change the port in the administrative console.
    1. In the administrative console, click Servers > Other middleware servers > Apache Tomcat servers > tomcat_server.
    2. Edit HTTP connector or HTTPS connector. Click OK and save and synchronize your changes.
  4. [For Unix operating system] Optional: Disable security for the Tomcat server. By default, the -security argument is enabled when you create the server. If you want to start the server without security, you must remove the -security argument in the administrative console.
    1. In the administrative console, click Servers > Apache Tomcat servers > tomcat_server > Start.
    2. Remove the -security argument from the list of Executable arguments. Click OK, and save and synchronize your changes.
    If you want to create a new Tomcat server that does not have security enabled, you must create a custom Tomcat server template. See Creating middleware server templates for more information.

What to do next


The URL for this topic is: