IBM Support

Collecting Data: Managed Pages for WebSphere Portal

Recommended Resources


Abstract

Collecting data for troubleshooting issues with Managed Pages in IBM® WebSphere® Portal to expedite time to resolution by enabling IBM Support to provide informed problem analysis.

Content

If you have already contacted IBM Support and must collect data to determine the nature of a problem in WebSphere Portal, review the information below for the available methods of data collection. Otherwise, review Collecting Data: Read first for WebSphere Portal.

Managed Pages problem information
Managed Pages are Portal pages which have a Web Content Manager (WCM) representation in the Portal Site library. The management of such pages via WCM allows Portal pages to leverage WCM features such as workflow, projects, versioning, etc.

A brief outline of the various problems and other errors related to Managed Pages are given below:

  • Pages created in Portal do not appear in the Portal Site library
  • Portal pages are out of sync with WCM pages in the Portal Site library
  • Project operations failing
  • Draft operations failing
  • XMLAccess failing
  • Portal Scripting failing
  • Syndication failing
  • Page Title not displayed in WCM
  • Access Control

Based on where the problem lies, go to the appropriate section in the table below to collect the necessary troubleshooting data.

Data Collection
Use the following instructions for collecting the necessary troubleshooting data.

I. Enabling trace logging
Enable tracing during problem recreation in order to investigate the specific behavior of the component(s). Choose to enable either static or dynamic tracing and proceed with the steps accordingly. For further information regarding logging and tracing in the portal, refer to the System event logging topic in the WebSphere Portal Knowledge Center.


Option A: Enabling static (extended) tracing
Static tracing is the recommended method of capturing data, as it collects data from server startup until problem recreation.

1. Log into the Integrated Solutions Console as the WebSphere Application Server administrator.
2. Click Troubleshooting > Logs and Trace > WebSphere_Portal > Diagnostic Trace.
3. On the Configuration tab, ensure Enable Log is selected. On this same tab, ensure you increase the Maximum File Size and Maximum Number of Historical Files as needed to ensure that the tracing of the problem recreation is not overwritten due to the amount of traffic on the system and output of the tracing itself.
4. Click Change Log Level Details and enter the trace string based on the table below.
5. Click OK and save the changes.
6. Restart the WebSphere_Portal application server.


Option B: Enabling dynamic tracing
Dynamic tracing can be used for situations that do not permit a server restart.
1. Log in as the Portal administrator.
2. Click Administration > Portal Analysis > Enable Tracing. The Enable Tracing portlet appears.
3. Type the required trace string into the field Append these trace settings as per the pertinent problem defined above.
4. Click the Add icon. Enable Tracing updates the field Current trace settings.

Note: Restarting WebSphere Portal will remove traces that were set by using the Enable Tracing Administration portlet.


Trace strings

Issue Trace strings
Pages created in Portal do not appear in the Portal Site library com.ibm.wps.wcm.access.project.*=all:
com.ibm.wps.wcm.events.extensions.*=all:
com.ibm.wps.logging.ExceptionLogger=all:
com.ibm.wps.model.content.controller.wcm.*=all:
com.ibm.workplace.wcm.api.ItemSynchronizeServiceImpl=all


Please answer the below questions and provide supporting information wherever needed:
  1. Create a page either using the Portal Administration portlet “Manage Pages” or using the Edit Mode feature of the Portal theme: Create > Page > Basic > sibling of current page
  2. Check that Managed Pages is turned on. (In 8.5 and 8.0.0.1, the page viewed in Edit Mode will state “non-managed” if it is not a managed page).
  3. Check that the page was created in WCM:
    • Install the WCM Support Tools portlet and navigate to the directory of the page from your appropriate workspace (ROOTWORKSPACE if you are on the base portal and the corresponding objectID workspace if you are on a virtual portal).
    • Typical navigation is Content Root > Home > path_to_page
    • If you see this page at the path, then check the permissions and the labels for the page. If the page is hidden, then many users will not be able to see it.
  4. Check that the page is properly represented in WCM/JCR
    • Export the page with XMLAccess
    • Install the WCM Support Tools portlet and look for the "content-mapping content-id" attribute of the page in the XMLAccess export. Search for that content-id in the WCM Support Tools portlet. Please provide a screenshot of this page for support.
    • Check that the blob looks the same as the XML export: WCM Support Tools Portlet > Browse nodes > enter UUID > ibmcontentwcm:portalPagePathXML > [BINARY]
  5. Check that the parent of the page is managed as well
    • The XMLAccess export should have a "content-mapping content-id" tag for the parent page.
Portal pages are out of sync with WCM pages in the Portal Site library Please answer the below questions and provide supporting information wherever needed:
  1. When was the most recent backup made? Was the entire Portal database backed up? Was the entire Portal file system backed up?
  2. For any inconsistencies in general, use the sync task to sync Portal and WCM
    • For Unix/Linux: ./ConfigEngine.sh create-page-nodes
    • For Windows: ConfigEngine.bat create-page-nodes
  3. If the task fails, enable the following trace string and then provide the SystemOut.log, ConfigTrace.log and trace.log to support:

    com.ibm.wps.wcm.sync.*=all
