Preparing to Customize the Administrative and User Console

Purpose

This OBE tutorial describes and shows you how to prepare Oracle Identity Manager to customize its Administrative and User Console.

Time to Complete

Approximately 1 hour

Topics

This OBE tutorial covers the following topics:

 Overview
 Scenario
 Prerequisites
 Modifying the global-web-application.xml and orion-web.xml Files
 Modifying the server.xml File
 Transferring the _oracle_jsp_xlWebApp.jar File
 Clearing Content from the Web browser Cache
 Summary
 Related Information

Viewing Screenshots

 Place the cursor over this icon to load and view all the screenshots for this tutorial. (Caution: Because this action loads all screenshots simultaneously, response time may be slow depending on your Internet connection.)

Note: Alternatively, you can place the cursor over each individual icon in the following steps to load and view only the screenshot associated with that step.

The screenshots will not reflect the specific environment you are using. They are provided to give you an idea of where to locate specific functionality in Oracle Identity Manager.

Overview

Oracle Identity Manager is a component of the suite of Oracle Identity and Access Management products. It administers and selectively automates tasks to manage user access privileges across a company’s resources throughout the identity management life cycle. Specifically, Oracle Identity Manager handles tasks for creating user access privileges, modifying these privileges dynamically (based on changes to user and business requirements), and removing user access privileges. As a result, Oracle Identity Manager handles user identity information across multiple identity data stores to maintain data accuracy.

Features and benefits of Oracle Identity Manager include identity and role administration (user and group management, self-service functionalities for users, and delegated administration), provisioning (approval and request management, and configurable workflow models), policy-based entitlements, reconciliation, and attestation support (for audit, regulatory, and compliance purposes).

Back to Topic List

Scenario

Linda works as a network administrator for Mydo Main Corporation. She is responsible for performing identity and access management tasks on users within the company. One such task is customizing the Administrative and User Console for the Oracle Identity Manager environment installed and configured for Mydo Main. By doing so, she can tailor this console to meet her company's requirements.

However, before Linda can customize the Administrative and User Console, she must configure her company's Oracle Identity Manager environment so that this console can be modified. This includes:

In this OBE, Linda prepares to customize the Oracle Identity Manager Administrative and User Console for Mydo Main Corporation.

Back to Topic List

Prerequisites

Before starting this tutorial, you should complete the OBE titled Installing, Configuring, and Launching Oracle Identity Manager.

Back to Topic List

Modifying the global-web-application.xml and orion-web.xml Files

Linda works as a network administrator for Mydo Main Corporation, responsible for customizing the Administrative and User Console for her company's Oracle Identity Manager environment.

Before Linda can customize the Administrative and User Console, she must configure her company's Oracle Identity Manager environment so that this console can be modified. This includes changing the value of the main_mode parameter for the global-web-application.xml and orion-web.xml files (from justrun to recompile). As a result, whenever a file for customizing the Administrative and User Console is modified, Oracle Identity Manager recompiles the file so that the modification appears in the console.

To modify the global-web-application.xml and orion-web.xml files, perform the following steps:

1.

Shut down the Oracle Identity Manager Server, Administrative and User Console, and Design Console.

 

2.

Using a text editor, open the global-web-application.xml file (found in the C:\product\10.1.3.1\OracleAS_1\j2ee\home\config directory).

 

3.

In this file, locate the following piece of code:

<param-name>main_mode</param-name>

 

4.

Remove the comment tags that precede and follow the <init-param> and </init-param> tags (that is, the <!-- and --> tags).

 

5.

Change the value of the main_mode parameter (from justrun to recompile).

 

6.

Save and close the global-web-application.xml file.

 

7.

Using a text editor, open the orion-web.xml file (found in the C:\product\10.1.3.1\OracleAS_1\j2ee\home\applications\Xellerate\xlWebApp\WEB-INF directory).

 

8.

In this file, locate the following piece of code:

main-mode=”justrun”

 

9.

Change the value of the main-mode parameter (from justrun to recompile).

 

10.

Save and close the orion-web.xml file.

Linda modified the the global-web-application.xml and orion-web.xml files. She is ready to modify the server.xml file.

 

Back to Topic List

Modifying the server.xml File

Linda is ready to modify the server.xml file. Specifically, she is to change the value of the file's check_for_updates parameter (from adminClientOnly to all). By doing so, Oracle Identity Manager polls its application server (Oracle Application Server) for changes to files associated with the Administrative and User Console. If it discovers files are modified, based on a file’s date-and-time stamp, these files are compiled, and the resultant modifications appear in the console.

To modify the server .xml file, perform the following steps:

1.

Using a text editor, open the server.xml file (found in the C:\product\10.1.3.1\OracleAS_1\j2ee\home\config directory).

 

2.

In this file, locate the following piece of code:

check-for-updates=”adminClientOnly”

 

3.

Change the value of the check-for-updates parameter (from adminClientOnly to all).

 

4.

Save and close the server.xml file.

Linda modified the the server.xml file. She is ready to copy the _oracle_jsp_xlWebApp.jar file to the Desktop.

 

Back to Topic List

Transferring the _oracle_jsp_xlWebApp.jar File

Linda is ready to copy the _oracle_jsp_xlWebApp.jar file to the Desktop. This is a precautionary step to recover files associated with the Administrative and User Console if a problem occurs from editing them.

To transfer the _oracle_jsp_xlWebApp.jar file, perform the following steps:

1.

Copy the _oracle_jsp_xlWebApp.jar file, located in the C:\product\10.1.3.1\OracleAS_1\j2ee\home\ applications\Xellerate\xlWebApp\WEB-INF\lib directory.

 

2.

Paste this file into the C:\Documents and Settings\All Users\Desktop directory.

Linda copied the _oracle_jsp_xlWebApp.jar file to the Desktop. She is ready to clear the Web browser cache for the Administrative and User Console.

 

Back to Topic List

Clearing Content from the Web Browser Cache

Linda is ready to clear content from the Web browser cache for the Administrative and User Console. As a result, when she modifies files to customize this console, the associated modifications appear in the console.

To clear content from the Web browser cache, perform the following steps:

1.

Open a Mozilla Firefox Web browser.

 

2.

From the Web browser's Menu Bar, select Tools > Options.

 

3.

On the Options window’s Toolbar, click the Privacy button.

 

4.

Populate the Private Data region of the Options window, as follows (and click OK):

Field Name Field Value
“Always clear my private data when I close Firefox” check box [selected]
“Ask me before clearing private data” check box [cleared]

The Mozilla Firefox Web browser is active.

Linda cleared the Web browser cache. in this OBE, she learned how to prepare Oracle Identity Manager so that its Administrative and User Console can be customized.

Linda is ready to customize this console, according to the methods listed in the OBEs titled Branding the Administrative and User Console and Changing the Functionality of the Administrative and User Console.

Back to Topic List

Summary

In this lesson, you learned how to:

 Modify the global-web-application.xml and orion-web.xml files
 Modify the server.xml file
 Transfer the _oracle_jsp_xlWebApp.jar file
 Clear content from the Web browser cache

Back to Topic List

Related Information

 To ask a question about this OBE tutorial, post a query on the OBE Discussion Forum.

Back to Topic List

 Place the cursor over this icon to hide all screenshots.

 

Left Curve
Popular Downloads
Right Curve
Untitled Document