The globus_rls_client package must be built and installed first,
since the server is linked with this API.  The server also depends on
an ODBC API to an SQL database, which must be installed prior to
building the server.  The server was originally developed using the
ODBC interface iODBC, and the database server MySQL and ODBC driver
MyODBC.  Due to licensing restrictions with MyODBC we have switched
to the database server PostgreSQL and ODBC driver psqlODBC, however
RLS continues to work with MySQL as well.

packages:

  libiodbc-3.0.5	Available from www.iodbc.org

  PostgreSQL-7.2.3	Available from www.postgresql.org
  psqlODBC-7.2.5	Available from gborg.postgresql.org

  MySQL-4.0.1-alpha	Available from www.mysql.com
  MyODBC-3.51.01	Available from www.mysql.com

Please note if you use MySQL you should use version 4.0.1 or later,
since earlier versions do not support transactions.  Also if
installing MySQL be aware that some versions of Linux include MySQL
already installed.  If so there will be a file /etc/my.cnf with global
configuration options.  This file will interfere with any new
installation of MySQL and should be renamed or removed before
proceeding, or you can start mysqld_safe with the option

	--defaults-file <path to your global my.cnf file>

The installation process assumes that IODBC was installed
in $GLOBUS_LOCATION.  If you installed this package in
another location you may specify it by setting an environment
variable, or by specifying a command line option when configuring the server.
The environment variable is (default in square brackets):


  GLOBUS_IODBC_PATH [$GLOBUS_LOCATION]    # toplevel dir where iodbc installed

The equivalent command line option, which should be passed to gpt-build,
globus-build, or configure, is:

  --with-iodbc-path=<toplevel dir where iodbc is installed>

You may pass this options directly to configure, or if you're
using gpt version 1 or 2 add the option:

  CONFIGOPTS_GPTMACRO=--with-iodbc-path=/where-iodbc-is

to the gpt-build or globus-build command (see below).

You may use gpt version 1 or 2 to build and install the RLS server.
The command if using gpt2 is:

  gpt-build [-force] globus_rls_server-1.1.tar.gz gcc32dbgpthr

or if you've already unpacked the tar file:

  gpt-build [-force] -srcdir=. gcc32dbgpthr

With gpt1:

  globus-build [-force] gcc32dbgpthr -srcdir=.

Or you may configure, build and install by hand:

  ./configure --with-flavor=gcc32dbgpthr --enable-debug --with-threads=pthreads
  make
  make install

MDS

  This package includes a program globus-rls-reporter
  that is installed in $GLOBUS_LOCATION/libexec that can be used
  to extract info from an RLS server and report it to MDS.

  To enable MDS reporting of RLS statistics please append the file
  rls-ldif.conf to $GLOBUS_LOCATION/etc/grid-info-resource-ldif.conf.
  You will need to set your VO name in rls-ldif.conf first if it is not
  "local".  Note it needs to be set twice, in the "dn:" and "args:" lines.
  You may also wish to set the URL of the RLS server you're monitoring
  if it's not running on the same host as MDS, or it's not using the
  default port.  You can also set the certificate and key files to
  use for authentication with the -c and -k args.  Please see the
  globus-rls-reporter(1) man page for details.

