Installing the Flocker Node Services¶

Prerequisites¶

Before you begin to install the Flocker node services, you will need the following:

• A minimum of 2 nodes:
  • We support installing the Flocker node services on RHEL 7, CentOS 7, Ubuntu 14.04 and Ubuntu 16.04.
  • If you do not have any nodes, our guides listed below can be used to help you set up nodes, using Amazon Web Services, Rackspace, or Google Compute Engine.
  • To avoid potential disk space problems (for example, when storing popular Docker images), we recommend a minimum of 16 GB storage on each node.
• You will need permission for SSH access from your laptop.
• Depending on your usage of Flocker, you will require access to a range of ports. For example, instructions on specifying which ports to make available are included in the Amazon Web Services guide.
• Flocker’s container management features depend on Docker. You will need to make sure Docker (at least 1.8) is installed and running.

Helpful Guides for Setting Up Nodes¶

If you do not have any nodes, the following guides will help you set some up, with AWS, Rackspace, or GCE.

• Setting Up Nodes Using Amazon Web Services
• Setting Up Nodes Using Google Compute Engine
• Setting Up Nodes Using Rackspace

Installing on RHEL 7¶

1. Log into the first node as root:

   ssh root@<your-first-node>
   

2. Install the clusterhq-flocker-node package:

   To install clusterhq-flocker-node on RHEL 7 you must install the RPM package provided by the ClusterHQ repository. The commands below will install the two repositories and the clusterhq-flocker-node package.

   Run the following commands as root on the target node:

   yum list installed clusterhq-release || yum install -y https://clusterhq-archive.s3.amazonaws.com/centos/clusterhq-release$(rpm -E %dist).centos.noarch.rpm
   
   sed -i 's/$releasever/7/g' /etc/yum.repos.d/clusterhq.repo
   yum-config-manager --enable clusterhq
   yum install -y clusterhq-flocker-node
   

3. Install the clusterhq-flocker-docker-plugin package:

   At this point you can choose to install the Flocker plugin for Docker. Run the following command as root on the target node:

   yum install -y clusterhq-flocker-docker-plugin
   

4. Repeat the previous steps for all other nodes:

   Log into your other nodes as root, and then complete step 2 and 3 until all the nodes in your cluster have installed the clusterhq-flocker-node and the optional clusterhq-flocker-docker-plugin package.

Installing on CentOS 7¶

1. Log into the first node as root:

   ssh root@<your-first-node>
   

2. Install the clusterhq-flocker-node package:

   To install clusterhq-flocker-node on CentOS 7 you must install the RPM package provided by the ClusterHQ repository. The commands below will install the two repositories and the clusterhq-flocker-node package.

   Run the following commands as root on the target node:

   yum list installed clusterhq-release || yum install -y https://clusterhq-archive.s3.amazonaws.com/centos/clusterhq-release$(rpm -E %dist).noarch.rpm
   yum install -y clusterhq-flocker-node
   

3. Install the clusterhq-flocker-docker-plugin package:

   At this point you can choose to install the Flocker plugin for Docker. Run the following command as root on the target node:

   yum install -y clusterhq-flocker-docker-plugin
   

4. Repeat the previous steps for all other nodes:

   Log into your other nodes as root, and then complete step 2 and 3 until all the nodes in your cluster have installed the clusterhq-flocker-node and the optional clusterhq-flocker-docker-plugin package.

Installing on Ubuntu 16.04¶

1. Log into the first node as root:

   ssh root@<your-first-node>
   

2. Install the clusterhq-flocker-node package:

   To install clusterhq-flocker-node on Ubuntu 16.04 you must install the package provided by the ClusterHQ repository. The commands below will install the two repositories and the clusterhq-flocker-node package.

   Run the following commands as root on the target node:

   apt-get update
   apt-get -y install apt-transport-https software-properties-common
   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
   mv /tmp/apt-pref /etc/apt/preferences.d/buildbot-700
   apt-get update
   apt-get -y install --force-yes clusterhq-flocker-node
   

3. Install the clusterhq-flocker-docker-plugin package:

   At this point you can choose to install the Flocker plugin for Docker. Run the following command as root on the target node:

   apt-get install -y clusterhq-flocker-docker-plugin
   

4. Repeat the previous steps for all other nodes:

   Log into your other nodes as root, and then complete step 2 and 3 until all the nodes in your cluster have installed the clusterhq-flocker-node and the optional clusterhq-flocker-docker-plugin package.

Installing on Ubuntu 14.04¶

1. Log into the first node as root:

   ssh root@<your-first-node>
   

2. Install the clusterhq-flocker-node package:

   To install clusterhq-flocker-node on Ubuntu 14.04 you must install the package provided by the ClusterHQ repository. The commands below will install the two repositories and the clusterhq-flocker-node package.

   Run the following commands as root on the target node:

   apt-get update
   apt-get -y install apt-transport-https software-properties-common
   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
   mv /tmp/apt-pref /etc/apt/preferences.d/buildbot-700
   apt-get update
   apt-get -y install --force-yes clusterhq-flocker-node
   

3. Install the clusterhq-flocker-docker-plugin package:

   At this point you can choose to install the Flocker plugin for Docker. Run the following command as root on the target node:

   apt-get install -y clusterhq-flocker-docker-plugin
   

4. Repeat the previous steps for all other nodes:

   Log into your other nodes as root, and then complete step 2 and 3 until all the nodes in your cluster have installed the clusterhq-flocker-node and the optional clusterhq-flocker-docker-plugin package.

Next Step¶

The installation of the Flocker clients, node services and the Flocker plugin for Docker is now complete. To enable these services, and to configure your cluster security and backend, you must now configure Flocker:

Or, return to the installation menu.