summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--INSTALL_VFL130
1 files changed, 130 insertions, 0 deletions
diff --git a/INSTALL_VFL b/INSTALL_VFL
new file mode 100644
index 0000000..7d3e490
--- /dev/null
+++ b/INSTALL_VFL
@@ -0,0 +1,130 @@
+ Installation Instructions for HDF5
+ with Different Virtual File Layer
+
+ * * *
+
+This file contains installation instructions for HDF5 with certain Virtual File
+Layer to handle file I/O. We currently have documented SRB and Globus-GASS.
+
+
+
+ --- Part I. SRB ---
+I. Overview
+-----------
+This part contains instructions for remote-accessing HDF5 through SRB. The
+SRB version 1.1.6 on Sun Solaris 2.7 platform has been tested. If you have
+difficulties installing the software in your system, please send mails to me
+(Raymond Lu) at
+
+ slu@ncsa.uiuc.edu
+
+First, you must obtain and unpack the HDF5 source as described in the file
+INSTALL. You need the SRB library(client part) installed. You should also
+have access to SRB server.
+
+
+The Storage Resource Broker(SRB) from San Diego Supercomputer Center is client-
+server middleware that provides a uniform interface for connecting to
+heterogeneous data resources over a network and accessig replicated data sets.
+SRB, in conjunction with the Metadata Catalog(MCAT), provides a way to access
+data sets and resources based on their attributes rather than their names or
+physical locations. Their webpage is at http://www.npaci.edu/Research/DI/srb.
+
+HDF5 is built on the top of SRB as a client to remotely access files on SRB
+server through SRB. Right now, HDF-SRB only support low-level file transfer of
+SRB. The MCAT part is not supported yet. Low-level file transfer means files
+are treated just like Unix type files. Files can be read, written and
+appended. Partial access(read and write to a chunk of file without transferrig
+the whole) is also supported.
+
+
+II. Installation Steps
+----------------------
+The installation steps are similar to the ones in INSTALL file:
+
+1. Run 'configure' file with SRB options:
+ configure --with-srb=$SRB/include,$SRB/lib
+ where $SRB is your SRB installed library directory.
+
+ For example, below is a script file to run 'configure':
+ #! /bin/sh
+ # how to configure to use the SRB
+
+ SRB_DIR=/afs/ncsa.uiuc.edu/projects/hdf/users/slu/srb_install
+ configure --with-srb=$SRB_DIR/include,$SRB_DIR/lib
+
+2. Run 'make'
+
+3. Run 'make check'
+
+4. Run 'make install'
+
+5. Run testing program:
+ Go to the testing directory(cd test) and run srb_write, srb_read,
+ srb_append.
+
+ srb_write: Connect to SRB server, write an HDF5 file with an integer
+ dataset to SRB server.
+ srb_read: Connect to SRB server, read part of HDF5 file on the SRB server.
+ srb_append: Connect to SRB server, append an integer dataset to an existent
+ HDF5 file on the SRB server.
+
+6. For using HDF-SRB, please read comments in srb_write.c, srb_read.c,
+ srb_append.c in the hdf5/test directory.
+
+
+
+ --- Part II. Globus-GASS ---
+
+I. Overview
+-----------
+This part contains instructions for remote-accessing HDF5 through Globus-GASS.
+The SGI IRIX64(and IRIX) 6.5 platform have been tested. If you have
+difficulties installing the software in your system, please send mails to me
+(Raymond Lu) at
+ slu@ncsa.uiuc.edu
+
+First, you must obtain and unpack the HDF5 source as described in the file
+INSTALL. You need the Globus 1.1.x and SSL(should have come with Globus)
+packages.
+
+HDF5 is built on the top of Globus-GASS(1.1.x) to handle remote access.
+Globus-GASS(1.1.x) only supports HTTP and HTTPS protocals for 'whole file
+read and write'. More features may be added in the future.
+
+II. Installation Steps
+----------------------
+The installation steps are similar to the ones in INSTALL file:
+
+1. Run 'configure' file with SSL and GASS options:
+ configure --with-ssl=$SSL/lib --with-gass=$GASS/include,$GASS/lib
+ where $SSL is your SSL directory, and $GASS is your Globus directory.
+
+ For example, below is a script file to run 'configure':
+ #! /bin/sh
+ # how to configure to use the Globus-GASS(1.1.x)
+
+ GASS_DIR=/usr/local/globus-install-1.1.1/development/mips-sgi-irix6.5-64_nothreads_standard_debug
+ SSL_LIB=/usr/local/ssl/lib
+
+ configure --with-ssl=$SSL_LIB --with-gass=$GASS_DIR/include,$GASS_DIR/lib
+
+2. Run 'make'
+
+3. Run 'make check'
+
+4. Run 'make install'
+
+5. Run testing program:
+ There is one read testing program called 'gass_read' in the 'test'
+ directory. It does whole file read through HTTP protocal. The URL is
+ hard coded as
+ http://hdf.ncsa.uiuc.edu/GLOBUS/a.h5
+
+ The writing really depends on your web server. You have to set up your
+ server in right way to accept writing in files. We have tested it using
+ Apache Server(1.3.12) without authentication. If you need more details
+ about our testing, please contact us. Globus suggests using their GASS
+ server.
+
+ There is another program called 'gass_append' used for experiments.