Advanced Installation

Contents

Introduction

Remote Collector System Requirements

Rootless Collector Installation

Rootless Agent Installation

Configuring Collector High-Availability

 

Introduction

In sensitive production environments, OverOps allows the Agent to communicate with the Collector via sockets instead of shared memory. This reduces CPU and RAM footprints as the OverOps Collector is installed separately from the production machines. Depending on the applied deployment, 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).

When installing OverOps components on different machines, you may not have root access to all machines. This article describes OverOps installation without root access. The procedure requires you to make some manual adjustments.

Remote Collector System Requirements

Hardware

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

Software

  • Linux
  • Java 6 and above.

 

Rootless Collector Installation

The OverOps Collector can also be installed without root access.

Note: Currently, Rootless Collector installation is not supported on Windows.

To install a Collector without root access:

  1. From get.takipi.com/takipi-latest.tar.gz, download the Collector installation TAR file.
  2. Extract files to your working folder:
    tar -xf takipi-collector-latest.tar.gzA ‘takipi’ folder is created.
  3. If you do not possess an Installation key, from the OverOps web application, generate an installation key, see: 
  4. Copy the installation key and paste it into a text file named secret.key.
  5. Save the secret.key file in the <PATH>/takipi/work directory on your machine.
  6. According to the template below, create the takipi.properties file:

    jvmPath=${JAVA_HOME}/jre/lib/amd64/server/libjvm.so
    baseUrl=https://backend.takipi.com/
    s3ConnectionTestUrl=https://s3.amazonaws.com/app-takipi-com/ConnectionTest
    # The TCP port to listen on
    listenOnPort=
    # Used by both Collector & Agent, Arbitrary token used to identify the Agent against the Service
    passphrase=
    # The server name of the Collector. Leave empty for HOSTNAME
    serverName=
    # The internal JVM max heap size
    javaHeapSize=1G
    ...

  7. Place the properties file in the takipi directory on your machine.
  8. Run the Collector:
    <PATH_TO_TAKIPI>/takipi/bin/takipi-service
  9. Test the installation:From the OverOps web application (app.overops.com) Dashboard, click Add Server and then, from the dialog box, click Next and then click Test Installation.
    When the connection is established, the Collector status is 'Monitoring'.
  10. Test that your application throws exceptions.
    Rootless installation does not enable the Collector to start automatically after a reboot.
  11. Run the Collector as a daemon according to your system.

 

Rootless Agent Installation

To install the Agent without sudo:

  1. From, get.takipi.com/takipi-latest.tar.gz, download the Agent installation TAR file.
  2. Extract files to your working folder.

    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

 

Configuring Collector High-Availability

OverOps supports multiple Collectors that can be configured for high-availability and/or for load balancing. 

Note: Collector high-availability is not supported on macOS.

To configure Collector high-availability:

  1. From the Agent, open the takipi.properties file and add the Collector Endpoints: 
    masterEndpoints=<HOST1:PORT>,<HOST2:PORT>..<HOSTn:PORT>
  2. Leave masterHost and masterPort empty.
  3. Save and close the properties file.

To configure load balancing for multiple Collectors, see Load Balancing with Nginx as an example.

Have more questions? Submit a request