WLM_WATCH.CGI(1M)WLM_WATCH.CGI(1M)
ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
NAME
wlm_watch.cgi - CGI script for providing web-based view of various WLM
monitoring tools
SYNOPSIS
wlm_watch.cgi[?option]
OPTIONS
Options to wlm_watch.cgi are given via URL parameters, not the command
line. The options are given below.
choice
Specifies the menu choice to run. Acceptable values include:
choice=help:about_WLM
Prints information about the running version of WLM
choice=help:about_wlm_watch.cgi
Prints information about the running version of wlm_watch.cgi
choice=status:wlminfo_group
Runs wlminfo group
choice=status:wlminfo_slo
Runs wlminfo slo
choice=status:wlminfo_metric
Runs wlminfo metric
choice=status:wlminfo_host
Runs wlminfo host
choice=status:wlminfo_par
Runs wlminfo par
choice=status:wlminfo_proc
Runs wlminfo proc
choice=status:groups
Runs prmlist
choice=status:cpu_usage
Runs prmmonitor
choice=status:active_wlm_file
Searches through the WLM log file for the WLM configuration files
that have been active and lists the most recent.
choice=status:show_active_wlm_file
Shows the current config file via the 'wlmd -C' command.
choice=errors:syslog
Runs the HP-UX 'tail' command on the syslog
/var/adm/syslog/syslog.log
choice=errors:syslogWLM
Looks for the last several syslog messages containing
'wlm' or 'WLM'.
choice=errors:msglog
Runs the HP-UX 'tail' command on the default wlmd error log
/var/opt/wlm/msglog
choice=metrics:wlmdstats
Runs the HP-UX 'tail' command on the default wlmd stats log
/var/opt/wlm/wlmdstats log file (See wlmd's logging options
for more information on stats.)
choice=procs:process_list
Lists the active workload groups using the HP-UX 'ps -efP'
command; output is sorted by PRM groupname
choice=procs:process_groups
Lists the active workload groups using the HP-UX 'ps -efP'
command excluding PRM_SYS and OTHERS; output is sorted by
PRM groupname
choice=apache:tail_error_log
Runs the HP-UX 'tail' command on the default Apache log
/opt/hpws/apache/logs/error_log
choice=apache:tail_access_log
Runs the HP-UX 'tail' command on the default Apache log
/opt/hpws/apache/logs/access_log
PRMGROUP
Optionally specifies a target PRM workload group for the
choice=procs:process_list menu item.
DESCRIPTION
wlm_watch.cgi is a simple CGI script that lets a system administrator
monitor the workload groups and processes on a given server by having
Apache run wlminfo, prmlist, ps -ePR, prmmonitor, and other commands.
Only read-only commands are supported--the system administrator must
log into the system to make WLM or PRM changes.
Output
The output of the wlm_watch.cgi script is similar to the various WLM
and PRM commands that allow the user to list or monitor the workload
groups and their processes.
Errors
wlm_watch.cgi reports errors to the user's browser via the CGI::Carp
module.
EXAMPLES
Example 1
Run wlm_watch.cgi starting with the default menu:
http://myhost/cgi-bin/wlm_watch.cgi
Example 2
Call wlm_watch.cgi and immediately list the processes with workload
(PRM) group names:
http://myhost/cgi-bin/wlm_watch.cgi?choice=procs:process_list
Example 3
Call wlm_watch.cgi and immediately list the processes in the specific
'mygroup' workload group:
http://myhost/cgi-bin/wlm_watch.cgi?choice=procs:process_list&PRMGROUP=mygroup
RETURN VALUE
wlm_watch.cgi reports problems to the user's browser via the
CGI::Carp module.
LIMITATIONS
If showing workload groups, users, or process names is not acceptable
for your security situation, do not enable wlm_watch.cgi.
wlm_watch.cgi requires perl 5 and the CGI module. These are available
from various sources including http://www.hp.com/go/softwaredepot.
The CGI::Carp module is required if you want to display CGI errors in
the user's browser; otherwise, comment out the CGI::Carp line in the
wlm_watch.cgi file.
PATH DEPENDENCIES
To view the latest entries in the error_log and access_log,
wlm_watch.cgi must know where the logs files are. To be flexible,
wlm_watch.cgi attempts to locate the log files in potential apache
installation locations. First, wlm_watch.cgi checks the setting of
HPWS_APACHE_ROOT in /etc/rc.config.d/hpws_apacheconf if it exists. If
it does not, or there is no setting, /opt/hpws/apache/ is used. If
that does not exist, /opt/apache/ is used. If that does not exist
either, an error message is printed.
If you have used other paths for the the log files or you are not using
the default names access_log and error_log, you may need to modify your
copy of wlm_watch.cgi to view them. Be sure to modify the copy you
place in your cgi-bin directory, not the /opt/wlm/tool‐
kits/apache/bin/wlm_watch.cgi copy, as that copy will be overwritten
during any WLM upgrades.
AUTHOR
wlm_watch.cgi 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), wlmtk(5), wlmd(1M), wlminfo(1M), prmlist(1M), prmmonitor(1M)
Using HP-UX Workload Manager with Apache-based Applications
(/opt/wlm/toolkits/apache/doc/apache_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
WLM_WATCH.CGI(1M)