Appendix A Installing Identity Manager Manually

If you do not want to install Identity Manager through the installation interface, use these alternate, manual installation procedures.

Installation Steps

Follow these general installation and configuration steps:

• Step 1: Install the Application Server software

• Step 2: Install the Application Software

• Step 3: Configure the Identity Manager Database Connection

• Step 4: Install Optional Components

Step 1: Install the Application Server software

Refer to the installation chapters in Part II, Installing Identity Manager for information on installing and configuring specific application servers.

Step 2: Install the Application Software

Follow these steps to install the software.

On Windows

Enter the following series of commands:

set JAVA_HOME=Path to JDK
cd ApplicationDeploymentDirectory

where ApplicationDeploymentDirectory is the directory where your application server is deployed. For example, for a Tomcat installation, change directory to c:\tomcat-5.5.3\webapps.

mkdir idm (or any other directory name)
cd idm
set WSHOME=ApplicationDeploymentDirectory\idm
jar– xvf %CDPATH%\idm.war

Make sure the value of the WSHOME environment variable does NOT contain the following:

• Quotation marks (“ “)

• A backslash at the end of the path (\)

Do not use quotation marks, even if the path to the application deployment directory contains spaces.

ON UNIX

Enter the following series of commands:

PATH=$JAVA_HOME/bin:$PATH
cd $TOMCAT_HOME/webapps
cd ApplicationDeploymentDirectory

where ApplicationDeploymentDirectory is the directory where your application server is deployed. For example, for a Tomcat installation, change directory to /tomcat-5.5.3/webapps.

mkdir idm (or any other directory name)
cd idm
WSHOME=ApplicationDeploymentDirectory/idm;export WSHOME
jar– xvf /cdrom/cdrom0/idm.war

Change directory to $WSHOME/bin then set permissions on the files in the directory so that they are executable.

Step 3: Configure the Identity Manager Database Connection

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 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 the Appendix C, Database Reference.

The ServerRepository.xml file is an encrypted file that defines how to connect to the repository. Use one of the following procedures to configure the repository XML file.

To Configure the Repository XML file in Windows or Xwindows (UNIX) Environments

1. Enter one of the following commands to launch the setup interface.

   On Windows

   cd %WSHOME%\bin lh setup

   On UNIX

   cd $WSHOME/bin lh setup

   The installer displays a welcome page. Click Next to display the Locate the Repository panel.

2. Select a database from the list provided. Depending on your selection, setup prompts for additional setup information.

   Depending on your selection, setup prompts for additional setup information.

   ---

   Note –

   See Appendix C, Database Reference, for selections and setup instructions.

   ---

3. Click Next to display the Continue Identity Manager Demo Setup? panel. Follow all subsequent prompts as directed.

To Configure the Repository XML file in Non-Xwindows Environments

1. Set your repository with the following series of commands:

   cd $WSHOME/bin chmod 755 *

2. Run the setRepo command, using the appropriate location flags required to connect to the database.

   ---

   Note –

   For complete setRepo usage and options, see Appendix F, setRepo Reference.

   ---

3. Start the application server.

4. Load the initial database values. Follow these general steps:

   1. Log in to the Administrator Interface.

   2. From the menu bar, select Configure > Import Exchange File.

   3. Enter or browse for the init.xml file (located in the idm/sample directory), and then click Import.

Step 4: Install Optional Components

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.