Manually deploying agents - tarball

Install agents on nodes running Cassandra or DataStax Enterprise clusters.

address.yaml 

The location of the address.yaml file depends on the type of installation:

  • Package installations: /var/lib/datastax-agent/conf/address.yaml
  • Tarball installations: install_location/conf/address.yaml

opscenterd.conf 

The location of the opscenterd.conf file depends on the type of installation:

Location Package Installer (GUI or text mode) Tarball
Service No-service
/etc/opscenter/opscenterd.conf X X    
install_location/conf/opscenterd.conf     X X

Prerequisites

  • 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.
  • SYSSTAT Utilities (needed for the collection of I/O metrics).

Procedure

  1. Download the DataStax agent tarball, expand and unarchive it.
    $ curl -L http://downloads.datastax.com/community/datastax-agent-<version-number>.tar.gz | tar xz 
  2. Change into the agent directory.
    $ cd datastax-agent-<version-number>
  3. In address.yaml set stomp_interface to the IP address that OpsCenter is using. (You may have to create the file.)
    $ echo "stomp_interface: <reachable_opscenterd_ip>" >> ./conf/address.yaml
  4. If SSL communication is enabled in opscenterd.conf, use SSL in address.yaml.
    $ echo "use_ssl: 1" >> ./conf/address.yaml
  5. Start the agent.
    $ bin/datastax-agent
    Use the -f flag to run in the foreground.