IBM Support

Submitting a Testcase for Dump Analysis

Question & Answer


Question

Submitting a Testcase for Dump Analysis

Answer

This document covers submitting a testcase for dump analysis of a system crash or system hang situation. This document applies to AIX and VIO servers. Please use the section that applies to your situation. If you are not creating a snap for a VIO server skip to the section that checks the dump size.


Creating a snap for a VIO server

Creating a snap for a VIO server

This section only applies to VIO servers. If the server in question is not a VIO server please proceed to Check the dump size . To create a snap for a VIO server, log in to the server using the "padmin" account. Type:

$snap

and press enter.

This will create a snap.pax.Z file in the /home/padmin directory.

Proceed to the section, "Naming convention for the testcase".

Please note that more detailed instructions regarding snaps for VIO servers can be found in this technote:

Check the dump size

Check the dump size

Check the size of the current dump and see which file system will have enough space to package the dump (the default file system is /tmp).

  1. Log in as root.
  2. At the command line, enter:
         sysdumpdev -L
    

Look at the dump size. If the dump is compressed you will need to find a file system that is double this size plus another 300MB. This is because the dump is written out, along with other information, after which a compressed pax file is created. If the dump is not compressed the snap process will create a compressed dump file before creating the pax file. Compression may reduce the dump from half to one tenth or more of its initial size. Dump compression has been enabled by default since the inception of AIX 6.1.

Check to see if /tmp has sufficient space. First execute

# snap -r
If prompted, answer :"yes" to remove temporary directories. Check under /tmp/ibmsupt for any renamed snap files and delete them if they exist.

Execute #df -m to find a filesystem with enough space to package the complete snap. Once a file system has been found, proceed to the appropriate section.

NOTE: If the dump is very large and was not produced by resetting the server due to a system hang, you may wish to submit a general snap. We have had some customers who have had 2TB dumps. AIX support can examine the minidump to see if the stack trace corresponds to a known issue. If this is not the case support will then need a full snap to review. A general snap is produced by typing

# snap -r
#snap -gc
If submitting a general snap please proceed to the section, "Where  to submit the testcase":

If the above Note does not apply to your situation proceed to the next step, Packaging the dump for submission


Packaging the dump for submission

Packaging the dump for submission
Please be aware of the next section, "Creating a snap with split files".

If there is enough space in the /tmp filesystem, follow Procedure 1; otherwise, skip to Procedure 2.

Procedure 1

Packaging dump the for submission when there is room in /tmp.

 # snap -acN 
 # cd /tmp/ibmsupt

This will create a snap.pax.Z file in the /tmp/ibmsupt directory Ensure that unix.Z, dump.snap and dump.Z(or dump.BZ) are present. If not then check to make certain /tmp has sufficient space to hold the snap.

Proceed to the section, "Where  to submit the testcase".

Procedure 2

Packaging the dump for submission when there is no room in /tmp. /<filesystem> represents the filesytem with sufficient space.

 # snap -acNd /<filesystem>/ibmsupt 
 # cd  /<filesystem>/ibmsupt
This will create a snap.pax.Z file in the /<filesystem>/ibmsup directory. Ensure that unix.Z, dump.snap and dump.BZ (or dump.Z) are present in the dump directory

Proceed to the section, "Where  to submit the testcase".


Creating a snap with split files

If you know you have a limitiation on the size of files that can be transmitted outside of your network and the snap will be quite large, use the "-O" option to snap.  You supply an integer as the argument for the size in MB to this option.  This will produce a complete snap as well as the split files.  You will need to make sure you have enough free space in the file system for all of these files.

For example, to split the snap into 30MB files:
    # snap -ac -O 30
    ...
   <multiple lines of output deleted>
    ...
    Starting pax/compress process... Please wait... done.
     was split succesfully ...
    -rw-------    1 0        0         160381986 Jun 12 15:32 snap.pax.gz
    -rw-------    1 0        0          31457280 Jun 12 15:32 snap.perflab4.061225153233.pax.gzaaa
    -rw-------    1 0        0          31457280 Jun 12 15:32 snap.perflab4.061225153233.pax.gzaab
    -rw-------    1 0        0          31457280 Jun 12 15:32 snap.perflab4.061225153233.pax.gzaac
    -rw-------    1 0        0          31457280 Jun 12 15:32 snap.perflab4.061225153233.pax.gzaad
    -rw-------    1 0        0          31457280 Jun 12 15:32 snap.perflab4.061225153233.pax.gzaae
    -rw-------    1 0        0           3095586 Jun 12 15:32 snap.perflab4.061225153233.pax.gzaaf

This is equivalent to using the snapsplit command documented in a separate technote:

Proceed to the section, "Where  to submit the testcase".

What to do if the dump is on tape

What to do if the dump is on tape

Put the tape in the tape drive.

Find a filesystem with sufficient space and enter the following:

NOTE: /<filesystem> represents the filesystem with sufficient space.

        # cd /<filesystem>
        # mkdir ibmsupt
        # cd ibmsupt
        # pax -rvf /dev/rmt#

NOTE: If you are running AIX 4.3.3 with Maintenance Level 06 or below, you cannot execute pax command. You must execute the following:

        #tar -xvf /dev/rmt#

The pax or tar command will create a file called dump_file in /<filesystem>/ibmsupt. Continue with the following steps:

   
        # snap -aNd /<filesystem>/ibmsupt
        # mv dump_file /<filesystem>/ibmsupt/dump/dump_fvvile
        # cd /<filesystem>/ibmsupt/dump
        # ls ->
Ensure that unix.Z, dump.snap and dump.Z (or dump.BZ) are present.
        # cd /<filesystem>/ibmsupt
        # snap -cd /<filesystem>/ibmsupt
This will create a snap.pax.Z file in /<filesystem >/ibmsupt directory.

Proceed to the section,  "Where  to submit the testcase"


Where to submit the testcase

Where to submit the testcase

Starting in April of 2018 sent to the testcase server, testcase.software.ibm.com or testcase.boulder.ibm.com will be redirected to the Ecurep site in Europe. Starting in July 2020 anonymous ftp uploads are not allowed.  This means that customers need to login via a portal and data is associated with the ticket used as part of that process.   Snaps are submitted to Ecurep for regular customers or through the Blue Diamond portal for customers under HIPAA guidelines.

Using Ecurep to submit your snap

https://www.ecurep.ibm.com/app/upload

Uploads to Blue Diamond

Blue Diamond customers will need to register and upload via the Blue Diamond portal: https://msciportal.im-ies.ibm.com/


[{"Product":{"code":"SWG10","label":"AIX"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Support information","Platform":[{"code":"PF002","label":"AIX"}],"Version":"Version Independent","Edition":"","Line of Business":{"code":"LOB08","label":"Cognitive Systems"}}]

Historical Number

isg1pTechnote1432

Document Information

More support for:
AIX

Software version:
Version Independent

Operating system(s):
AIX

Document number:
669627

Modified date:
13 June 2025

UID

isg3T1000654

Manage My Notification Subscriptions