Chapter 6 Installing Identity Manager for JBoss

Use the following information and procedures to install Identity Manager for use with the JBoss application server. This chapter contains:

Before You Begin

Installation Steps

Before You Begin

The location where JBoss is installed

The login and password you selected when you set up the index database

Installation Steps

Step 1: Install the JBoss Software

Step 2: Install the Identity Manager Software

Step 3: Install the Sun Identity Manager Gateway

Step 1: Install the JBoss Software


Note	Steps in this chapter that outline JBoss installation are for general reference only. For detailed information about installing JBoss, refer to the Web page or reference information provided by the application server software provider.

Install the JBoss software according to the instructions provided by the application server provider. You may find helpful information at the JBoss Project site, at http://labs.jboss.com/portal/jbossas .

You may need to perform one or more of these general steps when installing the software:

Install the full JBoss application server.

Ensure that the JBoss installation path does not contain spaces.

Specify the administrator name and password for Application Server administration.

When configuring JBoss to support UTF-8, add the URIEncoding="UTF-8" attribute to the Connector element in the InstallDir\server\default\deploy\jbossweb-tomcat55.sar\server.xml file, for example:

<Connector port="17001" address="${jboss.bind.address}"
   maxThreads="250" strategy="ms" maxHttpHeaderSize="8192"
   emptySessionPath="true" enableLookups="false" redirectPort="8443"
   acceptCount="100" connectionTimeout="20000"
   disableUploadTimeout="true" URIEncoding="UTF-8" />

When configuring JBoss to support UTF-8, also add -Dfile.encoding=UTF-8 in your Java VM options.

Increase the JBoss PermGen space to avoid out-of-memory errors. For example, add the following arguments in your JAVA_OPTS environment variable to increase the space to 128 MB:

-XX:PermSize=128m -XX:MaxPermSize=128m

Step 2: Install the Identity Manager Software

Set the environment variables JAVA_HOME and WSHOME:

set JAVA_HOME=/PathTo/java
set WSHOME=Path To IDM Directory



Note	Make sure the value of the WSHOME environment variable does NOT contain the following: Quotation marks (“ “) A slash or backslash at the end of the path (/ or \) Do not use quotation marks, even if the path to the application deployment directory contains spaces.

You may install the software using one of two methods:

Using the installer Graphic User Interface

Run the install.bat (for Windows) or install (for UNIX) command to launch the installation process.

The installer displays the Welcome panel.

Using the nodisplay option (UNIX only)

Change directory to the Identity Manager software location. Enter the following command to activate the installer in nodisplay mode:

install -nodisplay

The installer displays the Welcome text. The installer then presents a list of questions to gather installation information in the same order as the Graphic User Interface installer in these procedures.



Note	If no display is present, the installer defaults to the nodisplay option. The DISPLAY environment variable must be set to a valid X server or the installation may fail.

Click Next to display 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 a staging directory. Enter the location (or click Browse to locate it), and then click Next.



Note	If the directory you enter does not exist, the installer prompts for confirmation, and then creates the directory.

Click Next to begin installation.

After installing files, the installer displays the Launch Setup panel.

Add the Java mail.jar and activation.jar files to the $WSHOME/WEB-INF/lib directory. These files can be found at:

http://java.sun.com/products/javamail

http://java.sun.com/products/beans/glasgow/jaf.html



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. If you are planning to use a Data Source as your repository location, see the special instructions in Configuring Data Sources for Identity Manager. When finished, click Launch Setup to launch the Setup Wizard and continue with setup steps. 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 Setup Wizard panel.

The product 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 21.

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:

First name

Last name

Email address



Note	This personal information is used to create the Approver user (with configurator privileges.)

Enter the following Approver information:

Approver name

Approver password

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.

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.

Create a .war file from WSHOME:

jar -cvf idm.war *

Copy the idm.war file to the JBoss deploy directory. (For example, InstallDir\server\default\deploy)

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 *

Step 3: 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.

Previous Contents Index Next
Sun[TM] Identity Manager 8.0 Installation Guide