Skip to content

Commit 9a9d5e4

Browse files
m-dilorenzigsanchietti
authored andcommitted
docs: connection history storage options for OpenVPN Road Warrior
1 parent 800e504 commit 9a9d5e4

1 file changed

Lines changed: 11 additions & 2 deletions

File tree

openvpn_roadwarrior.rst

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -251,13 +251,22 @@ The MTU values may need to be adjusted to fit your specific network environment.
251251
Connection history
252252
------------------
253253

254-
Every time a client connects or disconnects from the server, the event is saved inside a SQLite database stored in RAM.
254+
Every time a client connects or disconnects from the server, the event is saved inside a SQLite database.
255255
Such event history can be viewed by clicking on tab ``Connection History`` available on the top of the page.
256256

257257
By default the page will display all connections from current day, but it is possible to filter the results by date and time and account name.
258258

259259
To download all history in CSV format, click on the button :guilabel:`Download server history`.
260260
The header of the CSV file explains the meaning of each column, including the units of measure.
261261

262-
Once the server is rebooted, the local history is lost.
262+
History is read from an SQLite database that can be stored in:
263+
264+
- **RAM**: stored in RAM (not persistent); it will be lost when the firewall reboots.
265+
- **Storage**: stored on persistent storage; it will survive a reboot.
266+
267+
By default, if persistent storage is available and configured, connection events are stored in the storage database, otherwise they are stored in the RAM database.
268+
269+
If a RoadWarrior server is already configured and a new storage device is connected, the history is automatically moved from RAM to storage, making it persistent and able to survive reboots.
270+
Conversely, if the storage is removed, new connection events will be stored in the RAM database and will be visible in the Connections History section. If the storage is then reconnected, the histories from RAM and storage are merged without data loss.
271+
263272
If the server is connected to a :ref:`controller-section`, the history is sent to the controller and can be viewed inside the :ref:`historical_monitoring-section`.

0 commit comments

Comments
 (0)