Flopsar Documentation
4.0
4.0
  • Introduction
  • overview
    • Versioning
    • Licensing
    • Supported Platforms and Requirements
    • Distribution Packages
  • administrator guide
    • Architecture Fundamentals
    • Installation
    • Agent
    • Server
    • Registering License
    • Managing Users
    • Logging
  • user guide
  • Workstation
  • Data Inspector
  • Database Browser
  • Metrics
  • Agents
  • Profiles
  • Symptom Driven Diagnostics
  • Managing Licenses
  • Method Execution Tree
  • developer guide
    • Agent Plugins
  • miscellaneous
    • FAQ
    • Third-party Components
Powered by GitBook
On this page
  • Server
  • Docker
  • Standalone
  • Agent
  • Workstation
  • Quick Start
  1. administrator guide

Installation

Server

Docker

The server is shipped as a Docker image. To install the Flopsar server, you only need to execute the command or use docker-compose.yml file:

$ docker run -d      \
-p 9000:9000         \
-p 9443:9443         \
-e ACCEPT_EULA=y     \
flopsar/server:4.0.0 flopsar start
version: '3'

services:
    flopsar-server:
      image: flopsar/server:4.0.0
      command: flopsar start
      ports:
        - "9000:9000"
        - "9443:9443"
      environment:
        - ACCEPT_EULA=y  

This will create a new container and start the server. By default, the server listens on two ports: 9000 and 9443. The first port is used by agents and the second one by workstations.

It is recommended to attach a volume for the server data. You can do this by executing the command:

$ docker run -d                              \
-p 9000:9000                                 \
-p 9443:9443                                 \
-v <REPLACE_WITH_YOUR_PATH>:/opt/flopsar     \
-e ACCEPT_EULA=y                             \
flopsar/server:4.0.0 flopsar start
version: '3'

services:
    flopsar-server:
      image: flopsar/server:4.0.0
      command: flopsar start
      ports:
        - "9000:9000"
        - "9443:9443"
      environment:
        - ACCEPT_EULA=y
      volumes:
        - <REPLACE_WITH_YOUR_PATH>:/opt/flopsar  

By default, the server uses /opt/flopsar for its data directory. This can be changed by setting the FLOPSAR_HOME environment variable, e.g.:

$ docker run -d                             \
-p 9000:9000                                \
-p 9443:9443                                \
-v <REPLACE_WITH_YOUR_PATH>:/flopsar        \
-e FLOPSAR_HOME=/flopsar                    \
-e ACCEPT_EULA=y                            \
flopsar/server:4.0.0 flopsar start
version: '3'

services:
    flopsar-server:
      image: flopsar/server:4.0.0
      command: flopsar start
      ports:
        - "9000:9000"
        - "9443:9443"
      environment:
        - ACCEPT_EULA=y
        - FLOSPAR_HOME=/flopsar
      volumes:
        - <REPLACE_WITH_YOUR_PATH>:/flopsar 

Standalone

To install the server manually, follow the instructions below:

  • download the Swift runtime

  • unpack the Swift binaries into the system root directory:

    $ sudo tar xzvf <SWIFT.TAR.GZ> -C / --strip=1

  • copy the flopsar binary to your machine

Agent

To install the 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 a Flopsar home directory) and ext subdirectory for the agent data.

  3. optionally put all your agent plugins into the ext directory.

  4. restart your application.

When the agent starts for the first time it does not have any profile assigned. It just registers itself to the server after a successful connection, sends its status data, and does not instrument anything nor send any data.

Workstation

Quick Start

To quickly set up and start your environment follow the instructions below:

  1. Download, install the agent, and start your application

  2. Download, install and start the workstation

  3. Log out and log in to the workstation again in normal mode

Last updated 3 years ago

The server component can also be installed manually, if Docker is not an option. In this case, first you must install the . Obviously, you can install the server only on those platforms, that are supported by the Swift runtime.

install all the by the runtime

the agent.

The agent must have a to send its basic data and a to send the instrumented data.

If you are on a Windows platform, just download a Windows installation file and install the workstation. For other platforms, download the zip file with the workstation application. Since the application is distributed without Java runtime, you will need to install both before you start the workstation.

Download, and start the server

Log in to the workstation in and

to your applications

, add some rules, and to the profile

Finally, .

Swift runtime
dependencies required
configure
license assigned
profile
JRE 11 and JFX
install
Admin Mode
register a license
Assign the license
Create a profile
assign one of your applications
activate the profile