5.2 Installation and Configuration

Once you’ve installed all of the necessary prerequisite software and made sure your computer is properly set up, you can install the User Application. The order that you perform these tasks is important.

  1. Register the User Application driver with a given driver set. Do not turn it on yet. This step creates new objects in the Identity Vault with default data values (for some).

    This step fails if you have not already installed Identity Manager. For more information, see Section 5.3, Creating the User Application Driver.

  2. Run the User Application installation program. For more information, see Section 5.4, Installing the User Application.

  3. Start your database. The default install leaves MySQL running.

    If you chose the default install, the installer starts MySQL for you automatically. However, after a reboot, use the start-mysql.sh script (on Linux) or the start-mysql.bat (on Windows). It is located in mysql directory of your installation folder.

  4. Start JBoss. When you use the User Application installer to install the JBoss application server, it provides a set of startup and shutdown scripts. They are located in the installation /idm directory. For example,

    On Linux:

    /idm/start-jboss.sh
    

    On Windows:

    \idm\start-jboss.bat
    

    This is the recommended way to start JBoss.

    • If you are using an existing JBoss application server then you cannot use these scripts and you need to do one of the following to avoid trusted certificate errors.

    • Make sure that the JAVA_HOME points to the JRE installed by the User Application install program.

    Or

    • Change the keystore path value to point to the keystore for your existing JBoss install. The Identity Vault certificate will be downloaded to this location during the User Application install.

  5. Turn on the User Application driver. This enables communication between the User Application and the driver. To turn on the User Application Driver:

    1. Log into iManager.

    2. In Roles and Tasks (left navigation frame), open the Identity Manager heading and select Identity Manager Overview.

    3. In the content view that appears, specify the driver set that contains the User Application driver, then click Search.

    4. A graphic appears, showing the driver set with its associated drivers. Click the minus sign in the red circular area at the upper right of the User Application Driver icon to turn the driver on.

    NOTE:The driver, upon starting, attempts a handshake with the User Application If JBoss isn’t running or the WAR wasn’t successfully deployed, the driver errors out.

  6. Launch and log in to the User Application. Using your web browser, go to:

    http://hostname:port/ApplicationName

    where hostname:port is the JBoss application server ApplicationName is IDM by default. You specified the application name during the install when providing JBoss configuration information. The Novell Identity Manager User Application home page should appear. In the upper right corner of that page, click Login to log in to the User Application.