If you do not want to install the applications through the installation interface, use these alternate, manual installation procedures.
Before You Begin
Before beginning installation, you need to know your application license key. The key was provided with the installation CD.
Installation Steps
Follow these general installation and configuration steps, located in this appendix and other chapters:
- Step 1: Install and configure the application server software
- Step 2: Install the Identity Install Pack software
- Step 3: Configure the Identity Install Pack index database connection
- Step 4: Install the Sun Identity Manager Gateway [optional] Note The application server installation and configuration process differs by type. Refer to previous application server-specific installation chapters for more information on their installation and configuration.
The procedures in this section begin with Step 2, Install the Application Software.
Step 2: Install the Application Software
Follow these procedures 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-3.2.3\webapps.
mkdir idm [or any other directory name]
cd idm
set WSHOME=ApplicationDeploymentDirectory\idm
jar –xvf %CDPATH%\idm.war
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 c:\tomcat-3.2.3\webapps.
mkdir idm [or any other directory name]
cd idm
WSHOME=ApplicationDeploymentDirectory/idm;export WSHOME
jar –xvf /cdrom/cdrom0/idm.war
Before You Continue
If you plan to use an index 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 , .
When finished, continue with Step 3.
Step 3: Configure the Identity Install Pack Index Database Connection
The ServerRepository.xml file is an encrypted file that defines how to connect to the index repository. Use one of the following procedures to configure the repository XML file.
Windows or Xwindows [UNIX] Environments
If you are running on Windows or in an Xwindows-capable environment:
- Enter one of the following commands to launch the setup interface.
cd %WSHOME%\bin
lh setup
cd $WSHOME/bin
lh setup
The installer displays the Locate the Repository panel.
- Select an index database:
- Click Import from File to import your license key data from an XML file.
- The installer displays the Import XML Files panel.
- Accept the default XML file [$WSHOME\sample\init.xml], or enter or browse to the path to the XML file you will use to set initial database values. When finished, click Import File.
- When import completes, click Done in the setup panel.
The installer displays the License Key panel.
Non-Xwindows Environments
If you are not running in an Xwindows-capable environment, follow these steps.
- Set your index repository with the following series of commands:
- Run the setRepo command, using the appropriate location flags required to connect to the database. Note For complete setRepo usage and options, see , .
- Set your license key with the following commands:
- Start the application server.
- Load the initial database values. Follow these general steps:
- Log in to the administrator interface.
- From the menu bar, select ConfigureImport Exchange File.
- Enter or browse for the init.xml file [located in the idm\sample directory], and then click Import.
cd $WSHOME/bin
chmod 755 *
cd idm\bin
lh license set -f LicenseKeyFile
Step 4: Install the Sun Identity Manager Gateway
If you plan to set up Windows 2000, Novell NetWare, or RSA ACE/Server resources, you should install the Sun Identity Manager Gateway. Follow the procedures in , .