README for IBM Spectrum LSF License Scheduler Windows Client Package
June 2016
IBM Corporation

=============================
Contents
=============================
1. Distribution Contents
2. Installation and Configuration
3. Troubleshooting
4. Copyright

=============================
1. Distribution Contents
=============================
The IBM Spectrum LSF License Scheduler Windows Client distribution package contains 
the following files:

README               -- This file
blstat.exe           -- User commands
blinfo.exe
blusers.exe
bladmin.exe
blhosts.exe
blkill.exe
bltasks.exe
blparams.exe
blcstat.exe

lsf.licensescheduler -- LSF License Scheduler configuration file
lsf.conf             -- LSF configuration file


=============================
2. Installation and Configuration
==============================
-----------------------------
2.1. For LSF mixed cluster
-----------------------------
If you have installed LSF on your Windows host, complete the following
steps:

1. Copy all user commands to $LSF_BINDIR on your Windows client.

2. Copy the lsf.licensescheduler configuration file to $LSF_ENVDIR
   and edit it to suit your LSF License Scheduler Master host 
   configuration.

-----------------------------
2.2. For LSF License Scheduler Windows client only
-----------------------------
To use LSF License Scheduler without LSF, complete the following 
steps:

1. Create a new directory as LSF_TOP directory; Create bin, conf and 
   etc sub-directory in LSF_TOP. For example:

   C:\LS10.1
      |
      |---bin
      |
      |---conf
      |
      |---etc

2. Copy all user commands to the bin directory.

3. Copy lsf.conf to the conf directory and edit it to suit your 
   installation.

4. Copy lsf.licensescheduler to the conf directory and edit it to suit
   your installation.

5. Set the LSF_BINDIR environment variable to <disk>:\LSF_TOP\bin. 
   For example, set LSF_BINDIR to C:\LS_10.1\bin.

6. Set LSF_ENVDIR environment variable to <disk>:\LSF_TOP\conf. 
   For example, set LSF_ENVDIR to C:\LS_10.1\conf.

7. Set LSF_SERVERDIR environment variable to <disk>:\LSF_TOP\etc. 
   For example, set LSF_SERVERDIR to C:\LS_10.1\etc.

=============================
3. Troubleshooting
=============================

1. To avoid the following error from LSF License Scheduler commands:

   Network I/O error with the License Scheduler server

   configure your Windows host name and IP address in the /etc/hosts 
   file on the master host.
   
   NOTE: The method above is useful only when you see the message below
   in mbatchd's log file.
   
   callglb(): cc -1
   Failed in an LSF library call: Failed in sending/receiving a
   message: error 0: The operation completed successfully

2. To enable the blhosts command to work, make sure your Windows 
   client can resolve the master host IP address correctly.

3. See the LSF License Scheduler user guide 
   (lsf10.1_license_scheduler.pdf) for more information about 
   configuring and using LSF License Scheduler user guide is 
   distributed with this package file.

=============================
4. Copyright
=============================
Copyright IBM Corp. 1992, 2016. All rights reserved.
US Government Users Restricted Rights - Use, duplication or disclosure 
restricted by GSA ADP Schedule Contract with IBM Corp.

==============================
End of README for IBM Spectrum LSF License Scheduler Windows Client Package
==============================
