Remote Collector Process



Remote Collector System Requirements

Installing the Collector

Installing the Micro-Agent


Advanced Security (optional)



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


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


  • Linux or Windows OS
  • Java 6 and above


Installing the 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 | sudo bash /dev/stdin -i --sk=<SECRET_KEY> --listen_on_port=<COLLECTOR_PORT>
    With cURL:
    curl -sL /dev/null | 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


To install Collector on Windows OS:

  1. From the Collector machine, open the OverOps web application and click Add Servers.
  2. From the Install OverOps on another Server dialog box, click Copy to copy the secret key to the clipboard.
  3. Click Download.
  4. Click on the downloaded file to install OverOps and follow the wizard 
  5. When prompted, paste the secret key.
  6. From the Collector machine, open the file (by default it is in C:\takipi folder): 
    1. Insert:
    2. Save and close the file.
    3. From Windows Services, find Takipi in the services list, and restart it.
      Note: You may need to modify the inbound rules of the Windows Firewall setting to open connection from the collector. 
  7. Repeat Steps 1 to 5 on the Agent machine.
  8. From the Agent machine, open the file (by default it is in the C:\takipi folder): 
    1. Insert:
    2. Save and close the file.


Installing the Micro-Agent

To quick install the Agent with sudo:

  1. Run the installation command from a terminal:
    With Wget:
    wget -O - -o /dev/null | sudo bash /dev/stdin -i --sk=<SECRET_KEY> --daemon_host=<REMOTE_COLLECTOR_HOST> --daemon_port=<REMOTE_COLLECTOR_PORT>

    With cURL:

    curl -sL /dev/null | 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:

    With cURL
    curl -LO

  2. Unpack it to any directory. A takipi folder is created.
  3. Edit the 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/ -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 | 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):
Have more questions? Submit a request