2020-05-14 23:29:41 +02:00
Redis session backend
=====================
`Apache::Session::Browseable::Redis <https://metacpan.org/pod/Apache::Session::Browseable::Redis> `__
is the faster shareable session backend
Setup
-----
2021-06-26 23:58:27 +02:00
Install and launch a `Redis server <https://redis.io/> `__ .
2020-05-14 23:29:41 +02:00
Install
2021-06-27 00:19:41 +02:00
`Apache::Session::Browseable::Redis <https://metacpan.org/pod/Apache::Session::Browseable::Redis> `__
2020-05-14 23:29:41 +02:00
Perl module.
2021-07-05 23:50:42 +02:00
With Sentinel, make sure you are using at least version 1.3.8 of `` Apache::Session::Browseable `` , this might require installing it from Debian Backports or CPAN.
2020-05-14 23:29:41 +02:00
In the manager: set
`Apache::Session::Browseable::Redis <https://metacpan.org/pod/Apache::Session::Browseable::Redis> `__
in `` General parameters `` » `` Sessions `` » `` Session storage `` »
2020-08-24 17:53:38 +02:00
`` Apache::Session module `` and add the connection parameters for your Redis server(s).
2020-05-14 23:29:41 +02:00
2020-08-25 10:43:23 +02:00
This backend uses the perl bindings for Redis database provided by the `Redis perl module <https://metacpan.org/pod/Redis> `__ .
A complete list of supported constructor/connection options can be found in the `module documentation <https://metacpan.org/pod/Redis> `__ .
2020-05-14 23:29:41 +02:00
2020-08-24 17:53:38 +02:00
E.g., Parameters (case sensitive):
2020-05-14 23:29:41 +02:00
2020-08-24 17:53:38 +02:00
============= =========================== ===============================================
Name Comment Example
============= =========================== ===============================================
**server** Redis server @ IP:PORT 127.0.0.1:6379
**sock** Redis server @ unix socket unix:/path/to/redis.sock
**sentinels** Redis sentinels list 127.0.0.1:26379,127.0.0.2:26379,127.0.0.3:26379
2021-07-05 23:50:42 +02:00
**service** Sentinel service name mymaster
2020-08-24 17:53:38 +02:00
**password** password (== requirepass) ChangeMe
2021-07-28 22:07:19 +02:00
**database** Redis DB 1
2020-09-23 07:51:35 +02:00
**Index** Fields to index refer to :ref: `fieldstoindex`
2020-08-24 17:53:38 +02:00
============= =========================== ===============================================
2020-05-14 23:29:41 +02:00
Security
--------
Restrict network access to the redis server. For remote servers, you can
use :doc: `SOAP session backend<soapsessionbackend>` in cunjunction to
increase security for remote server that access through an unsecure
network