Migration de la base de données de ASM

Transcription

Migration de la base de données de ASM
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 <repository> 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 <repository> 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 <répertoire d’installation de ASM>\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
<répertoire d’installation de ASM>\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 <répertoire d’installation de ASM>/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 <répertoire d’installation de ASM>/engine/asmd.ini :
[odbc]
source=<nom de la source de données ODBC>
user=<nom d’utilisateur pour la connexion à la base de données, voir
étape 4>
pass=<mot de passe correspondant>
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 : <répertoire d’installation d’ASM>/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 <répertoire d’installation de ASM>\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 : <répertoire
d’installation de ASM>/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 <répertoire d’installation de ASM>\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 <répertoire d’installation
d’ASM>/engine/asmd.ini :
[odbc]
source=<nom de la source de données ODBC>
user=<nom d’utilisateur pour la connexion à la base>
pass=<mot de passe correspondant>
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] <dossier source> <dossier de destination> [<extension>] [-p <mot de passe>]
/s -> doit être spécifié si les fichiers à copier sont enregistrés dans des sous-dossiers du répertoire source
<extension> -> extension des fichiers à copier
<dossier de destination> -> chemin d’accès au dossier engine > queue de ASM
-p <password> -> 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’, ‘<login>’, ‘<login>’” afin d’harmoniser les ID de sécurité
des différents éléments.
http://www.watsoft.com
Contact : [email protected]
Page 12/12

Documents pareils