Manually deploying DataStax Agents from RPM

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

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

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

Procedure

In a terminal:

  1. Add the DataStax Yum repository in the /etc/yum.repos.d/datastax.repo file.
    [opscenter] 
    name = DataStax Repository
    baseurl = https://DSA_email_address:downloads_key@rpm.datastax.com/enterprise
    enabled = 1
    gpgcheck = 0
    Note: Set the 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 http://rpm.datastax.com/rpm/repo_key 
  3. Install the DataStax agent:
    sudo yum install datastax-agent-6.5.3-1

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

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