FBSNG v1.4 Release Notes
-------------------------

This document summarizes the changes made in FBSNG v1.4 comparing to v1.3
and describes v1.2*, v1.3* to v1.4 upgrade procedure.

What in new in FBSNG v1.4 ?
----------------------------

New Features:
-------------
*   Globus Job Manager interface scripts are provided in "globus"
    subdirectory. See README file in that subdirectory for details.

*   Node held/released status is now kept in configuration
    so that it is restored when Batch Manager restarts.

*   FBSNG comes with its own HTTP server (FBSWWW) which can be used to provide
    web interface to basic monitoring information.

Major Bugs Fixed:
-----------------

Upgrading from FBSNG v1.2*, v1.3* to v1.4 in FUE environment
------------------------------------------------------------
1. Hold all FBSNG queues (fbs hold queue all).

2. Shut down all FBSNG daemons using $FBSNG_ROOT/bin/shutdown_*.sh
   scripts. To shut down launchers, you must log in as root.

3. If necessary, install or upgrade FCSLIB to v2_0a;

4. If necessary, as user "products", install and declare desired version
   of Python.

5. As user "products", install, declare and tailor FBSNG v1_3f (for Python 
   1.5.*) or v1_3f+p2_1 (for Python 2.1*) for all required
   platforms. If you are using UPS to install fbsng, use "upd install -R ..."
   command. This will install FCSLIB too. Optionally, declare
   fbsng with "local_python" qualifier (ups declare ... -q local_python ...)
   for the patform(s) farm nodes are running. See FBSNG Installation
   and Administration Guide for tailoring instructions.

6. If Kerberos support is required, install and declare Kerberos for
   all platforms following Kerberos installation instructions;

7. Initialize FBSNG v1.3f environment (issue setup fbsng).

8. If upgrading from v1.2*, add event_mgr_port definition to set "bmgr" of
   FBSNG configuration file (pointed to by FBS_CONFIG environment variable).
   See FBSNG Installation and Administration Guide for the description of this
   parameter.

9. If necessary, add rsrc_units parameter to set "bmgr" of fbs.cfg.
   Typically, it should be:
   
        %set bmgr
        ...
        rsrc_units = cpu:100

10. If you are going to run FBSWWW server, add FBSWWW configuration
    information to fbs.cfg. For example:
    
        %set fbswww
        port = 8080
        graphs_dir = /tmp/fbswww_graphs

    Copy start_fbswww.sh, kill_fbswww.sh, shutdown_fbswww.sh from
    $FBSNG_DIR/templates/bin to $FBSNG_ROOT/bin. Use these scripts
    to start, restart and shut down FBSWWW server.

11.Run "fbs chkcfg" to validate the configuration.

12.Start FBSNG v1.3f components using $FBSNG_ROOT/bin/start_*.sh
   scripts. To start launchers, you must log in to farm nodes as root.

13.Remove history.run.cron script from cron table as it is obsolete.

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


