Server Scripts

The Location for each of these scripts is both where they should live, but also where the most recent copies can currently be found.

Statistics

Note: These scripts are dependent on the timestamp scheme currently being used (MMM dd yyyy HH:mm:ss.SSS). These scripts assume that administrators will want to break down usage into the groups In Music Library, On Campus, Off Campus, and Totals which are specified by IP addresses. These scripts only deal with UI and Darwin Streaming Server log processing and analyzing.

generateStats.pl

Location:

/home/dmlserv/dml/bin/

Usage:

generateStats.pl Mmm dd yyyy filename (Analyze only specified date)
generateStats.pl filename (Analyze an entire file)
generateStats.pl (Analyze yesterday)

When to run:

Nightly

Notes:

 

Changes to make for test sites:

Line 75: sortedlogfiles - filesystem path to Darwin log files
Line 82: logfile - filesystem path to Darwin log file
Line 88: filepath - filesystem path to output directory where statistics live
Line 565: music_ip_file - full filesystem path to file containing IPs of Music Library computers
Line 569: oncampus_ip_file - full filesystem path to file containing IPs of On Campus computers

generateQTStats.pl

Location:

/home/dmlserv/dml/bin/

Usage:

generateQTStats.pl filename (Analyze an entire file)
generateQTStats.pl (Analyze all logfiles /var/streaming/logs/StreamingServer.*.log or /var/streaming/logs/StreamingServer.log)

When to run:

Nightly

Notes:

 

Changes to make for test sites:

Line 33: filepath - filesystem path to output directory where statistics live
Line 34: logfilepath - filesystem path to where logfiles live
Line 499: music_ip_file - full filesystem path to file containing IPs of Music Library computers
Line 502: oncampus_ip_file - full filesystem path to file containing IPs of On Campus computers
Line 965: cmd - contains full filesystem path to ID translation script

viewStats.cgi

Location:

/var/www/cgi-bin/

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="605a51ec-e8a4-4004-a9e8-5d0b2302bbc3"><ac:plain-text-body><![CDATA[

Usage:

viewStats.cgi?[current][year=yyyy][month=Mmm][day=dd][location=In+Music+Library|On+Campus|Off+Campus|Totals][view=yearly|monthly|daily]

]]></ac:plain-text-body></ac:structured-macro>

When to run:

Whenever an administrator wants to view statistics

Notes:

For this script to work the filepath directory should be linked into an apache viewable directory that is specified with urlpath.
This script now displays both UI and Darwin statistics.

Changes to make for test sites:

Line 28: filepath - filesystem path to statistics files generated by generateStats.pl and generateQTStats.pl
Line 29: v2URL - url of access page rendering script
Line 30: urlPath - url where comma delimited files and generated images can be found
Line 31: homepage - url of statistics about page
Line 282: CSS link is specified as urlPath/dml1.css