Differences

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

Link to this comparison view

documentation:2.1:changesessionbackend [2019/12/13 11:49] (current)
maxbes created
Line 1: Line 1:
 +====== How to change session backend ======
 +
 +LemonLDAP::​NG provides a script to change session backend. This script will help you transfer existing persistent sessions (or offline sessions) when migrating from one backend to another, or when adding indexes to a [[:​browseablesessionbackend|browseable sessio ​ backend]]. It is available in LemonLDAP::​NG utilities directory (''​convertSessions''​).
 +
 +===== How it works =====
 +
 +The ''​convertSessions''​ utility requires you to create a job configuration file with the following content:
 +
 +<​file>​
 +# This example migrates psessions from the default File backend to a PostgreSQL database
 +[sessions_from]
 +storageModule = Apache::​Session::​File
 +storageModuleOptions = { \\
 +      '​Directory'​ => '/​var/​lib/​lemonldap-ng/​psessions',​ \\
 +      '​LockDirectory'​ => '/​var/​lib/​lemonldap-ng/​psessions/​lock',​ \\
 +}
 +# Only convert some session types
 +# sessionKind = Persistent, SSO
 +
 +[sessions_to]
 +storageModule = Apache::​Session::​Browseable::​Postgres
 +storageModuleOptions = { \\
 + '​DataSource'​ => '​DBI:​Pg:​database=lemonldapdb;​host=pg.example.com',​ \\
 + '​UserName'​ => '​lemonldaplogin',​ \\
 + '​Password'​ => '​lemonldappw',​ \\
 + '​Commit'​ => 1, \\
 + '​Index'​ => '​ipAddr _whatToTrace user', \\
 + '​TableName'​ => '​psessions',​ \\
 +}
 +
 +</​file>​
 +
 +
 +===== Invokation =====
 +
 + <​code shell>
 +convertSessions -c job.ini ​
 +</​code>​
 +
 +Options:
 +
 +  * ''​-c'':​ job configuration file (mandatory)
 +  * ''​-i'':​ ignore errors. By default errors will stop the script execution
 +  * ''​-d'':​ print debugging output