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.3.0    # Command-line parsing library
argcomplete==0.8.4 # Bash tab completion for argparse
kerberos==1.1.1    # Kerberos high-level interface
requests==2.5.3    # Python HTTP for Humans
requests-kerberos==0.6.1 # A Kerberos authentication handler for python-requests
#  TODO: requests-cache==0.4.8  # Persistent cache for requests library
urllib3==1.10.1       # 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.6  # Caching API plugins
nose==1.3.4           # rucio test-server
boto==2.36.0          # S3 boto protocol
tabulate==0.7.1       # Pretty-print tabular data
progressbar==2.3

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