HCL Web Content Manager tracing

Enable the use of WebSphere Application Server trace facilities to create trace information for Web Content Manager. This tracing can be enabled either permanently or for just the current HCL Digital Experience session.

HCL Web Content Manager uses the IBM® WebSphere® Application Server trace facilities to create trace information. If you need detailed trace output of Web Content Manager to debug a problem, follow these steps:

Enable static (extended) tracing

Static tracing is recommended when there is a need to capture data, as it collects data from server startup until problem recreation.

Log in to the Integrated Solutions Console as the WebSphere Application Server administrator.
Select Troubleshooting > Logs and Traces > WebSphere_Portal >Diagnostic Trace.
On the Configuration tab, ensure that the Enable Log checkbox is selected. On this same tab, 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.
Click Change Log Level Details and enter the trace string based on the table below.
Click OK and save the changes.
Restart the WebSphere_Portal application server.

Enable dynamic tracing

Dynamic tracing can be used for situations that do not permit a server restart.

Log in to the Integrated Solutions Console as the Portal administrator.
Select Administration > Portal Analysis > Enable Tracing**. The Enable Tracing portlet appears.
Type the required trace string into the field Append these trace settings based on the table below.
Click the Add icon. Enable Tracing updates the field Current trace settings.

Note

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

Trace Strings

In HCL Digital Experience 9.5 and higher releases, the following trace strings are now available:

Issue	Trace String
General Search Traces	- `com.ibm.hrl.=all:` - `com.ibm.crawler.=all:` - `com.ibm.portal.search.=all:` - `com.ibm.lotus.search.=all:` - `com.ibm.siapi.search.*=all`
Remote Search Server	- `com.ibm.hrl.=all:` - `com.ibm.crawler.=all:` - `com.ibm.portal.search.=all:` - `com.ibm.lotus.search.=all:` - `com.ibm.siapi.search.*=all`
WCM Seedlist	- `com.ibm.workplace.wcm.searchseed.=finest:` - `com.ibm.lotus.search.providers.content.seedlist.=finest:` - `com.ibm.workplace.wcm.seedlist.=finest:` - `com.ibm.workplace.wcm.services.=finest`
WCM REST API	- `com.ibm.workplace.wcm.rest.=all:` - `com.hcl.wcm.rest.=all:`
Search Token issues	- `com.ibm.ilel.*=all`

The following table is the list of all trace strings available for HCL Digital Experience 8.5 and higher releases:

