IBM Support

MustGather: JavaServer Faces (JSF) problems



Collecting data for problems with JavaServer Faces (JSF) in the WebSphere Application Server. Gathering this information before calling IBM® support will help familiarize you with the troubleshooting process and save you time.

Resolving The Problem

If you have already contacted support, continue on to the component-specific MustGather information. Otherwise, click: MustGather: Read first for WebSphere Application Server.

For most of the JSF related problems, a simple testcase will speed resolution. Ensure that the testcase does not have any external dependencies and is easily re-creatable. If you cannot provide a simple testcase, then follow the instructions below.

Instructions for setting up the trace:

  1. In the WebSphere Application Server administrative console, expand the Troubleshooting section and click Logs and Trace.

  2. Click the link for your server.

  3. Click Diagnostic Trace.

  4. Make sure Enable Log is checked, Maximum File Size as 100 MB, Historical Files as 10, and specify a File Name. You might have to select different values for Maximum File Size and Historical Files as per the frequency of the problem or as suggested by support team.

  5. Click OK.

  6. Click on Change Log Level Details.

  7. In Trace Specification, enter the following string:
    • For V8 and V7 using Sun RI


    • For V8 and V7 using MyFaces implementation


    • For V6.x using Sun RI


  8. Click apply and save your configuration.

  9. Stop the Application Server.

  10. Clear all SystemOut.log and SystemErr.log logs for the Application Server.

  11. Start the Application Server.

  12. Recreate the error condition and document the steps taken.

  13. Collect the following information:
    • A brief description of what JSF implementation you are using and how it is configured.

    • Trace file from the diagnostic trace.

    • All files in the following directory:


      If you have configured the Application Server to write the logs into a different location then, send them accordingly.

    • All files in the following directory:


    • The server.xml file located in the following directory:


    • The faces-config.xml and web.xml files located in web-inf folder of the failing WAR file.

    • The failing .jsf file and any other dependent files.

    • The historyReport.html file generated by running the tool genHistoryReport.bat or located in the following directory:


      The historyreport.html file is generated in the working directory from where the genHistoryReport tool is being run.

  14. Follow instructions to send diagnostic information to IBM support.

For a listing of all technotes, downloads, and educational materials specific to the JSF component, search the WebSphere Application Server support site.

Related information
Submitting information to IBM Support
Steps to getting support
MustGather: Readme First
Troubleshooting guide
Recording your screen to share with IBM Support

[{"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Servlet Engine\/Web Container","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"9.0;8.5;8.0;7.0","Edition":"Base;Express;Network Deployment","Line of Business":{"code":"LOB36","label":"IBM Automation"}},{"Product":{"code":"SSNVBF","label":"Runtimes for Java Technology"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Java SDK","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
15 June 2018