README.txt

This directory is for building the cloud client.

The scripts and directory layout that makes the cloud client work is all contained in
"nimbus-cloud-client-src".  However, this is missing the embedded Globus directory.

If you have checked this out of CVS in order to build a releasable cloud client, you will
need to run this script:

  bash ./builder/get-wscore.sh

That script will retrieve the necessary wscore binary tarball and place it in the same directory
as this README file.

Now that you have retrieved the tarball, you can run the following script to make a release:

  bash ./builder/dist.sh

This will do the following:

  1) Remove any previous dist directory completely: something basically equivalent to
     "rm -rf ./nimbus-cloud-client-011".
     *** Never hand-alter any files in this dist directory.

  2) Create a fresh dist directory (e.g. "nimbus-cloud-client-011").

  3) Copy the entire contents of "nimbus-cloud-client-src" into the dist directory.

  4) Remove all "CVS" directories.

  5) Checksum the wscore tarball that was downloaded and compare it to the expected value.

  6) Expand that tarball into the dist directory, e.g. "nimbus-cloud-client-011/lib/globus"
     It expects that this directory does not exist yet.

  7) Set up that directory as GLOBUS_LOCATION for the next step

  8) Call the "../bin/clients-only-build-and-install.sh" script in the Nimbus source tree.
     Since the embedded Globus directory is set up as GLOBUS_LOCATION, it will install the
     client libraries there.

  9) Tar/gz the dist directory as e.g. "nimbus-cloud-client-011.tar.gz"


Notes:

  - You need to have the Nimbus source tree, in particular "bin", "messaging", and the
    "service/client" directories.

  - Once you have downloaded the wscore binary tarball, you can make a fresh release over
    and over without more downloads.  This is intentional, this is why downloading that is
    a first step.

  - The wscore tarball, cloud client dist directory, and cloud client tarball should never be
    checked into CVS.

  - To update names, wscore tarball URL, expected checksum, etc., see "./builder/environment.sh"