Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
VOSpace based filesystem based on FUSE
Python Shell
Failed to load latest commit information.
docs Tying some docs
scripts Configured the logging a bit more cleanly
test Corrected missing tmpdir
vos Reverted to using global debug level when set, to get more diagnostic…
.DS_Store cleaned up some cruft.
.gitignore merged in D. Rusk's cutout functionality
FAQ.txt Initial checkin to git from svn.
PKG-INFO Initial checkin to git from svn.
README.md added some clarifying text to correct the base documentation.
build.xml Story s1475. Reverted build.xml to non-test version.
gms.py An example script for pulling authentication/authorization from CADC GMS
runtest Fixed some node caching bugs. Removed the second layer of Node cachin…
setup.cfg Initial checkin to git from svn.
setup.py

README.md

DOCUMENTATION

vos is a set of python modules and scripts that ease access to VOSpace.

The default installation of vos is tuned for accessing the VOSpace provided by the Canadian Advanced Network For Astronomical Research (CANFAR)

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

There are three ways to use vos:

  1. access VOSpace using the command-line script: eg. vcp
  2. make VOSpace appear as mounted filesystem: mountvofs
  3. use the vos module inside a Python script: import vos

Authentication to the CANFAR VOSpace service is performed using X509 security certificates, header tokens or username/password pairs. The authentication system is managed by the CADC Group Management Service (GMS).

To retrieve an X509 security certificate for use with the vos tools use the getCert script included with this package.

Additional information is available in the CANFAR documentation

System Requirments

  • A CANFAR VOSpace account (required for WRITE access, READ access can be anonymous)
  • fuse OR OSX-FUSE (see additional documentation, only required for filesystem based access, not for command line or programmatic)
  • python2.6 or later

Installation

vos is distributed via PyPI/vos and PyPI is the most direct way to get the latest stable release:

pip install vos --upgrade --user

Or, you can retrieve the github distribution and use

python setup.py install --user

Tutorial

  1. Get a CANFAR account
  2. Install the vos package.
  3. Retrieve a X509/SSL certificate using the built in getCert script.
  4. Example Usage.
    1. 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_). fusermount -u /tmp/vospace (LINUX) or umount /tmp/vospace (OS-X) unmounts the file system. VOSpace does not have a mapping of your unix users IDs and thus files appear to be owned by the user who issued the 'mountvofs' command.
    2. Commandline usage:
      • vls -l vos: [List a vospace]
      • vcp vos:jkavelaars/test.txt ./ [copies test.txt to the local directory from vospace]
      • vmkdir --help [get a list of command line options and arguments]
      • vmkdir, vrm, vrmdir, vsync vcat, vchmod and vln
    3. In a Python script (the example below provides a listing of a vospace container)
#!python
import vos
client = vos.Client()
client.listdir('vos:jkavelaars')
Something went wrong with that request. Please try again.