FBSNG v1.2c Release Notes
-------------------------

This document summarizes the changes made in FBSNG v1.2a comparing to v1.1
and describes v1.1 or v1.2 to v1.2a upgrade procedure.

Major Features implemented in v1.2
----------------------------------

Dynamic farm configuration functionality now includes removing
queues, process types, node classes, resources and resource pools.
Dynamic farm configuration functions are available via command
line interface, GUI and API.

Kerberos authentication support. FBSNG, if required, can use Kerberos v5
to authenticate users. Also, FBSNG can create Kerberos credentials
for batch processes. FBSNG supports proxy lists to support
"group account" concept.

Customizable farm node selection algorithm. In addition to round-robin
process placement algorithm, FBSNG now supports "pack as tightly as
possible" and "spread one per node" schemas of choosing farm nodes
for section processes. This functionality is implemented as experimental
feature, and not yet fully documented.

Ability to run batch processes in interactive mode.

FBSNG GUI monitor provides functionality to monitor abstract resource
utilization.

Improved Scheduler. Scheduler algorithm is improved to allow simpler
"fair share" configuration.

Many bugs found in earlier versions are fixed in v1.2c, including:
- BMGR and Launcher no longer use /tmp for log files. Instead
  they use $FBSNG_ROOT/bmgr and /fbsng directories respectively.
- Improved clean-up after network shutdown
- Improved history output
- Work around system clock shifts
- Fixed recovery procedures in case of farm node shutdown
- Held/locked queue status is now persistent
- Fixed potential hang-up of Kerberos credentials exchange protocol
- "Hidden" sections - "fbs kill <job#>" command does not kill sections
  which names begin with "_"
- New dependency type "canceled"

In v1.2c, history clean-up script "history.run.cron" is absolete.

Upgrading from FBSNG v1.1 or v1.2 to v1.2c in FUE environment
-------------------------------------------------------------
1. Hold all FBSNG queues;
2. Shut down all FBSNG daemons using $FBSNG_ROOT/bin/shutdown_*.sh
   scripts;
3. If necessary, install or upgrade FCSLIB to v1.10;
4. Install, declare and tailor FBSNG v1.2 for all required platforms;
   If you are using UPS to install fbsng, and you do not want to
   install Kerberos, use "upd install -R ..." command.
5. If Kerberos support is required, install and declare Kerberos for
   all platforms;
6. Add "kerberos" and "user_profile" sets to FBSNG configuration file
   $FBSNG_ROOT/fbs.cfg. See FBSNG Installation and Administration Guide
   for details on these sets. See also fbs.cfg.example in templates/cfg
   subdirectory;
7. Initialize FBSNG v1.2 environment (issue setup fbsng);
8. Copy all scripts from $FBSNG_DIR/templates/bin into $FBSNG_ROOT/bin.
   This will replace start_*.sh, shutdown_*.sh, fbs_run.sh, etc.
   Also, this will copy start_fbsng.sh and start_fbsng_central.sh
   scripts.
   If necessary, edit scripts in $FBSNG_ROOT/bin to use correct
   location for setups.sh scripts.
9. Start FBSNG v1.2a components using $FBSNG_ROOT/bin/start_*.sh
   scripts.
10.Remove history.run.cron script from cron table as it is obsolete.

There are no known installations of FBSNG in non-FUE
environemnt. Therefore, this document does not contain
instructions for upgrading of non-FUE installations.
Contact FCS group at fcs-group@fnal.gov for information on
upgrading FBSNG to v1.2 in non-FUE environemnt.

For more details on FBSNG configuration and shutting down and starting FBSNG 
components, see FBSNG Installation and Administration Guide.