• Glossary
  • Support
  • Downloads
  • DataStax Home
Get Live Help
Expand All
Collapse All

DataStax Enterprise Installation Guide

    • Installing DSE 6.8
      • Which install method should I use?
      • Install on a single node
      • Installing supporting software
      • Installing a cluster using Lifecycle Manager 6.8
      • Installing from the Yum package
      • RedHat systemd configuration
      • Installing from the Debian package
      • Install from the tarball on any Linux distribution
      • Installing patch releases
      • Installing on cloud providers
      • Installing on Docker
      • Uninstalling DSE
      • Default DSE file locations
        • Package installations
        • Tarball installations
    • Installing DSE 6.8 Tools
      • Installing CQLSH
      • Installing DataStax Studio 6.8
      • Installing DSE Graph Loader
      • Installing DataStax Bulk Loader
      • Installing DataStax Apache Kafka Connector
    • Installing DSE OpsCenter 6.8
      • Installing from the RPM package
      • Installing from the Debian package
      • Installing from the tarball on any Linux distribution
      • Installing on Docker
      • Uninstalling OpsCenter
      • Installing DataStax Agents 6.8
        • Installing DataStax Agents automatically
        • Installing DataStax Agents manually
          • From the RPM package
          • From the Debian package
          • From a tarball
        • Setting Agent permissions to run as the DSE user
        • Configuring JAVA_HOME
  • DataStax Enterprise Installation Guide
  • Installing DSE OpsCenter 6.8
  • Installing DataStax Agents 6.8
  • Installing DataStax Agents automatically

Installing DataStax Agents automatically

DataStax Agents must be installed on every managed node in a cluster and are necessary to perform most of the functionality within DSE OpsCenter.

After adding a cluster, OpsCenter determines whether DataStax Agents are already properly installed and configured. If they are not, you are prompted to check the status of the Agents and potentially install them from the Agents tab.

Prerequisites

  • OpsCenter must be installed.

  • Root or sudo access to the machines where the DataStax Agents are installed.

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

  • Either you configured the SSH port, or accepted the default SSH port (22) for node-Agent communication.

  • DataStax Enterprise 6.8. See DSE OpsCenter compatibility with DSE.

Procedure

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

  1. Start your DataStax Enterprise cluster and the OpsCenter daemon.

  2. Open a browser window and go to the OpsCenter URL at http://opscenter_host:8888, where opscenter_host is the IP or hostname of the OpsCenter machine.

    A dialog prompts you to select a cluster option:

    opscNewCluster
  3. Click Manage Existing Cluster > Get Started.

    The Connect to Existing Cluster dialog appears.

    Collapsed view Connect to Existing Cluster dialog in OpsCenter Monitoring
  4. Add one or more hostnames or IP addresses of the nodes in the cluster. For best results, use private IP addresses.

  5. Click Next.

    The Set Up Agents dialog appears.

    Install Agents automatically or manually dialog
  6. Install or start agents automatically is selected by default. Click Next.

    If your environment requires manual installation of DataStax Agents, click Install agents manually. Click the link to access the instructions for manually installing DataStax Agents.

    The Agents Credentials dialog appears.

    Agents Credentials dialog for connecting to nodes
  7. Enter SSH credentials to connect to the nodes:

    1. Enter a Username. The user must have root or sudo privileges.

    2. If using a sudo password for the specified user, enter the password in the Password field.

    3. If using an SSH private key, enter it in the Private Key field.

    Entered credentials information is not saved or stored.

  8. Click Submit.

    The Agents tab opens, starts installing the DataStax Agents, and displays the progress of the agent installation. The DataStax Agent services may go up and down during the installation process.

    Agent Status while installing

    When the install process successfully completes, the DataStax Agents have been deployed and configured for each managed node in the DataStax Enterprise cluster.

    opscAgentsStatusTab

Results

If there are any issues with installing DataStax Agents, a banner at the top of the OpsCenter workspace is displayed. The banner cannot be dismissed until the DataStax Agent issues have been resolved but the banner does not prevent using or navigating the OpsCenter UI. Clicking the Show Details link in the banner displays the clusters having DataStax Agent issues and the number of problems currently detected by OpsCenter. Clicking the # problems link opens the Agent Status tab where you can view more detailed information about Agent status, view troubleshooting suggestions, and access the Set Up Agents button to retry installing the Agents.

Show/Hide Details link in banner for Agent issues

If you were unable to install the Agents through the OpsCenter UI, follow the instructions to manually install the Agents.

Installing DataStax Agents 6.8 Installing DataStax Agents manually

General Inquiries: +1 (650) 389-6000 info@datastax.com

© DataStax | Privacy policy | Terms of use

DataStax, Titan, and TitanDB are registered trademarks of DataStax, Inc. and its subsidiaries in the United States and/or other countries.

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.

landing_page landingpage