Using the Pre-configured Apache Tomcat Installation

RTViewCentral includes a pre-configured Apache Tomcat installation which hosts all of the servlets necessary to run the Monitor on port 8068. However, it does not run by default. Instead, the CentralServer hosts all necessary servlets using Jetty on port 10070.

To use the pre-configured Tomcat instead of Jetty:

1. Open RTViewCentral\bin\start_servers.bat (Windows) or start_servers.sh (UNIX) in a text editor and uncomment the start_tomcat line.

2. The instructions in this document refer to the Jetty port, 10070. When following instructions, use the Tomcat port 8068 instead.

3. You can optionally change user names and passwords for the servlets hosted in Tomcat in RTViewCentral/apache-tomat*sl/conf/tomcat-users.xml. The user names and passwords in this file can be changed, but you cannot modify the roles as these are required by the servlets.

4. You can optionally disable Jetty or allow access via both Jetty and Tomcat. To disable Jetty, to the Configuration Application on Tomcat (http://localhost:8068/rtview-central-rtvadmin), go to the DataServer tab and turn off HTML Server Enabled. Save and RESTART SERVERS to apply your changes. Now the Configuration Application can only be accessed via Tomcat.

You can optionally Integrate LDAP with Tomcat and HTML UI.

Integrate LDAP with Tomcat and HTML UI

This section describes how to setup Tomcat so that you can log into RTView applications using your LDAP username and password and automatically associate that with an RTView role (for example, rtvadmin, rtvuser, and so forth). This feature uses Apache Tomcat’s built-in LDAP integration, the JNDI Realm.

To integrate LDAP with Tomcat and the HTML UI you edit two configuration files. Then, when a user logs into RTView, it is located in the directory and authenticated using the given password. Users can be located by a direct name-to-DN association or by searching for a specified attribute. You can search using the credentials of the given user or supply a connectionName and connectionPassword and search using those credentials.

After a user is authenticated, they are associated with an RTView role according to the entries in the rtview-roles.txt file. Users given the role:

• rtvuser will be able to log into the HTML UI.

• rtvadmin will be able to log into the Configuration Application.

• rtvalertmgr will be able to manage alerts.

Note that you must restart the Tomcat server after editing server.xml but it is not necessary to restart it after editing rtview-roles.txt.

To setup LDAP integration:

1. Open the server.xml file, located in the TOMCAT_HOME/conf directory.

2. Comment out this section:

<Realm className="org.apache.catalina.realm.UserDatabaseRealm" and uncomment the section <Realm className="org.apache.catalina.realm.RTViewJNDIRealm"

The result should look like this:



3. Specify your LDAP server connection information and other LDAP options.

4. Restart the Tomcat server.

5. Open the rtview-roles.txt file, located in the TOMCAT_HOME/conf directory, to specify your role-to-attribute mappings.

Refer to Tomcat JNDI Realm documentation for additional information and the following examples below.

Example 1

You have four users in a container named Users. You want to find them by name and associate each one with RTView roles. Tom needs the rtvadmin role. Nancy needs both the rtvadmin and rtvalertmgr roles. Joe and Susan need the rtvuser role. To set these up you edit the files as follows:

• In server.xml you include:

userPattern="CN={0},CN=Users,DC=mycompany,DC=com"

• In rtview-roles.txt you include:

rtvadmin:CN=Tom,CN=Users,DC=mycompany,DC=com

rtvadmin,rtvalertmgr:CN=Nancy,CN=Users,DC=mycompany,DC=com

rtvuser:CN=Joe,CN=Users,DC=mycompany,DC=com

rtvuser:CN=Susan,CN=Users,DC=mycompany,DC=com

Example 2

Your groups are in a container named Roles. You want any members of the Administrators group to get the rtvadmin and rtvuser roles. You also want any members of the Users group to get the rtvuser role. To set these up you edit the files as follows:

• In server.xml you include:

userPattern="CN={0},CN=Users,DC=mycompany,DC=com"

userRoleName="memberOf"

• In rtview-roles.txt you include:

rtvadmin,rtvuser:CN=Administrators,CN=Roles,DC=mycompany,DC=com

rtvuser:CN=Users,CN=Roles,DC=mycompany,DC=com

For additional details, refer to Apache Tomcat JNDI Realm documentation.

Proceed to Start RTViewCentral.