mirror of
https://github.com/HDFGroup/hdf5.git
synced 2025-02-17 16:10:24 +08:00
[svn-r2150] Instruction for Virtual File Layer goes in this file.
This commit is contained in:
Raymond Lu
parent
54ca932b75
commit
f12e331666
130
INSTALL_VFL
Normal file
130
INSTALL_VFL
Normal file
@ -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.
|
||||
Loading…
Reference in New Issue
Block a user