IBM BPM, V8.0.1, All platforms > Customize and rebranding interfaces > Customize Process Portal

Customize the login page for Process Portal

You can customize the login page of Process Portal so that it has the logo and colors of your company.

You must have administrator privileges to complete this task.

Distributed Authoring and Versioning (WebDAV) provides a network protocol for creating interoperable, collaborative applications.

You must have access rights to the WebDAV folder to design and customize Process Portal styles. In certain cases, you might need to restart the server.

Tip: For many changes, use a web development tool, such as Mozilla Firebug, that can edit cascading style sheet (CSS) files. For simple changes, such as replacing images with other images of the same size, a web development tool is not necessary.

Process Portal uses image files to provide the elements for the login screen and a CSS file to control their usage and positioning. Process Portal uses the style settings in the login.css file as defaults.

You customize the login page by overriding these settings in a different CSS file that you have modified.

Procedure

1. Connect to the WebDav folder and navigate to the /login directory.
2. Make a local copy of the bspace folder and contents, and rename it.
   Your new folder contains an images directory.

3. Add any new image files to the images folder that you want displayed on the login page.
4. Modify your copy of the login.css file to change the appearance of your login page, such as the background color or images that are displayed.

5. Copy your new folder to the webDAV login folder so that it contains both the original and new folders. Your WebDAV folder directory now contains the following folders:

    WebDAV_folder/login/bspace
   
    WebDAV_folder/login/ folderName

   where folderName is the name of your folder.
6. Locate the ConfigService.properties file.
   

   For a stand-alone server:

   profile_root/BusinessSpace/node_name/server_name/mm.runtime.prof/config

   For a cluster:

   dmgr_profile_root/BusinessSpace/cluster/mm.runtime.prof/config

7. Change the value of folder name for the com.ibm.bspace.login.style property to the folder that contains the copy of the bspace folder, WebDAV_folder/login/ folderName.

8. Run the updatePropertyConfig command using the wsadmin scripting client to update the configuration.
   

   • For a stand-alone server:

     The following example uses Jython:

     AdminTask.updatePropertyConfig('[-serverName server_name -nodeName node_name -propertyFileName "profile_root/BusinessSpace/node_name/server_name/mm.runtime.prof/config/ConfigService.properties" -prefix "Mashups_"]')
     
     AdminConfig.save()

     The following example uses Jacl:

     $AdminTask updatePropertyConfig {-serverName server_name -nodeName node_name -propertyFileName "profile_root/BusinessSpace/node_name/server_name/mm.runtime.prof/config/ConfigService.properties" -prefix "Mashups_"} 
     $AdminConfig save

   • For a cluster:

     The following example uses Jython:

     AdminTask.updatePropertyConfig('[-clusterName cluster_name -propertyFileName "dmgr_profile_root/BusinessSpace/cluster_name/mm.runtime.prof/config/ConfigService.properties" -prefix "Mashups_"]')
     
     AdminConfig.save()

     The following example uses Jacl:

     $AdminTask updatePropertyConfig {-clusterName cluster_name -propertyFileName "dmgr_profile_root/BusinessSpace/cluster_name/mm.runtime.prof/config/ConfigService.properties" -prefix "Mashups_"} 
     $AdminConfig save

9. Clear your browser cache, and then log in to Process Portal.
   You can now see the updated login page.

• Example: Login page customizations for Process Portal
  

  You can customize a number of different elements of the Process Portal login page, such as the graphics, background color, and login field labels.

Customize Process Portal

Related tasks:
Connecting to the WebDav folder to customize Process Portal