cluster

The cfy cluster command is used to manage clusters of tenants in Cloudify Manager.

Optional flags

These commands support the common CLI flags.

Commands

Start

Usage

cfy cluster start [OPTIONS]

Start a Cloudify Manager cluster with the current manager as the master.

This initializes all the Cloudify Manager cluster components on the current manager, and marks it as the master. After that, other managers can join the cluster by passing this manager’s IP address and encryption key.

Optional flags

Example

$ cfy cluster start
...

Creating a new Cloudify Manager cluster
2017-03-30T08:53:40 Started /opt/manager/env/bin/create_cluster_node.
2017-03-30T08:53:40 Starting /opt/manager/env/bin/create_cluster_node...
.
.
.
2017-03-30T08:55:32 commands.create_cluster_node:INFO: Starting filesystem replication
2017-03-30T08:55:35 commands.create_cluster_node:INFO: HA Cluster configuration complete
Cloudify Manager cluster started at 10.239.0.148.

...

Join

Usage

cfy cluster join [OPTIONS] JOIN_PROFILE

Join a Cloudify Manager cluster on this manager.

A cluster with at least one machine must already exist. Pass the address of at least one member of the cluster as --cluster-join. Specifying multiple addresses, even all members of the cluster, is recommended, to enable joining the cluster even if some of the current members are unreachable. However, it is not required.

Optional flags

Example

$ cfy cluster join 10.239.0.148
...

Joining the Cloudify Manager cluster: [u'10.239.0.148']
2017-03-30T09:14:28 Started /opt/manager/env/bin/create_cluster_node.
2017-03-30T09:14:28 Starting /opt/manager/env/bin/create_cluster_node...
.
.
.
2017-03-30T09:14:33 commands.create_cluster_node:INFO: Starting database
Node joined the cluster, waiting for database replication to be established
Cloudify Manager joined cluster successfully.

...

Update Profile

Usage

cfy cluster update-profile

Fetch the list of cluster nodes and update the current profile.

Use this to update the profile if nodes are added to the cluster from another machine. Only the cluster nodes that are stored in the profile are contacted in the event of a cluster master failure.

This means that when a cluster administrator adds or removes a node from the cluster, all users must run this command to update their CLI profile.

Example

$ cfy cluster update-profile
...

Fetching the cluster nodes list...
Profile is up to date with 2 nodes

...

Nodes

Usage

cfy cluster nodes [OPTIONS] COMMAND [ARGS]

Manage the nodes in the cluster. (Applicable only in cluster.)

Subcommands

list

Display a table with basic information about the nodes in the cluster. This is the primary way of retrieving the cluster status.

Example

$ cfy cluster nodes list
HA Cluster nodes
+----------------+-----------+---------+--------+-------------------+----------+-----------+
|      name      |  host_ip  |  state  | consul | cloudify services | database | heartbeat |
+----------------+-----------+---------+--------+-------------------+----------+-----------+
| manager_node_1 | 10.10.1.1 |  leader |   OK   |         OK        |    OK    |     OK    |
| manager_node_2 | 10.10.1.2 | replica |   OK   |         OK        |    OK    |     OK    |
| manager_node_3 | 10.10.1.3 | replica |   OK   |         OK        |    OK    |     OK    |
+----------------+-----------+---------+--------+-------------------+----------+-----------+

remove

Unregister a node from the cluster.

Note that this will not teardown the removed node, only remove it from the cluster. Removed replicas are not usable as Cloudify Managers, so it is left to the user to examine and teardown the node.

Example

$ cfy cluster nodes remove cloudify_manager_W81PXP
Node cloudify_manager_W81PXP was removed successfully!

Set Active

Usage

cfy cluster set-active NODE_NAME

Specify the node that will be the active node (master) in the cluster.

Example

$ cfy cluster set-active cloudify_manager_UAFA8Y
...

cloudify_manager_UAFA8Y set as the new active node

...

Status

Usage

cfy cluster status

Display the current installation status of the Cloudify Manager cluster.

Example

$ cfy cluster status
...

Cloudify Manager cluster initialized!

...