5 Customizing Logos

This chapter describes how to add your own corporate logo or that of your customers or partners to the Administrative and User Console. You can do this by copying a logo file into the EAR file, and editing the relevant values in the xlDefaultAdmin.properties file. This lets you brand the appearance of the solution you are providing to your customers, or apply the branding that your partners may require if they want their own logos displayed.

Figure 5-1 shows the default logo that is displayed on the Administrative and User Console login page.

Figure 5-1 Default Logo on Administrative and User Console Login Page

Description of "Figure 5-1 Default Logo on Administrative and User Console Login Page"

See Also:

Chapter 2, "Customizing General Page Layout" for instructions on how to align logos within the banner region

5.1 Files to Modify

The xlWebApp\WEB-INF\classes\xlDefaultAdmin.properties file
The xlWebApp\images directory

5.2 Replacing the Product Logo

To replace the default Oracle Identity Manager logo that is displayed to the left in the uppermost banner:

1. Place the GIF image file that contains your logo in the \xlWebApp\images directory.

2. Open the xlDefaultAdmin.properties file.

3. In the xlDefaultAdmin.properties file, locate the GLOBAL images section. In this section, set the global.image.clientlogo property to the full path and name of the image file that contains the desired logo. For example, if the logo is /images/mycorporate_logo.gif, then the default value of the global.image.clientlogo property is /images/client_logo.gif.

4. Redeploy the Enterprise ARchive (EAR) file. The name of the EAR file varies depending on your application server, as follows:

   • JBoss Application Server or Oracle Application Server—XellerateFull.ear

   • IBM WebSphere Application Server—Xellerate.ear

   • Oracle WebLogic Server—WLXellerateFull.ear

See Also:

The "Accessing Administrative and User Console Customization Files" section for details on how to access the \xlWebApp\images directory and the xlDefaultAdmin.properties file and how to redeploy the EAR file

5.3 Inserting the Company Logo

To replace the placeholder image that is displayed to the right in the uppermost banner:

1. Place the image file that contains your logo in the \xlWebApp\images directory.

2. Open the xlDefaultAdmin.properties file.

3. Locate the GLOBAL images section and set the global.image.xelleratelogo property to the full path and name of the image file that contains the desired logo. For example, if the logo is /images/myproductbrand_logo.gif, then the default value of this property is /images/xellerate-trans-grey.gif.

4. Redeploy the Xellerate.ear file.

See Also:

The "Accessing Administrative and User Console Customization Files" section for details on how to access the \xlWebApp\images directory and the xlWebAdmin.properties file and how to redeploy the EAR file