IBM Support

Collecting data for IBM FileNet Image Services 4.x or P8 PE (Process Engine) for Windows

Question & Answer


Question

What information should be collected when I experience a problem with my software? Collecting this information before contacting IBM support will help you understand the problem and save time analyzing the data.

Answer


Collecting data for IBM FileNet Image Services 4.x or P8 PE for Windows

1. Initial Triage

  • What products, versions, and system configuration exist? The more detail the better.
    Example: One Root/Index server, with a BES server, running Image Services 4.0 Service Pack 5 Fix Pack 9, Oracle 9i (9.2.0.x), Windows 2003, etc.
  • What is the error message or symptom? If available, screen shots or log file.
  • Which system is affected? Production, QA (Quality Assurance), Development, DR (Disaster Recovery) or Test?
  • What changes have been made to the environment recently?
    Example: hardware or software added or modified? change in network configuration? users added?
  • Has this problem occurred before? If so, how often and can it be reproduced?
  • Is there a workaround?
  • What is the current business impact?


2. Instructions on how to collect the data

The Image Services and P8 Process Engine (PE) 911 logs provide the majority of information used by IBM support staff to analyze and resolve reported issues. Additional logs may be requested by IBM, after review of the 911 logs depending upon the issue reported.

Depending on your system and the error condition, 911 completes the process or it may hang. Please choose one of the scenarios based on the behavior of 911.

  • 911 completes:
    1. Run the 911 prior to restarting the Image Services software.
    2. If there are multiple Image Services Servers (Root/Index server, OSAR/MSAR servers, and Application servers), run 911 on each server and collect the data from each server.
  • 911 hangs:
    1. If 911 hangs, then enter a Ctrl+C to quit the currently running 911.
    2. Execute the following commands to gather data prior to restarting IS software.
      cd \fnsw_loc\tmp
      • cormon -p > cormon.txt
      • ipc_tool -Ni > ipci.txt
      • ipc_tool -s > ipcs.txt
      • ipc_tool -t > ipct.txt
      • ipc_tool -P > ipcp.txt
      • MKF_debug > mkfdebug.txt
      • netstat -a > netstata.txt
      • netstat -n > netstatn.txt
      • dbp -s > dbp.txt
      • fn_util whichfn > whichfn.txt
      • ppmoi >> ppmoi.txt (tp, svc, l, pre; are in IS 4.1.2)
        • rp
        • qp
        • sh
        • st
        • tp
        • svc
        • l
        • pre
        • quit
    3. winmsd /report winout.txt (may take a few minutes to complete)
    4. Get the current modules stamp information:
      getstamps32.exe -stamps
3. Collect the following outputs
  • The 911 command is located in the x:\fnsw\support\ directory.
    The output file is located in \fnsw_loc\logs\911\911.<date>.<sequence number>.{fzp,zip}
    The output file for Image Services 4.0 through Image Services 4.0.40 use the extension of ".fzp" and Image Services 4.0.50 and above use the extension ".zip". The ".fzp" files uses the program fnzip, found on the server, to uncompress.

    Example: x:\fnsw_loc\logs\911\911.20080617.01.zip. This would be a compressed file containing all the data gathered by running the 911 script.
    Note: If there are multiple Image Services Servers (Root/Index and OSAR/MSAR servers) collect the data on each server.
  • Get the WAL log if it exists from x:\fnsw\client\logs\wal<yyyymmdd>
  • Get the highest numbered CDB file from the Root/Index server in \fnsw_loc\sd\conf_db\IMS_###.cdb
  • Optionally, run the performance reports after restarting the Image Services software.
    • perf_report -a -csv -m3000
    • perf_report -rful -m3000 > perf.rful<date>.txt
  • Gather the output files you created and other data to send to IBM. May want to use zip to create the final output file.
  • Send the 911 output file and other data to IBM.

4. Follow instructions in Exchanging information with IBM Technical Support


What to do next
You can submit files using one of the following methods to help speed problem diagnosis:
    1. IBM Support Assistant (ISA)
    2. Electronic Service Request (SR)
    3. FTP to the Enhanced Customer Data Repository (ECuRep)
For a listing of all technotes, downloads, and educational materials specific to the IBM FileNet Image Services 4.x search the IBM FileNet Image Services Support Portal.

For a listing of all technotes, downloads, and educational materials specific to the IBM FileNet Content Manager, including P8 PE, search the FileNet Content Manager Support Web site.

[{"Product":{"code":"SSNVUD","label":"FileNet Image Services"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Image Services","Platform":[{"code":"PF033","label":"Windows"}],"Version":"4.2;4.1.2;4.1.1;4.1;4.0","Edition":"All Editions","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSNW2F","label":"FileNet P8 Platform"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Process Engine","Platform":[{"code":"PF033","label":"Windows"}],"Version":"4.5;4.0;3.5;3.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Historical Number

1330445

Document Information

Modified date:
17 June 2018

UID

swg21420046