Installation
Server
Docker
To install the Flopsar server, you only need to execute the command or use docker-compose.yml
file:
- Command
- docker-compose.yml
$ 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:
- Command
- docker-compose.yml
$ 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.:
- Command
- docker-compose.yml
$ 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
The server component can also be installed manually, if Docker is not an option. In this case, first you must install the Swift runtime. Obviously, you can install the server only on those platforms, that are supported by the Swift runtime.
To install the server manually, follow the instructions below:
- download the Swift runtime
- install all the dependencies required by the 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:
- copy the agent file
flopsar-agent-X.Y.Z.jar
to your server machine. - create a directory (we call this directory a Flopsar home directory) and
ext
subdirectory for the agent data. - configure the agent.
- optionally put all your agent plugins into the
ext
directory. - 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.
The agent must have a license assigned to send its basic data and a profile to send the instrumented data.
Workstation
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 JRE 11 and JFX before you start the workstation.
Quick Start
To quickly set up and start your environment follow the instructions below:
- Download, install and start the server
- Download, install the agent, and start your application
- Download, install and start the workstation
- Log in to the workstation in Admin Mode and register a license
- Log out and log in to the workstation again in normal mode
- Assign the license to your applications
- Create a profile, add some rules, and assign one of your applications to the profile
- Finally, activate the profile.