Flopsar Documentation
3.0
3.0
  • Introduction
  • Overview
    • Versioning
    • Licensing
    • Supported Platforms and Requirements
    • Distribution Packages
    • Release Notes
    • Flopsar Lite
  • Administrator Guide
    • Architecture Fundamentals
    • Installation
    • Agent
    • Server
    • Data Archiving
    • Authentication and Authorization
    • Logging
    • Docker
  • User Guide
    • Workstation
    • Agents Profiles
    • Agents Status
    • Data Browsing
    • Online Monitoring
    • Data Inspector
    • Custom Key-Value Metrics
    • Method Execution Stack
  • Developer Guide
    • Agent API
    • Agent Plugins
    • Server Plugins
    • Database API
  • MISCELLANEOUS
    • Troubleshooting
    • Third-party Components
    • Bug Reporting
Powered by GitBook
On this page
  • Server
  • Installation Example
  • Agent
  • Installation Example
  1. Administrator Guide

Installation

Last updated 4 years ago

Before you install the software, make sure you meet the following requirements:

  • You have at least a few GB of storage for Server data.

  • Your networking environment does not block TCP connections between components.

Server

There are two packages available for installation: flopsar-server-X.Y.Z.deb and flopsar-server-X.Y.Z.rpm. For Debian based distributions you can install it by executing the following command:

# dpkg -i flopsar-server-X.Y.Z.deb

For Red Hat based distributions you can install it by executing one of the following commands:

# rpm -ih flopsar-server-X.Y.Z.rpm
# zypper install flopsar-server-X.Y.Z.rpm
# yum install flopsar-server-X.Y.Z.rpm

You will not be able to run Flopsar unless you accept the (EULA). In order to accept the license, you have to set the environment variable FLOPSAR_EULA_ACCEPT to YES.

You can verify if the Flopsar has been installed successfully by executing the command:

$ flopsar

You should see the Flopsar banner similar to the one below:

  *******************************************************
  *   ______ _      ____  _____   _____         _____   *
  *  |  ____| |    / __ \|  __ \ / ____|  /\   |  __ \  *
  *  | |__  | |   | |  | | |__) | (___   /  \  | |__) | *
  *  |  __| | |   | |  | |  ___/ \___ \ / /\ \ |  _  /  *
  *  | |    | |___| |__| | |     ____) / ____ \| | \ \  *
  *  |_|    |______\____/|_|    |_____/_/    \_\_|  \_\ *
  *                                                     *
  *******************************************************

	Version:     3.0.0
	Build:       3.0.0 
	Released on: (release date)

    Copyright (C) 2012-present by Flopsar Technology
    http://flopsar.com
  *******************************************************

For either standalone or manager modes you must have a valid license file inside your environment directory. For database mode, the license file is not required.

Installation Example

In this example, we use the standalone architecture.

  1. Create a new environment:

    $ flopsar init /opt/flopsar-server
  2. Copy the license file:

    $ cp license.key /opt/flopsar-server/
  3. Accept the EULA:

    $ export FLOPSAR_EULA_ACCEPT=YES
  4. Start the server:

    $ flopsar start /opt/flopsar-server

Agent

In order to install Agent, follow carefully the instructions below:

  1. copy the agent file flopsar-agent-X.Y.Z.jarto your server machine.

  2. create a directory (we call this directory as Flopsar home directory) and ext subdirectory for the agent data.

  3. restart your application.

When the agent starts for the first time it does not have any configuration deployed. It just registers itself to the manager, after a successful connection, and does not instrument anything.

Installation Example

In this example we assume there is already a Server instance running and listening on A.B.C.D:port socket address.

  1. Create a Flopsar home directory along with the ext directory:

    $ mkdir /opt/flopsar
    $ mkdir /opt/flopsar/ext
  2. Copy the agent file:

    $ cp flopsar-agent-X.Y.Z.jar /opt/flopsar/
  3. Copy some plugins:

    $ cp my-plugin.jar /opt/flopsar/ext/
  4. Update JVM start options:

    -Dflopsar.id=MyApp                  \
    -Dflopsar.home=/opt/flopsar         \
    -Dflopsar.manager=A.B.C.D:port      \
    -javaagent:/opt/flopsar/flopsar-agent-X.Y.Z.jar
  5. Restart your application. If the installation was successful, a log file /opt/flopsar/MyApp.0.log should appear.

the agent.

optionally put all your agent into the ext directory.

Flopsar End User License Agreement
plugins
configure