Installation

Last updated 6 months ago

Linux How To

At this moment the supported distributions by the instalation script are

ubuntu debian

probably will work on

centos redhat fedora

From the web panel you can download the binary agent and get the installation script for your distribution.

Windows Installer.

To get the last version of the Windows installer, please contact us. We will provide you an installer with last versión of the binary agent.

Prerequisites

First, go to TheEye Web Site and create and account. After you receive you account credential , singin and go to the profile page. There you will found the agent credentials and the installation instructions and software (if available).

If you need to debug, develop or if you prefer the manual installation of the agent, keep reading.

Manual Instalation from sources

Before Start

  • Is not mandatory, but your will get more benefits if you install the agent with admin privileges (root/administrator).

  • NodeJS ( minimal v0.12 (can stopped working eventually). v8 recommended )

  • NPM (part of the node toolkit. version 3 or higher)

This how-to was written for Linux users. But if your platoform can run nodejs, then you can install the agente and will work. Please, contact us if you need support.

Step 1.

create a directory to contain the agent. we use /opt/theeye-agent

mkdir /opt/theeye-agent

download the sources (lastest - production version).

cd /opt/; git clone https://github.com/theeye-io/theeye-agent

Step 2.

create a configuration file using the default empty template

mkdir /etc/theeye; cp /opt/theeye-agent/misc/theeye/theeye.conf /etc/theeye/theeye.conf

Step 3.

setup the configuration file

OPTIONAL. get the agent version and update the config file with it. The will be reported from the web panel

git describe

This is the configuration file. You would get the values to fill in from the Web

#!/bin/bash
# export all vars hereunder
set -a
THEEYE_SUPERVISOR_CLIENT_ID=''
THEEYE_SUPERVISOR_CLIENT_SECRET=''
THEEYE_SUPERVISOR_CLIENT_CUSTOMER=''
# were to put the downloaded scripts
THEEYE_AGENT_SCRIPT_PATH='/opt/theeye-agent/scripts'
#
# Execution logging level. Don't change in production unless you know what are doing.
# If you need to increase debug level check this link for more information
# Link: https://www.npmjs.com/package/debug
#
# default is to output only errors
#THEEYE_AGENT_DEBUG='eye:*:error'
THEEYE_AGENT_DEBUG='eye:*:error'
# You will probably need this to be reported.
# If you download the source get the version with `git describe` and update
THEEYE_AGENT_VERSION=''
# This is the api url. You will need one. https://app.theeye.io
THEEYE_SUPERVISOR_API_URL=''
# If you need to use a proxy, it is time to set it
#http_proxy=""
#https_proxy=""
# Environment
NODE_ENV='production'

Step 4.

install dependencies.

cd /opt/theeye; npm install

Step 5.

run the agent.

cd /opt/theeye; ./run.sh

Optional Arguments.

optional arguments are passsed via shell environment.

THEEYE_CLIENT_HOSTNAME='myawesomehost.com' ./run.sh

if you want to use any option as a default settings, you can set it in the config file.

More Options.

to set a custom hostname. this will be used to register the agent and the host agains the api. hostname-customer combination MUST be unique.

THEEYE_CLIENT_HOSTNAME='the_hostname_you_want'

Offline Installation

Step 1.

download the sources (https://s3.amazonaws.com/theeye.agent/linux/theeye-agent64.tar.gz).

cd /opt/; sudo tar -xvf ./theeye-agent64.tar.gz

Step 2.

create a configuration file using the default empty template

mkdir /etc/theeye; cp /opt/theeye-agent/misc/theeye/theeye.conf /etc/theeye/theeye.conf

Step 3.

run /opt/theeye-agente/runBinary.sh