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:

  • 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

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.

Procedure

  1. Add the DataStax repository to the /etc/apt/sources.list.d/datastax.sources.list file (if you have already not done so). 
    echo "deb https://dsa_email_address:password@debian.datastax.com/enterprise\
stable main" | \
sudo tee -a /etc/apt/sources.list.d/datastax.sources.list

    where DSA_profile_name and downloads_key are your DataStax Academy Profile Name and My Downloads Key. Depending on your environment, you might need to replace @ in your email address with %40 and escape any character in your password that is used in your operating system's command line. Examples: \! and \|.

  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 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