S4PM 4.0.0 RELEASE NOTES

Release Date

July 24, 2002

Functional Changes

1. NO CHANGES TO ANY CONFIGURATION FILES SHOULD BE MADE DIRECTLY IN ANY STATION BUILT BY STRING MASTER. THIS INCLUDES ALL station.cfg FILES AS WELL AS ALL OTHER .cfg FILE. Changes should only be made via String Master.
   
   
2. In its first use, tk_pwbox.pl is being used with RELEASE_JOB_NOW and EXPIRE_CURRENT_TIMERS in the Gran Find station. When an operator clicks on the RELEASE JOB NOW or the EXPIRE CURRENT TIMERS buttons in the GUI, he/she is prompted for a password before the job is released. An incorrect password results in the job not being released.
   
   
3. Trigger PGE jobs will fail if the trigger data type turns up missing. This, of course, should never happen. One way this can happen is if, after a job gets through Gran Find, someone manually cleans out or manually deletes the trigger data type. It can't be deleted by clean_expired_data.pl since Gran Find does a /touch/ on granules it locates to ensure that they stick around a while longer.
   
   
4. Data that is cleaned by virture of the clean_expired_data.pl script now produce clean data work orders with CLEAN_EXPIRED in the file name. In this way, such data cleans can be easily distinguished among the archived logs.
   
   
5. Lifeguard has been replaced by Smart Alloc, a new GUI for viewing the current state of the disk pools. It should prove more useful and it addresses some of the shortcomings of Lifeguard.

Detailed File Changes

tk_smart_alloc.pl

• New GUI replacement for Lifeguard that provides a graphical monitor for the Allocate Disk database, which shows the available space in the data pools. For each pool, it shows how much of the pool has been allocated in terms of granules. There is both a bar-type graphical display, as well as the actual numbers of granules used (allocated), left (space available), and total. The color of the bar turns yellow at 70% used, orange at 85% and red at 95%.

tkS4PMadmin.pl

• Got rid of any checking for the grancentral.csv file and thereby fixed a bug where this file was being created anew each time database clean up was run.
• Modified Integrity Check portion so that if the audit_config.pl script is not found, the program quietly skips it and doesn't flag it as an error. With String Master coming, the audit_config.pl is becoming obsolete.

run_pge.pl

• Modified on behalf of the DPREP PGEs so that an exit code of 216 is considered a success (equivalent to 0).

clean_expired_data.pl

• Changed the output work order file name to something that includes 'EXPIRED' so that when the Clean Data log files are archived, one can distinguish this type from other types (e.g. manual clean out of data via the Clean Data GUI).
• Fixed a bug where the script was still looking for the granfind.cfg file in order to know directory locations of data. This information is gotten from the allocdisk.cfg file instead.

trigger_pge.pl

• Minor fix so that script fails when it discovers the trigger data file missing (rather than noting it and simply continuing).

show_pge.pl

• Minor fix that was causing it to fail in the AIRS instance in OPS mode where some of the PGE directories had been purposely "hidden" to prevent accidental runs with them.

gen_input_usage_report.pl

• New script that parses the granfind.log files and produces statistics on stdout. There are many options; see man page.

tk_pwbox.pl

• New script that produces a pop-up box to obtain a password. If the password is accepted, the command is run. This allows "risky" commands (such as "touch RELEASE_JOB_NOW") to be password protected.

receivePAN.pl

• Modified to fail quickly on zero-length PDRD/PANs.

stringmaster.pl

• This is a new program for managing the configurations of S4PM strings. Once this is validated and operational, this should be the only means through which permanent changes to strings are made.

Stringmaster can be run in 5 different modes:

1. Query mode (-q argument)

Queries the current configuration for a string

Example: stringmaster.pl -q tmp.1 -s S4PM10_TE_FW.cfg

puts the configuration of the S4PM10_TE_FW string in the directory tmp.1.

2. Update mode (-u argument)

Updates the current configuration for a string

Example: stringmaster.pl -u -s S4PM10_TE_FW.cfg

Overwrites the current configuration files in the S4PM10_TE_FW string.

3. Creation mode (-c argument)

This creates a new string, or updates an existing one. It is the only way to update a string if new directories or symbolic links are needed.

Example: stringmaster.pl -u -s S4PM99_TE_FW.cfg

Creates a new configuration for the S4PM99_TE_FW string.

4. Append mode (-a argument)

This appends any max_children override values to the station configuration files as $cfg_max_children values.

Example: stringmaster.pl -a -s S4PM10_TE_FW.cfg

5. Hypothetical mode (no arguments)

This creates the temporary configuration files that would be used for an update or creation.

Example: stringmaster.pl -s S4PM10_TE_FW.cfg

Puts new configuration files in ./tmp.

More details can be found in the stringmaster and related man pages.