Tomcat 6.x Configuration

Tomcat 6.x

 A pre-configured installation of Tomcat is available as part of the standard OpenIAM IDM distribution.  This instance of Tomcat can be found in the <install>/apache-tomcat-6.0.26 directory

Pre-requisites:

OpenIAM and the Tomcat web server require Java JDK (JSE) 1.6. Please download and install this JDK prior to installing the OpenIAM Identity Manager.  

Setting up Environment Variables

The following environment variables need to be defined.

+Windows:+Environment variables may be defined in Windows through the control panel. Alternatively, you may also update the startup.bat file for Tomcat to define these variables. The startup.bat file maybe found at apache-tomcat-6.0.20\bin.

• JAVA_HOME:

+Linux:+The following variables should be defined in the Tomcat startup scripts <enter the script name>:

• JAVA_HOME
• JAVA_OPTS

Setting up a Datasource

A datasource is necessary to communicate with a relational database such as Oracle, MySQL or SQL server.  Datasources are defined in the datasource.properties file that is found at

<install dir root>\apache-tomcat-6.0.35\lib.  The following parameters in the datasource.properties file need to defined:

• openiam.driver_url=jjdbc:mysql://localhost:3306/openiam?useUnicode=true&characterEncoding=UTF-8
• openiam.driver_classname=com.mysql.jdbc.Driver
• openiam.username=idmuser
• openiam.password=idmuser
• openiam.hibernate.dialect =org.hibernate.dialect.MySQLDialect 

• fetch.size=100 : Determines the number of records that are fetched. The default value is 100
• logSQL=false : Determines if SQL statements should be logged. By default the value is set to false. It should only be set to True for Debugging.

IDM Server Configuration Files

The following files should be updated to reflect your environment

• apache-tomcat-6.0.20\lib\securityconf.properties
  • MS_KEY_LOC: Location of they key file. For example: C:/appserver/apache-tomcat-6.0.35/iamconf
  • scriptRoot: Location of the script file.  Fore example: C:/appserver/apache-tomcat-6.0.35/iamscripts

Starting the Application Server

To start Tomcat, go to you <tomcat home>/bin directory and enter either one of the following commands:

• Windows: startup.bat
• Linux:     ./startup.sh

Accessing the Administration Console

• Open a browser such as Internet Explorer 7 or Firefox 3
• Go to http://<host name>:8080/webconsole/ .  Note that 8080 is the default port for Tomcat. If changed the port during configuration, then please use that new port.
• At the login prompt enter:
  • login id : sysadmin
  • password:  passwd00
• This is the default login for the system administrator.

 Accessing the Self Service Application

• Open a browser such as Internet Explorer 7 or Firefox 3
• Go to http://<host name>:8080/selfservice/  .  Note that 8080 is the default port for Tomcat.
• At the login prompt enter:
  • login id: snelson
  • password: passwd00

This is the default login for a test end user account.