Issue	Trace String
General Information	- `com.ibm.workplace.wcm.=all` - `com.aptrix.=all` - `com.presence.connect.*=all`
Syndication	- Refer to Collecting Data: Syndication for HCL Portal 8.5
Security	- `com.ibm.wps.engine.=all` - `com.ibm.wps.services.puma.=all` - `com.ibm.wps.puma.=all:com.ibm.wps.um.=all` - `com.ibm.wps.sso.=all` - `com.ibm.wps.services.authentication.=all` - `com.ibm.ws.security.=all` - `com.ibm.ws.wim.=all:com.ibm.websphere.wim.=all` - `com.ibm.wsspi.wim.=all:com.ibm.workplace.wcm.=all` - `com.aptrix.=all` - `com.presence.connect.wmmcomms.=all` - `com.presence.connect.profile.=finest`
Authoring Portlet	- `com.ibm.workplace.wcm.app.ui.=all` - `com.aptrix.=all` - `com.presence.connect.=all` Note:* Client-side trace required. When recreating the issue, it is important to note any JavaScript exceptions you may see in the browser. Additionally, you need to collect some browser-side information so we can see the requests being passed. There are multiple methods for collecting this information: - The JavaScript console of the browser - Fiddler - Firefox HTTP Header Live - Firefox Firebug
API	- `com.ibm.workplace.wcm.=all` - `com.aptrix.=all:` - `com.presence.connect.*=all`
WCM REST API	- `com.ibm.workplace.wcm.*=all`
JSR 286 Web Content Viewer	- `com.aptrix.=all` - `com.presence.=all` - `com.ibm.workplace.wcm.=fine` - `com.ibm.workplace.wcm.app.ui.portlet.=all` - `com.ibm.websphere.wmm.=all` - `com.ibm.wps.services.puma.=all` - `com.ibm.wps.puma.=all` - `com.ibm.workplace.wcm.resolver.=all` - `com.ibm.workplace.wcm.services.addressability.*=all`
Remote Web Content Viewer Portlet	On the remote rendering server:- `com.ibm.workplace.wcm.app.ui.remote.=all` - `com.ibm.workplace.wcm.app.ui.portlet.=all` If the credential vault is in use, add the following the remote rendering server traces: - `com.ibm.wps.services.credentialvault.=finest` - `com.ibm.wps.sso.credentialvault.=finest` - `com.ibm.wps.command.credentialvault.=finest` - `com.ibm.wps.engine.Servlet.=finest` On the rendering server: - `com.aptrix.=all` - `com.presence.connect.wmmcomms.=all` - `com.ibm.wps.services.puma.=all` - `com.ibm.wps.puma.=all` - `com.ibm.wps.sso.=all` - `com.ibm.wps.services.authentication.=all` - `com.ibm.ws.security.=all` - `com.ibm.ws.wim.=all:com.ibm.websphere.wim.=all` - `com.ibm.wsspi.wim.=all`
Caching	- `com.presence.connect.cache.=finest` - `com.presence.connect.business.=finest` - `com.aptrix.pluto.renderer.=finest` - `com.ibm.workplace.wcm.services.content.=finest`
Pre-rendering	- `com.aptrix.cacher.*=finest`
Enterprise Content Management Integration	Document Picker issues:- `com.ibm.wps.proxy.=all` - `com.ibm.mm.proxy.=all` - `com.ibm.lotus.quickr.=all` Personalization Federated Document issues: - `com.ibm.workplace.wcm.pzn.ecm.=all` - `com.ibm.websphere.personalization.=all` Note:* Client-side trace required. When recreating the issue, it is important to note any JavaScript exceptions you may see in the browser. Additionally, you need to collect some browser-side information so we can see the requests being passed. There are multiple methods for collecting this information: - The JavaScript console of the browser - Fiddler - Firefox HTTP Header Live - Firefox Firebug
Blogs and Wikis	- `com.ibm.workplace.wcm.=all` - `com.aptrix.=all:com.presence.=all` - `com.ibm.icm.jcr.=finest` - `com.ibm.icm.ci.schema.impl.SchemaService=info`
Java Content Repository (JCR)	- `com.ibm.icm.*=finest` - `com.ibm.icm.ci.schema.impl.SchemaService=info`
Java Content Repository (JCR) Export/Import of Library	- `com.ibm.icm.jcr.command.*=all`
Web Content Integrator	- `com.ibm.workplace.feed.*=finest`
Migration	- `com.ibm.workplace.wcm.app.migration.* = all`
Seedlist and Search	WCM Seedlist issues:- `com.ibm.lotus.search.providers.content.seedlist.=finer` - `com.ibm.workplace.wcm.seedlist.=finer` - `com.ibm.workplace.wcm.services.=finer` WCM Search issues: - `com.aptrix.pluto.cmpnt.=finest` - `com.ibm.workplace.wcm.data.siapi.=finest` - `com.ibm.workplace.wcm.services.siapi.=finest`
Personalization	For issues with personalization in HCL Portal (rules, campaigns, application objects): - `com.ibm.websphere.personalization.=all:com.ibm.websphere.query.=all` For issues with personalization and security: - `com.ibm.webshere.personalization.=finest:` - `com.ibm.icm.ci.query.impl.ResultSetProcessor=finest` - `com.ibm.icm.ci.query.impl.QueryProcessor=finest:com.ibm.wps.services.puma.=finest:` - `com.ibm.wps.puma.=finest` For issues with personalization and Web Content Management (WCM): - `com.ibm.websphere.personalization.=all:com.ibm.websphere.query.=all:` - `com.ibm.workplace.wcm.pzn.=all:com.ibm.workplace.wcm.services.pzn.=all` For issues with personalization and JCR: - `com.ibm.websphere.personalization.=all:com.ibm.websphere.query.=all:` - `com.ibm.icm.=finest:com.ibm.icm.ci.schema.impl.SchemaService=info` For issues with personalization authoring performance: - `com.ibm.websphere.personalization.=all:com.ibm.wps.caf.=all` For issues with personalization runtime performance: - `com.ibm.websphere.personalization.=all` For issues with personalization publishing: - `com.ibm.websphere.personalization.=all` For configuration issues with personalization authoring environment (Navigator Portlet, Editor Portlet, and List Portlet): - `com.ibm.websphere.personalization.=all:com.ibm.wps.caf.=all`
Java Message Service (JMS)	- `com.ibm.workplace.wcm.services.messaging.=all` - `com.ibm.workplace.wcm.messaging.=all` - `Messaging=all:JMSApi=all:JMSServer=all`
Advanced Editor (RTE)	Enable Java Console logging on client system and send output. Note: Client-side trace required. When recreating the issue, it is important to note any JavaScript exceptions you may see in the browser. Additionally, you need to collect some browser-side information so we can see the requests being passed. There are multiple methods for collecting this information: - The JavaScript console of the browser - Fiddler - Firefox HTTP Header Live - Firefox Firebug
Multilingual Solutions	MLS Install Trace location: [WAS_PROFILE_ROOT]/ConfigEngine/log/ConfigTrace.logConfiguration Issues: - `com.ibm.workplace.wcm.ml.utils.=all` - `com.ibm.workplace.wcm.ml.messaging.=all` Authoring plugin: - `com.ibm.workplace.wcm.ml.utils.=all` - `com.ibm.workplace.wcm.ml.processor.=all` - `com.ibm.workplace.wcm.ml.MLServlet=all` - `com.ibm.workplace.wcm.ml.ServletUtils=all` Workflow Traces: 1. Localize stage: - `com.ibm.workplace.wcm.ml.utils.=all` - `com.ibm.workplace.wcm.ml.workflowactions.LocalizeMLCustomWorkflowAction=all` - `com.ibm.workplace.wcm.ml.workflowactions.service.LocalizeCustomWorkflowActionService=all` - `com.ibm.workplace.wcm.ml.workflowactions.service.AbstractSyncUpdateCustomWorkflowActionService=all` - `com.ibm.workplace.wcm.ml.workflowactions.service.AbstractMLCustomWorkflowActionService=all` - `com.ibm.workplace.wcm.ml.workflowactions.WorkflowSwitcherWorkflowAction=all` 2. Regionalize stage: - `com.ibm.workplace.wcm.ml.utils.=all` - `com.ibm.workplace.wcm.ml.workflowactions.RegionalizeMLCustomWorkflowAction=all` - `com.ibm.workplace.wcm.ml.workflowactions.service.RegionalizeCustomWorkflowActionService=all` - `com.ibm.workplace.wcm.ml.workflowactions.service.AbstractSyncUpdateCustomWorkflowActionService=all` - `com.ibm.workplace.wcm.ml.workflowactions.service.AbstractMLCustomWorkflowActionService=all` - `com.ibm.workplace.wcm.ml.workflowactions.WorkflowSwitcherWorkflowAction=all` 3. Pending Publish stage: - `com.ibm.workplace.wcm.ml.utils.=all` - `com.ibm.workplace.wcm.ml.workflowactions.SyncPublishMLCustomWorkflowAction=all` - `com.ibm.workplace.wcm.ml.workflowactions.service.SyncPublishCustomWorkflowActionService=all` - `com.ibm.workplace.wcm.ml.workflowactions.service.AbstractSyncStageCustomWorkflowActionService=all` - `com.ibm.workplace.wcm.ml.workflowactions.service.AbstractMLCustomWorkflowActionService=all` 4. Pending Expired stage: - `com.ibm.workplace.wcm.ml.utils.=all` - `com.ibm.workplace.wcm.ml.workflowactions.SyncExpireMLCustomWorkflowAction=all` - `com.ibm.workplace.wcm.ml.workflowactions.service.SyncExpireCustomWorkflowActionService=all` - `com.ibm.workplace.wcm.ml.workflowactions.service.AbstractSyncStageCustomWorkflowActionService=all` - `com.ibm.workplace.wcm.ml.workflowactions.service.AbstractMLCustomWorkflowActionService=all` 5. Delete stage: - `com.ibm.workplace.wcm.ml.utils.=all` - `com.ibm.workplace.wcm.ml.workflowactions.SyncDeleteMLCustomWorkflowAction=all` - `com.ibm.workplace.wcm.ml.workflowactions.service.SyncDeleteCustomWorkflowActionService=all` - `com.ibm.workplace.wcm.ml.workflowactions.service.AbstractMLCustomWorkflowActionService=all` 6. Servlet Rendering Plugin Traces: - `com.ibm.workplace.wcm.ml.utils.=all` - `com.ibm.workplace.wcm.ml.processor.LocaleNavigatorProcessorImpl=all` 7. Portlet Rendering Plugin Traces: - `com.ibm.workplace.wcm.ml.utils.=all` - `com.ibm.workplace.wcm.ml.contextprocessor.=all` 8. Library Copy Traces: - `com.ibm.workplace.wcm.ml.utils.*=all` - `com.ibm.workplace.wcm.ml.processor.LibraryCopyContextProcessorImpl=all`
Workflow	- `com.ibm.workplace.wcm.api.=finest` - `com.aptrix.pluto.workflow.=finest` - `com.ibm.workplace.wcm.services.workflow.*=finest`

The resulting traces of Virtual Member Manager are written below:

AIX® and Linux™: wp_profile_root/logs/HCL Portal and HCL Web Content Manager/trace.log
Windows™: wp_profile_root\logs\HCL Portal and HCL Web Content Manager\trace.log

Related information

WebSphere® Integrated Solutions Console