FBSNG v1.1 Release Notes
------------------------

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

Major Features implemented in v1.1
----------------------------------

The concept of Resource Pools (see FBSNG Resources) is implemented in 
FBSNG v1.1. With Resource Pools implemented, FBSNG can handle sets of 
interchangeable resources such as multiple scratch disks on worker nodes, 
compatible versions of required software, etc.

Many farm configuration parameters are available for dynamic modifications. 
FBSNG Administrator can perform (within certain limits) the following operations
without re-starting FBSNG components:
    - Add a queue, modify queue parameters, lock/unlock a queue
    - Add a process type, modify process type parameters
    - Add a node class, modify local resources capacity for nodes of the
      class,  configure local scratch disks, add or remove a node or nodes to
      or from a  node class
    - Add a local resource or a node attribute
    - Add a global resource, modify its capacity
    - Add a resource pool, modify its composition

FBSNG now includes an interactive (command-line and GUI-based) interface
to farm re-configuration.  

Enhanced security. FBSNG Administrator can limit submission of FBSNG jobs to 
a set of "trusted nodes". Also, it is possible to define set of "administrator" 
accounts allowed to modify FBSNG configuration.

Other Improvements
    - FBSNG API Reference Manual and Installation and Administration Guide are
    now  included in the product distribution;
    - FBSNG Scheduler algorithm is modified to allow more easily controlled
    "fair  share" scheduling configuration;
    - Some bugs have been fixed.

Upgrading from FBSNG v1.0 to v1.1 in FUE environment
----------------------------------------------------
There are no known installations of FBSNG v1.0 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 of non-FUE installation of FBSNG v1.0.

In order to upgrade existing FBSNG v1.0 installation to v1.1, FBSNG
administrator has  to perform the following steps:
1.  Upgrade FCSLIB to v1_9 or newer
2.  Hold all farm nodes, this will make sure new jobs will not start;
3.  Wait for all running FBSNG jobs to finish;
4.  Install FBSNG v1.1 and tailor it to use the same $FBSNG_ROOT directory;
5.  Declare FBSNG v1.1 as current;
6.  Log in or "su" to the account used to run BMGR process. Steps 7-11
    must be performed under this account;
7.  Use UPS to set up FBSNG v1.1 environment (issue "setup fbsng");
8.  Execute upgrade_v10_v11 command. This command will:
    a. make backup copy of FBSNG_ROOT directory
    b. convert FBSNG v1.0 job database to v1.1 format
    c. split FBSNG v1.0 configuration file fbs.cfg into 
       fbs.cfg and farm.cfg in v1.1 format;
9.  Add configuration of local scratch disks in "node_class" set(s) in farm.cfg
    following the instructions found in the file;
10. If necessary, add submit_allow, submit_deny and admin_list parameter 
    values to set "bmgr" in file fbs.cfg following instructions
    found in the file;
11.	Run "fbs chkcfg" to check for the configuration errors or 
    inconsistencies.
12. Shut down all running FBSNG v1.0 components including BMGR, logd, 
    launchers;
13. Start FBSNG v1.1 components.

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