convertSessions.1p - Man Page

A tool to convert Lemonldap::NG sessions between storage backends.

Synopsis

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

Description

convertConfig is a command line tool to migrate all sessions stored in a source backend (sessions_from), into a new backend (sessions_to).

It requires a special configuration file in which you must list the source and destination backend modules and parameters.

Sessions will not be deleted from the source backend. Existing sessions in the destination backend will be kept, unless they have the same session ID as a session in the source backend. In that case, the source will overwrite the destination.

Options

--config,-c

Specify configuration file

--debug,-d

Turns on debugging information

--ignore-errors,-i

Skip to the next session if converting a session fails

--rename oldkey=newkey,-r oldkey=newkey

Rename key names when migrating from one backend to the next.

This option can be specified multiple times

Configuration File Format

The configuration file needs two sections to describe the source and destination backends

Here is an example

    [sessions_from]
    storageModule = Apache::Session::File
    storageModuleOptions = {    \
          'Directory' => '/var/lib/lemonldap-ng/sessions',      \
          'LockDirectory' => '/var/lib/lemonldap-ng/sessions/lock', \
    }
    # Only migrate 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' => 'sessions', \
    }

The sessionKind parameter may be used to filter only some session types.

Thanks to this, you can use this script to migrate from one database holding  all your sessions to separate tables from each session type.

See Also

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

Authors

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

Bug Report

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

Download

Lemonldap::NG is available at <https://lemonldap-ng.org/download>

Info

2024-02-06 perl v5.38.2 User Contributed Perl Documentation