wlmtk(5)wlmtk(5)NAMEwlmtk - HP-UX Workload Manager Toolkits
DESCRIPTION
The HP-UX Workload Manager Toolkits (WLMTK) provide utilities that
allow you to use certain products more easily with the HP-UX Workload
Manager (WLM).
WLM is an automatic resource management tool used for goal-based
workload management. A workload is a group of processes that are
treated as a single unit for the purposes of resource management. For
example, a database application that consists of multiple cooperating
processes could be considered a workload.
WLM provides automatic resource allocation and application
performance management through the use of prioritized service-level
objectives (SLOs). Multiple prioritized workloads can be managed on a
single server based on their reported performance levels.
WLMTK currently includes the following toolkits:
* WLM Oracle Database Toolkit (ODBTK)
* WLM Apache Toolkit (ApacheTK)
* WLM BEA WebLogic Server Toolkit (WebLogicTK)
* WLM SNMP Toolkit (SNMPTK)
* WLM SAP Toolkit (SAPTK)
* WLM Toolkit for Base SAS Software (SASTK)
These toolkits are described below.
WLM Oracle Database Toolkit (ODBTK)
This toolkit contains the following utilities:
* wlmoradc
wlmoradc is a data collector for Workload Manager. It provides
an easy building block for Oracle instance management with wlmd(1M).
It takes one or more SQL statements and uses the Oracle tool
SQL*Plus to connect to an Oracle instance and execute the
statements, returning either the raw value returned from the SQL or
the elapsed execution time. The results are sent to stdout for human
viewing, logging, or most often, for use by wlmd(1M) by means of the
wlmrcvdc(1M) or wlmsend(1M) utilities.
* smooth
smooth takes a stream of newline-delimited numbers and outputs a
stream of numbers that are a running average of the last n values,
where n is a value that can be set on the command line. The
principal use for the smooth utility is to remove short spikes or
dips in data collector output used with WLM, but can be
applied to any stream of floating-point numbers.
* cpushares keyword in WLM configuration
Although technically not part of ODBTK, this configuration file
keyword provides shares-per-metric allocations. This enables you to
create goal-based SLOs in WLM of the form "x CPU shares for each
metric y." (A CPU share is 1/100 of one CPU or of each CPU,
depending on WLM's mode of operation.) (This type of allocation can
also be thought of as a parametric allocation. It is calculated
directly from the metric and is thus a function of the metric. This
type of function is a parametric equation.)
NOTE
The cpushares keyword is available starting with
HP-UX WLM Version A.01.02.
WLM Apache Toolkit (ApacheTK)
ApacheTK includes a white paper and example configuration files that
demonstrate resource separation of Apache-based workloads. It also
includes the simple data collector time_url_fetch, which uses the
Apache benchmark tool ab to time URL response times. In addition,
ApacheTK provides wlm_watch.cgi, which provides a web-based
view of the standard prmmonitor, prmlist, and other WLM and
PRM command-line tools. These are view-only reports--no modifications
are allowed from the CGI script.
WLM BEA WebLogic Server Toolkit (WebLogicTK)
WebLogicTK includes a white paper and example configuration files that
demonstrate how to separate WebLogic Server instances and manage their
CPU resources. It also includes the wlmwlsdc data collector for
tracking metrics from WebLogic instances. In addition, it provides the
expsmooth utility for smoothing values from WLM data collectors by
computing a running average in which the importance of old values
diminishes (decays) over time.
Using WLM with WebLogic, you can move CPUs to or from WebLogic Server
instances as needed to maintain acceptable performance. By managing
the instances' CPU resources, the instances will tend to use less net
CPU resources over time. You can then use the additional CPU resources
for other computing tasks.
WLM SNMP Toolkit (SNMPTK)
SNMPTK provides a WLM data collector called snmpdc, which fetches
values from an SNMP agent so you can use them as metrics in your WLM
configuration.
WLM SAP Toolkit (SAPTK)
SAPTK provides a tool called wlmsapmap that identifies SAP
processes based on user-defined criteria. Use this
utility in conjunction with WLM's process map (procmap) feature
to assign the SAP processes to specific workload groups. SAPTK
includes a white paper and example configuration files that
demonstrate the use of the wlmsapmap tool with WLM.
WLM Toolkit for Base SAS Software (SASTK)
====================> NOTE ON DEPRECATION <=========================
SASTK will be deprecated in a future release; however, a new and
improved SASTK will be made available. A white paper and example
configuration files will also be included.
=====================================================================
SASTK provides enhancements to DMTK specifically for users of SAS
software. These enhancements include a macro for instrumenting SAS
jobs to report "percent complete" info to wlmdurdc for fine-tuning of
duration management. (DMTK will be deprecated in a future release.)
EXAMPLES
For example ODBTK configurations, see the files in
/opt/wlm/toolkits/oracle/config/.
For example ApacheTK configurations, see the files in
/opt/wlm/toolkits/apache/config/.
For example WebLogicTK configurations, see the files in
/opt/wlm/toolkits/weblogic/config/.
For example SNMPTK configurations, see the files in
/opt/wlm/toolkits/snmp/config/.
For example SAPTK configurations, see the files in
/opt/wlm/toolkits/sap/config/.
For example SASTK configurations, see the files in
/opt/wlm/toolkits/sas/config/.
SUPPORT AND PATCH POLICIES
Visit http://www.hp.com/go/wlm for information on WLMTK's support
policy and patch policy. These policies indicate the time periods
for which this version of WLMTK is supported and patched. (Use the
"what" command on the file /opt/wlm/toolkits/README to print the
version of your WLMTK.)
AUTHOR
WLMTK was developed by HP.
FEEDBACK
If you would like to comment on the current WLM Toolkits
functionality or make suggestions for future releases, please
send email to:
wlmfeedback@rsn.hp.com
Version information
@(#) HP WLMTK A.01.10.01 (2006_11_05_16_54_54) hpux_ipf
SEE ALSOwlm(5), wlmoradc(1M), smooth(1M), time_url_fetch(1M),
wlm_watch(1M), wlmwlsdc(1M), expsmooth(1M), snmpdc(1M), wlmdurdc(1M),
wlmd(1M), wlmrcvdc(1M), wlmsend(1M), glance_tt(1M), wlmconf(4),
wlmsapmap(1M)
HP-UX Workload Manager User's Guide
(/opt/wlm/share/doc/WLMug.pdf)
Using HP-UX Workload Manager with Apache-based Applications
(/opt/wlm/toolkits/apache/doc/apache_wlm_howto.html)
Using HP-UX Workload Manager with BEA WebLogic Server
(/opt/wlm/toolkits/weblogic/doc/weblogic_wlm_howto.html)
Using HP-UX Workload Manager with SAP
(/opt/wlm/toolkits/sap/doc/sap_wlm_howto.html)
HP-UX Workload Manager Toolkits User's Guide
(/opt/wlm/toolkits/doc/WLMTKug.pdf)
http://www.hp.com/go/wlm
WLMTK updates and information
wlmtk(5)