Project operations failing com.ibm.wps.wcm.access.project.*=all:
com.ibm.wps.wcm.events.extensions.*=all:
com.ibm.workplace.wcm.api.ProjectServiceImpl=all:
com.ibm.workplace.wcm.services.project.ProjectServiceImpl=all

Note: This is especially for the “Publish Project” operation. Make sure all content is published within the project before publishing the project.
Draft operations failing com.ibm.wps.wcm.events.extensions.*=all:
com.ibm.workplace.wcm.services.workflow.WorkflowServiceImpl=all:
com.ibm.wps.services.pageserialization.PageSerializationServiceImpl=all

Note: Pages in draft mode will not show up in an XMLAccess export.
XMLAccess failing com.ibm.wps.command.xml.*=all:
com.ibm.wps.wcm.events.extensions.*=all:
com.ibm.wps.wcm.events.xmlaccess.*=all
Portal Scripting failing com.ibm.wps.scripting.*=all:
com.ibm.wps.wcm.scripting.*=all
Syndication failing Syndicator:
com.aptrix.syndication.*=all:
com.aptrix.deployment.*=all:
com.ibm.wps.wcm.events.extensions.*=all:
com.ibm.wps.logging.ExceptionLogger=all:
com.ibm.wps.model.content.controller.wcm.*=all:
com.ibm.wps.services.pageserialization.PageSerializationServiceImpl=all

Subscriber:

com.aptrix.syndication.*=all:
com.aptrix.deployment.*=all:
com.ibm.wps.wcm.events.extensions.*=all:
com.ibm.wps.logging.ExceptionLogger=all:
com.ibm.wps.model.content.controller.wcm.*=all:
com.ibm.wps.services.pageserialization.PageSerializationServiceImpl=all


Important Note: Ensure that you first perform a staging to production of the syndicator and subscriber environments. Only after this happens will pages syndicate. Only published pages will be moved via XMLAccess export / import.

Please provide a release export from both the syndicator and subscriber environments
Page Title not displayed in WCM com.ibm.wps.wcm.events.extensions.*=all:
com.ibm.workplace.wcm.services.localization.LocalizationServiceImpl=all:
com.ibm.wps.model.content.controller.wcm.ContentModelControllerForPPmiWCM=all
Access Control Minimum traces:
com.ibm.wps.ac.impl.AccessControlFederator=fine:
com.ibm.wps.ac.impl.ProjectScopedFullEntitlementsEngine=fine

More detailed traces:
com.ibm.wps.ac.impl.AccessControlFederator=fine:
com.ibm.wps.ac.impl.ProjectScopedTreeResolver=all:
com.ibm.wps.ac.impl.ProjectScopedFullEntitlementsEngine=fine

Debugging access control assignment/modification issues:
com.ibm.wps.ac.impl.ProjectHelperPACFilter=all:
com.ibm.wps.ac.impl.AccessControlFederator=all:
com.ibm.wps.ac.impl.AccessControlConfigFederator=all:
com.ibm.wps.wcm.sync.util.AccessControlSyncHelperImpl=all:
com.ibm.wps.datastore.projects.ProjectHelperFilterChainImpl=all


Check that the access control of the page and wcm node is correctly set and in sync:
  • Page access control can be reviewed through Administration > Resource Permissions -OR- Administration > User and Group Permissions
  • WCM access control can be reviewed through Applications > Web Content Management > Library Explorer > Portal Site library > Content > path_to_page > Read > Properties > Access
  • Use JCRExplorer to locate the page node via uuid or traverse the path. Use the [PAC] link to check the access control on the WCM node.

Note: Special access control considerations are documented in the InfoCenter under 'Access control for managed pages' refer to the Portal 8.5 Infocenter or Portal 8.0 Infocenter.


II. Collecting and submitting logs and configuration data

1. Reproduce the problem. Collect screenshots, userId, and timestamp information as appropriate.
2. Run the following script from <wp_profile>/PortalServer/bin to collect the data:
  • Windows: wpcollector.bat
  • Linux/Unix/i: wpcollector.sh

Note: If you wish to use wpcollector to FTP the files to IBM Support, include the -Dpmr=<pmr_number> parameter to indicate the relevant PMR #. For example: wpcollector.bat  -Dpmr=11111,222,333

3. If you did not FTP your files via wpcollector, locate the "wp.mustgather.zip" file or the "<pmr #>-wp.mustgather-timestamp.zip" file in <wp_profile_root> /filesForAutoPD/. Send the files to IBM Support by using the instructions outlined in Exchanging information with IBM Technical Support for problem determination.

Reminder: When sending in logs for review, include any relevant screenshots, timestamps, userIds, etc. in order to expedite analysis of the issue.


Related Information

Document information

More support for: WebSphere Portal

Software version: 8.0, 8.5

Operating system(s): AIX, IBM i, Linux, Solaris, Windows, z/OS

Software edition: Enable, Express, Extend, Server

Reference #: 1960989

Modified date: 25 November 2015


Translate this page: