Customize banner content

We can change the appearance of the administrative console user interface by customizing the banner.

We can add or modify banner content to alter the appearance of the administrative console user interface. The default banner area is defined in two files, a JSP file named banner.jsp and a properties file named ui.properties. The banner area consists of four parts:

• Banner launch link
• Banner launch logo
• Banner logo
• Banner background image

When customizing the banner, adjust the dimensions (width and height) of the components in the banner.jsp. Adjust these dimensions so that the custom logo image is sized properly without any distortion. Also ensure that the entire banner frame is not distorted.

We can change the banner launch link and logo by modifying the ui.properties file. To modify the background image and banner logo, we must create a file to display your banner. This file can be either an HTML or a JSP banner file. The following property keys in the ui.properties file define the banner launch link and banner launch logo. They also define the URL to the banner background image and logo.

Property key	Default value	Description
enrole.ui.customerLogo.image	ibm_banner.gif	Launch link logo, located in the directories\itim_console.war\html\images directory. We can also specify a URL pointing to the image file or put this file in the directories\itim_console.war\custom directory. If this directory does not exist, we must create it. Prefix the path name with /itim/console/custom in the ui.properties file. Specifying no value results in the default ibm_banner.gif file being displayed.
enrole.ui.customerLogo.url	www.ibm.com	Launch link URL. This value can be specified with or without the HTTP prefix. For instance, we can use www.ibm.com or http://www.ibm.com to specify the launch link URL.
ui.banner.URL	This value is left blank by default and displays the default banner area.	The HTML or JSP file that provides the banner logo, background image, and launch link and logo. We can enter either a URL or put this file in the directories\itim_console.war\custom directory If this directory does not exist, we must create it. Prefix the path name with /itim/console/custom in the ui.properties file.
ui.banner.height	48	Enter the pixel height of the banner.

To modify these files...

1. From the top level of the Appliance Dashboard, click Configure > Advanced Configuration > Update Property.

2. From the All Files tab, select a property file ui.properties.

3. Optional: Search for the property to modify.

4. Select a property name. For example, ui.banner.height.

5. Click Edit to open the Update property window.

6. Edit the existing value in the Property value field with the new value.

7. Click Save Configuration.
8. Restart ISIM application for these changes to take effect.

   1. From the Server Control widget, do these steps.

      1. Select Security Identity Manager server.

      2. Click Restart.
      See View the Server Control widget.

Be sure to back up the custom version of the files we have created so your customizations are not lost.

Parent topic: Administrative console user interface customization