Installing Rucio Clients

Prerequisites

Rucio clients runs on Python 2.6, 2.7.

Platforms: Rucio should run on any Unix-like platform.

Python Dependencies

Rucio clients need the following python modules:

argparse==1.4.0 # Command-line parsing library
argcomplete==1.0.0 # Bash tab completion for argparse
kerberos==1.2.2 # Kerberos high-level interface
requests==2.8.1 # Python HTTP for Humans
requests-kerberos==0.7.0 # A Kerberos authentication handler for python-requests
#  TODO: requests-cache==0.4.8  # Persistent cache for requests library
urllib3==1.12 # HTTP library with thread-safe connection pooling and file post support
wsgiref==0.1.2 # WSGI (PEP 333) Reference Library
dogpile==0.2.2 # Caching API
dogpile.core==0.4.1 # Caching API
dogpile.cache==0.5.7 # Caching API plugins
nose==1.3.7 # rucio test-server
boto==2.38.0 # S3 boto protocol
tabulate==0.7.5 # Pretty-print tabular data
progressbar==2.3 # Text progress bar
bz2file==0.98 # Read and write bzip2-compressed files.
python-magic==0.4.10 # File type identification using libmagic

All Dependencies are automatically installed with pip.

Install via pip

When pip is available, the distribution can be downloaded from the Rucio PyPI server and installed in one step:

$> pip install rucio-clients

This command will download the latest version of Rucio and install it to your system.

Upgrade via pip

To upgrade via pip:

$> pip install --upgrade rucio-clients

Install via pip and virtualenv

To install the Rucio clients in an isolated virtualenv environment:

$> wget --no-check-certificate https://raw.github.com/pypa/virtualenv/master/virtualenv.py
$> python virtualenv.py rucio
$> source rucio/bin/activate.csh
$> pip install rucio-clients
$> export RUCIO_HOME=`pwd`/rucio/

Installing using setup.py

Otherwise, you can install from the distribution using the setup.py script:

$> python setup.py install