Collecting Data: XML Configuration Interface (XMLAccess) for WebSphere Portal
Collecting troubleshooting data for XMLAccess issues with IBM WebSphere Portal expedites time to resolution by enabling IBM Support to provide informed problem analysis.
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.
Collecting XMLAccess information
XMLAccess issues can include: errors/exceptions on command line or in the output XML file during import/export, performance issues such as command hangs, or abrupt termination, command line syntax, specific requests using the tool, questions related to XMLAccess in virtual portals, etc.
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 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 following trace string:
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:
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.
1. Collect the input file used in the XMLAccess command specified by the -in parameter.
2. Collect the ouptut file used in the XMLAccess command specified by the -out parameter.
3. Obtain an XMLAccess export of the base or virtual portal you are attempting to running the XMLAccess command against. Note: This may not be possible depending on the nature of the XMLAccess issue and may be skipped if the attempt of obtain the export fails.
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.
4. Upload the input file used in the XMLAccess command, the output file used in the XMLAccess command, and the XMLAccess export. Send the files to IBM Support by using the instructions outlined in Exchanging information with IBM Technical Support for problem determination.
Note: When sending in logs for review, include any relevant screenshots, timestamps, userIds, etc. in order to expedite analysis of the issue.
|Organizational Productivity- Portals & Collaboration||WebSphere Portal End of Support Products||AIX, HP-UX, IBM i, Linux, Solaris, Windows, z/OS||7.0, 6.1|
More support for:
Software version: 8.0, 8.5
Operating system(s): AIX, IBM i, Linux, Solaris, Windows
Software edition: Enable, Express, Extend, Hypervisor Edition, Server
Reference #: 1451423
Modified date: 10 November 2010
Translate this page: