Comparaison des versions

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.
Commentaire: Published by Scroll Versions from space DA and version BM-3.5
Sv translation
languagefr

Présentation

Cette page vous donne les procédures à suivre dans les cas suivants :

  1. Le contenu de la messagerie d'un utilisateur ou d'une boîte partagée doit être restauré et la Restauration unitaire via DataProtect n'a pas fonctionné.
  2. On souhaite restaurer le contenu de la boîte de messagerie

...

  1. dans un dossier de la boîte de messagerie d'un autre utilisateur

...

Sur cette page :

Sommaire
maxLevel2

En rapport :

...

  1. ou d'une

...

  1. boîte partagée

BlueMind met à votre disposition un couple de scripts shell et python permettant de vous assister dans la restauration des données précédemment sauvegardées de la boîte de messagerie

...

concerné.

Pré-requis

Pour pouvoir utiliser ces scripts, le Client Python doit être installé sur la machine.

Fichiers utiles

View file
namerestore.sh
height250
View file
nameupdateMboxAcls.py
height250

Procédure

Le script restore.sh restaurera les données de

...

la boîte de messagerie à partir du répertoire de sauvegarde dans la boîte de messagerie

...

elle-même ou

...

dans une autre boîte, dans un sous-dossier nommé restored_<timestamp>.

Il se lance ainsi :

Bloc de code
./restore.sh USER|MAILSHARE BACKUP_PATH USER|MAILSHARE EMAIL_ADDRESS
  • USER|MAILSHARE : pour restaurer un utilisateur indiquer le mot clé USER, pour restaurer une boîte partagée indiquer MAILSHARE
  • BACKUP_PATH : chemin où se trouvent les données dans le répertoire de sauvegarde de BlueMind (/var/backups). Le chemin est de la forme :

    Tabs group
    borderall-sides
    navcolornavy
    Boîte utilisateur/var/backups/bluemind/dp_spool/rsync/<IP>/mail/imap/

...

  • <sauvegarde>/var/spool/cyrus/data/

...

  • <domaine>/domain/<initiale

...

  • _domaine>/

...

  • <domaine>/<initiale

...

  • _utilisateur>/user/<utilisateur>/

    Par exemple pour l'utilisateur jdoe sur le domaine bluemind.loc :

    /var/backups/bluemind/dp_spool/rsync/192.168.122.148/mail/imap/806/var/spool/cyrus/data/bluemind_loc/domain/b/bluemind.loc/j/user/jdoe/

...

  • La spécification du dossier de l'utilisateur

...

Exemples d'utilisation :

...

borderall-sides
navcolornavy

...

Restauration de la messagerie de l'utilisateur John Doe (identifiant jdoe) dans sa propre boîte (adresse email jdoe@bluemind.loc)

Les messages, ainsi que l'arborescence de dossiers, sont dès lors consultable dans la boîte de l'utilisateur John Doe :

...

Restauration de la messagerie de l'utilisateur John Doe (identifiant jdoe) dans la boîte d'un autre utilisateur (adresse email hannibal@bluemind.loc) :

Les messages, ainsi que l'arborescence de dossiers, sont dès lors consultable dans la boîte de l'utilisateur John Smith :

Restauration manuelle

Notions

Les données (mails) sont stockées sur le serveur dans le répertoire /var/spool/cyrus/data/domain_loc/[...]/[n]/user/nom_user/ (où [n] est la 1ère lettre du login, ici *n*om_user)

...

  • permet de ne restaurer qu'un sous-dossier en particulier.

    Boîte partagée/var/backups/bluemind/dp_spool/rsync/<IP>/mail/imap/<sauvegarde>/var/spool/cyrus/data/<domaine>/domain/<initiale_domaine>/<domaine>/

    On remarque ici que pour une boîte partagée, le chemin à indiquer s'arrête au domaine concerné. Ainsi, le chemin est toujours le même pour toutes les boîtes du domaine.
    Par exemple dans notre domaine bluemind.loc :

    /var/backups/bluemind/dp_spool/rsync/192.168.122.148/mail/imap/806/var/spool/cyrus/

...

  • data/

...

  • bluemind_loc/

