Manually deploying DataStax Agents from Debian

Installs DataStax Agents on Linux nodes using APT packages.

Prerequisites

  • Root or sudo access to the machines where the agents will be installed.
  • The DataStax Enterprise cluster is up and running.
  • OpsCenter is installed and configured.
  • JMX connectivity is enabled on each node in the cluster.

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:
  • Package installations: /etc/opscenter/opscenterd.conf
  • Tarball installations: install_location/conf/opscenterd.conf

Procedure

Important: End User License Agreement (EULA). By downloading this DataStax product, you agree to the terms of the EULA.

In a terminal window:

  1. Add the DataStax repository to the /etc/apt/sources.list.d/datastax.sources.list file (if not already done):
    echo "deb https://debian.datastax.com/enterprise\
    stable main" | \
    sudo tee -a /etc/apt/sources.list.d/datastax.sources.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=6.5.6-1

    If you are using DSE 5.1 or earlier, you must install an earlier version of the DataStax Agent. See DataStax OpsCenter compatibility with DSE.

    sudo apt-get install datastax-agent datastax-agent-6.0.version-1
  4. In address.yaml, set stomp_interface to the IP address that OpsCenter is using. You might have to create the address.yaml 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