Skip to content
This repository

VOSpace based filesystem based on FUSE

branch: master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 docs
Octocat-spinner-32 scripts
Octocat-spinner-32 test
Octocat-spinner-32 vos
Octocat-spinner-32 .DS_Store
Octocat-spinner-32 .gitignore
Octocat-spinner-32 FAQ.txt
Octocat-spinner-32 PKG-INFO
Octocat-spinner-32 README
Octocat-spinner-32 build.xml
Octocat-spinner-32 cantop
Octocat-spinner-32 setup.cfg
+++++++++++++++++++++++++ DOCUMENTATION ++++++++++++++++++++++++++

cadcVOFS is a set of python modules and scripts for access VOSpace.

The default installation of cadcVOFS is tuned for accessing the
VOSpace provided by the Canadian Astronomy Data Centre

VOSpace is a Distrbuted Cloud storage service for use in Astronomy.

There are three ways to use cadcVOFS:
     1) access VOSpace from the command-line 

     2) make VOSpace appear as mounted filesystem
     3) use the vos module inside a Python script

All of these methods require the user to have a pre-existing VOSpace
account with the CADC.

Authentication to the CADC VOSpace service is performed using security
certificates which are managed by the CADC Group Management Service
(GMS).  The certificates can be retrieved from the CADC using the
'getCert' script and users CADC account and password information.



+++++++++++++++++++++++ REQUIREMENTS +++++++++++++++++++++++++++++++

    A CADC VOSpace account
    fuse OR OS-FUSE  (see additional documentation)
    python2.6 or newer

+++++++++++++++++++++++++ INSTALLATION +++++++++++++++++++++++++++

python install 

+++++++++++++++++++++++++ USAGE ++++++++++++++++++++++++++++++++++

1) Get a CADC account <>

2) Retrieve a SSL certificate from the CADC servers.

> getCert

  retrieves a certificate from the CADC servers, these certifcates are
  valid for 2 days (be default) but can be valid for upto 30 days (see
  the getCert help).  The cerificate is stored in ${HOME}/.ssl by

3a) For filesystem usage: 

> mountvofs

  mounts the CADC VOSpace root Container Node at /tmp/vospace and
  initiates a 5GB cache in the users home directory (${HOME}/vos_)

  **** Since the VOSpace does not have a mapping of your unix users
       IDs all files appear to be owned by the user who issued the
       'mountvofs' command.  Only that user can see the mount point.

3b) Commandline usage:

> vls -l vos:

  Lists the contents of the CADC root VOSpace Container Node.

> vcp vos:jkavelaars/test.txt ./

  copys the files 'test.txt' from the the vospace container jkavelaars
  to your local directory.

See --help for the commands:  vmkdir, vrm, vrmdir, vsync 
Something went wrong with that request. Please try again.