The HTCondorView Client Contrib Module¶
The HTCondorView Client contrib module is used to automatically generate World Wide Web pages to display usage statistics of an HTCondor pool. Included in the module is a shell script which invokes the condor_stats command to retrieve pool usage statistics from the HTCondorView server, and generate HTML pages from the results. Also included is a Java applet, which graphically visualizes HTCondor usage information. Users can interact with the applet to customize the visualization and to zoom in to a specific time frame.
After unpacking and installing the HTCondorView Client, a script named make_stats can be invoked to create HTML pages displaying HTCondor usage for the past hour, day, week, or month. By using the Unix cron facility to periodically execute make_stats, HTCondor pool usage statistics can be kept up to date automatically. This simple model allows the HTCondorView Client to be easily installed; no Web server CGI interface is needed.
Step-by-Step Installation of the HTCondorView Client¶
Make certain that the HTCondorView Server is configured. Section Setting Up for Special Environments describes configuration of the server. The server logs information on disk in order to provide a persistent, historical database of pool statistics. The HTCondorView Client makes queries over the network to this database. The condor_collector includes this database support. To activate the persistent database logging, add the following entries to the configuration file for the condor_collector chosen to act as the ViewServer.
POOL_HISTORY_DIR = /full/path/to/directory/to/store/historical/data KEEP_POOL_HISTORY = True
Create a directory where HTCondorView is to place the HTML files. This directory should be one published by a web server, so that HTML files which exist in this directory can be accessed using a web browser. This directory is referred to as the
Download the view_client contrib module. Follow links for contrib modules from the wiki at https://htcondor-wiki.cs.wisc.edu/index.cgi/wiki.
Unpack or untar this contrib module into the directory
VIEWDIR. This creates several files and subdirectories. Further unpack the jar file within the
jar -xf condorview.jar
Edit the make_stats script. At the beginning of the file are six parameters to customize. The parameters are
A brief name that identifies an organization. An example is “Univ of Wisconsin”. Do not use any slashes in the name or other special regular-expression characters. Avoid the characters ˆ and $.
The e-mail address of the HTCondor administrator at your site. This e-mail address will appear at the bottom of the web pages.
The full path name (not a relative path) to the
VIEWDIRdirectory set by installation step 2. It is the directory that contains the make_stats script.
The full path name of the directory which contains the condor_stats binary. The condor_stats program is included in the
<release_dir>/bindirectory. The value for
STATSDIRis added to the
PATHparameter by default.
A list of subdirectories, separated by colons, where the make_stats script can find the awk, bc, sed, date, and condor_stats programs. If perl is installed, the path should also include the directory where perl is installed. The following default works on most systems:
To create all of the initial HTML files, run
Open the file
index.htmlto verify that things look good.
Add the make_stats program to cron. Running make_stats in step 6 created a
cronentriesfile is ready to be processed by the Unix crontab command. The crontab manual page contains details about the crontab command and the cron daemon. Look at the
cronentriesfile; by default, it will run make_stats hour every 15 minutes, make_stats day once an hour, make_stats week twice per day, and make_stats month once per day. These are reasonable defaults. Add these commands to cron on any system that can access the
STATSDIRdirectories, even on a system that does not have HTCondor installed. The commands do not need to run as root user; in fact, they should probably not run as root. These commands can run as any user that has read/write access to the
VIEWDIRdirectory. The command
can set the crontab file; note that this command overwrites the current, existing crontab file with the entries from the file
Point the web browser at the
VIEWDIRdirectory to complete the installation.