Skip to main content

Tools for interacting with CADC VOSpace.

Project description


+++++++++++++++++++++++++ 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
http://www.cadc.hia.nrc.gc.ca/vospace.

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.

ADDITIONAL DOCUMENTATION AVAILABLE AT:

<http://canfar.phys.uvic.ca/wiki/index.php/VOSpace_filesystem>

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

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

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

python setup.py install

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

1) Get a CADC account <http://www.cadc.hia.nrc.gc.ca/>

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
default.

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

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vos-1.9.0b.tar.gz (55.4 kB view details)

Uploaded Source

File details

Details for the file vos-1.9.0b.tar.gz.

File metadata

  • Download URL: vos-1.9.0b.tar.gz
  • Upload date:
  • Size: 55.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for vos-1.9.0b.tar.gz
Algorithm Hash digest
SHA256 bbd0ea8836be1864023cf1bc2f39c83de19f2ca7845f123eecab9ad0dccb441a
MD5 9cbe30285c2ee2b82a95991808722156
BLAKE2b-256 d1a9e0a6b47cc539fb945bca0034fe3e0d0f15ee486d9c4fd03233d38c60ae95

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page