Installation

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

caution

You will not be able to run Flopsar unless you accept the Flopsar End User License Agreement (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
  *******************************************************

info

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.jar to your server machine.
2. create a directory (we call this directory as Flopsar home directory) and ext subdirectory for the agent data.
3. configure the agent.
4. optionally put all your agent plugins into the ext directory.
5. 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.