Skip to end of metadata
Comment: Migrated to Confluence 4.0
Go to start of metadata

Tomcat 6.x

 A pre-configured installation of Tomcat is available as part of the standard OpenIAM IDM distribution of the Community Edition. This instance of Tomcat can be found in the <install>/apache-tomcat-6.0.20 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.20\lib.  The following parameters in the datasource.properties file need to defined:

  • openiam.driver_url=jdbc:mysql://localhost:3306/openiam
  • openiam.driver_classname=com.mysql.jdbc.Driver
  • openiam.username=idmuser
  • openiam.password=idmuser
  • openiam.hibernate.dialect  : Should point to the class that supports your database. For example, MySQL have the following dialect class: org.hibernate.dialect.MySQLDialect  For Oracle the dialect would be: org.hibernate.dialect.Oracle10gDialect
  • 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.20/iamconf
    • scriptRoot
    • USER_PROPFILE_LOC

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. 

Labels:
None
Edit Labels