Manually deploying agents - Debian

Installs agents on Linux nodes using APT packages.

address.yaml 

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

  • Installer-Services or package installations: /var/lib/datastax-agent/conf/address.yaml
  • Installer-No Services or tarball installations: install_location/conf/address.yaml

opscenterd.conf 

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

  • Installer-Services or package installations: /etc/opscenter/opscenterd.conf
  • Installer-No Services or tarball installations: install_location/conf/opscenterd.conf
  • Windows installations: Program Files (x86)\DataStax Community\opscenter\conf\opscenterd.conf

Prerequisites

  • Root or sudo access to the machines where the agents will be installed.
  • The Cassandra or DataStax Enterprise cluster is up and running.
  • OpsCenter is installed and configured.
  • JMX connectivity is enabled on each node in the cluster.
  • The OpsCenter diagnostic tarball feature requires a GNU tar version 1.16 or above. CentOS/RHEL version 5.x does not include the required tar version. For those running on CentOS or RHEL version 5, either upgrade OpsCenter to CentOS or RHEL version 6 or above, or download and compile an acceptable version of tar.

Procedure

  1. Add the DataStax repository to the /etc/apt/sources.list.d/datastax.community.list file (if you have already not done so).
    $ echo "deb http://debian.datastax.com/community stable main" | \
    sudo tee -a /etc/apt/sources.list.d/datastax.community.list
  2. Add the DataStax repository key to your Aptitude trusted keys.
    $ curl -L https://debian.datastax.com/debian/repo_key | sudo apt-key add -
  3. Install the DataStax agent.
    $ sudo apt-get update
    $ sudo apt-get install datastax-agent
  4. In address.yaml set stomp_interface to the IP address that OpsCenter is using. You might have to create the file.
    $ echo "stomp_interface: reachable_opscenterd_ip" | sudo tee -a /var/lib/datastax-agent/conf/address.yaml
  5. If SSL communication is enabled in opscenterd.conf, use SSL in address.yaml.
    $ echo "use_ssl: 1" | sudo tee -a /var/lib/datastax-agent/conf/address.yaml
  6. Start the DataStax agent.
    $ sudo service datastax-agent start