Remote Collector Installation

Contents

Introduction

Remote Collector System Requirements

Installing the Remote Collector

Installing the Micro-Agent for the Remote Collector

Advanced Security (optional)

 

Introduction

For hyper-sensitive production environments, OverOps allows the micro-agent to communicate with the Collector via sockets instead of shared memory. This further reduces CPU and RAM footprints as the OverOps Collector is removed from the production machines. Depending on the applied mode of usage, the Collector can be installed on the Shark cluster (on-premises mode), on the storage server (Hybrid mode) or in any other machine available (SaaS mode).

 

Remote Collector System Requirements

Hardware

  • Minimum 4 GB RAM (8 GB recommended)
  • Minimum 50 GB Disk Space

Software

  • Linux
  • Java 6 and above

 

Installing the Remote Collector

To install Collector on Linux OS:

  1. Select a port to connect to the Collector's machine: <COLLECTOR_PORT>. 
  2. Verify that the <COLLECTOR_PORT> is not blocked by any firewall.
  3. Run the installation command from a terminal:
    With Wget:
    wget -O - -o /dev/null http://get.takipi.com | sudo bash /dev/stdin -i --sk=<SECRET_KEY> --listen_on_port=<COLLECTOR_PORT>

    With cURL:
    curl -sL /dev/null http://get.takipi.com | sudo bash /dev/stdin -i --sk=<SECRET_KEY> --listen_on_port=<COLLECTOR_PORT>
  4. Save the IP address of the machine: <COLLECTOR_HOST>.

  5. Continue to installing the micro-agent as described below.

 

Installing the Micro-Agent for the Remote Collector

To quick install the Agent with sudo:

  1. Run the installation command from a terminal:
    With Wget:
    wget -O - -o /dev/null http://get.takipi.com | sudo bash /dev/stdin -i --sk=<SECRET_KEY> --daemon_host=<REMOTE_COLLECTOR_HOST> --daemon_port=<REMOTE_COLLECTOR_PORT>
    With cURL:
    curl -sL /dev/null http://get.takipi.com | sudo bash /dev/stdin -i --sk=<SECRET_KEY> --daemon_host=<REMOTE_COLLECTOR_HOST> --daemon_port=<REMOTE_COLLECTOR_PORT>
  2. Start your application with -agentlib:TakipiAgent JVM argument.

 

To install the micro-agent without sudo:

  1. Download the Takipi agent:
    With Wget:
    wget http://get.takipi.com/takipi-agent-latest.tar.gz

    With cURL
    curl -LO http://get.takipi.com/takipi-agent-latest.tar.gz

  2. Unpack it to any directory. A takipi folder is created.
  3. Edit the takipi.properties file and set:
    - serverName: the machine name, usually this is the output of echo `hostname`.
    - masterHost: the Collector host.
    - masterPort: the Collector port.
  4. Start your application with -agentpath and full path java -agentpath:/home/user/takipi/lib/libTakipiAgent.so -jar sample.jar arg1

 

Advanced Security (optional)

To establish a secure connection through SSH tunneling:

  1. Select a port to use for connection from the Agent machine: <AGENT_PORT>.
  2. On the Agent machine, from a terminal, run:
    ssh [-i </path/to/key.pem>] -f -L <AGENT_PORT>:<COLLECTOR_HOST>:<COLLECTOR_PORT> <USER>@<COLLECTOR_HOST> -N

    <USER> = the user to connect as on the Collector machine.

  3. Run the installation command from terminal:
    wget -O - -o /dev/null http://get.takipi.com | sudo bash /dev/stdin -i --sk=<SECRET_KEY> --daemon_host=localhost --daemon_port=<AGENT_PORT>

  4. Add a passphrase to the Collector and the Agent to prevent uncertified agents from connecting to the Collector (optional). This is an additional security layer to prevent from agents to overload the Collector. Add the following argument to the installation command (of both the Agent and Collector):
    --passphrase=<ANY_GIVEN_TEXT>
Have more questions? Submit a request