Manually deploy DataStax Agents from Debian

It is preferable to install DataStax Agents automatically. However, when automatic DataStax Agent installation is unsuccessful, manually install them.

This procedure uses APT packages to manually install DataStax Agents on Linux nodes running DataStax Enterprise clusters. Use this procedure if your DataStax Enterprise (DSE) instance was also installed with a Debian package. Otherwise, choose one of the following procedure types that does match:


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


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

In a terminal:

  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
  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 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=6.8.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

Was this helpful?

Give Feedback

How can we improve the documentation?

© 2024 DataStax | Privacy policy | Terms of use

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: +1 (650) 389-6000,