Manually deploying DataStax Agents from RPM

Installs DataStax Agents on Linux nodes using Yum 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 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


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


In a terminal:

  1. Add the DataStax Yum repository in the /etc/yum.repos.d/datastax.repo file.
    name = DataStax Repository
    baseurl =
    enabled = 1
    gpgcheck = 0
    Note: Set gpgcheck=1 to perform a GPG signature check.

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

  2. If you have enabled signature verification (gpgcheck=1), import the repository key:
    sudo rpm --import 
  3. Install the DataStax agent:
    sudo yum install datastax-agent

    If you are using an earlier version of OpsCenter, add the supported version to the command:

    sudo yum install 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 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