DataStax OpsCenter Documentation

Manually deploying agents - Packaged installations

If you installed OpsCenter on a cluster node using a package, you can deploy agents on other supported CentOS, Debian, OEL, RHEL, or Ubuntu nodes.

Use this method to deploy the agents:

  • If you do not need an SSH connection between the agents and the OpsCenter machine.
  • If you want to install the agents as part of your node deployment process.

Because this method uses the agent packages, it requires sudo access. After installation, the agent runs as a service that starts when the machine boots up and restarts automatically.

Prerequisites

  • Your Cassandra or DataStax Enterprise cluster is up and running.
  • OpsCenter is installed and configured on a node in the cluster.
  • JMX connectivity is enabled on each node in the cluster.
  • If you do not install using the agent Debian or RPM package, make sure that your nodes also have the SYSSTAT utility installed (needed for the collection of I/O metrics).

Installing agents

To install agents in packaged installations:

  1. On the OpsCenter machine, go to the opscenter directory:

    $ cd /usr/share/opscenter
    
  2. Copy the agent software to the home directory in your cluster node. For example:

    $ scp agent.tar.gz <user>@<node_IP>:~/
    
  3. Log in to the node, go to the home directory, and unpack it. For example:

    $ ssh <user>@<node_IP>
    $ cd ~/
    $ tar -xzf agent.tar.gz
    

    The binary package creates and agent directory containing the installation files.

  4. If you have sudo access, installing the agent using the package is recommended:

    1. If needed get the IP address of the OpsCenter host. On the node containing the OpsCenter:

      $ hostname -i
      
    2. On the node where you are installing the agent, go to the agent directory:

      $ cd agent
      
    3. Install the agent:

      RHELCentOS: sudo bin/install_agent.sh opscenter-agent.rpm <opscenter_host>

      DebianUbuntu: sudo bin/install_agent.sh opscenter-agent.deb <opscenter_host>

      Note

      Generally the agent can detect the listener IP address for the node, which is the IP address displayed for node by running nodetool ring -h localhost. If needed, add <node_listen_address> to the above command.

  5. If you do not have sudo access:

    1. If needed get the IP address of the OpsCenter host. On the node containing the OpsCenter:

      $ hostname -i
      
    2. On the node where you are installing the agent, go to the agent directory:

      $ cd agent
      
    3. Run the setup command and install the agent:

      $ bin/setup <opscenter_host>
      

      Note

      Generally the agent can detect the listener IP address for the node, which is the IP address displayed for node by running nodetool ring -h localhost. If needed, add <node_listen_address> to the above command.

    4. Start the OpsCenter agent:

      $ bin/opscenter-agent (in the background - default)

      $ bin/opscenter-agent -f (in the foreground)

  6. Open a browser window and go to the OpsCenter console URL at http://<opscenter_host>:8888. For example:

    http://110.123.4.5:8888