Novell Doc: Identity Manager Roles Based Provisioning Module 3.6.1 User Application: Installation Guide

2.3 Installing an Application Server

2.3.1 Installing the JBoss Application Server

If you plan to use the JBoss Application Server, you can either:

Download and install the JBoss Application Server according to manufacturer’s instructions. See Section 1.3, System Requirements for the supported version.
Use the JBossMySQL utility provided with the Roles Based Provisioning Module download to install a JBoss Application Server (and optionally MySQL). For directions, see Installing the JBoss Application Server and the MySQL Database.

Do not start the JBoss server until after you install the Identity Manager Roles Based Provisioning Module. Starting the JBoss server is a post-installation task.

Table 2-3 JBoss Application Server Minimum Recommended Requirements

Component	Recommendation
RAM	512 MB is the minimum recommended RAM for the JBoss Application Server when running the Identity Manager Roles Based Provisioning Module.
Port	8080 is the default for the application server. Record the port that your application server uses.
SSL	Enable SSL if you plan to use external password management: Enable SSL for the JBoss servers on which you deploy the Identity Manager Roles Based Provisioning Module and IDMPwdMgt.war file. Ensure that the SSL port is open on your firewall. For information on enabling SSL, see your JBoss documentation. For information on the IDMPwdMgt.war file, see Section 8.5, Configuring External Password Management and also see the User Application: Administration Guide.

Component

Recommendation

RAM

512 MB is the minimum recommended RAM for the JBoss Application Server when running the Identity Manager Roles Based Provisioning Module.

Port

8080 is the default for the application server. Record the port that your application server uses.

SSL

Enable SSL if you plan to use external password management:

Enable SSL for the JBoss servers on which you deploy the Identity Manager Roles Based Provisioning Module and IDMPwdMgt.war file.
Ensure that the SSL port is open on your firewall.

For information on enabling SSL, see your JBoss documentation.

For information on the IDMPwdMgt.war file, see Section 8.5, Configuring External Password Management and also see the User Application: Administration Guide.

Installing the JBoss Application Server and the MySQL Database

The JBossMySQL utility installs the JBoss Application Server and MySQL on your system. This utility does not support a console mode; it requires a graphical user interface environment. For Linux/Unix users, it is recommended that you install this as a non-root user.

Locate and execute JBossMySQL.bin or JBossMySQL.exe from the .iso.
- /linux/jboss/JBossMySQL.bin (for Linux)
- /nt/jboss/JBossMySQL.exe (for Windows)
The utility is not available for Solaris.

Follow the on-screen instructions for navigating the utility. Refer to the following table for additional information.

Installation Screen	Description
Choose Install Set	Choose which products to install. JBoss: Installs the JBoss Application server in the directory you specify along with scripts to start and stop it. NOTE:This utility does not install the JBoss Application Server as a Windows service. For directions, see Installing the JBoss Application Server as a Service or a Daemon. MySQL: Installs MySQL and creates a MySQL database in the directory you specify along with scripts to start and stop it.
Choose JBoss parent folder	Click Choose to select an installation folder other than the default.
Choose MySQL parent folder	Click Choose to select an installation folder other than the default.
MySQL Info	Specify the following: Database Name: Specify the name of the database for the installer to create. You are prompted for this name by the User Application installation utility, so you should make a note of the name and location. ‘root’ user password (and confirm password): Specify the root password (and confirm it) for this database.
PreInstallation Summary	Review the Summary page. If the specifications are correct, click Install.

The utility displays a successful-completion message after it installs the products you selected. If you installed the MySQL database, continue to Section 2.4.1, Configuring a MySQL Database.

Installing the JBoss Application Server as a Service or a Daemon

To start JBoss Application as a daemon, see the instructions from JBoss.

Using a JavaServiceWrapper You can use a JavaServiceWrapper to install, start, and stop the JBoss Application Server as a Windows service or Linux or UNIX daemon process. See directions from JBoss at http://wiki.jboss.org/wiki/Wiki.jsp?page=RunJBossAsAServiceOnWindows.One such wrapper is at http://wrapper.tanukisoftware.org/doc/english/integrate-simple-win.html: manage it by JMX (see http://wrapper.tanukisoftware.org/doc/english/jmx.html#jboss).

IMPORTANT:For previous versions, you could use a third-party utility such as JavaService to install, start, and stop the JBoss Application Server as a Windows service, but JBoss no longer recommends using JavaService. For details, see http://wiki.jboss.org/wiki/Wiki.jsp?page=JavaService.

2.3.2 Installing the WebLogic Application Server

If you plan to use the WebLogic Application Server 10, download and install it. See Section 1.3, System Requirements for information about the supported versions.

2.3.3 Installing the WebSphere Application Server

If you plan to use the WebSphere Application Server 6.1, download and install it. See Section 1.3, System Requirements for information about the supported versions.