DataStax OpsCenter Documentation

Automatically deploying agents - Packaged installations

Use this method when you have installed OpsCenter from a package and want a quick and easy installation that provides an SSH connection between the agent and OpsCenter. This method requires root or sudo access to your cluster nodes and login credentials and installs agents using the OpsCenter Dashboard.


  • Your Cassandra or DataStax Enterprise cluster is up and running.
  • OpsCenter is installed and configured.
  • JMX connectivity is enabled on each node in the cluster.
  • You have root or sudo access to the machines where the agents will be installed.
  • You either configured the SSH port or you will accept the default SSH port (22) for node-agent communications.

Installing agents from OpsCenter

To install agents from OpsCenter:

  1. Open a browser window and go to the OpsCenter URL at http://<opscenter_host>:8888 where <opscenter_host> is the IP or hostname of the OpsCenter machine. For example:

  2. When you start OpsCenter for the first time, you will be prompted to connect to your cluster:

  3. Enter the Hostnames or IP addresses of two or three nodes in the cluster and set the JMX set JMX and Thrift ports and credentials.

  4. After connecting to the cluster, start installing the agents by clicking the Fix link located near the top of the Dashboard.

  5. In the Install Node Agent dialog, click Enter Credentials.

  6. In the Node SSH Credentials dialog, enter a Username that has root privileges or sudo access to all of the nodes in your cluster, plus any other required credentials, and then click Done.

  7. In the Install Nodes Agent dialog, click the Install on all nodes.

  8. If prompted, click Accept Fingerprint to add a node to the known hosts for OpsCenter.


It takes a few minutes for OpsCenter to complete the agent installations. After all agents are installed, a success message is displayed.