OpenGrok

Cross Reference: sa
xref: /onnv/onnv-gate/usr/src/cmd/sa
Home | History | Annotate | only in /onnv/onnv-gate/usr/src/cmd/sa
Up to higher level directory
NameDateSize
Makefile29-Oct-20103.3K
README29-Oct-20102.8K
sa.h29-Oct-20105.1K
sa1.sh29-Oct-20101.1K
sa2.sh29-Oct-20101.2K
sadc.c29-Oct-201020.1K
sadp.c29-Oct-201029.3K
sar.c29-Oct-201029.8K
sar.xml29-Oct-20102.5K
svc-sar29-Oct-20102.1K
timex.c29-Oct-20106.7K

README

      1 #
      2 # CDDL HEADER START
      3 #
      4 # The contents of this file are subject to the terms of the
      5 # Common Development and Distribution License, Version 1.0 only
      6 # (the "License").  You may not use this file except in compliance
      7 # with the License.
      8 #
      9 # You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
     10 # or http://www.opensolaris.org/os/licensing.
     11 # See the License for the specific language governing permissions
     12 # and limitations under the License.
     13 #
     14 # When distributing Covered Code, include this CDDL HEADER in each
     15 # file and include the License file at usr/src/OPENSOLARIS.LICENSE.
     16 # If applicable, add the following below this CDDL HEADER, with the
     17 # fields enclosed by brackets "[]" replaced with your own identifying
     18 # information: Portions Copyright [yyyy] [name of copyright owner]
     19 #
     20 # CDDL HEADER END
     21 #
     22 
     23  Copyright 2004 Sun Microsystems, Inc.  All rights reserved.
     24  Use is subject to license terms.
     25 
     26 ident	"%Z%%M%	%I%	%E% SMI"
     27 
     28 README 1.9 of 5/8/89
     29 
     30 Instruction of daily report generation:
     31 
     32 1.  The line
     33 
     34     /usr/lib/sa/sadc /var/adm/sa/sa`date +%d`
     35 
     36     is executed by the start method for the system/sar:default service,
     37     if enabled
     38 
     39     sadc is executed once, such that a special record is written to
     40     the daily data file when UNIX restarts.
     41 
     42 2.  The execution of shell script
     43     sa1 [t n]
     44     causes data collection program to write system activity
     45     counters n times at every t-second interval on data file.
     46     If t and n are not specified, it writes data once.
     47     According to your installation's requirement, enter
     48     entries of executing  sa1 [t n] in /var/spool/cron/crontabs/sys
     49     to collect system activity data.
     50     For example, entries
     51 
     52     0 8-17 * * 1-5 su sys -c "/usr/lib/sa/sa1 1200 3 &" and
     53     0 18-23 * * 1-5 su sys -c "/usr/lib/sa/sa1 &"
     54 
     55     cause data collection program to be activated at every hour
     56     on the hour from 8:00 to 23:00 on weekdays.
     57     Moreover, It writes data on data file 3 times at every 20
     58     minutes interval from 8:00 to 17:00 and once at other times.
     59 
     60 3.  Shell procedure sa2 will invoke sar command to generate
     61     the daily report from the data file.  Its usage is
     62 
     63     sa2 [-options] [-s hh:mm] [-e hh:mm] [-i ss]
     64 
     65     where -s and -e specify the report starting and ending times
     66     respectively, -i specifies the report data interval in seconds.
     67     If they are not specified, all data from the data file are to
     68     be reported.  -options are report options, see manual page
     69     sar.1 for description.
     70 
     71     Make an entry to execute sa2 in /var/spool/cron/crontabs.
     72     For instance, entry
     73 
     74     5 18 * * 1-5 su adm -c "/usr/lib/sa/sa2 -s 8:00 -e 18:01 -i 3600
     75     -ubd &"
     76 
     77     causes the invocation of sar command at 18:05.  It generates
     78     the daily report that includes the hourly cpu utilization,
     79     buffer usage and disk and tape  activities from 8:00 to 18:01.
     80