Installing the Flocker Client

The following sections describe how to install the Flocker client on your platform:

Installing on Ubuntu 16.04 (64-bit)

Note

These instructions require that you have sudo access.

If you are using a 32-bit Ubuntu platform, see the instructions for Installing on Other Linux Distributions.

On Ubuntu 16.04 (64-bit), the Flocker CLI can be installed from the ClusterHQ repository:

sudo apt-get update
sudo apt-get -y install apt-transport-https software-properties-common
sudo add-apt-repository -y "deb https://clusterhq-archive.s3.amazonaws.com/ubuntu/$(lsb_release --release --short)/\$(ARCH) /"
cat <<EOF > /tmp/apt-pref
Package: *
Pin: origin clusterhq-archive.s3.amazonaws.com
Pin-Priority: 700
EOF
sudo mv /tmp/apt-pref /etc/apt/preferences.d/buildbot-700
sudo apt-get update
sudo apt-get -y install --force-yes clusterhq-flocker-cli

Note

If you are using a 32-bit Ubuntu platform, see the instructions for Installing on Other Linux Distributions.

Installing on Ubuntu 14.04 (64-bit)

Note

These instructions require that you have sudo access.

If you are using a 32-bit Ubuntu platform, see the instructions for Installing on Other Linux Distributions.

On Ubuntu 14.04 (64-bit), the Flocker CLI can be installed from the ClusterHQ repository:

sudo apt-get update
sudo apt-get -y install apt-transport-https software-properties-common
sudo add-apt-repository -y "deb https://clusterhq-archive.s3.amazonaws.com/ubuntu/$(lsb_release --release --short)/\$(ARCH) /"
cat <<EOF > /tmp/apt-pref
Package: *
Pin: origin clusterhq-archive.s3.amazonaws.com
Pin-Priority: 700
EOF
sudo mv /tmp/apt-pref /etc/apt/preferences.d/buildbot-700
sudo apt-get update
sudo apt-get -y install --force-yes clusterhq-flocker-cli

Note

If you are using a 32-bit Ubuntu platform, see the instructions for Installing on Other Linux Distributions.

Installing on RHEL 7.2

Note

These instructions require that you have sudo access.

On RHEL 7.2, the Flocker CLI can be installed from the ClusterHQ repository:

yum install -y clusterhq-flocker-cli

Installing on Other Linux Distributions

Warning

These are guidelines for installing Flocker on a Linux distribution for which we do not provide native packages. These guidelines may require some tweaks, depending on the details of the Linux distribution in use.

Note

These instructions require that you have sudo access.

Before you install flocker-cli you will need a compiler, Python 2.7, and the virtualenv Python utility installed.

To install these prerequisites with the yum package manager, run:

sudo yum install -y gcc libffi-devel openssl-devel python python-devel python-virtualenv

To install these prerequisites with the apt package manager, run:

sudo apt-get update
sudo apt-get -y install gcc libffi-dev libssl-dev python2.7 python2.7-dev python-virtualenv

To install flocker-cli in a Python virtualenv, run:

virtualenv --python=/usr/bin/python2.7 flocker-client
source flocker-client/bin/activate
pip install --upgrade pip
pip install https://clusterhq-archive.s3.amazonaws.com/python/Flocker-1.15.0-py2-none-any.whl

Whenever you need to run Flocker CLI commands, ensure you are in the virtualenv:

source flocker-client/bin/activate
flocker-ca --version
1.15.0

Installing on OS X

Install pip and virtualenv on your machine at the system level:

sudo python -m ensurepip
sudo pip install virtualenv

To install flocker-cli in a Python virtualenv, run:

virtualenv --python=/usr/bin/python2.7 flocker-client
source flocker-client/bin/activate
pip install --upgrade pip
pip install https://clusterhq-archive.s3.amazonaws.com/python/Flocker-1.15.0-py2-none-any.whl

If you are prompted to install command line developer tools at any point, please install the tools and then re-run whatever command failed in the background.

Whenever you need to run Flocker CLI commands, ensure you are in the virtualenv:

source flocker-client/bin/activate
flocker-ca --version
1.15.0