[intrepid-notify] upcoming clusterbank upgrade

[Jonathon Anderson]

On 8 September 2008 a new version of clusterbank (0.3.2) will be
enabled in the default software environment on Surveyor and Intrepid.
Along with the requisite bug fixes, changes have been made to the
command-line user interface, cbank.

Some architectural changes have been made with respect to how the
different reports are called internally, having the effect that the
report name must come before any other options. For example, whereas
before "cbank -p project1 charges" was admissible, now it must be
"cbank charges -p project1".

= new reports =
 A 'users' report has been added to display charge summaries
"by-user". A 'holds' report has been added, parallel to the 'charges'
report, to display active holds. (The ALCF does not yet utilize
holds.)

= report options =
The 'projects', 'allocations', and 'charges' reports have all been
updated to behave more intuitively by default and when presented with
the available options.

= default 'charges' time window =
The 'charges' report now displays, by default, only those charges that
occurred within the past 7 days. You can override this behavior using
the -a, --after option:

cbank charges -a 2008-04-01

= report columns =
The columns of the three existing reports has changed.

== projects ==
 0.2.15.1::
   Name,Members,Owner,Allocated,Available
 0.3::
   Name,Charges,Charged,Available

== charges ==
 0.2.15.1::
   Date,Resource,Project,User,Amount
 0.3::
   #,Date,Resource,Project,User,Charged

== allocations ==
 0.2.15.1::
   Expires,Resource,Project,Allocated,Available
 0.3::
  #,Expiration,Resource,Project,Charges,Charged,Available


= Multi-value options =
Multi-value option processing has changed from comma-separated values
to multiple options. For example:

cbank -p project1,project2

becomes

cbank -p project1 -p project2

= -e, --extra-data =
The -e, --extra-data flags that is available on some reports has been
deprecated in favor of -c, --with-comments to better reflect its
purpose in 0.3.

= entity ids =
The allocation and charge reports now provide an id column. This id
can be used to get detailed information on any specific allocation or
charge:

cbank detail charge <charge id> ...
cbank detail allocation <allocation id> ...

An FAQ page for the 0.3 series is available at
http://trac.mcs.anl.gov/projects/clusterbank/wiki/faq-0.3

Please contact the ALCF Support Helpdesk, support at alcf.anl.gov, if you
have any trouble, questions, or comments.