01/31/96 Collecting Data for HANFS Problem Determination SPECIAL NOTICES Information in this document is correct to the best of our knowledge at the time of this writing. Please send feedback by fax to "AIXServ Information" at (512) 823-4009. Please use this information with care. IBM will not be responsible for damages of any kind resulting from its use. The use of this information is the sole responsibility of the customer and depends on the customer's ability to eval- uate and integrate this information into the customer's operational environment. +----------------------------------------------------------+ | | | NOTE: The information in this document has NOT been | | verified for AIX 4.1. | | | +----------------------------------------------------------+ ABOUT THIS DOCUMENT This document assumes that you are working with AIX Support under one of the service options. For information on the AIX Support Family and Program Services (IBM's base support for code-related problems), request these faxes from 1-800-IBM-4FAX: 1537 Overview of AIX Support 1760 Using Program Services 2464 The AIX Support Family Non U.S. Customers can requests documents by dialing (from a fax machine) 514-855-4FAX. This document describes how to collect the data that AIX Support needs to better understand your HANFS problem. Please do the following as accurately as possible. Put the collected data in /tmp/XXXXX, where XXXXX is the problem number. COLLECTING DATA ON THE PRIMARY SERVER 1. Make sure no clients are using any of the file systems serviced by hanfs. If you need the backup to take over when the primary stops, make sure both SLIP and the primary interface are detached on the primary server. Then stop hanfs with "stopsrc -g hanfs". 2. On the primary server, copy the output from the fol- lowing commands to the XXXXX directory: Collecting Data for HANFS Problem Determination 1 01/31/96 netstat -ni netstat -nr mount lsdev -Cc disk lsvg Also collect copies of these files: /etc/hanfs /etc/exports.hanfs 3. Make sure you have a logfile (/tmp/hanfs.log) in your hanfs configuration. On the primary server, start hanfs with "startsrc -g hanfs". Then collect the output from the following commands. netstat -ni netstat -nr lsvg mount Copy the logfile (/tmp/hanfs.log) to the XXXXX direc- tory. Since hanfs was just started, the logfile will include any data collected when hanfs was started. 4. Collect a listing of all the hanfs selective fixes on the machine. You can find a listing of these fixes in smit, or you can run "lslpp -haB |pg" and note all the selective fixes under hanfs.obj. COLLECTING DATA ON THE BACKUP SERVER 1. On the backup server, stop hanfs with "stopsrc -g hanfs". Stopping hanfs on the backup will not effect users if the primary server is running. 2. On the backup server, gather the output from the fol- lowing commands: netstat -nr netstat -ni lsdev -Cc disk lsvg Also collect copies of these files: /etc/hanfs /etc/exports.hanfs 3. If the problem is with the backup taking over from the primary, execute the following steps: a. Start hanfs on the backup with "startsrc -g hanfs". b. Make sure you have a logfile available. Then shut- down the primary server machine so that the backup will try to take over. c. After the backup takes over, or after a problem occurs, collect output from the following commands: Collecting Data for HANFS Problem Determination 2 01/31/96 netstat -ni netstat -nr lsvg mount Also copy the logfile (/tmp/hanfs.log or the proper logfile). 4. If the problem is with hanfs not starting on the backup, do the following: a. Start hanfs on the backup with "startsrc -g hanfs". b. Collect the same data as in step 3 above. 5. Collect a listing of all the hanfs selective fixes on the machine. You can find a listing of these fixes in smit, or you can run "lslpp -haB |pg" and note all the selective fixes under hanfs.obj. SENDING INFORMATION TO THE SUPPORT CENTER Please include a README file in /tmp/XXXXX with some description of the network topology. Also, make sure all the data you collected is in /tmp/XXXXX. 1. Compress and tar the whole /tmp/XXXXX directory with tar -cvf- XXXXX | compress > XXXXX.tar.Z 2. Tar the compressed tar file to a diskette or tape: tar -cvf /dev/(device) XXXXX.tar.Z 3. Please label the media with the problem number, the branch office number, and the command used to put the data on the media. Then send the tape or diskette by one of the methods in the following section. Methods for Sending Information STANDARD MAIL OR OVERNIGHT DELIVERY NOTE: Look at the "file Naming Convention" section of this document and name testcases accordingly. IBM Corp. / Zip 2900 / Bldg 42 Attn: AIX Testcase Dept. J66S 11400 Burnet Road Austin, TX 78758-3493 Extension 3-4050 Note: NO overnight delivery service delivers directly to bldg. 42, instead they are delivered to IBM Receiving. Please keep this in mind when choosing a delivery time. If you specify Saturday delivery you must first make special arrangements with an AIX Support specialist (1-800-225-5249 or 1-800-call-aix), otherwise there could be a delay of several days. Collecting Data for HANFS Problem Determination 3 01/31/96 INTERNET | +--- SERVICE USE AGREEMENT --------------------------------+ | | | | International Business Machines Corporation | | | Internet Testcase Delivery Service | | | Service Use Agreement | | | | | THIS IS A LEGAL AGREEMENT TO WHICH YOU ARE CONSENTING TO | | | BE BOUND. IF YOU DO NOT AGREE TO ALL OF THE TERMS OF | | | THIS LICENSE, DO NOT USE THE SERVICE. | | | | | o International Business Machines Corporation (IBM) | | | grants you a non-exclusive access to the Testcase | | | Delivery Service via the Internet. | | | | | o IBM makes no representations about the suitability | | | of this service or about any content or information | | | made accessible by the service, for any purpose. The | | | service is provided "as is" without express or | | | implied warranties, including warranties of | | | merchantability and fitness for a particular purpose | | | or noninfringement. This service is provided | | | gratuitously and, accordingly, IBM shall not be | | | liable for any damages suffered by you or any user | | | of the service. | | | | | o While IBM intends to maintain this Service, IBM | | | reserves the right at any time to alter access, fea- | | | tures, capabilities and functions of this Service. | | | IBM may terminate this Service at any time without | | | notice to you. | | | | | (continued) | | | +----------------------------------------------------------+ | +--- SERVICE USE AGREEMENT (CONTINUED) --------------------+ | | | | o You may not download or upload or otherwise export | | | or reexport images or files from or to systems pro- | | | viding this Service except in full compliance with | | | all United States and other applicable laws and reg- | | | ulations. In particular, but without limitation, | | | none of the images or files provided or received by | | | this Service may be downloaded or uploaded or other- | | | wise exported or reexported (i) into or received | | | from (or to a national or resident of) Cuba, Haiti, | | | Iraq, Libya, Yugoslavia, North Korea, Iran, or Syria | | | or (ii) to anyone on the US Treasury Department's | | | list of Specially Designated Nationals or the US | | | Commerce Department's Table of Deny Orders. By down- | | | loading or uploading images or files from or to | | | systems providing this Service, you are agreeing to | | | the foregoing and you are representing and war- | | | ranting that you are not located in, under control | | | of, or a national or resident of any such country on | | | any such list. | | | +----------------------------------------------------------+ Collecting Data for HANFS Problem Determination 4 01/31/96 | Email Via Internet | Relatively small testcases can be sent via e-mail to | aasc@austin.ibm.com. The allowable size of the testcase | depends mostly on intermediate mail gateways. It is gener- | ally not advisable to send tescases larger than approxi- | mately 4MB via e-mail. Testcases sent via e-mail in the | correct format are automatically processed, making them | almost immediately available for analysis. See the "File | Naming Convention" section of this document for more | details. | FTP Via Internet | Sample file names for the tarred and compressed files: | ad1000.tar.Z (item number.tar.Z) | 1x234.001.tar.Z (problem_report_#.branch_office_#.tar.Z) | 1x234.1234567.tar.Z (problem_report_#.customer_#.tar.Z) | FTP it to our testcase repository: | ftp 198.17.57.67 (or "ftp testcase.boulder.ibm.com") | login: anonymous | password: | (e.g., "customer@wallyworld.com") | bin (change to binary transfer mode) | cd aix | put 1x234.001.tar.Z (for example) | ls -l | quit | FILE NAMING CONVENTION: | NOTE: Testcases should be archived into a compressed tar | archive using relative path names. If FTPing, Do not create | a separate directory on the testcase server. | Use of the following naming convention will allow our tools | to automatically move the testcase to the proper directories | and update the PMR to indicate that the testcase is avail- | able. Failure to use this naming convention could cause | delays in processing the testcase. | If the testcase files cannot be associated with an existing | PMR or XMENU item, they will be tagged as lost and eventu- | ally deleted. | Testcases associated with PMRs Collecting Data for HANFS Problem Determination 5 01/31/96 | ppppp.bbb.ccc.tar.Z | | | | | | | | | | | Indicates that the archive is compressed. | | | | | If you have the gzip command available, | | | | | this will be .gz rather than .Z. | | | | | | | | | Indicates a tar archive. | | | | | | | The 3 character country code. | | | (May be omitted if the country code is 000.) | | | | | The 3 character branch office number. | | | The 5 character PMR number. | Testcases associated with XMENU items | xxxxxx.tar.Z | | | | | | | Indicates that archive is compressed. | | | If you have the gzip command available, | | | this will be .gz rather than .Z. | | | | | Indicates a tar archive. | | | The XMENU item number. | CREATING A COMPRESSED TAR ARCHIVE | Testcases should be archived into a compressed tar archive | using relative path names. The following is an example of | how to create a compressed tar archive. | o Place the testcase files into a separate directory using | commands similar to those in the following example. In | this example, we'll use a directory named /tmp/testcase. | cd /tmp | mkdir testcase | cp file1 file2 file3 testcase | o Execute one of the following commands to create the com- | pressed tar archive. Using the gzip command (if avail- | able), will generally produce a significantly smaller | file. | With the gzip command: | tar -cf- testcase | gzip -9 >9x999.999.999.tar.gz | Without the gzip command: | tar -cf- testcase | compress >9x999.999.999.tar.Z | Testcases should be archived into a compressed tar archive | using relative path names. The following example will | uuencode and send the compressed tar archive created in the | previous section. You should substitute the correct filename | when sending your testcase. | uuencode 9x999.999.999.tar.gz 9x999.999.999.tar.gz | \ | mail -s "AIX_Testcase:9x999.999.999.tar.gz" aasc@austin.ibm.com Collecting Data for HANFS Problem Determination 6 01/31/96 VM (IBM INTERNAL) REMINDER: If you have absolutely no other available elec- tronic method of sending a testcase, you can send it through VNET. This method only works for IBM internal customers. It is not automated, which could cause delays in testcase proc- essing. FTP IS THE PREFERRED METHOD FOR SENDING TESTCASES. The testcase should be combined into a single compressed tar archive and uploaded in BINARY format. Please name the file PPPPPBBB TARZBIN, where PPPPP is the PMR number and BBB is the branch office number (without the "b"). node = "AUSVMR" userid = "V3DEFECT" Collecting Data for HANFS Problem Determination 7 01/31/96 READER'S COMMENTS Please fax this form to (512) 823-4009, attention "AIXServ Informa- tion". You may also e-mail comments to: elizabet@austin.ibm.com. These comments should include the same customer information requested below. Use this form to tell us what you think about this document. If you have found errors in it, or if you want to express your opinion about it (such as organization, subject matter, appearance) or make sug- gestions for improvement, this is the form to use. If you need technical assistance, contact your local branch office, point of sale, or 1-800-CALL-AIX (for information about support offer- ings). These services may be billable. Faxes on a variety of sub- jects may be ordered free of charge from 1-800-IBM-4FAX. Outside the U.S. call 415-855-4329 using a fax machine phone. When you send comments to IBM, you grant IBM a nonexclusive right to use or distribute your comments in any way it believes appropriate without incurring any obligation to you. NOTE: If you have a problem report or item number, supplying that number may help us determine why a procedure did or did not work in your specific situation. Problem Report or Item #: Branch Office or Customer #: Be sure to print your name and fax number below if you would like a reply: Name: Fax Number: ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ END OF DOCUMENT (hanfs.debug.tcp) Collecting Data for HANFS Problem Determination 8