Cloudify Cluster Manager CLI

Overview

The purpose of the Cluster Manager package is to automate the procedure of installing a Cloudify cluster on existing VMs. The following article will guide you through the different steps of easily installing a Cloudify cluster on either 3 or 9 VMs.

Installation

Choosing a Cluster Configuration

Before using the Cluster Manager package you must prepare a set of VMs for your cluster. The Cluster Manager package supports all cloud providers and the following configurations:

Please follow the prerequisites and sizing guidelines and generate the required number of VMs according to the mentioned spec. You should also prepare a load balancer to distribute the load over the managers.


NOTE

  1. The Cluster Manager package is currently supported over CentOS or RHEL OS.
  2. A load balancer is required for load distribution over the managers. The setup will expect a load balancer address. The Cluster Manager package does not install the load balancer.

Installing the Cluster Manager Package

You can run the Cluster Manager package from one of the cluster’s VMs, or from a different host in the cluster network. You can install the package either by using an RPM or by using pip install:

Installing Using an RPM

Run the following command:

sudo yum install -y http://repository.cloudifysource.org/cloudify/cloudify-cluster-manager/1.1.1/ga-release/cloudify-cluster-manager-1.1.1-ga.el7.x86_64.rpm

Installing Using pip Install

pip install cloudify-cluster-manager

 

Using the Cluster Manager Package

Once the VMs are ready, using the Cluster Manager package to build the cluster consists of three steps:

  1. Generating a cluster configuration file template based on the cluster topology you wish to deploy.
  2. Filling in the generated file with the relevant information.
  3. Running the cluster installation based on the completed configuration file.

Generating a Configuration File

Generating the configuration file is done using the command:

cfy_cluster_manager generate-config [OPTIONS]

Options

NOTE: --three-nodes or --nine-nodes must be specified, and they cannot be specified together.

Filling in the Configuration File

General Note

Fill in the information according to the comments in the file itself. NOTE! Do not delete anything from the file.

Load Balancer

As mentioned before, a load-balancer is not installed as part of the cluster installation. The load_balancer_ip value is used in the different config.yaml files for the instances’ connection.

Certificates

config.yaml Files

Credentials

Installing a Cloudify Cluster

Now that the configuration file is completed, we can move on to the cluster installation using the following command:

cfy_cluster_manager install [OPTIONS]

Options

Removing a Cloudify Cluster

The created Cloudify cluster can be removed using the following command:

cfy_cluster_manager remove [OPTIONS]

Options

Upgrading a Cloudify Cluster

The Cloudify cluster can be upgraded from v5.1.0 (or any later release) to a more recent version using the following command:

cfy_cluster_manager upgrade [OPTIONS]

Options

 

Fault Tolerance Mechanisms

The Cluster Manager package has a few mechanisms to handle errors: