tunesh(ADM)                   06 January 1993                    tunesh(ADM)


 Name

    tunesh - administrator interface for kernel tuning

 Syntax

    /usr/lib/tunesh/tunesh

 Description

    tunesh tailors kernel resources based on your system configuration and
    information you supply about expected usage.  It tunes a large set of
    kernel parameters (as opposed to configure(ADM), which is used to adjust
    individual parameters).  tunesh can be invoked by the super user to
    reconfigure the system to account for changes in usage, installation of
    additional memory, and so on.

    tunesh makes adjustments based on the following information:

    +  the amount of memory (RAM) installed (detected automatically)

    +  software components installed (particularly NFS)

    +  the number of X terminals - Server only

    +  the number of serial login sessions (serial terminals and modems) -
       Server only

    +  the number of remote login sessions (via rlogin, telnet, and ftp) -
       Server only

    +  the number of filesystems exported and imported via NFS

    +  number of local filesystems that will be mounted

    Kernel parameters are adjusted according to the information provided.  To
    allow the changes to take effect, the kernel must be relinked.

    tunesh also sends mail to root listing the changed parameters and their
    new values, plus any error messages encountered during the tuning pro-
    cedure.

    tunesh modifies the following parameters:

    GPGSHI     NBLK16     NBUF      NMPBUF       NSTREAM
    GPGSLO     NBLK2048   NCLIST    NMPHEADBUF   S5CACHEENTS
    MAXBUF     NBLK256    NFILE     NNFSRNODE    S5HASHQS
    MAXSLICE   NBLK4      NHBUF     NPROC
    MAXUP      NBLK4096   NHINODE   NQUEUE
    NBLK1024   NBLK512    NINODE    NREGION
    NBLK128    NBLK64     NMOUNT    NSPTTYS

    After tunesh calculates each parameter value, it is compared with the
    maximum possible value listed in mtune(F). If the calculated value is
    larger than the maximum possible, the value is set to the maximum. If the
    parameter value is less than the current default stated in the mtune
    file, it is set to the default value.  idtune(ADM) is then called with
    the -f and -m flags to tune the kernel based on the parameter value.  If
    the calculated value is less than the value specified in stune(F) (if it
    is there already), the value is not changed.  When a calculated parameter
    value is less than the existing value, the existing value is retained.
    The System configuration log mail reflects only the calculated values.

 See also

    configure(ADM), idtune(ADM), sar(ADM), mtune(F)

    Performance and Troubleshooting in the System Administrator's Guide

 Notes

    The configuration program calculates and sets system resources to levels
    appropriate for your system configuration, but may not result in optimum
    system performance.  System administrators should monitor the system and
    perform manual tuning to maximize system performance.  The Personal Sys-
    tem makes calculations assuming 2 serial login sessions, 2 X-terminals,
    and 2 remote logins (the limits imposed by the Personal System license).

 Value added

    tunesh is an extension of AT&T System V provided by The Santa Cruz Opera-
    tion, Inc.