8 Starting and Stopping Oracle Identity Manager

This chapter describes how to start and stop Oracle Identity Manager, and how to access the Administrative and User Console. This chapter contains the following topics:

• Removing Backup xlconfig.xml Files After Starting or Restarting

• Starting Oracle Identity Manager

• Stopping Oracle Identity Manager

• Accessing the Administrative and User Console

• Using the Diagnostic Dashboard to Verify Installation

Important:

You must complete all post-installation steps in Chapter 7, "Postinstallation Configuration for Oracle Identity Manager and JBoss Application Server" before starting Oracle Identity Manager.

8.1 Removing Backup xlconfig.xml Files After Starting or Restarting

After you start any Oracle Identity Manager component for the first time, or after you change any passwords in the xlconfig.xml file, Oracle Identity Manager encrypts and saves the passwords. Oracle Identity Manager also creates a backup copy of the xlconfig.xml file before saving changes to the file. These backup files contain old passwords in plaintext. The backup file are named xlconfig.xml.x, where x is the latest available number, for example xlconfig.xml.0, xlconfig.xml.1, and so on.

Note:

You must remove these backup files after starting any Oracle Identity Manager component for the first time, or on restarting after changing any passwords in xlconfig.xml once you have established that the new password is working properly.

8.2 Starting Oracle Identity Manager

This section describes how to start Oracle Identity Manager on Microsoft Windows, UNIX.

To start Oracle Identity Manager:

1. Verify that your database is up and running.

2. Start Oracle Identity Manager by running one of the following scripts appropriate for your operating system. Running the Oracle Identity Manager start script also starts JBoss Application Server.

   On Microsoft Windows

   OIM_HOME\xellerate\bin\xlStartServer.bat

   On UNIX

   OIM_HOME/xellerate/bin/xlStartServer.sh

8.3 Stopping Oracle Identity Manager

To stop Oracle Identity Manager gracefully, you stop the JBoss Application Server by running one of the following scripts appropriate for your operating system.

On Microsoft Windows

JBOSS_HOME\bin\shutdown.bat -S

On UNIX

JBOSS_HOME/bin/shutdown.sh -S

8.4 Accessing the Administrative and User Console

After starting the JBoss Application Server and Oracle Identity Manager, you can access the Administrative and User Console.

To access the Administrative and User Console:

1. Browse to the following URL by using a Web browser:

   http://hostname:port/xlWebApp
   

   In this URL, hostname represents the name of the computer hosting the application server and port refers to the port on which the server is listening. The default port number for JBoss Application Server is 8080.

   Note:

   The application name, xlWebApp, is case-sensitive.

   For example:

   http://localhost:8080/xlWebApp
   

2. After the Oracle Identity Manager login page is displayed, log in with your user name and password.

8.5 Using the Diagnostic Dashboard to Verify Installation

The Diagnostic Dashboard verifies each component in your postinstallation environment by testing for:

• A trusted store

• Single Sign-On Configuration

• Messaging capability

• A task scheduler

• A Remote Manager

The Diagnostic Dashboard also checks for all supported versions of components along with their packaging.

Note:

See "Using the Diagnostic Dashboard" for more information.