...

  • domain/b/bluemind.loc/
  • USER|MAILSHARE : de même que pour le premier mot clef, celui-ci indique le type de boîte cible dans laquelle la restauration sera effectuée, USER pour une boîte utilisateur, MAILSHARE pour une boîte partagée
  • EMAIL_ADDRESS : adresse de messagerie de l'utilisateur ou de la boîte partagée cible

On a donc 4 cas d'utilisation possibles :

Tabs group
borderall-sides
navcolornavy
Utilisateur > UtilisateurUtilisateur > Boîte partagéeBoîte partagée > UtilisateurBoîte partagée > Boîte partagée

Enregistrer

Sv translation
languageen

Introduction

This page describes the procedure to follow in the following cases:

  1. The contents of a user's mailbox must be restored and Single-user restoration using DataProtect has failed.
  2. You want to restore the contents of a user's mailbox into another user's mailbox.

BlueMind provides a couple of shell and python scripts to help you with restoring data from a user mailbox backup.

Volet

On this page:

Sommaire
maxLevel2

Related:

Sauvegarde et restauration

Prerequisites

To be able to use these scripts, the Python Client must be installed on the machine.

Useful files

View file
namerestore.sh
height250
View file
nameupdateMboxAcls.py
height250

Procedure

The script restore.sh will restore user data from the backup directory into a user's or another user's mailbox, as required, into a sub-folder named restored_<timestamp>.

To start it:

Bloc de code
./restore.sh USER|MAILSHARE BACKUP_PATH USER|MAILSHARE EMAIL_ADDRESS
  • USER|MAILSHARE: to restore a user use the keyword USER, to restore a shared mailbox use the keyword MAILSHARE
  • BACKUP_PATH: path to the data in the BlueMind backup directory (/var/backups). The path looks like:

    Tabs group
    borderall-sides
    navcolornavy
    User

    /var/backups/bluemind/dp_spool/rsync/<IP>/mail/imap/<backup number>/var/spool/cyrus/data/<bluemind domain>/domain/<domain initial>/<domaine bluemind>/<user initial>/user/<user>/

    E.g. for the user "jdoe" on the domain "bluemind.loc":

    /var/backups/bluemind/dp_spool/rsync/192.168.122.148/mail/imap/806/

...

Autant que possible, il est préférable d'effectuer une sauvegarde des méta-données. Cependant, en l'absence de celle-ci, la restauration des messages reste possible, ils seront alors présents dans leur état d'origine : ils seront considérés comme non lus, non répondus, sans statut particulier.

Pré-requis et données exemples

  • le serveur sur lequel sont restaurées les données, s'il n'est pas le serveur d'origine, doit avoir les mêmes caractéristiques que celui-ci : même nom de domaine, même adresse IP, même url, même version de BlueMind, etc.
  • le nom d'utilisateur doit être identique à celui d'origine

Pour la procédure, nous utiliserons l'utilisateur suivant :

  • domaine bluemind.loc
  • nom d'utilisateur jdoe

Les données :

  • les données de messagerie (voir ci-dessus) sont déposées sur le serveur cible dans les répertoires suivants :
    • données : /var/backups/jdoe/
    • méta-données : /var/backups/jdoe-meta/
  • la restauration de ses données se fera dans un sous-dossier de sa messagerie nommé restore_dir (ce nom est libre, on pourra par exemple utiliser la date du jour ou autre convention)

Procédure

Remarque

Dans les chemins de répertoires ou certaines lignes de commandes, le point '.' du nom de domaine est remplacé par un underscore '_'.

Veillez à bien effectuer ce remplacement lors de l'adaptation des commandes à votre domaine.

Cas de la restauration dans une autre boîte que celle de l'utilisateur

Pour restaurer les messages d'un utilisateur dans une autre boîte que celle d'origine, on pourra au choix :

  • effectuer une restauration sans les méta-données (voir ci-dessous)
  • effectuer une restauration avec les méta-données (voir ci-dessous) puis :
    • se connecter avec le login de l'utilisateur cible
    • se rendre dans la gestion des paramètres > Messagerie > onglet Gestion des partages > cliquer sur « Enregistrer »
      Il n'est pas ici nécessaire d'effectuer une modification, il faut juste forcer le ré-enregistrement des partages.

Restauration avec les méta-données

