[UNIX][Linux]

Manually packaging information on UNIX and Linux

On UNIX and Linux®, you first select a directory with enough free space to hold all the data that you need to collect. You then add the required files to a compressed file with a name beginning with your IBM® case number.

Procedure

  1. Find a directory with enough free space to hold all the IBM MQ data.
    The contents of the /var/mqm/errors and /var/mqm/trace directories typically make up most of the IBM MQ data, so check the disk usage of those directories against the free space in your file systems using the du (disk usage) and df (display file systems) commands. For example:
    sh> du -sk /var/mqm/errors /var/mqm/trace
    384     /var/mqm/errors
    189496  /var/mqm/trace
    
    sh> df -k
    Filesystem    1024-blocks      Free %Used    Iused %Iused Mounted on
    /dev/hd4           393216    256536   35%     8641    12% /
    /dev/hd2          8257536   1072040   88%    70803    21% /usr
    /dev/hd9var        393216    126792   68%     6694    16% /var
    /dev/hd3         12582912  12441980   99%     5108     2% /tmp
    /dev/hd1          1310720    162560   88%      439     2% /home
    /proc                   -         -    -         -     -  /proc
    /dev/hd10opt      7208960     97180   99%    64796    65% /opt
    /dev/fslv00      16777216  15405312    9%    12415     1% /var/mqm
    
  2. In the directory you chose, create a new tar file whose name begins with your IBM case number and add the contents of the IBM MQ errors directory to it.
    For example:
    sh> tar -cf /tmp/TS001234567-mqdata.tar /var/mqm/errors
  3. Add the IBM MQ configuration files to the tar file. Include the mqinst.ini file only if you have installed IBM WebSphere® MQ 7.1 or later on the system:
    sh> tar -uf /tmp/TS001234567-mqdata.tar /var/mqm/mqs.ini /etc/opt/mqm/mqinst.ini
  4. Add the IBM MQ configuration files and error logs for your queue managers.
    For example:
    sh> tar -uf /tmp/TS001234567-mqdata.tar /var/mqm/qmgrs/QMA/qm.ini /var/mqm/qmgrs/QMA/errors/*.LOG
  5. Add any additional files as shown in Collecting troubleshooting information on Multiplatforms and as requested by IBM Support, including files that contain output from IBM MQ and system commands.
    For example:
    sh> tar -uf /tmp/TS001234567-mqdata.tar /tmp/ps.txt /tmp/ipcs.txt /tmp/mqconfig.txt
  6. If you gathered an IBM MQ trace, add the trace files last of all:
    sh> tar -uf /tmp/TS001234567-mqdata.tar /var/mqm/trace
  7. Compress the tar file using any available compression tool on your system.
    For example:
    • Using compress: creates a .tar.Z file
      sh> compress /tmp/TS001234567-mqdata.tar
    • Using gzip: creates a .tar.gz. file
      sh> gzip /tmp/TS001234567-mqdata.tar
    • Using bzip2: creates a .tar.bz2 file
      sh> bzip2 /tmp/TS001234567-mqdata.tar
  8. After sending your data to IBM as described in Sending troubleshooting information to IBM, take a back up copy of your file to keep until your case is resolved then delete the file from the system to save space.
    sh> rm /tmp/TS001234567-mqdata.*