# 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
```

{% hint style="warning" %}
You will not be able to run Flopsar unless you accept the [Flopsar End User License Agreement](http://flopsar.com/EULA.txt) (EULA). In order to accept the license, you have to set the environment variable `FLOPSAR_EULA_ACCEPT` to `YES`.
{% endhint %}

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
  *******************************************************
```

{% hint style="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.
{% endhint %}

### 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](/3.0/administrator-guide/agent.md#configuration) the agent.
4. optionally put all your agent [plugins](/3.0/developer-guide/untitled.md) 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flopsar.com/3.0/administrator-guide/quick-installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.