Connecté au serveur en tant que root :

  • se placer dans /var/spool/cyrus/data/bluemind_loc/domain/b/bluemind.loc/j/user/jdoe/
  • copier les données a restaurer et donner les droits adéquats au répertoire ainsi créé :

    Bloc de code
    mv /var/backups/jdoe/ restore_dir
    chown -R cyrus:mail restore_dir
    chmod -R u+rwx restore_dir
  • se placer dans  /var/spool/cyrus/meta/bluemind_loc/domain/b/bluemind.loc/j/user/jdoe/
  • copier les méta-données a restaurer dans un sous répertoire qui porte le même nom que celui utilisé pour les données :

    Bloc de code
    mv /var/backups/jdoe-meta/ restore_dir
    chown -R cyrus:mail restore_dir
    chmod -R u+rwx restore_dir
  • exécuter la commande cyrus de reconstruction de la boîte :

    Bloc de code
    /usr/lib/cyrus/bin/reconstruct -r -f user/jdoe@bluemind.loc

Restauration en l'absence des méta-données

 

Remarque

Dans les chemins de répertoires ou certaines lignes de commandes, le point '.' du nom de domaine est remplacé par un underscore '_'.

Veillez à bien effectuer ce remplacement lors de l'adaptation des commandes à votre domaine.

Connecté au serveur en tant que root :

...

  • var/spool/cyrus/data/bluemind_loc/domain/b/bluemind.loc/j/user/jdoe/

copier les données a restaurer et donner les droits adéquats au répertoire ainsi créé :

...

  • Mailshare

  • /var/backups/

...

  • bluemind/

...

reproduire l'arborescence pour les méta-données :

...

  • dp_spool/rsync/<IP>/mail/imap/<sauvegarde>/var/spool/cyrus/

...

  • data/

...

  • <domaine>/domain/<initiale_domaine>/

...

  • <domaine>/

    You can see that for a mailbox, the path stops at the domain level. Therefore, the path is always the same for all mailshares of the domain.

    E.g. in our sample domain "bluemind.loc", path will be:

    /var/backups/bluemind/dp_spool/rsync/192.168.122.148/mail/imap/806/var/spool/cyrus/data/bluemind_loc/domain/b/bluemind.loc/

  • USER|MAILSHARE: as for first keyword, indicates the target mailbox type
  • EMAIL_ADDRESS: email address for the target mailbox you want to restore the data into

Then, you have 4 possibilities:

Tabs group
borderall-sides
navcolornavy
User > UserUser > MailshareMailshare > UserMailshare > Mailshare

...

se placer dans le dossier des méta-données de l'utilisateur, créer les fichiers cyrus.header et positionner les droits adéquats :

Bloc de code
cd /var/spool/cyrus/meta/bluemind_loc/domain/b/bluemind.loc/j/user/jdoe/
find restore_dir -type d -exec touch {}/cyrus.header \;
chown -R cyrus:mail restore_dir

...

exécuter la commande cyrus de reconstruction de la boîte :

Bloc de code
/usr/lib/cyrus/bin/reconstruct -p bluemind_loc -r -f user/jdoe/restore_dir@bluemind.loc

Finalisation - dans tous les cas

  1. exécuter la commande d'application du quota :

    Bloc de code
    /usr/lib/cyrus/bin/quota -f -d bluemind.loc user/jdoe
  2. À ce stade, les mails doivent-être visibles depuis le webmail. Si ce n'est pas le cas, s'assurer de bien rafraîchir le cache de l'arborescence de la façon suivante :

    • connecté à BlueMind en tant que l'utilisateur, cliquer sur les engrenages en bas à gauche de la liste des dossiers > « Organiser les dossier » :
      Image Removed
    • le dossier restore_dir et son arborescence doivent-être visible dans l'arborescence
    • revenir dans le webmail sans faire d'action particulière
    • le dossier et les mails restaurés doivent-être alors être visibles
  3. Pour terminer :

    • si il y a un quota sur la boîte, s'assurer qu'il n'est pas atteint ; le cas échéant, augmenter temporairement ce dernier.
    • dans la console d'administration, connecté en tant qu'admin0 :
      • se rendre dans la gestion de l'utilisateur > onglet maintenance
      • cocher « Réparer l'indexation de la boîte »
      • cliquer sur Enregistrer

Enregistrer

Enregistrer

Enregistrer

Enregistrer

...