TOCPREVNEXTINDEX

Lund Performance Solutions


SOS/SOLARIS Overview

SOS Performance Advisor Architecture

SOS/SOLARIS Performance Advisor is comprised of several programs and files. The relationships between the most significant programs and files is illustrated in Figure 2.1.


Figure 2.1 SOS/SOLARIS Performance Advisor relationships between key processes and files
The LPSMID process is responsible for retrieving much of the performance data from the kernel and providing it to other processes. The user does not have to execute LPSMID, it will be executed automatically by any process that requires it. LPSMID is a daemon process, so it executes in the background and does not interact with the user. Any informational, warning, and error messages from LPSMID will be stored in the lps.log file.

The LPSMID process uses a shared memory segment to deliver the performance data to other processes, which include SOS and SOSLOGD. In addition to the data provided by LPSMID, both SOS and SOSLOGD retrieve some data from the kernel directly.

The SOS process displays real-time performance data to the user in text mode.

SOSLOGD is a daemon process. Its function is to periodically write performance data to log files for later historical analysis. Since it’s a daemon process, it also stores informational, warning, and error messages in the lps.log file.

The SOSLOGX process reads the log files created by SOSLOGD. SOSLOGX displays this information to the user, and also allows the user to convert that information to other file formats:
  • ASCII text, to export data to spreadsheet applications, such as MS Excel.
  • Performance Gallery Gold (*.pfg), to export data to Performance Gallery Gold, a trend analysis and graphical reporting application by Lund Performance Solutions.
  • For information about Performance Gallery Gold, please refer to the Performance Gallery Gold User’s Guide or contact your Lund account manager (see "Lund Performance Solutions Sales Team").

    OSF/1 Directory Hierarchy

    SOS Performance Advisor versions 2.x, A.0x and later use the OSF/1 directory hierarchy.

    IMPORTANT A directory other than the default directory can be assigned during the installation process. Please be aware that every user of this software package will need the same directory in their path.

    Directories


    IMPORTANT The LPS directory statements that include the default directory and the corresponding environment variable must be set if the default location is not used.
    For example:
    LPS_OPT_PATH=/opt/lps
    Where:
  • LPS_OPT_PATH is the environment variable
  • /opt/lps is the default directory location

  • In the past, all Lund Performance Solutions files (lps files) associated with the SOS Performance Advisor application could be found in one directory (LPSPATH=/opt/lps). In accordance with the OSF/1 standard, Lund Performance Solutions files are now located in three different directories, which are described in the next table.
    Table 2.1 SOS Performance Advisor directory locations
    Directory
    Description
    LPS_ETC_PATH=/etc/opt/lps
    Contains host-specific configuration files that can be modified by the user.
    LPS_OPT_PATH=/opt/lps
    Contains host-specific, third-party files that do not generally change.
    LPS_VAR_PATH=/var/opt/lps
    Contains host-specific files that are dynamic in nature, including temporary files and files that grow in size.

    Subdirectories

    The subdirectories of each directory are listed and described in the next table (it is assumed the default directory is used).
    Table 2.2 SOS Performance Advisor subdirectory listings
    Directory
    Subdirectory
    Description
    /etc/opt/lps/
    cfg
    Contains configuration files used by the Lund Performance Solutions products. Initially, these will be the same files found under /opt/lps/newcfg, except they are actually used by the product and can be modified by the user.
    rpt
    Contains SOSLOGX report files.
    /opt/lps/
     
    bin
    Contains the lps binary files.
    lib
    Contains the lps library files.
    newcfg
    Contains the configuration files as distributed by Lund Performance Solutions (before user customization). These files are meant to be used as a reference point. They are not actually used by the product. See /etc/opt/lps for more information.
    /var/opt/lps/
    log
    Contains log files.
    tmp
    Contains temporary files.

    Files

    The following file listings are grouped by directory location.
    Table 2.3 SOS Performance Advisor file listings
    Location
    File
    Description
    /etc/opt/lps/cfg/
    advice
    Contains configurations for the SYSTEM PERFORMANCE ADVICE messages in the Global Summary screen.
    holidays
    Contains the configurations for holidays (predetermined days to be excluded from data collections).
    ppoints
    Contains configurations for pulse points.
    soskip
    Contains configurations for the KIP (key indicators of performance) line.
    workdefs
    Contains workload definitions.
    /etc/opt/lps/rpt/
    reprtdef
    Contains compiled SOSLOGX reports.
    *.rpt
    Contains SOSLOGX reports.
    /opt/lps/bin/
    kiclean
    An executable program that turns off kernel measurements and cleans up the interprocess communication (IPC) structures created by LPSMID (for example, micro-state accounting for Solaris).
    lpscheck
    A program that checks the license status.
    lpsextnd
    An executable program used to extend the demonstration license expiration date.
    lpskill
    An executable program that kills any lps daemon.
    lpsmid
    A daemon that periodically reads process information from the /rocfs structure and saves it.
    /opt/lps/bin/
    lpstrap
    A script to send SNMP traps from the advice module to an event browser.
    sos
    The character-based real-time performance tool.
    soslogd
    A daemon that creates historical performance files.
    soslogx
    A character-based tool to view the historical files and extract them for other formats (such as Performance Gallery gold data files (*.pfg)).
    sosrcrom
    The SOSLOGX report compiler.
    /opt/lps/lib/
    itemlist
    A list of all data items logged in historical files and usable by soskip, advice, and ppoints.
    license
    A new version of license file.
    logxhelp
    The SOSLOGX online help file.
    lpscfg
    The obsoleted license file.
    pfgitems2
    A list of Performance Gallery Gold extraction items.
    soshelp
    The SOS online help file.
    /opt/lps/newcfg/
    cfg
    The advice, ppoints, soskip, and holidays configuration files as distributed by Lund Performance Solutions (before user customization). See /etc/opt/lps/cfg for descriptions.
    rpt cfg
    The reprtdef and *.rpt files as distributed by Lund Performance Solutions (before user customization). See /etc/opt/lps/rpt for descriptions.
    /var/opt/lps/log/
    SLLOGCAT
    The log file catalog.
    SL*
    Contains historical log files.
    /var/opt/lps/tmp/
    *unix.ino
    Contains kernel inode to help determine if rebuild of ksymbols.db is necessary.
    lps.log
    Contains messages from lps daemons.
    lpsmid.pid
    Contains the LPSMID process ID.
    soslogd.pid
    Contains SOSLOGX process ID.

    Environment Variables

    Each of the environment variables are outlined in Table 2.4. For instructions to set the environment variables, see "Setting the Environment Variables".
    Table 2.4 SOS Performance Advisor environment variables
    Variable Name
    Default Value
    Accepted Value
    PATH
    $PATH:/opt/lps/bin
    $PATH:/<custom directory name>/bin
    TERM
    N/A
    N/A
    LPS_OPT_PATH
    /opt/lps
    An existing, fully-qualified directory
    LPS_ETC_PATH
    /etc/opt/lps
    LPS_VAR_PATH
    /var/opt/lps
    LPS_TIME_SEP
    : (colon)
    Any single alpha-numeric character
    LPS_DATE_SEP
    / (forward slash)
    LPS_DECIMAL_INDICATOR
    . (period)
    LPS_DATE_FMT
    MDY (month day year)
    MDY, DMY, or YMD

    Security

    UNIX software products from Lund Performance Solutions utilize a system group for security purposes. The "lps" group is created during the software installation process.

    Members of the lps group can execute the following tasks:
  • Modify existing SOS Performance Advisor reports.
  • Execute kiclean to remove unnecessary overhead and used memory by LPSMID when it is not able to perform cleanup prior to the last exit (when LPSMID is killed using the 9 signal (kill -9 PID)).
  • The LPS group is also used to enforce security for log files, the log catalog and the lps directories.

    Lund Performance Solutions
    www.lund.com
    Voice: (541) 812-7600
    Fax: (541) 81207611
    info@lund.com
    TOCPREVNEXTINDEX