Sun Java logo     Previous      Contents      Next     

Sun logo
Sun Java System Identity Pack 2005Q4M3 Installation  

15

Installing The Applications (Manual Installation)

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:

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

Note  If you re-license the product you must import update.xml again. This will insure that you get all the objects for the products which are licensed to you.

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 Appendix A, Index Database Reference.

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:

  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 the Locate the Repository panel.

  1. Select an index database:
    • Oracle (JDBC Driver)
    • Oracle (Data Source)
    • MySQL (JDBC Driver)
    • MySQL (Data Source)
    • DB2 (JDBC Driver)
    • DB2 (Data Source)
    • SQL Server (JDBC Driver)
    • SQL Server (Data Source)
    • LocalFiles

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

      Note  See Appendix A, Index Database Reference, for selections and setup instructions.

  2. Click Next.

    3. The installer displays the License Key panel.

  3. Click Import from File to import your license key data from an XML file.
  4. Click Next.
  5. The installer displays the Import XML Files panel.
  6. 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.
  7. When import completes, click Done in the setup panel.

Non-Xwindows Environments

If you are not running in an Xwindows-capable environment, follow these steps.

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

    2. cd $WSHOME/bin
    chmod 755 *

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

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

  3. Set your license key with the following commands:

    4. cd idm\bin
    lh license set -f LicenseKeyFile

  4. Start the application server.
  5. Load the initial database values. Follow these general steps:
    1. Log in to the administrator interface.
    2. From the menu bar, select ConfigureImport Exchange File.
    3. Enter or browse for the init.xml file (located in the idm\sample directory), and then click Import.

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 Chapter 11, Install the Sun Identity Manager Gateway.



Previous      Contents      Next     

Copyright 2006 Sun Microsystems, Inc. All rights reserved.