Installing DataStax agents

DataStax agents must be installed on every managed node in a cluster and are necessary to perform most of the functionality within OpsCenter.

After you've added the cluster to OpsCenter, you'll see the status of the agents in the Dashboard.

OpsCenter attempts to automatically install the agents on the nodes in the newly added cluster. If this fails, you might need to manually install and configure the agents on each node.

Prerequisites

  • Root or sudo access to the machines where the agents will be installed.
  • JMX connectivity is enabled on each node in the cluster.
  • Either you configured the SSH port, or accepted the default SSH port (22) for node-agent communication.

Procedure

  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.

    When you start OpsCenter for the first time, you are prompted to connect to a cluster:



  2. 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.
    http://1.2.3.4:8888/
  3. In Add Cluster, enter the Hostnames or IP addresses of two or three nodes in the cluster, set the JMX and Thrift ports, and click Save Cluster.
    After OpsCenter connects to the cluster, a Fix link appears near the top of the Dashboard.
  4. Click the Fix link to start installing the agents.


  5. In Install Node Agent, click Enter Credentials.


  6. In Node SSH Credentials, enter a username that has root privileges or sudo access to all of the nodes in your cluster, plus any other required credentials, and click Done.
  7. In the Install Node Agent dialog, click Install on all nodes.
  8. If prompted, click Accept Fingerprint to add a node to the known hosts for OpsCenter.



Results

DataStax agents have been deployed and configured for each managed node in the cluster.

If you are unable to install the agents through the OpsCenter UI, follow the instructions to manually install the agents.