Installation
Before you install the software, make sure you meet the following requirements:
you have at least a few GB of storage for the data.
your networking environment does not block TCP connections between components.
The installation procedure covers the server and the agents.
Server
The server binary is distributed as both deb
and rpm
packages. First of all, you need to download the server installation package for your platform and architecture. If you want to serve the workstation application from the Flopsar server, download flopsar-workstation.zip
file too. For Debian based distributions you can install it by executing the following command:
# dpkg -i flopsar-server-<VER>.<arch>.deb
For Red Hat based distributions you can install it by executing one of the following commands:
# rpm -ih flopsar-server-<VER>.<arch>.rpm
# zypper install flopsar-server-<VER>.<arch>.rpm
# yum install flopsar-server-<VER>.<arch>.rpm
In both cases, the installation procedure performs the following operations:
installs
flopsar-server
binarycreates a
flopsar
user, which is used to run the serveradds a
flopsar
systemd
servicecreates a global configuration at
/etc/flopsar
Environment Installation
When the server is installed, next you need to create a new Flopsar environment where the data will be stored. You have two options at your disposal, either bundled environment or separated one.
Copy flopsar-workstation.zip
to your destination machine. Now, you need to create a new Flopsar environment by executing the following command:
$ flopsar-server create --app flopsar-workstation.zip <server_home>
where <server_home>
is a path to the location where the server home directory will be created. If the command executes successfully, it will create a new directory at the specified path.
If you start the server using systemd
, note that it will run it as flopsar
user by default. Make sure this user has read/write permissions to the environment directory.
Server Configuration
The server stores its configuration globally in /etc/flopsar/settings.yml
file. You must edit this file to make at least two changes. The first one is required and you must accept the EULA by setting option eula: true
otherwise, you will not be able to run the server. The second one is to set the data
option, which points to you environment directory.
Running the Server
Finally, you can start the server by executing the following command:
# systemctl start flopsar
If you installed the workstation application bundled with the Flopsar Server, then you can access the application at the address specified at the server configuration. If you installed the workstation application outside the Flopsar server, you can access it at the address specified in your web server configuration. In either case, you should be able to access the workstation application login page at the address: https://<YOUR_IP>:9443

Docker Image
Alternatively, you can use a Docker image which has preinstalled the server along with the workstation. The image is shipped for two architectures: amd64
and aarch64
. All you need to do is pull the image. For amd64
architecture:
$ docker pull flopsar/server:5.3.0 --platform linux/amd64
or for aarch64
:
$ docker pull flopsar/server:5.3.0 --platform linux/arm64
Next, run the server by executing the following command:
$ docker run -d -p 9443:9443 -p 9000:9000 flopsar/server:5.3.0
or if you use podman
:
$ podman run -d -p 9443:9443 -p 9000:9000 docker.io/flopsar/server:5.3.0
Quick Sample Installation
This section presents a sample, quick installation of the Flopsar server. First download the installation package along with the workstation application. Next, execute the following command:
$ sudo dpkg -i flopsar-server-5.3.0.amd64.deb
or if you use rpm
package:
$ sudo rpm -i flopsar-server-5.3.0.x86_64.rpm
Next, let's create a new Flopsar environment at /opt
directory:
$ sudo flopsar-server create --app flopsar-workstation.zip /opt/flopsar
If the environment has been created successfully, the following output should be displayed:
Creating a new Flopsar Server environment...
Unpacking Flopsar Workstation application...
Flopsar Server environment created successfully.
Next, change the ownership of the environment directory to flopsar
user:
$ sudo chown -R flopsar /opt/flopsar
Next, open the /etc/flopsar/settings.yml
file:
eula: false
name: my environment
data: /path/to/data
max_ext_size: 1MiB
agent:
server_ip: 0.0.0.0
server_port: 9000
ui_srv:
server_ip: 0.0.0.0
server_port: 9443
ssl:
enable: true
cert: server.crt
key: server.pem
logger:
backend: Local
max_size: 50MiB
max_files: 5
archive:
enable: false
policy: purge
start_at: 03:00:00.0
retention: 3days
pass_policy:
enable: true
min_len: 8
digits: true
special_chars: false
capital_letters: false
forbidden_chars: ''
and make changes in both eula
and data
options (line 1 and 3):
eula: true
name: my environment
data: /opt/flopsar
max_ext_size: 1MiB
agent:
server_ip: 0.0.0.0
server_port: 9000
ui_srv:
server_ip: 0.0.0.0
server_port: 9443
ssl:
enable: true
cert: server.crt
key: server.pem
logger:
backend: Local
max_size: 50MiB
max_files: 5
archive:
enable: false
policy: purge
start_at: 03:00:00.0
retention: 3days
pass_policy:
enable: true
min_len: 8
digits: true
special_chars: false
capital_letters: false
forbidden_chars: ''
And finally, start the server:
$ sudo systemctl start flopsar
Now, you should be able to access the workstation application at https://localhost:9443
Agent
To install the agent, follow carefully the instructions below:
select the agent library file for your platform and architecture.
copy the agent library to your server machine.
configure the agent.
restart your application.
Last updated