[AIX Solaris HP-UX Linux Windows][z/OS]

Configuring Apache Tomcat servers

After you create a middleware server representation of an Apache Tomcat server, update the configuration settings to match your Apache Tomcat installation.

Before you begin

Federate the node that is running the Apache Tomcat server, and create a representation of the server.

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, you must configure the server operations for the Apache Tomcat middleware server representation.

Note: Intelligent Management support for using Apache Tomcat servers is stabilized. You can use the administrative console or wsadmin scripting to manage these servers.

Procedure

  1. Update the WebSphere variables so that they match the settings on the node that is running the Apache Tomcat server.
    • If you use wsadmin commands to edit the variables, follow the directions in the topic on modifying variables using wsadmin scripting.
    • If you use the administrative console to edit the variables, click Environment > WebSphere variables. Edit the variables.
    CATALINA_HOME
    Specifies the home directory of your Apache Tomcat installation.
    Default values are set at the cell scope level:
    [Windows]C:\Program Files\Apache Software Foundation\Tomcat
    [AIX HP-UX Solaris]/usr/local/apache-tomcat

    If the home directory is different on different nodes in your configuration, create the CATALINA_HOME variable for a 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 at the cell scope or at the node scope.
  2. Update server operations for the Tomcat server to include the user name and password so that you can start and stop server operations.
    • If you use the wsadmin scripting, follow the directions in the topic on starting the wsadmin scripting client using wsadmin scripting. The startMiddlewareServer command and the stopMiddlewareServer command require a user name and password to run.
    • If you use the administrative console, click Servers > Other middleware servers > Apache Tomcat servers > tomcat_server > Server operations. Edit the start and stop server operations to include the user name and password that are 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.
    • If you use wsadmin commands, run the modifyForeignServerProperty command to change the ports.
    • If you use the administrative console, click Servers > Other middleware servers > Apache Tomcat servers > tomcat_server. Edit HTTP connector or HTTPS connector. Click OK. Save and synchronize your changes.
  4. Optional: [AIX HP-UX Solaris]Disable security for the Tomcat server.
    By default, security is enabled when you create the server.
    If you want to create a Tomcat server that does not have security enabled, create a custom Tomcat server template. Read about creating middleware server templates.
    • Use the modifyForeignServerProperty command in the middleware server management administrative tasks to start the server without security.
    • If you use the administrative console, click Servers > Apache Tomcat servers > tomcat_server > Start. Remove the -security argument from the list of Executable arguments. Click OK. Save and synchronize your changes.

What to do next

  • To use this configuration when you are configuring your other Apache Tomcat servers, create a server template of your current Apache Tomcat server.
  • View the log files for your Apache Tomcat server on the computer that hosts it.
  • Edit configuration files for your Apache Tomcat server on the computer that hosts it.
  • After you create representations of all the Apache Tomcat servers, you can add the representations to a dynamic cluster.