Document technique WATSOFT

Migration de la base de données et récupération après un crash

MDaemon est une marque déposée de Alt-N Technologies. Archive Server for MDaemon est développé par la société Achab.

http://www.watsoft.com

Contact : [email protected]

Page 1/12

Document technique WATSOFT

Sommaire Différents cas de figures............................................................................................... 3 1. Réinstallation d’ASM après un crash..................................................................................................... 3 Version 2.2.0 ou ultérieure ..................................................................................................................... 3 Versions antérieures à la 2.2.0 .............................................................................................................. 4 2 – Déplacement de la base de données sur un autre serveur................................................................. 4 3 – Migration de MSDE vers SQL Server .................................................................................................. 4 4 - Migration de MSDE vers MySQL.......................................................................................................... 4 5 - Migration de SQL Server vers MySQL ................................................................................................. 5 6 - Refaire l’archivage du dossier d’archives ............................................................................................. 5

Migration de la base de données d’ASM ..................................................................... 6 Étape 1 - Arrêter ASM................................................................................................................................ 6 Étape 2 - Détacher la base de données .................................................................................................... 6 SQL Server/MSDE ................................................................................................................................. 6 MySQL ................................................................................................................................................... 6 Étape 3 - Déplacer les fichiers de la base de données ............................................................................. 6 SQL Server/MSDE ................................................................................................................................. 6 MySQL ................................................................................................................................................... 7 Étape 4 - Attacher la base de données d’ASM à la nouvelle base de données........................................ 7 SQL Server/MSDE ................................................................................................................................. 7 MySQL ................................................................................................................................................... 7 Étape 5 - Modifier le DSN ODBC............................................................................................................... 8 Étape 6 – Modifier le fichier d’accès à l’interface web – asm.cfg .............................................................. 8 SQL Server/MSDE ................................................................................................................................. 8 MySQL ................................................................................................................................................... 8 Étape 7 – Mettre à jour le registre ............................................................................................................. 8 Étape 8 - Redémarrer ASM ....................................................................................................................... 9

Migration d’ASM sur un autre serveur....................................................................... 10 Remarques ................................................................................................................... 12 À l’attention des utilisateurs de MSDE..................................................................................................... 12 Utilitaires .................................................................................................................................................. 12

Avertissement.............................................................................................................. 12

http://www.watsoft.com

Contact : [email protected]

Page 2/12

Document technique WATSOFT

Différents cas de figures Il existe différents cas pour lesquels il est nécessaire de restaurer ou de migrer une installation d’Archive Server for MDaemon.

1. Réinstallation d’ASM après un crash Afin de restaurer entièrement une installation d’ASM, vous devez posséder : • • •

Une sauvegarde du dossier d’archives (repository), afin de récupérer les messages précédemment sauvegardés. Une sauvegarde de la base de données, afin de conserver les paramètres configurés dans l’interface d’administration (domaines et utilisateurs, règles de non conservation...) et éviter de recommencer le processus d’archivage. Les caractéristiques de l’installation précédente (type de serveur web, informations d’accès à la base de données pour ASM, etc.).

Depuis la version 2.2.0, le processus de restauration est simplifié et permet d’installer la même version et de la rattacher à la même base de données. Cependant, en cas de besoin, la procédure des versions précédentes est toujours valable.

Version 2.2.0 ou ultérieure a) Le dossier ASM/Database/repository se trouve sur le même poste. Récupérez les sauvegardes de la base de données et le dossier de ASM. Puis : 1. Restaurez la base de données de ASM. 2. Réinstallez la même version de ASM. Dans la fenêtre de configuration de la base de données, indiquez le même nom et le même identifiant que dans l’installation précédente. 3. Arrêtez ASMd.exe. 4. Enregistrez la sauvegarde de votre base bases de données ASM sur celle que vous venez d’installer. Si vous modifiez le chemin du dossier d’archives, vous devrez changer le paramètre correspondant dans l’interface de ASM. 5. Redémarrez ASMd.exe. 6. Testez votre installation. b) La base de données se trouve sur un poste différent. Si la base de données se trouve sur un autre poste et n’a pas subi de dommages : 1. Réinstallez la même version d’ASM. Dans la fenêtre de configuration de la base de données, indiquez le nom et les identifiants de la base de données distante. 2. Arrêtez ASMd.exe. 3. Enregistrez la sauvegarde du dossier d’archives dans le nouveau répertoire. 4. Redémarrez ASMd.exe. 5. Testez votre installation.

http://www.watsoft.com

Contact : [email protected]

Page 3/12

Document technique WATSOFT

