Remote Collector Process

Contents

Introduction

Remote Collector System Requirements

Installing the Collector

Installing the Micro-Agent

 

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 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 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

 

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 takipi.properties file (by default it is in C:\takipi folder): 
    1. Insert:
      listenOnPort=<REMOTE_COLLECTOR_HOST>
    2. Save and close the takipi.properties 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 takipi.properties file (by default it is in the C:\takipi folder): 
    1. Insert:
      masterHost=<DAEMON_HOST> 
      masterPort=<DAEMON_PORT>
    2. Save and close the takipi.properties 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 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