Named Debug Guide

This document list steps for gathering information about a naming problem and is applicable to AIX 3.2. This document assumes that you are working with AIX Support under one of the service options.

Use the following steps to gather information about your naming problem to send to AIX Support.

NOTES:

• Please perform all the steps given below on the machine which is having "named" problems.
• Replace XXXXX with your problem number and YYY with your IBM branch office code.

1. Make a temporary subdirectory:

    
   mkdir /tmp/XXXXX 
   

2. Make subdirectories for the primary nameserver and for each secondary. For example:

    
   mkdir /tmp/XXXXX/pri 
   mkdir /tmp/XXXXX/sec.1 
   mkdir /tmp/XXXXX/sec.2 
   

3. Copy the named configuration files on these systems to their respective directories. Among the configuration files include the "named.boot" file and each of the database files listed in named.boot. For example:

    
   cp /etc/named.boot /tmp/XXXXX/pri 
   cp /etc/named.data /tmp/XXXXX/pri 
   

4. On the machine with which you are having named problems, please do the following:

   Start named with level 9 debugging or, if named is already running, send it "kill -USR1 <named_pid>" 9 times. Please note that "named" debugging will be collected in "/var/tmp" and that you must have sufficient space in that file system. IF you run out of space you will have to give signals to stop "named" debugging occasionally, backup the debug output, and send "named" a signal to start debug output. Examples of starting and stopping debugging are:

    
   startsrc -s named -a "-d 9" 
   kill -USR1 `cat /etc/named.pid` 
   

5. Now, reproduce the problem. After the problem appears,
   1. Send a signal to have named dump its configuration:

       
      kill -2 `cat /etc/named.pid` 
      

   2. Send a signal to stop named debugging:

       
      kill -USR2 `cat /etc/named.pid` 
      

   3. Issue the following commands to copy files to the temporary directory:

       
      cp /var/tmp/named.run /tmp/XXXXX 
      cp /var/tmp/named_dump.db /tmp/XXXXX 
      

   4. If a problem with zone transfer is suspected, issue the following command:

       
      cp /usr/tmp/xfr* /tmp/XXXXX 
      

   5. Please include a README file in /tmp/XXXXX which includes:
   • Some indication of the naming hierarchy, (domains, subdomains)
   • Ip addresses and hostnames of all name servers, (primaries, secondaries, etc.)
6. Compress and tar the whole XXXXX directory:

    
   tar -cvf- XXXXX | compress > XXXXX.tar.Z 
   

7. tar the compressed tar file to a diskette or tape:

    
   tar -cvf /dev/(device) XXXXX.tar.Z 
   

8. Include on the media label the problem number and branch office number (XXXXX,YYY) and the command used to place the data on the