Sun[TM] Identity Manager 8.0 Installation Guide |
Chapter 7
Installing Identity Manager for Oracle Application Server 10gUse the following information and procedures to install Identity Manager for use with the Oracle Application Server 10g Release 3. This chapter includes:
Before You BeginDuring installation, you will need to know:
Installation StepsFollow these installation and configuration steps, located in this chapter and following chapters:
Step 1: Install the Oracle Application Server Software
You may need to perform one or more of these general steps when installing the software:
Step 2: Install the Identity Manager Software
- You may install the software using one of two methods:
On UNIX systems, change directory to the software location. Enter the following command to activate the installer in nodisplay mode:
install -nodisplay
The installer displays the Welcome text. Click Next. The installer then presents a series of questions to gather installation information in the same order as the Graphic User Interface installer in these procedures.
- Click Next. The installer displays the Software License Agreement page. Read the agreement, then if you accept, click the Yes (Accept License) button. The installer displays the Install or Upgrade? panel.
- 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.
Note
If the directory you enter does not exist, Identity Manager prompts for confirmation, and then creates the directory.
- On the Ready to Install page, click Install Now to begin installation.
After installing the files, Identity Manager displays the Launch Setup panel.
Caution
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 Index Database Reference. When finished, click Launch Setup to launch the Setup Wizard and continue with setup steps.
A pop-up window will ask if you have copied all JAR files. If you have, click Yes, Continue.
If you click Launch Setup before copying your index database files, setup will not proceed correctly. If this happens, quit the installation program, and then use the lh setup command to restart the setup portion of the installation process.
- Click Next on the Sun Setup Wizard panel.
The installer displays the Locate the Repository panel.
- Select an index database from the list provided. Depending on your selection, setup prompts for additional setup information.
See Index Database Reference, for selections and setup instructions.
- Click Next.
- 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 19.
- 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:
- Enter the following Approver information:
- Click Next.
- 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.
- Click Next.
- 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 *
Getting More Information
When installation completes, the installer displays the Installation Summary panel. For detailed information about the installation, click Details.
Not all messages may not be displayed here. View the log file (identified in details) for more information.
When finished, click Close to exit the installer.
After completing installation, continue by optionally installing the Sun Identity Manager Gateway.
Step 3. Deploy Identity Manager into Oracle Application Server
Follow these steps to deploy the Identity Manager application into Oracle Application Server:
- Open a command prompt, then change to the staging directory where you installed the Identity Manager files. (This is the directory you specified in Step 4 in the procedure Step 2: Install the Identity Manager Software.)
- Create a .war file with the Identity Manager files by using the jar.exe (on Windows) or jar (on UNIX) command:
c:\java1.5\bin\jar.exe cvf ..\idm.war *
/usr/bin/jar cvf ../idm.war *- Launch your application server and log in to the Oracle Application Server Control Console.
- Navigate to the Cluster Topology page. Select View by Application Servers. Then select the OC4J name link.
- On the OC4J Home page, click the Applications link.
- Click the Deploy... button.
- In the Archive text box, enter the file path for the idm.war file.
- In the Deployment Plan section, select Automatically create a new deployment plan. Then click Next.
- When the Deploy: Application Attributes page displays, set the Application Name to idm. Set the Context Root to /idm, and then click Next.
- Set any Deployment Settings as necessary for your site.
- Click the Deploy button. The console displays a confirmation page when Identity Manager has been deployed.
Step 4. Install the Sun Identity Manager Gateway
If you plan to set up Windows Active Directory, Novell NetWare, Domino, Remedy, or RSA ACE/Server resources, you should install the Sun Identity Manager Gateway. Follow the procedures in Install the Sun Identity Manager Gateway.