AIX LPAR Entitlement Usage Monitor
This plug-in service monitor example was designed by uptime software with assistance from a number of up.time users. A special thanks goes out to Anders for his contribution to this monitor.
1. About
The AIX LPAR Entitlement service monitor returns basic information about LPAR entitlement usage in a micropartitioned environment. In a virtualized lpar environment % CPU usage for an lpar does not always give a complete picture of the performance of your lpar, this entitlement information provides additional information that will add value to your current up.time agent statistics in a virtualized environment.
The monitor is based on simple output from sar on your AIX lpar system. The scripts are written in shell script for linux/solaris and vbscript for windows monitoring stations.
Metrics
Entitlement
– the current CPU entitlement for this lpar
PCPU Usage
– the current physical CPU usage for this lpar
% Entitlement Used
– the current % of entitlement this lpar is using. If this value goes over 100% the lpar is consuming more than the allotted entitlement.
Configuration Options
Script Name
– the script to be executed. This should not require any changes
Agent Port
– the port that your AIX lpar agent is listening on
Agent Script Password
– the agent side script password as found in .uptmpasswd
Additional Information
– Agent based service monitor (requires some configuration on each lpar you wish to monitor)
– requires up.time 4
– requires AIX 5.3 agent with micropartitioning enabled
Download
– Agent Side Script
– Solaris/Linux monitoring station files
– Windows monitoring station files
2. Installation
Agent Side installation
The following must be completed on each of your AIX lpars that you wish to run this service monitor against.
1. Install the latest AIX agent found here
2. Create or edit the /opt/uptime-agent/bin/.uptmpasswd file. Ensure it is owned by the nobody user.
3. Add this line to the .uptmpasswd file. Change the '1234' if you wish to use a custom password for this script.
1234 /opt/uptime-agent/bin/lpar.sh
4. Download the agent side script lpar.sh and place it in the /opt/uptime-agent/bin/ folder on the lpar agent. Ensure the file is executable.
Your agent side setup is now complete
Solaris/Linux monitoring station installation
This section only applies if you are running up.time 4 on a Solaris or Linux monitoring station
1. Download check_lpar_ent_nix.tar to your up.time monitoring station
2. Extract the file from your up.time installation folder.
# su – uptime
$ cd /usr/local/uptime4
$ tar -xvf check_lpar_ent_nix.tar
3. Load the plug-in monitor template using these commands
# cd /usr/local/uptime4
# scripts/erdcloader -x “scripts/check_lpar_ent.xml”
4. Adjust PATH information
If you installed up.time to a location other than /usr/local/uptime4 be sure to edit the “check_lpar_ent.sh” file. Look for this line within the file and adjust to match your installation directory.
UPTIME_BASE=/usr/local/uptime4
5. You should now be able to add a service monitor of type 'LPAR Entitlement Usage', you will find it at the bottom of your Add Service Instance Page.
Windows monitoring station installation
This section is only required if you are running up.time 4 on a Windows monitoring station.
1. Download check_lpar_ent_win.zip to your up.time monitoring station
2. Extract the file into your up.time installation folder under the scripts subfolder.
3. Load the plug-in monitor template using these commands
> cd
> scriptserdcloader -x “scriptscheck_lpar_ent.xml”
4. You should now be able to add a service monitor of type 'LPAR Entitlement Usage', you will find it at the bottom of your Add Service Instance Page.
3. Setting up your service monitor
After configuring both your agent side script and your monitoring station you can now add your 'LPAR Entitlement Usage' service monitor to any agent system that is running the agent side script.
* Login to the up.time web interface
* Click Services -> Add New Service Instance
* Select 'LPAR Entitlement Usage' from the lower section of the new window
* Enter a service name and description
* Select the agent (or service group) you wish to assign this monitor to
* Enter your monitor configuration information. If you have not changed the agent port or password from the examples you can leave the first 3 fields as is.
* Enter your thresholds for each performance metric this monitor includes. Don't forget to click 'Retained Data Tracking' for each metric so that you can graph out the information later