Quick Linux Installation

Contents

Introduction

System Requirements

Installing Agent for a Local Collector

Installing a Remote Collector

Installing an Agent for the Remote Collector

Running an Application Behind a Proxy Server

 

Introduction

The OverOps Agent and Collector can be installed on one host or on separate hosts. OverOps provides one-liner scripts for both the Agent and the Collector for simple installation with root access. When installed on the same host, the OverOps Agent and Collector can be installed with a single script. 

This article described the simple OverOps installation using one-liners. This procedure requires root access and the Installation Key provided by OverOps.

Remote Collector System Requirements

Hardware

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

Software

  • Linux
  • Java 6 and above.

Installing Agent for a Local Collector

To install the Agent on monitored machines and restart JVM:

  1. Create a host-specific installation script, by replacing the <INSTALLATION_KEY> placeholder with your OverOps installation key in the one-liner below:
    With Wget:

    wget -O - -o /dev/null http://get.takipi.com | sudo bash /dev/stdin -i --sk=<INSTALLATION_KEY>
    With cURL:
    curl -sSL http://get.takipi.com | sudo bash /dev/stdin -i --sk=<INSTALLATION_KEY>
  2. Run the installation script on the host with the JVM to monitor.
  3. To connect the OverOps Agent to your processes, add agentlib:TakipiAgent to your JVM argument and restart your Java/Scala application.
    Note: -agentlib:TakipiAgent is a JVM argument and should be written before -jar / -cp (classpath) arguments.

Installing a Remote Collector

To install Collector on Linux OS:

  1. Select a TCP port to connect to the Collector host: <COLLECTOR_PORT>. 
  2. Verify that the <COLLECTOR_PORT> is not blocked by any firewall.
  3. Run the installation script from a terminal:
    With Wget:
    wget -O - -o /dev/null http://get.takipi.com | sudo bash /dev/stdin -i --sk=<INSTALLATION_KEY> --listen_port=<COLLECTOR_PORT>
    With cURL:
    curl -sSL http://get.takipi.com | sudo bash /dev/stdin -i --sk=<INSTALLATION_KEY> --listen_port=<COLLECTOR_PORT>
  4. Save the IP address of the <COLLECTOR_HOST>.

  5. Add an Agent as described below.

Installing an 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=<INSTALLATION_KEY> --collector_host=<REMOTE_COLLECTOR_HOST> --collector_port=<REMOTE_COLLECTOR_PORT>
    With cURL:curl -sSL http://get.takipi.com | sudo bash /dev/stdin -i --sk=<INSTALLATION_KEY> --collector_host=<REMOTE_COLLECTOR_HOST> --collector_port=<REMOTE_COLLECTOR_PORT>
  2. Start your application using the following JVM argument:
    -agentlib:TakipiAgent

Running an Application Behind a Proxy Server

If your application is running behind a proxy server, enter its address by setting the optional MyProxyAddress value (e.g. http://user:pass@192.168.1.101:8080/).

wget -e http_proxy=<MyProxyAddress> -e https_proxy=<MyProxyAddress> -O - -o /dev/null http://get.takipi.com | sudo bash /dev/stdin -i --sk=<INSTALLATION_KEY> --https_proxy=<MyProxyAddress> -d; source /opt/takipi/etc/takipi-auto-agentcurl -x <MyProxyAddress> -sSL http://get.takipi.com | sudo bash /dev/stdin -i --sk=<INSTALLATION_KEY> --https_proxy=<MyProxyAddress> -d; source /opt/takipi/etc/takipi-auto-agent

Note: The address must be entered in two places – once for the cURL command, and once for the installation script itself.

Have more questions? Submit a request