Manually deploy DataStax Agents from a tarball

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

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

Prerequisites

  • An IBMid.

    • If you are an existing IBM customer with an IBMid, you can continue to use your established account.

    • If you don’t have an IBMid, you can create one.

    • If your company uses Enterprise Federation (EF) for authentication with corporate credentials, see the EF documentation.

  • The DSE cluster is up and running.

  • OpsCenter is installed and configured.

  • JMX connectivity is enabled on each node in the cluster.

  • SYSSTAT Utilities (needed for the collection of I/O metrics).

The location of the address.yaml file depends on the type of installation:

  • Package installations: /var/lib/datastax-agent/conf/address.yaml

  • Tarball installations: INSTALLATION_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: INSTALLATION_LOCATION/conf/opscenterd.conf

Procedure

  1. Download and extract the tarball file:

    1. Sign in to Fix Central.

    2. In the Product selector field, enter IBM DataStax OpsCenter.

    3. Select the version you want to install from the Release list, and then click Continue.

    4. On the Identify fixes page, click Continue to use the default Browse for fixes option.

    5. Select the fix pack (OpsCenter version) you want to install, and then click Continue.

    6. Review the terms and conditions, and then click I agree.

  2. Click the DataStax Agent tarball link to download the file, for example, datastax-agent-6.8.47-bin.tar.gz.

  3. Extract the tarball file into the directory where you want to install the DataStax Agent:

    cd datastax-agent-VERSION_NUMBER

  4. In the address.yaml file, 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" >> ./conf/address.yaml

  5. If SSL communication is enabled in opscenterd.conf, use SSL in address.yaml:

    echo "use_ssl: 1" >> ./conf/address.yaml

  6. Start the agent:

    bin/datastax-agent

    Use the -f flag to run in the foreground.

Was this helpful?

Give Feedback

How can we improve the documentation?

© Copyright IBM Corporation 2025 | Privacy policy | Terms of use |  Manage Privacy Choices

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: Contact IBM