Versions antérieures à la 2.2.0 a) ASM/Database/repository se trouve sur le même poste. Récupérez les sauvegardes de la base de données et le dossier de ASM. Puis : 1. Réinstallez la même version de ASM. Utilisez le même répertoire d’installation et les mêmes paramètres pour la base de données. 2. Arrêtez ASMd.exe. 3. Restaurez la base de données de ASM à l’aide de la sauvegarde (le procédé de restauration dépend du type de base de données et des méthodes de sauvegarde utilisées). 4. Enregistrez la sauvegarde de votre base bases de données ASM sur celle que vous venez d’installer. Si vous modifiez le chemin du dossier d’archive, vous devrez changer le paramètre correspondant dans l’interface de ASM. 5. Redémarrez ASMd.exe. 6. Testez votre installation.

b) La base de données se trouve sur un poste différent. Si la base de données se trouve sur un autre poste et n’a pas subi de dommages : 1. Détachez la base de données du serveur (voir Migration de la base de données ASM, page 6) 2. Réinstallez la même version de ASM. Utilisez le même répertoire d’installation et les mêmes paramètres pour la base de données. 3. Arrêtez ASMd.exe. 4. Restaurez la base de données de ASM à l’aide de la sauvegarde (le procédé de restauration dépend du type de base de données et des méthodes de sauvegarde utilisées). 5. Enregistrez la sauvegarde du dossier d’archives dans le nouveau répertoire. 6. Redémarrez ASMd.exe. 7. Testez votre installation.

2 – Déplacement de la base de données sur un autre serveur Voir Migration de la base de données d’ASM, page 6.

3 – Migration de MSDE vers SQL Server La procédure est la même, que la base de données se trouve sur le même poste ou sur un autre : 1. Installez SQL Server. 2. Suivez la procédure décrite dans Migration de la base de données de ASM, concernant le détachement de la base de données de MSDE et la restauration sur SQL Server. 3. Testez votre installation. 4. Désinstallez MSDE si vous ne l’utilisez plus.

4 - Migration de MSDE vers MySQL ASM inclut un utilitaire permettant d’effectuer cette migration, appelé SQLServer2MySQL. Il se trouve dans le dossier tools\SQL du répertoire d’installation d’ASM. La procédure est la suivante : 1. Arrêtez le processus ASM. 2. Effectuez une copie de la règle du Filtre de contenu concernant ASM dans MDaemon, et paramétrez-la pour stocker les messages dans un dossier temporaire. 3. Sauvegardez la base de données et le dossier d’archives de ASM.

http://www.watsoft.com

Contact : [email protected]

Page 4/12

Document technique WATSOFT

4. 5. 6. 7. 8. 9. 10. 11. 12. 13.

Désinstallez ASM. Installez le pilote ODBC pour MySQL et MySQL. Réinstallez la même version de ASM. Arrêtez le processus ASM. Migrez la base de données avec l’utilitaire SQLServer2MySQL. Assurez-vous que la règle du Filtre de contenu concernant ASM soit activée dans MDaemon et renvoie les messages dans le dossier engine > queue de la nouvelle installation. Supprimez ou désactivez la règle temporaire du Filtre de contenu. Copiez les messages du dossier temporaire dans le dossier engine>queue de la nouvelle installation. Relancez le processus ASM. Assurez-vous que l’application fonctionne correctement.

5 - Migration de SQL Server vers MySQL ASM n’inclut pas d’utilitaire spécifique pour ce type de migration. Pour recréer la base de données et le dossier d’archives, suivez les étapes ci-dessous. Dans ce cas, vous devrez reconfigurer manuellement les paramètres d’ASM.

6 - Refaire l’archivage du dossier d’archives 1. Arrêtez le processus « Archive Server for MDaemon ». 2. Créez une règle dans le Filtre de contenu de MDaemon afin de copier les messages dans un répertoire temporaire, et désactivez la règle de ASM existante. 3. Sauvegardez le dossier d’archives dans un dossier situé hors du répertoire d’installation de ASM. 4. Désinstallez ASM (si le dossier d’archives se trouve dans le répertoire d’installation de ASM, il est supprimé). 5. Supprimez la base de données de ASM. 6. Réinstallez ASM avec le type de base de données souhaité. 7. Reconfigurez les politiques d’archivage dans l’interface d’administration de ASM. 8. Archivez les anciens éléments en copiant les messages de la sauvegarde du dossier d’archives dans \engine\queue. Il est possible d’effectuer cette opération avec l’utilitaire « Copyfiles » (voir Utilitaires, page 12). Cet outil se trouve dans le dossier tools du répertoire d’installation de ASM. Il permet de copier plusieurs fichiers répartis à différents endroits (dans le dossier d’archives de ASM) dans un seul dossier. Il est conseillé de tester d’abord son fonctionnement avec quelques fichiers seulement. 9. Attendez que l’archivage soit terminé (le répertoire engine>queue doit être vide). 10. Activez à nouveau la règle du Filtre de contenu afin que les messages soient copiés dans \engine\queue ; et désactivez la règle temporaire. 11. Copiez les messages du dossier temporaire dans le dossier engine>queue de la nouvelle installation. 12. Assurez-vous que l’archivage s’effectue correctement.

