Differences

This shows you the differences between two versions of the page.

Link to this comparison view

documentation:2.1:mongodbsessionbackend [2019/01/15 15:55] (current)
Line 1: Line 1:
 +====== MongoDB session backend ======
 +[[https://​metacpan.org/​pod/​Apache::​Session::​MongoDB|Apache::​Session::​MongoDB]] is a faster shareable session backend.
  
 +<note important>​Use an up-to-date version of Apache::​Session::​MongoDB,​ at least 1.8.1.</​note>​
 +
 +===== Setup =====
 +
 +Install and launch a [[https://​www.mongodb.org/​|MongoDB server]]. Install ​
 +[[http://​search.cpan.org/​perldoc?​Apache::​Session::​MongoDB|Apache::​Session::​MongoDB]] Perl module (version ⩾ 0.15 required). You also need a recent version of [[http://​search.cpan.org/​~mongodb/​MongoDB-v1.2.2/​|Perl MongoDB client]] (version ⩾ 1.00 required).
 +
 +In the manager: set [[http://​search.cpan.org/​perldoc?​Apache::​Session::​MongoDB|Apache::​Session::​MongoDB]] in ''​General parameters''​ » ''​Sessions''​ » ''​Session storage''​ » ''​Apache::​Session module''​ and add the following parameters (case sensitive):
 +
 +^                                    Optional parameters ​                               ^^^
 +^             ​Name ​             ^                 ​Comment ​                  ​^ ​    ​Example ​    ^
 +| **host** ​                     | MongoDB server (default: 127.0.0.1:​27017) | 127.0.0.1:​27017 |
 +| **db_name** ​                  | Session database (default: sessions) ​     | llconfdb ​       |
 +| **collection** ​               | Collection (default: sessions) ​           | sessions ​       |
 +| **auth_mechanism** ​           | Authentication mechanism ​                 | PLAIN           |
 +| **auth_mechanism_properties** |                                           ​| ​                |
 +| **connect_timeout** ​          | Connection timeout ​                       | 10000           |
 +| **ssl** ​                      | Boolean or hash ref (default: 0)          | 1               |
 +| **username** ​                 | Username to use to connect ​               | lluser ​         |
 +| **password** ​                 | Password ​                                 | llpassword ​     |
 +
 +===== Security =====
 +
 +Restrict network access to the MongoDB server. For remote servers, you can use [[soapsessionbackend|SOAP session backend]] in cunjunction to increase security for remote server that access through an unsecure network