Manually deploying DataStax Agents from Debian

Installs DataStax Agents on Linux nodes using APT packages.


  • Root or sudo access to the machines where the DataStax 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.


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


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


  1. Add the DataStax repository to the /etc/apt/sources.list.d/datastax.sources.list file (if not already done):
    echo "deb \
    stable main" | \
    sudo tee -a /etc/apt/sources.list.d/datastax.sources.list

    where DSA_email_address and downloads_key are your DataStax Academy email address 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 \|.

    For backward compatibility, you can use your DataStax Academy Profile Name and password instead of your email address and Downloads Key.

  2. Add the DataStax repository key to your Aptitude trusted keys:
    curl -L | sudo apt-key add -
  3. Install the DataStax agent:
    sudo apt-get update
    sudo apt-get install datastax-agent

    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.7.version-1
  4. In DataStax Agent configuration, 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 DataStax Agent configuration:
    echo "use_ssl: 1" | sudo tee -a /var/lib/datastax-agent/conf/address.yaml
  6. Start the DataStax agent:
    sudo service datastax-agent start