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
- 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
. Edit the variables.
- CATALINA_HOME
- Specifies the home directory of your Apache Tomcat installation.
- Default values are set at the cell scope level:
- C:\Program Files\Apache Software Foundation\Tomcat
- /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.
- 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 . Edit the start and stop server operations to
include the user name and password that are required to run these commands.
- 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 . Edit HTTP connector or HTTPS
connector. Click OK. Save and synchronize your changes.
- Optional: 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 . 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.