http://www.watsoft.com

Contact : [email protected]

Page 5/12

Document technique WATSOFT

Migration de la base de données de ASM Dans l’exemple ci-dessous, le nom de la base de données de ASM est ASM_DB (nom par défaut). La procédure dépend de la base de données utilisée (SQL Server/MSDE ou MySQL).

Étape 1 - Arrêter ASM Pour déplacer la base de données de ASM, vous devez arrêter le moteur ASM. Pendant que le moteur est arrêté, les fichiers reçus sont enregistrés dans le dossier queue de ASM. Aucun message n’est perdu. Pour arrêter le moteur, cliquez sur Démarrer->Programmes->Archive Server for MDaemon-> Arrêter le moteur, ou bien allez dans Panneau de configuration->Services. Assurez-vous que les utilisateurs ne puissent pas accéder à l’interface web de ASM. Si vous le pouvez, arrêtez le serveur web, ou bien remplacez le fichier /html/index.htm par une page « hors service ».

Étape 2 - Détacher la base de données SQL Server/MSDE SQL Server 2000/2005 (et MSDE 2000) inclut des fonctionnalités de détachement/attachement afin de faciliter le déplacement des bases de données d’un serveur sur un autre (ou simplement d’un emplacement à l’autre sur le même serveur). Le détachement s’effectue à l’aide de l’utilitaire SQL Server Enterprise Manager (si vous ne possédez pas cette application, consultez les remarques à l’attention des utilisateurs de MSDE, page 12) : • •

Dans le panneau de gauche, effectuez un clic droit sur la base données à détacher et sélectionnez Toutes les tâches -> Détacher la base de données. Cochez l’option Mettre les statistiques à jour avant le détachement, vérifiez qu’il n’y a aucune connexion active et que la base est prête à être détachée puis cliquez sur OK.

Avec SQL Server, vous pouvez également faire une sauvegarde de la base de données depuis SQL Server Enterprise Manager.

MySQL Sauvegardez la base de données (copiez le dossier data\ASM_DB ou effectuez un « dump » (copie) de la structure et des données de ASM_DB).

Étape 3 - Déplacer les fichiers de la base de données SQL Server/MSDE Si le nom de la base de données est ASM_DB (nom par défaut), sur SQL Server (ou MSDE) le répertoire Data contient deux fichiers : •

ASM_DB.mdf (données)

http://www.watsoft.com

Contact : [email protected]

Page 6/12

Document technique WATSOFT

•

ASM_DB_log.ldf (journal de transaction)

Remarque : si vous avez installé ASM+MSDE avec les paramètres par défaut, le dossier Data se trouve dans : c:\program files\MSDE\MSSQL$ASM\Data. Déplacez ces fichiers dans le dossier de votre choix sur le serveur contenant la base de données de destination (vous pouvez choisir le dossier par défaut Data, mais ce n’est pas obligatoire).

MySQL Effectuez une copie de la sauvegarde ou un « dump » des fichiers dans le dossier de votre choix sur le poste sur lequel vous souhaitez déplacer la base de données.

Étape 4 - Attacher la base de données de ASM à la nouvelle base de données SQL Server/MSDE Si vous avez détaché la base de données : 1. 2. 3. 4. 5. 6. 7. 8. 9. 10.

Ouvrez SQL Enterprise Manager. Effectuez un clic droit sur le dossier Bases de données dans le panneau de gauche. Sélectionnez Toutes les tâches -> Attacher une base de données. Indiquez dans la fenêtre qui s’ouvre ensuite le chemin d’accès au fichier .mdf (voir étape 3). Vérifiez que le fichier .mdf et le fichier .ldf se trouvent dans le panneau du milieu. Conservez la valeur Attacher en tant que par défaut et indiquez sa pour le propriétaire de la base de données. Cliquez sur Sécurité > Connexions dans Enterprise Manager. Choisissez un nom différent de celui utilisé dans l’ancienne installation d’ASM (en règle générale « ASM_USER »), sélectionnez l’authentification SQL, indiquez un mot de passe, sélectionnez la base de données ASM dans la liste, cliquez sur OK et confirmez le mot de passe. Si un message d’erreur indique qu’il est impossible d’accéder à la base de données sélectionnée avec le compte créé, cliquez sur Oui pour continuer. Cliquez sur l’onglet Accès aux bases de données et sélectionnez la base de données ASM. Développez le dossier Base de données > ASM > Utilisateurs. Double-cliquez sur l’utilisateur que vous venez de créer et cochez l’option db_owner.

