This documentation corresponds to an earlier product version. Make sure this document corresponds to your version.

Latest OpsCenter documentation | Earlier OpsCenter documentation

Manually deploying agents - Packaged installations

Deploy agents without an SSH connection between the agents and the OpsCenter machine, or to install the agents as part of your node deployment process.

If you installed OpsCenter on a cluster node using a package, you can deploy agents on any supported CentOS, Debian, OEL, RHEL, or Ubuntu nodes. After installation, the agent runs as a service that starts when the machine boots up and restarts automatically.

Prerequisites

Procedure

  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:

      RHEL installs: $ sudo bin/install_agent.sh -s opscenter-agent.rpm <opscenter_host>

      Debian installs: $ sudo bin/install_agent.sh -s 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.
  6. Start the OpsCenter agent:

    $ <install_location> bin/opscenter-agent (Use -f to start in the foreground.)