Technote (troubleshooting)
Problem
Documents for collecting troubleshooting data aid in problem determination and save time resolving Problem Management Records (PMRs).
Resolving the problem
Collecting troubleshooting data early, even before opening a PMR, helps IBM Support quickly determine if:
- Symptoms match known problems (rediscovery).
- There is a non-defect problem that can be identified and resolved.
- There is a defect that identifies a workaround to reduce severity.
- Locating root cause can speed development of a code fix.
Depending on the nature of the issue, IBM Support may need to request logs and tracing more than once. For example, initial log analysis may indicate that more specific traces are required to troubleshoot, and thus a problem recreation with new traces may be required.
Table of contents:
- Automated collection of troubleshooting data
- Gathering general information
- Gathering component specific information
- Related Information
Automated log collection via IBM Support Assistant Lite for WebSphere Portal is the recommended method for improving accuracy of the data collection.
IBM Support Assistant Lite
Download Tool | View Demo of Trace Collection
For IBM WebSphere® Portal V6.0 or later, use the IBM Support Assistant Lite for WebSphere Portal tool to gather the documentation and information necessary to troubleshoot the problem on the system(s) in your environment. If you cannot locate a problem type in IBM Support Assistant Lite which matches your scenario, select the problem type WebSphere Portal-->Installation and Configuration-->Portal Basic File Collection to gather a general data collection.
The IBM Support Assistant Lite for WebSphere Portal tool is tightly integrated with the following data collection documents and is the recommended method for gathering system information. However, manually gathering the requested information and sending it to Product Support is an alternative. If one of the product components below matches your symptom or the part of the product with which you are experiencing problems, follow the instructions in the associated data collection document:
Documents for collecting troubleshooting data which are applicable to WebSphere Portal and IBM Web Content Manager version 6.1
| Component: | Link: |
| Installation/Configuration: | |
| Installation for WebSphere Portal 6.1 on Multiplatform | 1468568 |
| XML Configuration Interface (XMLAccess) for WebSphere Portal 6.1 | 1314470 |
| Portlet Deployment for WebSphere Portal 6.1 | 1468572 |
| Migration to WebSphere Portal 6.1 | 1321174 |
| ConfigEngine for WebSphere Portal 6.1 | 1468567 |
| Upgrade Failures for WebSphere Portal 6.1 on Multiplatform | 1468569 |
| Installation and Configuration for Websphere Portal 6.1 on i5/OS | 1412500 |
| Runtime Operations: | |
| OutOfMemoryError on WebSphere Portal 6.1 | 1316563 |
| Crash of WebSphere Portal 6.1 | 1316516 |
| Performance, hang, or high CPU issues for WebSphere Portal 6.1 | 1316528 |
| Search for WebSphere Portal 6.1 | 1319722 |
| Site Analysis Logging for WebSphere Portal 6.1 | 1321832 |
| Parallel Portlet Rendering (PPR) for WebSphere Portal | 1255372 |
| Security/Administration: | |
| Login for WebSphere Portal 6.1 | 1312738 |
| Portal User Management Architecture (PUMA) for WebSphere Portal 6.1 | 1312815 |
| Tivoli Access Manager Integration for WebSphere Portal 6.1 | 1312840 |
| User/Group Search Issues when using Administrative Portlets in WebSphere Portal 6.1 | 1312818 |
| Session Management for WebSphere Portal 6.1 | 1313113 |
| Credential Vault for WebSphere Portal 6.1 | 1313734 |
| Portal Access Control (PAC) for WebSphere Portal 6.1 | 1313768 |
| Virtual Portals for WebSphere Portal 6.1 | 1313784 |
| Configuring Security for WebSphere Portal 6.1 | 1382707 |
| Step-up and Remember me for WebSphere Portal 6.1 | 1377161 |
| People Finder for WebSphere Portal 6.1 | 1429065 |
| eTrust SiteMinder Integration for WebSphere Portal 6.1 | 1243923 |
| Content Management: | |
| Personalization (PZN) for WebSphere Portal 6.1 | 1315586 |
| Web Content Management (WCM) 6.1 General Information | 1315460 |
| Web Content Management (WCM) 5.1 to 6.1 Migration | 1314869 |
| Web Content Management (WCM) 6.0 to 6.1 Migration | 1326941 |
| Web Content Management (WCM) 6.1 Migration of PDM Documents | 1408171 |
| Web Content Management (WCM) 6.1 API | 1316119 |
| Web Content Management (WCM) 6.1 Authoring | 1315809 |
| Web Content Management (WCM) 6.1 Authoring Performance Degradation | 1314293 |
| Web Content Management (WCM) 6.1 Local Rendering Portlet | 1316589 |
| Web Content Management (WCM) 6.1 Local Rendering Portlet 2.0 | 1380074 |
| Web Content Management (WCM) 6.1 Remote Rendering Portlet | 1326354 |
| Web Content Management (WCM) 6.1 Pre-Rendering | 1316596 |
| Java Content Repository (JCR) for WebSphere Portal 6.1 | 1316273 |
| Web Content Management (WCM) 6.1 JCR Export/Import of Library | 1314514 |
| Web Content Management (WCM) 6.1 Security | 1326269 |
| Web Content Management (WCM) 6.1 Syndication | 1316241 |
| Web Content Management (WCM) 6.1 Ephox EditLive! OEM Edition | 1380433 |
| Web Content Management (WCM) 6.1 Caching | 1316606 |
| Web Content Management (WCM) 6.1 Custom Workflow Action | 1441934 |
| Web Content Management (WCM) 6.1 Author Time Search | 1314561 |
| Web Content Management (WCM) 6.1.5 Web Content Integrator (WCI) | 1421590 |
| Web Content Management (WCM) 6.1.5 Enterprise Content Management Integration | 1421370 |
| Web Content Management (WCM) 6.1.5 Blogs and Wikis | 1420602 |
| Portlets/Development/Customization: | |
| Portlet Development for WebSphere Portal 6.1 | 1305675 |
| Remote Cache for WebSphere Portal 6.1 | 1319332 |
| Model SPI for WebSphere Portal 6.1 | 1319334 |
| Composite Applications for WebSphere Portal 6.1 | 1319533 |
| Struts Portal Framework for WebSphere Portal 6.1 | 1307638 |
| Web 2.0 Themes for WebSphere Portal 6.1 | 1329366 |
| Collecting data on z/OS | |
| 6.1 | |
| Installation and Configuration for Websphere Portal 6.1 on z/OS | 1398686 |
| Database Transfer for WebSphere Portal 6.1 on z/OS | 1399069 |
| Upgrade Failures for WebSphere Portal 6.1 on z/OS | 1398206 |
| Configuring Security for WebSphere Portal 6.1 on z/OS | 1398218 |
| Performance, hang, or high CPU issues for WebSphere Portal 6.1 on z/OS | 1474158 |
| Out of memory (OOM) issues for WebSphere Portal 6.1 on z/OS | 1474141 |
| 6.1.5 | |
| Database Transfer for WebSphere Portal 6.1.5 on z/OS | 1429728 |
| Upgrade Failures for WebSphere Portal 6.1.5 on z/OS | 1429740 |
| Configuring Security for WebSphere Portal 6.1.5 on z/OS | 1429741 |
| Performance, hang, or high CPU issues for WebSphere Portal 6.1.5 on z/OS | 1474156 |
| Out of memory (OOM) issues for WebSphere Portal 6.1.5 on z/OS | 1474142 |
If using the SR tool for data submission, update the PMR to indicate that data has been provided.
Related information
A simplified Chinese translation is available
Product Alias/Synonym
WP WPv6.1 WPv6x WPv61x WPv6.1.0
Rate this page:
Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.