Create an endless history of "user space" snapshots (images) of your devices our huge files.
Find a file
Matthias Förste 60145763e9 mkpath returns the number of directories created
which may be 0 if the directory exists. This is not an error.
2022-05-02 12:44:15 +02:00
bin mkpath returns the number of directories created 2022-05-02 12:44:15 +02:00
examples added nsca to example script 2011-11-23 09:40:03 +01:00
lib Use 3-arg open() 2022-02-21 12:38:02 +01:00
scratch new: Imager.pm, get_block as first function 2011-08-17 12:10:20 +02:00
t Use 3-arg open() 2022-02-21 12:38:02 +01:00
.editorconfig Add .editorconfig 2017-02-14 00:08:19 +01:00
.gitignore Maintain the debian/ dir in the debian branch 2022-02-15 22:09:47 +01:00
.perltidyrc [tidy] and move .perltidyrc to toplevel project dir 2022-02-20 22:47:12 +01:00
LICENSE Added copyright file (LICENSE): GPLv3 2013-02-05 14:13:50 +01:00
Makefile.PL tidy and dependency on Test::Compile 2017-02-11 23:24:07 +01:00
MANIFEST [tidy] and move .perltidyrc to toplevel project dir 2022-02-20 22:47:12 +01:00
MANIFEST.SKIP Cleanup Manifest 2022-02-17 12:09:56 +01:00
README added README for the impatient 2013-02-06 00:04:29 +01:00

Guide to the impatient user
===========================

Install the package
-------------------

    # perl Build.PL

    (optional step)
    # ./Build prereq_report

    ./Build install

Create your first image
-----------------------

NOTE: The device you're imaging must not be busy during
image creation. Other your image will be unusable!

The preferred way to get an idle device is using LVM snapshots:

    # lvcreate -s -L 1G -n lvol00-snap vg00/lvol00

    (optional - check the filesystem)
    # fsck -y /dev/mapper/vg00/lvol00-snap

    # imager save /dev/mapper/vg00/lvol00-snap /path/to/backup

Restore your image
------------------

For a full restore:

    # imager restore /path/to/backup/idx/HOST/DEVICE/IMAGE-name > image

If you need just parts of your image:

    # imager fuse /path/to/backup/ /mnt

Now you may browse the images below /mnt/. To select just some files -
loop mount such an image and restore the files you need:

    # mount -o loop /mnt/…/image /media/xxx

Happy landings….
-- 
Heiko Schlittermann <hs@schlittermann.de>