Si vous avez effectué une sauvegarde de la base de données avec Enterprise Manager : 1. 2. 3. 4.

Créez une connexion pour l’utilisateur ASM_USER. Créez une base vide appelée ASM_DB et indiquez ASM_USER en tant que propriétaire. Restaurez la base de données ASM_DB. Ajustez le SID à la valeur enregistrée sp_change_users_login.

MySQL Si vous avez fait une sauvegarde, utilisez l’outil d’administration MySQL pour restaurer la base de données. Si l’utilisateur n’est pas recréé lors de la restauration, vous devez le recréer manuellement. Dans le cas d’un « dump », restaurez la base de données à partir des fichiers copiés.

http://www.watsoft.com

Contact : [email protected]

Page 7/12

Document technique WATSOFT

Étape 5 - Modifier le DSN ODBC Le moteur ASM se connecte à la base de données à l’aide d’une connexion DSN (Data Source Name) ODBC. Les paramètres ODBC sont définis dans le fichier /engine/asmd.ini : [odbc] source= user= pass= Le mot de passe peut être crypté à l’aide de l’utilitaire en ligne de commande ASMCustSupport.exe. Exemple : c:\> ASMCustSupport CRYPT achab endecoded string (len=28): DEABF60B0C48D10C8F60AFDE Après avoir modifié asmd.ini, vous devez modifier la définition de la source de données ODBC (Panneau de configuration > Outils d’administration > Source de données ODBC).

Étape 6 – Modifier le fichier d’accès à l’interface web – asm.cfg SQL Server/MSDE L’application web de ASM utilise un fichier de configuration spécifique pour accéder à la base de données : /database/asm.cfg. Il est possible de le recréer à l’aide de l’utilitaire configTool.exe. Procédure : 1. Renommez le fichier « asm.cfg » en « asm.cfg.old ». 2. Ouvrez une invite de commandes. 3. Saisissez configTool.exe \database\asm.cfg. 4. Dans la fenêtre qui s’ouvre ensuite, sélectionnez Microsoft OLE DB Provider for SQL Server dans l’onglet Fournisseur, puis cliquez sur Suivant. 5. Sélectionnez ou saisissez le nom de votre serveur SQL (le serveur de destination). 6. Indiquez un nom d’utilisateur et un mot de passe (les mêmes que dans l’étape 5) et assurez-vous de cocher l’option Autoriser l’enregistrement du mot de passe. 7. Sélectionnez votre base de données dans le menu déroulant, puis cliquez sur Tester la connexion. 8. Si la connexion a réussi, cliquez sur OK. Sinon, vérifiez les informations saisies.

MySQL Le fichier utilisé par l’application web de ASM pour accéder à la base de données est : /database/asm.ini. Ce fichier n’est pas crypté, vous pouvez donc le modifier manuellement.

Étape 7 – Mettre à jour le registre ASM conserve dans le registre certaines informations concernant l’installation qui doivent être modifiées. Ces entrées se trouvent dans : HKLM\Software\Achab\Archive Server for MDaemon\Database.

http://www.watsoft.com

Contact : [email protected]

Page 8/12

Document technique WATSOFT

Remarques : dbtype = SQL Server, même pour MSDE Hostname = nom de l’instance (ex. : ordinateur\asm). La valeur « Password » est cryptée comme dans le DSN ODBC (voir étape 5).

Étape 8 - Redémarrer ASM Démarrez le moteur ASM (Démarrer->Programmes->Archive Server for MDaemon->Démarrer le moteur ou dans Panneau de configuration->Services) et redémarrez le serveur web. Vérifiez que l’installation fonctionne correctement.

http://www.watsoft.com

Contact : [email protected]

Page 9/12

Document technique WATSOFT

