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.2.1          # Command-line parsing library
distribute==0.6.48       # Easily download, build, install, upgrade, and uninstall Python packages
argcomplete==0.6.7       # Bash tab completion for argparse
kerberos==1.1.1          # Kerberos high-level interface
requests==2.2.0          # Python HTTP for Humans
requests-kerberos==0.4   # A Kerberos authentication handler for python-requests
#  TODO: requests-cache==0.4.4  # Persistent cache for requests library
urllib3==1.7.1           # HTTP library with thread-safe connection pooling and file post support
wsgiref==0.1.2           # WSGI (PEP 333) Reference Library
dogpile.core==0.4.1      # Caching API
dogpile.cache==0.5.3     # Caching API plugins

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 -i http://atlas-pip.cern.ch/simple

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

it will ask for the password and login.

To avoid this, you need to create a ~/.pip/pip.conf with:

[install]
index-url =
    http://pypi.python.org/simple

extra-index-url=
    http://<username>:<password>@atlas-pip.cern.ch/simple
  • username, which is the registered username on the PyPI server.

  • password, that will be used to authenticate. If omitted the user

    will be prompt to type it when needed.

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 -i http://atlas-pip.cern.ch/simple
$> 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