This documentation corresponds to an earlier product version. Make sure this document corresponds to your version.

Latest OpsCenter documentation | Earlier OpsCenter documentation

Manually deploying agents - Tarball installations

Install agents on nodes running tarball installations of Cassandra or DataStax Enterprise clusters.

The agent where OpsCenter is installed is automatically installed; it is not installed on the other nodes in the cluster. Only after starting OpsCenter, is the agent.tar.gz file installed in the OpsCenter installation folder. Use this file to manually deploy the agents to other nodes in a cluster.


  1. Copy the agent tar file from your existing OpsCenter installation directory to your cluster node. For example, to copy to the install location:
    $ cd <install_location>
    $ scp agent.tar.gz <user>@<node_IP>:/<install_location>
    Note: The agent.tar.gz file is not created until you run OpsCenter for the first time.
  2. Log in to the node, copy the agent.tar.gz file to the desired location, and unpack it. For example:
    $ ssh user@<node_IP>
    $ cd <install_location>
    $ tar -xzf agent.tar.gz
    The binary package creates and agent directory containing the installation files.
  3. Configure and start the agent:
    1. If needed, get the IP address of the OpsCenter host. On the node containing the OpsCenter:
      $ hostname -i
    2. On the node where you are installing the agent:
      $ cd agent
      $ bin/setup <opscenter_host>
      Note: Generally the agent can detect the listener IP address for the node, which is the IP address displayed for node by running nodetool ring -h localhost. If needed, add <node_listen_address> to the above command.
  4. Start the OpsCenter agent:

    $ <install_location> bin/opscenter-agent (Use -f to start in the foreground.)