CONVERTSESSIONS(1)

✨ NAME ✨

okay so this whole page is CONVERTSESSIONS(1) from the User Contributed Perl Documentation set, and the star of the show is convertSessions — a tool to convert Lemonldap::NG sessions between storage backends. that's it, that's the job. moving sessions from one place to another. slay. 💅

---

🌸 SYNOPSIS 🌸

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

not me noticing that the page title says convertSessions, the synopsis says convertSession, and the description says convertConfig… bestie the names are giving identity crisis but we are NOT editing them, they're canon 💀

---

💖 DESCRIPTION 💖

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

it needs a special configuration file where you list the source and destination backend modules and all their parameters. no config, no migration, periodt.

a couple things to know, and these are important so read them:

• sessions will not be deleted from the source backend. they stay put. nothing gets yeeted. 🫶
• 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 overwrites the destination. source wins, no cap.

---

🎀 OPTIONS 🎀

• --config, -c — specify configuration file. you need this one, it's giving main character.
• --debug, -d — turns on debugging information.
• --ignore-errors, -i — skip to the next session if converting a session fails. very "we move" energy.
• --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. yes it's commented out in the example, uncomment it when you're ready bestie, it's right there.

thanks to this, you can use this script to migrate from one database holding all your sessions to separate tables from each session type. organisation? iconic. 🌈

---

💜 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>

---

and that's the whole vibe check 💖 this page came to you courtesy of perl v5.42.3 and it's dated 2026-09-24 — go forth and migrate those sessions, bestie, you got this 🧚✨