GM-RESTORE_DATABASE(8)

📦 version 22.34, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💾 GM-RESTORE_DATABASE(8) 💾

ok bestie so this is a page from the System Manager's Manual, and it's giving vintage 2011 energy, but it's still got lore you need. it's about restoring a GNUmed database. let's get into it 🫶

🚨 NOTE (read this first, fr fr)

Deprecated in favour of gm-restore(8).

yeah. it's deprecated. the newer kid on the block is gm-restore(8). we still document this one because the details matter, but don't say I didn't warn you 💅

✨ NAME ✨

gm-restore_database — restoring a GNUmed database 🌸

🎀 SYNOPSIS 🎀

gm-restore_database <backup file>
<backup file>: a database backup file ("backup-gnumed_vX-*.tar.bz2")

so you hand it exactly one thing: the backup file. and that file looks like backup-gnumed_vX-*.tar.bz2. that's the vibe, that's the shape of it 🦋

💖 DESCRIPTION 💖

so the gm-restore_database script tries to restore a GNUmed database from a backup. that's the whole job.

the way it does it? very conservative. it's not out here being reckless, it's not main character energy, it's cautious. it's intended for interactive use by root — meaning you, sitting at a terminal, as root, running it yourself.

and heads up: it may have to be adjusted to your needs. it's not a one-size-fits-all, plug-and-play situation. you might need to tweak it. that's just how it is 😌

💀 KNOWN PROBLEMS 💀

ok so here's the cursed bit, and I need you to actually remember this one.

for some reason — and nobody knows why, it's just like that — restoring does not work when the backup file you intend to restore is a link to the actual backup.

a symlink? nah. it will not play nice. 🙈

use the full path instead. the actual path, to the actual file. no links, no shortcuts, no games. periodt.

👑 SEE ALSO 👑

go check out these besties:

🌈 AUTHOR 🌈

this manual page was written by Karsten Hilbert, for the Debian GNU/Linux system (but may be used by others). iconic of him honestly 🫶

so yeah. that's the page. GNUmed server database restore — this version is from 2011 May 10th, and it lives under GM-RESTORE_DATABASE(8). go use gm-restore(8) bestie, this one's the legacy edition ✨💖

📦 where this page comes from