36.3 Preparing Your Application Server for the Identity Applications

You should prepare Tomcat that will run the identity applications. For your convenience, NetIQ provides Apache Tomcat in the installation kit. For more information about using the applications in a cluster environment, also see Preparing a Cluster for the Identity Applications.

36.3.1 Preparing a Tomcat Environment

This section describes how to prepare an environment where you want to run the identity applications on Tomcat. The .iso for installing Identity Manager includes a program for installing Tomcat (and optionally PostgreSQL). For more information, see Section 28.0, Installing PostgreSQL and Tomcat.

You can use your own Tomcat installation program instead of using the convenience installer provided in the installation package. However, if you do use a different installation program, there are additional steps you must perform for Tomcat to function correctly with the Identity Applications.

Before you start the installation process, ensure that the versions of the components you are installing are supported with this version of the Identity Applications. For more information, see Prerequisites and Considerations for Installing the Identity Applications.

Install Apache Tomcat as a service on your server.

For more information, see Tomcat Setup.
Install the following components on the same server where you installed Tomcat.
- Java Runtime Environment (JRE): For more information, see the Java Platform Installation Guide.
- Apache ActiveMQ: For more information, see ActiveMQ.
- PostgreSQL: For more information, see PostgreSQL Manuals.
Copy the activemq-all-5.14 jar file to the TOMCAT_INSTALLED_HOME/lib folder for ActiveMQ.
Copy the following files to the TOMCAT_INSTALLED_HOME/lib folder for logging.
- log4j.jar
- log4j.properties
- tomcat-juli-adapters.jar
Set the following properties in the setenv.bat (Windows) or setenv.sh (Linux) file.
```
JAVA_HOME
JRE_HOME
PATH (set Java path)
JAVA_OPTS="-Xms1024m -Xmx1024m"
```
Create a user with the name novlua and create a group with the name novlua.

This allows you to run Tomcat as a non-root user. For more information, see A Guide To Apache Tomcat Linux Installation and Set-Up.
Make the novlua user and novlua group owners of the Tomcat files.
Copy the postgresql-9.4.1212jdbc42.jar file to the /TOMCAT_INSTALLED_HOME/lib folder.
(Conditional) In a cluster environment, open the server.xml file located by default in the /TOMCAT_INSTALLED_HOME/conf/ directory in the first node of the cluster and uncomment this line:

<Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"/>

Do this for all nodes in the cluster.

For advanced Tomcat clustering configuration, follow the steps from Apache Tomcat Documentation.

After you have installed Tomcat and the Identity Applications, you can tune Tomcat to function more effectively. For more information, see Post-Installation Steps.