Use the cassandra command of the cell management tool to connect the cell to an optional metrics database.

vCloud Director can collect metrics that provide current and historic information about virtual machine performance and resource consumption. Use this subcommand to configure an Apache Cassandra database for use as a vCloud Director metrics repository. Use the cell-management-tool configure-metrics subcommand to tool to configure the set of metrics to collect. See Configuring Metrics Collection.

Data for historic metrics is stored in an Apache Cassandra database. See the vCloud Director Installation and Upgrade Guide for more information about configuring optional database software to store and retrieve performance metrics.

To create a connection between vCloud Director and an Apache Cassandra database, use a command line with the following form:

cell-management-tool cassandra options

Table 1. Cell Management Tool Options and Arguments, cassandra Subcommand

Command

Argument

Description

--help (-h)

None

Provides a summary of available options for this command.

--cluster-nodes

address [, address ... ]

Comma-separated list of Cassandra cluster nodes to use for vCloud Director metrics.

--clean

None

Remove Cassandra configuration settings from the vCloud Director database.

--configure

None

Configure vCloud Director for use with an existing Cassandra cluster.

--dump

None

Dump the current connection configuration.

--keyspace

string

Set vCloud Director keyspace name in Cassandra to string. Defaults to vcloud_metrics.

--offline

None

Cofigure Cassandra for use by vCloud Director, but do not test the configuration by connection to vCloud Director.

--password

string

Password of Cassandra database user

--port

integer

Port to connect to at each cluster node. Defaults to 9042.

--ttl

integer

Retain metrics data for integer days. Set integer to 0 to retain metrics data forever.

--update-schema

None

Initializes the Cassandra schema to hold vCloud Director metrics data.

--username

string

User name of the Cassandra database user.

Configuring a Cassandra Database Connection

Use a command like this, where node1-ip, node2-ip, node3-ip and node4-ip are the IP address of the members of the Cassandra cluster. The default port (9042) is used. Metrics data are retained for 15 days.

[root@cell1 /opt/vmware/vcloud-director/bin]# ./cell-management-tool cassandra --configure --create-schema \
--cluster-nodes node1-ip,node2-ip,node3-ip, node4-ip \
--username admin --password 'P@55w0rd' --ttl 15

You must re-start the cell after this command completes.