Remote Collector Process

Contents

Introduction

Installing the Collector

Installing the Micro-Agent

Remote Collector System Requirements

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 (in on-premises mode), on the storage server (in Hybrid mode) or in any other machine available (in SaaS mode).

 

Remote Collector System Requirements

  • Linux Server
  • Java 7
  • Minimum 4GB RAM (8GB recommended)
  • Minimum 50GB Disk Space

 

Installing the Collector

  1. Select a port to use for connection into the Collector's machine. Let's mark it as <COLLECTOR_PORT>.
  2. Make sure <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 of the machine, we'll need it when installing the agent. Mark it as <COLLECTOR_HOST>.

  5. Install the micro-agent as described below

 

Installing the Micro-Agent

a. Easy instructions, requires 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.

b. Advanced instructions, 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, it will create a takipi folder.
  3. Edit takipi.properties file and set:
    - serverName: the machine name, usually this will be 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)

Secure connection can be made through ssh tunneling. To do this follow the instructions below:

  1. Select a port to use for connection from the agent's machine. Let's mark it as <AGENT_PORT>.
  2. On the agent machine, run the following connection from a terminal:
    ssh -f -L <AGENT_PORT>:<COLLECTOR_HOST>:<COLLECTOR_PORT> <USER>@<COLLECTOR_HOST> -N

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

    * If the machine needs a private key to connect to, add after the ssh command and before the -f argument:
    -i /path/to/key For example:
    ssh -i key.pem -f -L …

  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. In order to prevent un-certified agents from connecting to the Collector, a passphrase can be added to the Collector and the agent. This is an additional security layer to prevent from agents to connect and overload the Collector. To use it, the following argument should be added to the installation command (of both the Agent and Collector):
    --passphrase=<ANY_GIVEN_TEXT>
Have more questions? Submit a request