Follow these steps to install Identity Manager on the Apache Tomcat application server.
If you are installing multiple instances of Identity Manager on a single application server, change the waveset.serverId system property to a unique name for each Identity Manager instance. See Setting the waveset.serverId System Property for more information.
You may install the software using one of two methods:
Using the installer Graphic User Interface
If you copy the files from the installation media to your own location, note that the idm.war and install.class files must be in the same directory.
The installer displays the Welcome panel.
Using the nodisplay option (UNIX only)
Change to the directory where the Identity Manager software is located. Enter the following command to activate the installer in nodisplay mode:
The installer displays the Welcome text. The installer then presents a list of questions to gather installation information in the same order as the Graphic User Interface installer in these procedures.
If no display is present, the installer defaults to the nodisplay option. The DISPLAY environment variable must be set to a valid X server or the installation may fail.
The Install or Upgrade? panel opens.
Leave the New Installation option selected, and then click Next.
The installer displays the Select Installation Directory panel.
Replace the displayed directory location with the location where you want to install Identity Manager. This could be a staging location or a specific folder. Enter the location (or click Browse to locate it), and then click Next.
Unless you plan to create a new context (virtual directory) in Tomcat’s server.xml directory, Sun recommends installing to %TOMCAT_HOME%/webapps/idm.
If the directory you enter does not exist, the installer prompts for confirmation, and then creates the directory.
Click Next to begin installation.
After installing files, the installer displays the Launch Setup panel.
Add the Java mail.jar, activation.jar, and jms.jar files to the $WSHOME/WEB-INF/lib directory (UNIX), or the %WSHOME%\WEB-INF\lib directory (Windows). These files can be found at:
To get the latest jms.jar file, download and install Sun Java System Message Queue. The jms.jar file is located in the MessageQueue/lib folder in the base Message Queue directory.
Before you continue, if you plan to use a database, you may need to copy one or more files to the idm/WEB-INF/lib directory. For example, you may need to place into idm/WEB-INF/lib a JAR file containing a JDBC driver (for a DriverManager connection) or a JAR file containing a JNDI InitialContextFactory (for a DataSource connection). To determine the steps you may need to perform before you go on, see Appendix C, Database Reference.
When finished, click Launch Setup to launch the Setup Wizard and continue with setup steps. If you click Launch Setup before copying your database files, setup will not proceed correctly. If this happens, uninstall Identity Manager and repeat these installation steps.
Click Next on the Setup Wizard panel.
The product displays the Locate the Repository panel.
Select a database from the list provided. Depending on your selection, setup prompts for additional setup information.
See Appendix C, Database Reference, for selections and setup instructions.
The Continue Identity Manager Demo Setup? panel appears.
If this is a non-demo installation, click No, I will configure Identity Manager myself. Go to Step 1: Install the Identity Manager Software.
If appropriate, click Yes, I would like to continue setting up a demonstration environment.
This allows you to quickly configure users and enter environment and server information.
Enter the following personal information:
This personal information is used to create the Approver user (with configurator privileges.)
Enter the following Approver information:
Select the Server Type from the list.
Select None if your environment has no server to manage. If there is a server you wish to manage, select the appropriate server type. You will be prompted for further server information as appropriate.
If you have an email SMTP server, click SMTP Host and enter the server address. If desired, click Test Server to verify communication to the SMTP server.
If you would like email notifications to be written to a file, click Notification File. Click Browse to select another notification file.
The installer displays the Import Save Configuration panel.
Click Execute to perform all the listed functions. If desired, click Hide Details.
When all functions complete, click Done in the setup panel.
If the application server is installed on a UNIX machine, change directories to the $WSHOME/bin directory and run the following command to allow the scripts in this directory to be executed.
chmod -R +x *
When installation completes, the installer displays the Installation Summary panel. For detailed information about the installation, click Details.
Some messages may not be displayed here. View the log file (identified in details) for more information.
When finished, click Close to exit the installer.
If you are installing multiple instances of Identity Manager on a single application server, change the waveset.serverId system property to a unique name for each Identity Manager instance. You do not need to update the waveset.serverId property otherwise.
By default, the waveset.serverId property is set to the name of the machine the application server is installed on.
Log on to the Administrator user interface. See To Start Identity Manager and Log in to the User Interface for instructions.
In the menu click Configure > Servers.
Verify that the host names that you configured for your instances appear and are listed as active.
If your IT environment has Windows Active Directory, Novell NetWare, Domino, Remedy, or RSA ACE/Server resources, you should install the Identity Manager Gateway.
If your IT environment has Windows Active Directory domains, you should also install PasswordSync. The Identity Manager PasswordSync feature keeps user password changes made on Windows Active Directory domains synchronized with other resources defined in Identity Manager.
See Part III, Installing Optional Components for installation information.