NOTE:The installation program requires the Java 2 Platform Standard Edition Development Kit version 1.5. If you use an earlier or later version, the installation procedure does not successfully configure the User Application WAR file. The installation appears to succeed, but you encounter errors when trying to start the User Application.
Navigate to the directory containing your installation files.
Launch the installer using the IBM Java environment, as shown below:
Solaris
$ /opt/WS/IBM/WebSphere/AppServer/java/bin/java -jar IdmUserApp.jar
Windows
C:\WS\IBM\WebSphere\AppServer\java\bin\java -jar IdmUserApp.jar
With WebSphere, you must use the IBM JDK that has the unrestricted policy files applied.
When the installation program launches, you are prompted for the language.
Use the following information along with the instructions on each installation panel to complete the installation:
Installation Screen |
Description |
---|---|
Novell Identity Manager |
Select the language for the installation program. The default is English. |
License Agreement |
Read the License Agreement, then select . |
Application Server Platform |
Select If the User Application WAR file is in a different directory from the installer, the installer prompts for the path to the WAR. If the WAR is in the default location, you can click . Or, to specify the location of the WAR file, click and select a location. |
Standard or Provisioning |
: Select this option if you are installing the User Application Standard Edition. : Select this option if you are installing the Roles Based Provisioning Module. |
Data Migration |
Accept the default (verify that is not selected).WARNING:Do not select , If Yes is selected, you will encounter problems starting the User Application.For information on migrating, see the User Application: Migration Guide. |
Where is the WAR? |
If the Identity Manager User Application WAR file is in a different directory from the installer, the installer prompts for the path to the WAR. |
Choose Install folder |
Specify where you want the installer to put the files. |
Database Platform |
Select the database platform. The database and JDBC driver must already be installed. Options include:
|
Java Install |
Specify the Java root install folder. NOTE:With WebSphere, you must use the IBM JDK that has the unrestricted policy files applied. |
IDM Configuration |
Specify the application context |
Audit Logging |
To enable logging, click . the next panel prompts you to specify the type of logging. Choose from the following options:
For more information on setting up Novell Audit or OpenXDAS logging, see the . |
Novell Audit |
: If you turn Novell Audit logging on, specify the hostname or IP address for the Novell Audit server. If you turn logging off, this value is ignored. : Specify the directory for the logging cache. |
Security - Master Key |
: Allows you to import an existing master key. If you choose to import an existing encrypted master key, cut and paste the key into the install procedure window. : Creates a new master key. After you finish the installation, you must manually record the master key. The installation procedure writes the encrypted master key to the master-key.txt file in the installation directory. Examples of reasons to import an existing master key include:
|
You are prompted for the information that the installation program uses to configure the User Application WAR file. (If you are not prompted for this information, you might not have completed the steps outlined in Section 2.5, Installing the Java Development Kit.
Use the following information to complete the panel and continue with the installation.
Installation Screen |
Description |
---|---|
User Application Configuration |
The User Application install enables you to set User Application configuration parameters. Most of these parameters are also editable with configupdate.sh or configupdate.bat after installation; exceptions are noted in the parameter descriptions. For more information, see Section A.0, IDM User Application Configuration Reference. |
Pre-Installation Summary |
Read the Pre-Install Summary page to verify your choices for the installation parameters. If necessary, use to return to earlier installation pages to change installation parameters.The User Application configuration page does not save values, so after you re-specify earlier pages in the installation, you must re-enter the User Application configuration values. When you are satisfied with your installation and configuration parameters, return to the Pre-Install Summary page and click . |
Install Complete |
Indicates that installation is finished. |
If your installation completed without error, continue with Section 5.2.1, Adding User Application Configuration Files and JVM System Properties.
If the installation issued errors or warnings, review the log files to determine the problems:
Identity_Manager_User_Application_InstallLog.log holds results of the basic installation tasks.
Novell-Custom-Install.log holds information about the User Application configuration done during installation.