Globus GridFTP Google Cloud Storage DSI
=======================

The Globus GridFTP Google Cloud Storage DSI (Google Cloud DSI) implements a
data storage interface between a Globus GridFTP server and Google Cloud Storage
using its XML API, which uses a modified version of our S3 library.

It attempts to make the object store look like a filesystem.  The namespace
served by this DSI is rooted at the root of a configured project.
Items seen as "directories" in the top level are "buckets" in the project.
Creating a new toplevel directory creates a new bucket. Creating a directory
within a bucket or a subdirectory of a bucket adds a 0 byte placeholder object
to the object store, with a name that ends with the '/' character and metadata
indicating it's to be viewed as a directory by Globus.

== Installation

Install the package globus-gridftp-server-google-cloud from the Globus respository.

For Red Hat-based systems:

  % yum install globus-gridftp-server-google-cloud

For Debian-based systems:

  % apt-get install globus-gridftp-server-google-cloud


== Troubleshooting

To enable a debugging log for the google cloud dsi, set the environment
variable GLOBUS_S3_DEBUG "1023,/tmp/gcloud.log" to enable a highly verbose log
of the DSI. This can be easily done for a gridftp configuration by creating
a file /etc/gridftp.d/gcloud-debug with the contents

------------------------------------------------------------------------------
 $GLOBUS_S3_DEBUG "1023,/tmp/gcloud.log"
------------------------------------------------------------------------------
