1CONVERTSESSIONS(1)    User Contributed Perl Documentation   CONVERTSESSIONS(1)
2
3
4

NAME

6       convertSessions - A tool to convert Lemonldap::NG sessions between
7       storage backends.
8

SYNOPSIS

10         convertSession [-di] [-r oldkey=newkey ] -c parameters.ini
11

DESCRIPTION

13       convertConfig is a command line tool to migrate all sessions stored in
14       a source backend (sessions_from), into a new backend (sessions_to).
15
16       It requires a special configuration file in which you must list the
17       source and destination backend modules and parameters.
18
19       Sessions will not be deleted from the source backend. Existing sessions
20       in the destination backend will be kept, unless they have the same
21       session ID as a session in the source backend. In that case, the source
22       will overwrite the destination.
23

OPTIONS

25       --config,-c
26           Specify configuration file
27
28       --debug,-d
29           Turns on debugging information
30
31       --ignore-errors,-i
32           Skip to the next session if converting a session fails
33
34       --rename oldkey=newkey,-r oldkey=newkey
35           Rename key names when migrating from one backend to the next.
36
37           This option can be specified multiple times
38

CONFIGURATION FILE FORMAT

40       The configuration file needs two sections to describe the source and
41       destination backends
42
43       Here is an example
44
45           [sessions_from]
46           storageModule = Apache::Session::File
47           storageModuleOptions = {    \
48                 'Directory' => '/var/lib/lemonldap-ng/sessions',      \
49                 'LockDirectory' => '/var/lib/lemonldap-ng/sessions/lock', \
50           }
51           # Only migrate some session types
52           # sessionKind = Persistent, SSO
53
54           [sessions_to]
55           storageModule = Apache::Session::Browseable::Postgres
56           storageModuleOptions = {    \
57               'DataSource' => 'DBI:Pg:database=lemonldapdb;host=pg.example.com', \
58               'UserName' => 'lemonldaplogin', \
59               'Password' => 'lemonldappw', \
60               'Commit' => 1, \
61               'Index' => 'ipAddr _whatToTrace user', \
62               'TableName' => 'sessions', \
63           }
64
65       The "sessionKind" parameter may be used to filter only some session
66       types.
67
68       Thanks to this, you can use this script to migrate from one database
69       holding all your sessions to separate tables from each session type.
70

SEE ALSO

72       <http://lemonldap-ng.org/>
73

AUTHORS

75       Maxime Besson, <maxime.besson@worteks.com>
76

BUG REPORT

78       Use OW2 system to report bug or ask for features:
79       <https://gitlab.ow2.org/lemonldap-ng/lemonldap-ng/issues>
80

DOWNLOAD

82       Lemonldap::NG is available at <https://lemonldap-ng.org/download>
83
84
85
86perl v5.38.0                      2023-11-14                CONVERTSESSIONS(1)