[AIX HP-UX Linux Solaris Windows]

Troubleshooting and support

If you encounter problems, see the following information about how to troubleshoot a problem with your IBM® software.

About this task

Two different tools are included on your IBM WebSphere® Application Server Hypervisor Edition virtual images to assist with problem determination. The IBM Support Assistant Lite for WebSphere Application Server (ISA Lite) tool and the was_mustgather.sh script help automate the data collection process for you when troubleshooting a potential issue.

Procedure

  1. Use the tools that are included on your IBM WebSphere Application Server Hypervisor Edition virtual images to assist with problem determination.
    1. Use ISA Lite as an aid for troubleshooting problems associated with your WebSphere Application Server environment.

      The ISA Lite tool focuses on the automatic collection of problem data and provides some root cause symptom analysis for the various categories of problems encountered. The tool automates the most frequently used data collection scenarios. For information about installing and using the IBM Support Assistant Lite for WebSphere Application Server tool, see the Quick Start Guide for the tool, available in the /opt/IBM/WebSphere/AppServer/ISA/ISALite/doc. See the IBM Support Assistant Web site for more information about ISA Lite.

    2. Use the was_mustgather.sh script to gather additional information.
      In addition to using the IBM Support Assistant Lite for WebSphere Application Server tool, IBM WebSphere Application Server Hypervisor Edition support teams can request the collection of additional documentation to assist with problem determination. The was_mustgather.sh script gathers this additional data. The script gathers information about the application server environment and the operating system. The script creates a compressed file in the following two locations:
      • /tmp/was_mustgather.zip
      • /tmp/proc.tmp
      Avoid trouble Avoid trouble: If you have run the was_mustgather.sh script previously, you must either move or delete the previous .zip and .tmp file before running the tool.gotcha
      To execute the script, open a shell and run the was_mustgather.sh script using the following example:
      # /opt/IBM/WebSphere/AppServer/virtual/service/was_mustgather.sh
      The following table contains files and directories that the script includes in the was_mustgather.zip file.
      Table 1. Files and directories included in the was_mustgather.zip file.
      WebSphere Application Server Hypervisor image logs WebSphere Application Server logs SLES operating system logs
      • /opt/IBM/AE/AR
      • ConfigWAS.traceout
      • ConfigNET.log
      • ConfigPWD.log
      • tuneWAS.log
      • /opt/IBM/WebSphere/AppServer/properties/version/WAS.product
      • /opt/.ibm/.nif/.nifregistry
      • /opt/ibm/WebSphere/Profiles
      • /logs/manageprofiles/
      • entire .ibm directory
      • /var/log
      • boot.msg
      • /etc/ and /etc/sysconfig
      Information from the following locations is included in the proc.tmp file:
      • /proc/cpuinfo
      • /proc/meminfo
      • /proc/partitions
      • /proc/mounts
      • /proc/modules
      • /proc/vmstat
      • /home/virtuser

  2. Updating a WebSphere Application Server Hypervisor Edition image on PowerVM from Version 7.0.0.11 to 7.0.0.17 might fail. In the remote_std_out.log, you might receive the following errors:
    Installation prerequisites failed: The IBM WebSphere Application Server V7 Feature Pack for OSGi Applications and Java Persistence API 2.0 version 1.0.0.0 minimum service level (MSL) file specifies that IBM WebSphere Application Server V7 Feature Pack for Service Component Architecture (SCA) must be at >=1.0.1.5. The current version of IBM WebSphere Application Server V7 Feature Pack for Service Component Architecture (SCA) is 1.0.1.3.
    Installation prerequisites failed: IBM WebSphere Application Server V7 Feature Pack for OSGi Applications and Java Persistence API 2.0 version 1.0.0.3 requires that IBM WebSphere Application Server V7 Feature Pack for Service Component Architecture (SCA) must be at or above version 1.0.1.5. The current version of IBM WebSphere Application Server V7 Feature Pack for Service Component Architecture (SCA) is 1.0.1.3. 
    Solution:
    1. Update WebSphere Application Server Hypervisor Edition Version 7.0.0.11 to version 7.0.0.13.
    2. Update WebSphere Application Server Hypervisor Edition Version 7.0.0.13 to version 7.0.0.17.

Results

After successful completion of these steps, you will have gathered the diagnostic information needed to troubleshoot the issue you are experiencing.




In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Jun 14, 2012 5:51:46 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v610hyperv&product=was-nd-mp&topic=tins_virt_trouble
File name: tins_virt_trouble.html