Loading JBoss and MySQL with the IDM User Application

by in Security


The IDM User Application comes with a start-jboss.bat file that must be run in a console session in order to start application after restarting the server. That causes some painful moments ...

I already posted one tip which was based on my experience to load Jboss with Extend portal. Unfortunatelly that post lacked two points ...

  1. IDM only supports Java 1.4.2 (the tip recommended Java 1.5.0). See http://forums.novell.com/group/novell.support.identity-manager.userapp-workflow/message-index.tpt/@article@195.

  • The tip loaded the default instance of JBoss (the User App uses the IDM instance by default).


JBoss can be started as service with the JavaService program, downloadable from

A: Installation

1. Install UserApp. UserApp installs its own jre (1.4.2_08).

2. Configure Userapp with the following items:

  • LDAP directory

  • Admin

  • Base DN

  • Userapp driver

  • Userapp admin

  • User container

  • Groupcontainer (at this point, leave eDirectory certificates section as default)

  • Email host

3. Download the Java JDK 1.4.2 (currently used in this tip as 1.4.2_13):


4. Install the JDK to the default directory c:\j2sdk1.4.2_13 (or remember to use your install path in following steps).

B: Changing UserApp eDirectory Certificate Configuration

1. Run c:\novell\idm\configupdate.bat

2. Change the keystore path from c:\novell\idm\jre\lib\security\cacerts to c:\j2sdk1.4.2_13\jre\lib\security\cacerts, in order to use LDAPS connections with the new java.

C: Setting Up Windows Environment Variables

Javaservice needs environment variables to install correctly.

1. Right-click My Computer and choose Properties.

2. Go to Advanced > Enviroment Variables.

3. Select System Variables.

4. Add the variable JAVA_HOME with a value of "c:\j2sdk1.4.2_13".

5. Add the variable JBOSS_HOME with a value of "c:\novell\idm\jboss"

I restarted the server at this point.

Installing MySQL as a Service

1. Go to c:\novell\idm\mysql

2. Run "bin\mysqld -install MySQL". The default file is c:\novell\idm\mysql\my.ini

3. Start the mysql service: "net start mysql"

4. Set the service to start automatically.

E: Downloading javaservice and Running jbossinstall.bat

1. Download from http://force.objectweb.org/project/showfiles.php?group_id=137

2. Unzip to a directory of your choice.

3. Go to the command prompt for that directory.

4. Run "installjboss.bat MySQL -auto" (installs the service dependent on MySQL, and with autostart).

F: Editing the Jboss Service Parameter

1. Start Regedit. Remember that Regedit is dangerous tool if you don't know what you are doing!

2. Go to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\JBoss\Parameters.

3. In "Start Param Count", change the value from 0 to 1.

4. Add a new string value of "Start Param Number 0" and set the value to "-cIDM".

Optionally you can change the description of the Java service to better reflect what it's doing. For example:



Value: Novell IDM User Application - Uses Javaservice (http://javaservice.objectweb.org)

G: Starting the Services

1. Start MySQL.

2. Start Jboss.

Testing and Troubleshooting

Go to the User App page: http://ip:8080/IDM

If the User App page is displayed, everything is fine! If not, here are some tips for solving the problem:

  • If the services do not start, remove them and try reinstalling. Be sure to double-check the previous steps - I had a lot of difficulties installing Jboss java service because Java was not installed correctly.

  • Check the error log at c:\novell\idm\jboss\bin\out.log. If the Java service loads and Jboss starts to load, the error log can be used.

  • Go to http://ip:8080 ( http://ip:8080/ ) and verify that Jboss uses the IDM instance.
    Remember to unload User App that was loaded with the batch file before starting.


  • Java

  • Javaservice

  • Jboss