Portal Express, Version 6.0
Operating systems: i5/OS, Linux, Windows

---

 

Enable session handling

The default IBM^® Workplace Web Content Management™ session handling works by initiating a new Web Content Management session for each Web Content Management portlet instance that is on a page. This can cause performance issues if many users access a page containing a large number of Web Content Management portlets.

The following procedures enables a service that is used to keep track of valid sessions. The service will help ensure that only a single session will be active between the instance of IBM WebSphere^® Portal Express and Web Content Management for each user. The service will manage access to the pool of active sessions and queue the requests for sessions that are in the process of being established, but not stop requests for established sessions to other servers or with different credentials.

 

Enable Web Content Management session handling

1. Remove the service jar from the ilwwcm-remoterenderingportlet.warThe ilwwcm-remoterenderingportlet.war file contains a jar (ilwwcm-remoterenderingportlet-service.jar). This must be removed if the service is to be used. The jar is added to the class loader instead. It is important it does not appear in both places if the service is to be used.

   1. Locate the ilwwcm-remoterenderingportlet.war file. By default, this file is located in the portal_server_root/installableApps directory.

   2. Open the ilwwcm-remoterenderingportlet.war file with an appropriate file archive program.

   3. Extract the ilwwcm-remoterenderingportlet-service.jar file to the portal_server_root/wcm/shared/app directory.

   4. Delete the ilwwcm-remoterenderingportlet-service.jar file from the ilwwcm-remoterenderingportlet.war using the archive program and save the WAR file.

2. Create a new shared library

   1. Log in to the administrative console for WebSphere Application Server.

   2. Go to Environment/Shared Library .

   3. Create a new shared library called WCMRemoteLib.

3. Add the library to the portal server

   1. Open the WebSphere Administration console.

   2. Select WebSphere Portal Express.

   3. Select classloader.

   4. Select the class loader.

   5. Select libraries.

   6. Select WCMRemotelib from the list.

   7. Click Apply.

   8. Click OK.

   9. Save these settings.

4. Edit the Services.Properties file

   1. Open the services.properties file.

      ..\PortalServer\shared\app\config\services.properties

   2. Ensure the following Web Content Management session service line is included:

      # ValidationService com.ibm.wps.services.validation.ValidationService = com.ibm.wps.services.validation.ValidationServiceImpl

       

      # WCM session service com.ibm.workplace.wcm.service.contentServer.AbstractWCMSessionService = com.ibm.workplace.wcm.service.contentServer.WCMSessionService

      ############################################################ # Transcoding Portal Support

5. Restart WebSphere Portal Express

   Restart WebSphere Portal Express. Review the portal_server_root/log/SystemOut.log file to ensure the new service is running.

 

How Web Content Management session handling works

When a request is made for a session with Web Content Management for a defined credential vault slot and URL, the WCMSessionService checks to see if this session already exists. If so, this session will be used. If not, a new session will be created.

 

Parent topic:

Displaying content in a rendering portlet

---