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

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

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

Prerequisites

  • Root or sudo access to the machines where the agents will be 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 4.7 or greater.

Procedure

  1. Install OpsCenter.
  2. Start your DataStax Enterprise cluster and the OpsCenter daemon.
  3. 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.

  4. Click Manage Existing Cluster and Get Started.
    The Connect to Existing Cluster dialog appears.



  5. Add one or more hostnames or IP addresses of the nodes in the cluster. For best results, use private IP addresses.
  6. Click Next.
    The Set Up Agents dialog appears.

    Install Agents automatically or manually dialog

  7. Install or start agents automatically is selected by default. Click Next.
    If your environment requires manual installation of agents, click Install agents manually. Click the link to access the instructions for manually installing agents.
    The Install Agents - Credentials dialog appears.

    Install Agents - Credentials dialog for connecting to nodes

  8. Enter SSH credentials to connect to your nodes:
    1. Required: Enter a Username. The user must have root or sudo privileges.
    2. Optional: A sudo password can be entered in the Password box.
    3. Optional: Enter a Private Key.
    No information entered in the Install Agents - Credentials dialog is saved or stored.
  9. Click Install. The Agents tab opens and displays the progress of the agent installation.

Results

DataStax agents have been deployed and configured for each managed node in the DataStax Enterprise cluster.

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