Capacity Reports Logo  

Performance & Capacity Planning for AIX and Power Systems

pSeries Configuration and Performance Tool Install and Setup

How to collect the topas and nmon data.

Create a user id for your performance collection data.
We do not require the use of the root account, except for running nmon and topas CEC recording processes.
Decide where you want to store your nmon and topas data files.
We suggest that you use the /usr/local/nmon directory.
Decide on which AIX system you want to store the hmc and performance data files.
We suggest this is your nim server as this server needs to have an HTTP Web Server (Apache) with PHP.
It will also need ssh and scp access to all your client nodes.
Decide which filesystem you want to store all this data in.
We have created, mounted and used a /support JFS2 file system with inline log for these examples.

Setup NMON (topas_nmon) to run in data collection mode. Process should run as root.

Setup nmon to run in data collection mode.
    Running NMON on AIX
    Running NMON on VIO

Setup topas CEC recording for one LPAR in each pSeries machine. Process should run as root.

Setup topas CEC recording mode in one LPAR for each pSeries system.
Note: For AIX5.3, the set location for topas CEC recordings is /etc/perf.
 
Note: These recordings are no longer required for Version 2.0.
 
    AIX 5.3 - Add the following (single line) to /etc/inittab with mkitab
        mkitab "topasrec:2:once:/usr/bin/topas -R 2>&1 >/dev/null # Start topas recording"
    AIX 6.1 - Add the following (single line) to /etc/inittab with mkitab
        mkitab "topasrec:2:once:/usr/bin/topasrec -C -s 300 -R 1 -r 7 -o /usr/local/nmon/ -ypersistent=1 >/dev/null # Start topas recording"

Install all the pre-requisite RPMs and file-sets.

    List of RPMs you will need to install or build.
    Build Apache with php.
    Build the rrdtool software.

Download and extract the source tar file.

    Version 1.0 which has the following limitations:
        4-way power7 SMT systems - Incorrectly reports double the number of virtual processes on a 4-way SMT system.
        For VSCSI and NPIV disk mappings, this only supports Hitachi and internal SAS storage.
    Version 2.0 which now no longer requires the topas -C recordings
        I've fixed the 4-way power7 SMT systems.
        For VSCSI and NPIV disk mappings, this now supports Hitachi, internal SAS and EMC storage.
    Version 2.2Bug fixes from V2.0 and V2.1. Full package install.
        Fixed the bugs where pseries configurations would no longer display.
        Fixed various other minor bugs and display errors.
        Added defaults to php to stop errors and warnings in apache logfile.

Modify the following files as per your environment.


    /support/pseries_configs/hmc_list
        This file contains the hostnames of your HMC's.

    /support/pseries_configs/.ssh/hmc_key
    /support/pseries_configs/.ssh/collection_key
        These files contain the ssh keys required to authenticate with your HMC (hmc_key) and LPAR's (collection_key).

    /support/pseries_configs/unix_and_storage_header.php
        This file contains this line '<h2 class="auto-style2">pSeries Capacity and Performance Website</h2>'
        Change this text to what you would like to see as the header on your website.

    /support/pseries_configs/pseries_defaults.php
        This file contains the defaults used in the php scripts. If you use a different directory structure,
        you will need to update this file with the new directory names.

    /support/perf/include/rrd_defaults
        This file contains the defaults used in to create the performance graphs.
        If you use a different directory structure, you will need to update this file with the new directory names.
        This file also contains the graph sizes and colours, the UNIX user and group and the web server details.
        
    /support/perf/scripts/example_get_nmon
        This file is an example file for how to collect all the nmon and topas data files.
        You may use this file as is, or modify it as per your sites requirements.

Setup crontab to get it all working.

# These are just examples, please customise to your requirements.
# Collect the hmc configurations
50 06,09,12,15 * * * /support/pseries_configs/get_hmc_config 1>/dev/null 2>&1
# Create the VIO SCSI mappings
00 08 * * * /support/pseries_configs/create_scsi_maps 1>/dev/null 2>&1
# Collect the nmon and topas data every hour
01 00 * * * /support/perf/scripts/example_get_nmon 1>/dev/null 2>&1
# Collect the nmon and topas data every hour at 15 minutes past.
15 00 * * * /support/perf/scripts/process_perf.ksh 1>/dev/null 2>&1