Migration de ASM sur un autre serveur Seuls l’installation d’ASM et le dossier d’archives sont migrés. La base de données n’est pas déplacée. Sauvegardez les répertoires ASM et repository. Puis : 1. Migrez MDaemon sur le nouveau serveur. 2. Installez ASM sur le nouveau serveur (sans installer de nouvelle base de données). 3. Utilisez le même répertoire d’installation, et indiquez les informations d’accès à l’ancienne base de données. 4. Pour la connexion à la base de données, indiquez la base se trouvant sur l’ancien serveur. Puis créez une nouvelle base avec un nom différent, tel que ASM_DB_temp (indiquez un nom d’utilisateur et un mot de passe différents). 5. Arrêtez ASMd.exe sur le nouveau serveur. 6. Allez dans le dossier /database/ du répertoire d’installation de ASM. Pour MSDE ou SQL Server : • Renommez le fichier « asm.cfg » en « asm.cfg.old ». • Ouvrez une invite de commandes. • Saisissez configTool.exe \database\asm.cfg. • Dans la fenêtre qui s’ouvre ensuite, sélectionnez Microsoft OLE DB Provider for SQL Server dans l’onglet Fournisseur, puis cliquez sur Suivant. • Sélectionnez ou saisissez le nom de votre serveur SQL (le serveur de destination). • Indiquez un nom d’utilisateur et un mot de passe (les mêmes que dans l’étape 5) et assurez-vous de cocher l’option Autoriser l’enregistrement du mot de passe. • Sélectionnez votre base de données (celle d’origine) dans le menu déroulant, puis cliquez sur Tester la connexion. • Si la connexion a réussi, cliquez sur OK. Sinon, vérifiez le nom et le mot de passe. Pour MySQL : • Copiez le fichier « asm.ini » et renommez la copie « asm.ini.old ». • Modifiez les paramètres suivants dans le fichier d’origine : - database= nom de la base de données d’origine − hostname = adresse IP du serveur contenant la base de données d’origine − Nom d’utilisateur et mot de passe pour la connexion à la base de données d’origine. − Numéro de port utilisé par MySQL. • Enregistrez le fichier. 7. Copiez la sauvegarde du dossier d’archives sur la nouvelle installation. 8. Supprimez la base de données « ASM_DB_temp » ainsi que l’ancienne installation de Archive Server for MDaemon. 9. Le moteur ASM se connecte à la base de données à l’aide d’une connexion DSN (Data Source Name) ODBC. Les paramètres ODBC sont définis dans le fichier /engine/asmd.ini : [odbc] source= user= pass= 10. Indiquez dans les champs user et pass les identifiants de connexion à la base de données d’origine.

http://www.watsoft.com

Contact : [email protected]

Page 10/12

Document technique WATSOFT

Le mot de passe enregistré dans ce fichier asmd.ini peut être crypté à l’aide de l’utilitaire en ligne de commande ASMCustSupport.exe. Exemple : c:\> ASMCustSupport CRYPT achab endecoded string (len=28): DEABF60B0C48D10C8F60AFDE Après avoir modifié le fichier asmd.ini, vous devez également changer la connexion ODBC afin qu’elle pointe vers la base de données d’origine (Panneau de configuration > Outils d’administration). 11. Redémarrez ASMd.exe sur le nouveau serveur. 12. Testez votre installation.

http://www.watsoft.com

Contact : [email protected]

Page 11/12

Document technique WATSOFT

Remarques À l’attention des utilisateurs de MSDE Si vous possédez uniquement MSDE sans SQL Server Enterprise Manager, il existe un outil gratuit permettant d’attacher et détacher les bases de données, disponible à l’adresse : http://www.asql.biz/DbaMgr/DownLoad2k.shtm Vous pouvez également utiliser l’utilitaire en ligne de commande osql. Voir également : http://databasejournal.com/features/mssql/article.php/2224361

Utilitaires Fonctionnement de l’utilitaire « copyfiles.exe » : • Ouvrez une invite de commandes. • Rendez-vous dans le répertoire tools d’ASM (commande « cd »). • Utilisez la commande « copyfiles » suivie des paramètres souhaités. Syntaxe de la commande « copyfiles » : copyfiles [/s] [] [-p ] /s -> doit être spécifié si les fichiers à copier sont enregistrés dans des sous-dossiers du répertoire source -> extension des fichiers à copier -> chemin d’accès au dossier engine > queue de ASM -p -> mot de passe utilisé pour crypter les messages (nécessaire uniquement si le cryptage est utilisé) La durée du processus dépend du nombre de fichiers à copier et de leur taille.

Avertissement Après avoir restauré la base de données, il peut être nécessaire de lancer l’Analyseur de requêtes SQL et d’exécuter “sp_change_users_login ‘update_one’, ‘’, ‘’” afin d’harmoniser les ID de sécurité des différents éléments.

http://www.watsoft.com

Contact : [email protected]

Page 12/12