 
AIX 3.2.5 PERFPMR INFORMATION
-----------------------------
 
  TABLE OF CONTENTS
  -----------------
       I.   INTRODUCTION
 
      II.   HOW TO INSTALL THE TOOLS ON AN IBM RISC SYSTEM/6000.
 
     III.   HOW TO COLLECT DATA FOR AN AIX PERFORMANCE PROBLEM
 
      IV.   HOW TO SEND DATA TO IBM
 
 
 
 
 
  I.  INTRODUCTION
 
      This package contains a set of tools and instructions for
      collecting the data needed to analyze a AIX performance
      problem.  This tool set runs on AIX 3.2.5

 
 II.  HOW TO INSTALL THE TOOLS ON AN IBM RISC SYSTEM/6000.
 
      To install perfpmr on a RISC System/6000 from the compressed
      "tar" file downloaded from the IBM ftp site:

           NOTE:  These instructions assume the compressed tar file
           is named 'perf32.tar.Z'.

           a. login as root or use the 'su' command to obtain root
              authority

           b. create perf32 directory and move to that directory (this
              example assumes the directory built is under /tmp)

              # cd /tmp
              # mkdir perf32
              # cd perf32

           c. put 'perf32.tar.Z' in the perf32 directory

           d. uncompress 'perf32.tarbin.Z'

              # uncompress perf32.tarbin.Z

           e. extract the shell scripts out of the tar file

              # tar -xvf perf32.tar

           f. install the shell scripts

              # ./Install



III. HOW TO COLLECT DATA FOR AN AIX PERFORMANCE PROBLEM
 
 
     A. Purpose:

        1. This section describes the set of steps that should be
           followed to collect performance data.

        2. The goal is to collect a good base of information that
           can be used by AIX technical support specialists or
           development lab programmers to get started in analyzing
           and solving the performance problem. This process may
           need to be repeated after analysis of the initial set
           of data is completed and/or AIX personnel may want to
           dial-in to the customer's machine if appropriate for
           additional data collection/analysis.


     B. Collection of the Performance Data on Your System

        1. Detailed System Performance Data:

           Detailed performance data is required to analyze and
           solve a performance problem. Follow these steps to
           invoke the supplied shell scripts:

           NOTE:  You must have root user authority when executing
           these shell scripts.

           a. Create a data collection directory and 'cd'
              into this directory. Allow at least 15MB of space in
              whatever file system is used.  Using the 'df' command
              to verify the filesystem has at least 30000 blocks
              in the 'Free' column (30000 512 byte blocks = 15MB).

              For example using /tmp filesystem:

              # mkdir /tmp/perfdata
              # cd /tmp/perfdata


           b. Collect our 'standard' PERF32 data for 3600 seconds
              (3600 seconds = 1 hour):

              # perfpmr.sh 3600

              The perfpmr.sh shell provided will:
              - immediately collect a 5 second trace (trace.sh 5)
              - collect 3600 seconds of general system performance
                 data (monitor.sh 3600).
              - collect hardware and software configuration
                 information (config.sh).

              In addition, if it finds the following programs available
              in the current execution path, it will:
              - collect 60 seconds of tprof information (tprof.sh 60)
              - collect 60 seconds of filemon information (filemon.sh 60)
              - collect 60 seconds of netpmon information (netpmon.sh 60)
              - collect 60 seconds of iptrace information (iptrace.sh 60)

              NOTE:
              Since a performance problems may mask other
              problems, it is not uncommon to fix one issue and
              then collect more data to work on another issue.

           c. Answer the questions in the text file called
              'PROBLEM.INFO' in the data collection directory
              created above.  This background information
              about your problem helps us better understand
              what is going wrong.

 

 
 IV. HOW TO SEND THE DATA TO IBM.

     You should report suspected AIX performance problems to the IBM
     Software Service organization.  Use your normal software problem-
     reporting channel.  If you are not familiar with the correct
     problem-reporting channel for your organization, check with your
     IBM representative.
 
     A. Combine all the collected data into a single binary 'tar' file
        and compress it:
 
        Put the benchmark/application description and performance goals
        and current results in the same directory (ie. /tmp/perfdata in
        this example), then change to the parent directory, and use the
        tar command as follows:
 
        # cd /tmp/perfdata   (or whatever directory created for this use)
        # cd ..
        # tar -cvf perfdata.tar *
        # compress perfdata.tar

        The resulting file will be named 'perfdata.tar.Z'.
 
 
     B. Submission of testcase to IBM:
 
        If you have internet 'ftp' access:
        ----------------------------------
        The quickest method to get the data analyzed is
        for the customer to ftp the data directly to IBM.
        Data placed on the server listed below cannot be
        accessed by unauthorized personnel.

        Please contact your IBM representative for the
        PMR# and BRANCH#.  IBM uses both PMR# and
        BRANCH# to associate your data with your
        problem tracking record.
 
           'ftp testcase.software.ibm.com'
           Userid:  anonymous
           password:  your_internet_email_address
                      (ie. smith@austin.ibm.com)
           'cd /aix'
           'bin'
           'put perfdata.tar.Z PMR#.BRANCH#.tar.Z'
            (ie. 'put perfdata.tar.Z 1234x.060.tarbin.Z'
           'quit'
 
        Notify your IBM customer representative you have
        submitted the data.  They will then update the
        defect report to indicate the data is available
        for analysis.
 
 
        Allow IBM to dial in to retrieve the data
        -----------------------------------------
        The second quickest option is to allow your IBM
        representative to dial into your machine to
        retrieve 'perfdata.tar.Z'.  They will then forward it
        as described above or use the internal IBM network
        (V3DEFECT at AUSVMR) to submit it to AIX support.
        The IBM representative will need a guest userid,
        password capable of accessing the data,
        modem telephone number, and the modem settings
        (ie. 28800 baud, 8 bit data, 1 stop bit, no parity).
        A phone call is the best method to pass the
        login information to the IBM representative.
        Do not EMAIL it, you should consider internet
        email unsecured.
 
 
        Submitting physical media
        -------------------------
        If the above options are not viable, save your data to tape
        or diskettes and mail it to IBM.

        Note the following on the media label:

        - the PMR# and BRANCH#
          (contact your local IBM service representative)
        - the date that the data was gathered
        - the command to be used to extract the data
          from the media (such as tar), including
          any required command flags (such as blocksize, etc)

        Here's one way to put the data on a formatted diskette:

        'tar -cvf /dev/fd0 PMR#.BRANCH#.tar.Z


           Mailing address for United States customers:
           --------------------------------------------
              IBM Corp. / Zip 9551 / Bldg 905
              Attn: AIX Testcase Dept. H8TS
              11400 Burnet Road
              Austin, Texas 78758-3493 USA
 
 
           Mailing address for World Trade customers:
           ------------------------------------------
              Please contact your local IBM representative for the
              closest address.
 
         This data will then be transferred electronically
         to AIX Development by 'ftp' or VNET (a IBM
         internal data network).

         IBM Software Service in the geography should inform
         the Austin AIX Support Center when the performance
         data has been sent to Austin by updating the PMR.
 
         VNET Address. for IBM personnel:
            V3DEFECT at AUSVMR
 
         ftp address (use the procedure for internet ftp access
         described above):
            testcase.software.ibm.com
 

 
