Le client eMBox est un client Java à ligne de commande qui donne accès aux outils eMBox tels que eDirectory Backup eMTool. Il vous permet d'effectuer, à partir d'une seule machine, des tâches de sauvegarde, de restauration et de configuration de la consignation de transactions individuelles par fichier pour plusieurs serveurs, si vous disposez d'un accès derrière le pare-feu.
Le client eMBox peut être exécuté en mode de traitement par lots ; vous pouvez donc l'utiliser pour effectuer des sauvegardes sans surveillance à l'aide de eDirectory Backup eMTool.
Le fichier eMBoxClient.jar est installé sur votre serveur en tant qu'élément de eDirectory. Vous pouvez également copier ce fichier et l'exécuter sur toute machine équipée de Sun JVM 1.3.1. Pour plus d'informations, reportez-vous à eDirectory Management Toolbox et à Exécution du client eMBox sur un poste de travail.
Avant d'exécuter des tâches de sauvegarde et de restauration, reportez-vous à Liste de contrôle pour la sauvegarde de eDirectory pour avoir une vue d'ensemble des points à prendre en compte lors de la préparation d'une stratégie de sauvegarde efficace pour eDirectory.
Dans cette section :
Le client eMBox vous permet de sauvegarder les données d'une base de données eDirectory dans un fichier que vous indiquez, sur le serveur sur lequel la sauvegarde est en cours d'exécution. Le fichier de sauvegarde (ou le jeu de fichiers) contient les informations nécessaires pour restaurer eDirectory dans l'état où il se trouvait au moment de la sauvegarde. Le résultat du processus de sauvegarde est enregistré dans le fichier journal que vous spécifiez.
Avant d'exécuter des tâches de sauvegarde et de restauration, reportez-vous à Liste de contrôle pour la sauvegarde de eDirectory pour avoir une vue d'ensemble des points à prendre en compte lors de la préparation d'une stratégie de sauvegarde efficace pour eDirectory.
Le client eMbox vous permet d'effectuer un certain nombre de tâches, notamment :
Cela signifie que la base de données eDirectory est ouverte et accessible pendant le processus, mais que vous obtenez une sauvegarde complète qui constitue un instantané de la base au moment où la sauvegarde a commencé.
Cette option est utile lors de la mise à niveau d'une machine, ou du déplacement d'un serveur vers une nouvelle machine équipée du même système d'exploitation (comme expliqué dans Mise à niveau du matériel ou remplacement d'un serveur).
Pour exécuter ces tâches sans surveillance, reportez-vous à Sauvegardes sans surveillance à l'aide d'un fichier de traitement par lots et du client eMBox.
Ce fichier est installé sur votre serveur en tant qu'élément de eDirectory. Vous pouvez le copier afin de l'utiliser sur un autre ordinateur équipé de Sun JVM 1,10,3. Il vous permet d'effectuer à partir d'une même machine des sauvegardes pour plusieurs serveurs, si vous disposez d'un accès derrière le pare-feu. Pour plus d'informations, reportez-vous à Utilisation du client à ligne de commande eMBox.
Vous devez activer la fonction de consignation de transactions individuelles par fichier pour les serveurs qui font partie d'un anneau de répliques. Si vous ne le faites pas, des erreurs se produisent lors de la restauration à partir des fichiers de sauvegarde et la base de données ne s'ouvre pas.
Pour plus d'informations sur les journaux de transactions individuelles, reportez-vous à Utilisation des journaux de transactions individuelles. Pour savoir comment les activer, reportez-vous à Configuration des journaux de transactions individuelles à l'aide du client eMBox.
Vous pouvez sauvegarder les fichiers NICI et les fichiers de flux à l'aide des paramètres appropriés. Nous vous recommandons de sauvegarder systématiquement les fichiers NICI.
Pour inclure d'autres fichiers, tels que le fichier autoexec.ncf, vous devez indiquer leur chemin d'accès complet dans un fichier d'inclusion. Séparez les chemins d'accès par un point-virgule, sans inclure de retour chariot ni d'espace (Par exemple, sys:\system\autoexec.ncf;sys:\etc\hosts;)
SUGGESTION : pour faciliter le transfert des fichiers de sauvegarde sur une autre unité de stockage, vous pouvez spécifier la taille maximale de ces fichiers dans la commande de sauvegarde (utilisez l'option -s suivie d'un nombre indiquant la taille en octets). Vous pouvez également exécuter un logiciel de compression tiers sur les fichiers, une fois ceux-ci créés. Le taux de compression atteint environ 80 %.
Pour plus d'informations, reportez-vous à Le processus de vérification de la restauration offre une compatibilité ascendante avec eDirectory 8.5 et les versions ultérieures uniquement.
Pour sauvegarder la base de données eDirectory sur un serveur à l'aide du client eMBox, procédez comme suit :
Lancez le client eMBox en mode interactif.
Le fichier edirutil est un raccourci pour l'exécution du client eMBox. Il pointe vers l'exécutable Java et l'emplacement par défaut où le client eMBox est installé avec eDirectory ; pour NetWare, il comprend l'option -ns, qui est nécessaire (Vous pouvez également entrer les informations manuellement, comme indiqué dans Définition du chemin et du chemin de classe pour le client eMBox.)
Lorsque le client eMBox s'ouvre, l'invite correspondante s'affiche : Client eMBox>
Loguez-vous au serveur que vous souhaitez sauvegarder. Pour ce faire, entrez
login -s nom_serveur_ou_adresse_IP -p numéro_port -u nomutilisateur.contexte -w mot de passe
Par exemple, sous Windows, vous entrez
login -s 151.155.111.1 -p 8009 -u admin.masociété -w monmotdepasse
Si un message d'erreur indiquant qu'il est impossible d'établir une connexion sécurisée s'affiche, vérifiez si votre machine possède les fichiers JSSE listés dans Établissement d'une connexion sécurisée avec le client eMBox.
Pour savoir quel numéro de port utiliser, reportez-vous à Recherche des numéros de port eDirectory.
Le client eMBox indique si le login a réussi.
Entrez la commande backup à l'invite du client eMBox, en suivant le modèle général ci-dessous :
backup -b -f nom_et_chemin_fichier_de_sauvegarde -l nom_et_chemin_fichier_journal_sauvegarde -u nom_et_chemin_fichier_inclusion -e -t -w
Chaque paramètre doit être délimité par un espace. L'ordre des paramètres n'a pas d'importance. Il est recommandé de toujours sauvegarder les fichiers NICI (-e), afin de pouvoir les utiliser dans une restauration en vue d'accéder aux fichiers codés.
Par exemple, sous Windows, vous entrez
backup -b -f c:\backups\8_20_2001.bak -l c:\backups\backup.log -u c:\backups\fichierinclusion.txt -e -t -w
Cet exemple de commande permet d'effectuer une sauvegarde complète (-b), le fichier de sauvegarde étant enregistré sous c:\ backups\20_08_2001.bak et le fichier journal correspondant sous c:\backups\backup.log. Cette commande indique que d'autres fichiers doivent être sauvegardés avec la base de données.
Cet exemple de commande indique que le fichier de sauvegarde doit être remplacé (-w). Par conséquent, s'il existe déjà un fichier portant le même nom, Backup eMTool le remplace.
Le client eMBox indique si la sauvegarde a réussi.
Déloguez-vous du serveur. Pour ce faire, entrez la commande suivante :
logout
Quittez le client eMBox. Pour ce faire, entrez la commande suivante :
Quitter
Veillez à effectuer une sauvegarde du système de fichiers peu après avoir sauvegardé eDirectory, afin de placer les fichiers de sauvegarde en sécurité sur bande. (Backup eMTool les place uniquement sur le serveur.)
Pour exécuter des sauvegardes de eDirectory sans surveillance avec le client eMBox, vous devez utiliser un fichier de traitement par lots. Supposons que vous souhaitiez effectuer une sauvegarde complète de eDirectory toutes les semaines, et une sauvegarde incrémentielle toutes les nuits.
Vous pouvez, dans ce cas, exécuter le client eMBox en mode de traitement par lots en utilisant un fichier système, un fichier propre au client eMBox, ou encore une combinaison des deux. Pour plus d'informations, reportez-vous à Exécution du client à ligne de commande eMBox en mode de traitement par lots.
La procédure ci-dessous met en oeuvre un fichier de traitement par lots du système.
REMARQUE : sous NetWare, vous pouvez utiliser un logiciel de planification tiers ou cron.nlm, disponible sur le site Web de support de Novell.
Ce fichier est installé sur votre serveur en tant qu'élément de eDirectory. Vous pouvez le copier afin de l'utiliser sur un autre ordinateur équipé de Sun JVM 1.3.1. Il vous permet d'effectuer à partir d'une même machine des sauvegardes pour plusieurs serveurs, si vous disposez d'un accès derrière le pare-feu. Pour plus d'informations, reportez-vous à Utilisation du client à ligne de commande eMBox.
Vous devez activer la fonction de consignation de transactions individuelles par fichier pour les serveurs qui font partie d'un anneau de répliques. Si vous ne le faites pas, des erreurs se produisent lors de la restauration à partir des fichiers de sauvegarde et la base de données ne s'ouvre pas.
Pour plus d'informations sur les journaux de transactions individuelles, reportez-vous à Utilisation des journaux de transactions individuelles. Pour savoir comment les activer, reportez-vous à Configuration des journaux de transactions individuelles à l'aide du client eMBox.
Vous pouvez sauvegarder les fichiers NICI et les fichiers de flux à l'aide des paramètres appropriés. Nous vous recommandons de sauvegarder systématiquement les fichiers NICI.
Pour inclure d'autres fichiers, tels que le fichier autoexec.ncf, vous devez indiquer leur chemin d'accès complet dans un fichier d'inclusion. Séparez les chemins d'accès par un point-virgule, sans inclure de retour chariot ni d'espace (Par exemple, sys:\system\autoexec.ncf;sys:\etc\hosts;)
SUGGESTION : pour faciliter le transfert des fichiers de sauvegarde eDirectory sur une autre unité de stockage, vous pouvez spécifier la taille maximale de ces fichiers. Vous pouvez également exécuter un logiciel de compression tiers sur les fichiers, une fois ceux-ci créés. Le taux de compression atteint environ 80 %.
Créez un fichier système de traitement par lots pour sauvegarder les serveurs et suivez le modèle général ci-dessous, c'est-à-dire avec une ligne par serveur.
Voici le modèle général pour Windows et UNIX :
java -cp chemin/eMBoxClient.jar embox -s nom_serveur -p numéro_port -u nomutilisateur.contexte -w motdepasse -t backup.backup -b -f chemin_et_nom_fichier_de_sauvegarde -l chemin_et_nom_fichier_journal -u chemin_et_nom_fichier_inclusion -e -t -w
Sous NetWare, vous suivez le même modèle général, auquel s'ajoute -nsac, que vous ne devez pas utiliser sur d'autres plates-formes :
java -nsac -cp chemin/eMBoxClient.jar embox -s nom_serveur -p numéro_port -u nomutilisateur.contexte -w motdepasse -t backup.backup -b -f chemin_et_nom_fichier_sauvegarde -l chemin_et_nom_fichier_journal_sauvegarde -u chemin_et_nom_fichier_inclusion -e -t -w
Pour obtenir des exemples et des explications supplémentaires, reportez-vous à Exemples de fichiers système de traitement par lots pour les sauvegardes sans surveillance.
Pour les sauvegardes incrémentielles effectuées toutes les nuits, vous pouvez utiliser le même fichier que pour les sauvegardes complètes, mais en remplaçant l'option -b par -i. Vous obtenez ainsi une sauvegarde incrémentielle au lieu d'une sauvegarde complète. Il est également judicieux d'utiliser des noms de fichiers de sauvegarde différents pour les sauvegardes incrémentielles et pour la sauvegarde complète.
Pour savoir quel numéro de port utiliser, reportez-vous à Recherche des numéros de port eDirectory. Si vous voulez utiliser une connexion sécurisée, reportez-vous à Établissement d'une connexion sécurisée avec le client eMBox. Pour plus d'information sur l'utilisation d'un fichier de traitement par lots propre au client eMBox, reportez-vous à Exécution du client à ligne de commande eMBox en mode de traitement par lots.
Exécutez les fichiers de traitement par lots sans surveillance, conformément aux instructions de la documentation de votre système d'exploitation ou du logiciel tiers.
Prévoyez d'effectuer des sauvegardes du système de fichiers peu après avoir sauvegardé eDirectory, afin de placer les fichiers de sauvegarde de eDirectory en sécurité sur bande.
Backup eMTool les place uniquement sur le serveur.
Vérifiez périodiquement les résultats enregistrés dans le fichier journal que vous avez spécifié, pour vous assurer que les sauvegardes sans surveillance aboutissent.
Voici deux exemples :
java -nsac -cp sys:\system\embox\eMBoxClient.jar embox -s 10.10.1.200 -p 8008 -u admin.monconteneur -w monmotdepasse -n -t backup.backup -b -f sys:\system\backup\backup.bak -l sys:\system\backup\backup.log -u sys:\system\backup\fichierd'inclusion.txt -e -t -w
Les options suivantes figurent dans cet exemple de fichier de traitement par lots.
AVERTISSEMENT :
sur un serveur NetWare uniquement : pour éviter un abend, vous devez ajouter -ns.
L'option -ns ouvre un nouvel écran.
L'option ac ferme automatiquement l'écran lorsque la tâche du fichier de traitement par lots a été exécutée. Si vous n'introduisez pas cette option dans les fichiers de traitement par lots pour NetWare, un écran reste ouvert sur le serveur chaque fois que le fichier de traitement est exécuté sans surveillance.
IMPORTANT : s'il existe déjà un fichier de sauvegarde portant le même nom (ce qui est probable si vous utilisez régulièrement le même fichier de traitement par lots), votre sauvegarde aboutit uniquement si vous employez l'option -w pour remplacer le fichier de sauvegarde existant.
En mode de traitement par lots, s'il existe un fichier du même nom et si l'option -w n'est pas spécifiée, le comportement par défaut consiste à ne pas écraser le fichier, ce qui empêche la création d'une sauvegarde. (En mode interactif, si vous n'utilisez pas l'option -w, le client eMBox vous demande si vous voulez écraser le fichier.)
Si vous effectuez une sauvegarde du système de fichiers peu après chaque sauvegarde complète ou incrémentielle de eDirectory, les fichiers de sauvegarde précédents doivent avoir été copiés sur une bande. Vous pouvez donc écraser le fichier de sauvegarde existant sans crainte.
java -cp c:\novell\nds\embox\eMBoxClient.jar embox -s monserveur -p 8008 -u admin.monorg -w monmotdepasse -n -t backup.backup -b -f c:\backup\backup.bak -u c:\backup\includes\fichierd'inclusion.txt -l c:\backup\backup.log -e -t -w
Les options suivantes figurent dans cet exemple de fichier de traitement par lots.
IMPORTANT : s'il existe déjà un fichier de sauvegarde portant le même nom (ce qui est probable si vous utilisez régulièrement le même fichier de traitement par lots), votre sauvegarde aboutit uniquement si vous employez l'option -w pour remplacer le fichier de sauvegarde existant.
En mode de traitement par lots, s'il existe un fichier du même nom et si l'option -w n'est pas spécifiée, le comportement par défaut consiste à ne pas écraser le fichier, ce qui empêche la création d'une sauvegarde. (En mode interactif, si vous n'utilisez pas l'option -w, le client eMBox vous demande si vous voulez écraser le fichier.)
Si vous effectuez une sauvegarde du système de fichiers peu après chaque sauvegarde complète ou incrémentielle de eDirectory, les fichiers de sauvegarde précédents doivent avoir été copiés sur une bande. Vous pouvez donc écraser le fichier de sauvegarde existant sans crainte.
REMARQUE : les options -ns et ac présentées dans les exemples de fichier de traitement par lots pour NetWare doivent être utilisées dans cet environnement uniquement. Ne vous en servez pas sous Windows ou UNIX.
Le client eMBox vous permet de modifier les paramètres des journaux de transactions individuelles. Vous pouvez effectuer les tâches suivantes :
Vous devez activer la fonction de consignation de transactions individuelles par fichier pour les serveurs qui font partie d'un anneau de répliques. Si vous ne le faites pas, des erreurs se produisent lors de la restauration à partir des fichiers de sauvegarde et la base de données ne s'ouvre pas.
Pour plus d'informations sur la consignation de transactions individuelles par fichier, reportez-vous à Utilisation des journaux de transactions individuelles.
Ce fichier est installé sur votre serveur en tant qu'élément de eDirectory. Vous pouvez le copier afin de l'utiliser sur un autre ordinateur équipé de Sun JVM 1.3.1. Il vous permet d'effectuer à partir d'une même machine des sauvegardes pour plusieurs serveurs, si vous disposez d'un accès derrière le pare-feu. Pour plus d'informations, reportez-vous à Utilisation du client à ligne de commande eMBox.
Lancez le client eMBox en mode interactif :
Le fichier edirutil est un raccourci pour l'exécution du client eMBox. Il pointe vers l'exécutable Java et l'emplacement par défaut où le client eMBox est installé avec eDirectory ; pour NetWare, il comprend l'option -ns, qui est nécessaire (Vous pouvez également entrer les options manuellement, comme indiqué dans Exécution du client eMBox sur un poste de travail.)
Lorsque le client eMBox s'ouvre, l'invite correspondante s'affiche : Client eMBox>
Loguez-vous au serveur sur lequel vous souhaitez configurer la consignation de transactions individuelles par fichier. Pour ce faire, entrez
login -s nom_serveur_ou_adresse_IP -p numéro_port -u nomutilisateur.contexte -w mot de passe
Par exemple, sous Windows, vous entrez
login -s 151.155.111.1 -p 8009 -u admin.masociété -w monmotdepasse
Si un message d'erreur indiquant qu'il est impossible d'établir une connexion sécurisée s'affiche, vérifiez si votre machine possède les fichiers JSSE listés dans Établissement d'une connexion sécurisée avec le client eMBox.
Pour savoir quel numéro de port utiliser, reportez-vous à Recherche des numéros de port eDirectory.
Le client eMBox indique si le login a réussi.
(Facultatif) Recherchez la configuration actuelle. Pour ce faire, entrez
getconfig
Aucun paramètre n'est nécessaire.
Voici un exemple des informations que vous recevez :
Roll forward log status OFF
Stream file logging status OFF
Current roll forward log directory vol1:/rfl/nds.rfl
Minimum roll forward log size (bytes) 104857600
Maximum roll forward log size (bytes) 4294705152
Last roll forward log not used 00000000.log
Current roll forward log 00000001.log
*** END ***
Modifiez les paramètres à l'aide de la commande setconfig et suivez le modèle général ci-dessous :
setconfig [-L|-l] [-T|-t] -r chemin_journaux_transactions_individuelles -n taille_minimale_fichier -m taille_maximale_fichier
Chaque paramètre doit être délimité par un espace. L'ordre des paramètres n'a pas d'importance.
Par exemple, sous NetWare, vous entrez
setconfig -L -r rflvolume:\logs
Cet exemple active la consignation de transactions individuelles par fichier (paramètre -L) et spécifie que les journaux sont placés dans rflvolume:\logs. (En principe, il vous faudrait réserver un volume/une partition de disque à ces journaux, afin de faciliter le contrôle de l'espace disque et des droits.) L'exemple n'inclut pas l'option d'activation de la consignation des fichiers de flux.
AVERTISSEMENT :
si vous activez la consignation de transactions individuelles par fichier, n'utilisez pas l'emplacement par défaut. Pour assurer une tolérance aux pannes, placez le répertoire sur un volume/une partition de disque et une unité de stockage différents de ceux de eDirectory. Le répertoire des journaux de transactions individuelles doit résider sur le serveur sur lequel vous modifiez la configuration de sauvegarde.
IMPORTANT : si vous activez la consignation de transactions individuelles par fichier, vous devez surveiller l'espace disque sur le volume où vous placez les journaux de transactions individuelles. Si vous ne le surveillez pas, le répertoire des fichiers journal s'étend jusqu'à saturer le volume/la partition de disque. Si ces journaux ne peuvent pas être créés par manque d'espace disque, eDirectory cesse de fonctionner sur le serveur concerné. Nous vous conseillons de sauvegarder et de supprimer périodiquement du serveur les journaux de transactions individuelles inutilisés. Pour plus de détails, reportez-vous à Sauvegarde et suppression des journaux de transactions individuelles.
Déloguez-vous du serveur. Pour ce faire, entrez la commande suivante :
logout
Quittez le client eMBox. Pour ce faire, entrez la commande suivante :
Quitter
Utilisez le client eMBox pour restaurer une base de données eDirectory à partir des données stockées dans les fichiers de sauvegarde que vous avez créés manuellement ou à l'aide d'un fichier de traitement par lots. Le résultat du processus de restauration est enregistré dans le fichier journal que vous spécifiez.
Le client eMBox vous permet en outre d'utiliser des options de restauration avancées qui ne sont pas disponibles dans iManager. Ces options sont présentées dans Options de ligne de commande pour la sauvegarde et la restauration, sous restore et restadv.
Ce fichier est installé sur votre serveur en tant qu'élément de eDirectory. Vous pouvez le copier afin de l'utiliser sur un autre ordinateur équipé de Sun JVM 1.3.1. Il vous permet d'effectuer à partir d'une même machine des restaurations pour plusieurs serveurs, si vous disposez d'un accès derrière le pare-feu. Pour plus d'informations, reportez-vous à Utilisation du client à ligne de commande eMBox.
Reportez-vous à Préparation d'une restauration et à Localisation des fichiers de sauvegarde requis pour une restauration.
Par exemple, si la restauration est nécessaire en raison de la défaillance d'une unité de stockage, vous devez réinstaller eDirectory sur la nouvelle unité. Si vous restaurez un serveur défaillant sur une nouvelle machine, ou transférez simplement un serveur d'une machine à une autre, vous devez installer le système d'exploitation ainsi que eDirectory sur la nouvelle machine.
Pour restaurer une base de données eDirectory sur un serveur à l'aide du client eMBox :
Vérifiez que vous avez collecté les fichiers de sauvegarde dont vous avez besoin, comme indiqué dans Préparation d'une restauration.
Lancez le client eMBox en mode interactif :
Le fichier edirutil est un raccourci pour l'exécution du client eMBox. Il pointe vers l'exécutable Java et l'emplacement par défaut où le client eMBox est installé avec eDirectory ; pour NetWare, il comprend l'option -ns, qui est nécessaire (Vous pouvez également entrer les informations manuellement, comme indiqué dans Exécution du client eMBox sur un poste de travail.)
Lorsque le client eMBox s'ouvre, l'invite correspondante s'affiche : Client eMBox>
Loguez-vous au serveur que vous souhaitez restaurer. Pour ce faire, entrez
login -s nom_serveur_ou_adresse_IP -p numéro_port -u nomutilisateur.contexte -w mot de passe
Par exemple, sous Windows, vous entrez
login -s 151.155.111.1 -p 8009 -u admin.masociété -w monmotdepasse
Si un message d'erreur indiquant qu'il est impossible d'établir une connexion sécurisée s'affiche, vérifiez si votre machine possède les fichiers JSSE listés dans Établissement d'une connexion sécurisée avec le client eMBox.
Pour savoir quel numéro de port utiliser, reportez-vous à Recherche des numéros de port eDirectory.
Le client eMBox indique si le login a réussi.
Entrez la commande restore à l'invite du client eMBox, en suivant le modèle général ci-dessous :
restore -r -a -o -f chemin_et_nom_de_fichier_de_sauvegarde_complète
-d emplacement_journaux_transactions_individuelles -l chemin_et_nom_de_journal_de_restauration -e
Chaque paramètre doit être délimité par un espace. L'ordre des paramètres n'a pas d'importance. Veillez à utiliser le paramètre -r afin de restaurer la base de données eDirectory elle-même ; sinon, seuls les autres types de fichiers sont restaurés. Si vous voulez que la base de données soit active et ouverte une fois la restauration terminée, indiquez les options -a et -o. Si vous utilisez NICI, restaurez les fichiers NICI (-e) afin de pouvoir accéder aux données codées après la restauration.
Si vous restaurez les journaux de transactions individuelles, veillez à inclure leur chemin d'accès complet, y compris le répertoire créé automatiquement par eDirectory, en général \nds.rfl. (Pour plus d'informations sur ce répertoire, reportez-vous à Emplacement des journaux de transactions individuelles.)
Par exemple :
restore -r -a -o -f sys:/backup/nds.bak -d vol1:/rfldir/nds.rfl -l sys:/backups/backup.log -e
Cet exemple de commande indique que la base de données même doit être restaurée (-r), et qu'elle doit être activée (-a) et ouverte (-o) une fois la vérification de la restauration effectuée correctement. Le paramètre -f indique où se trouve le fichier de sauvegarde complète, le paramètre -d désigne l'emplacement des journaux de transactions individuelles et le paramètre -l, le fichier journal dans lequel le résultat de la restauration est enregistré. Les fichiers NICI sont également restaurés (-e).
Le client eMBox restaure la sauvegarde complète, puis vous invite à indiquer les fichiers de sauvegarde incrémentielle.
(Conditionnel) Si vous restaurez des fichiers de sauvegarde incrémentielle, indiquez le chemin d'accès et le nom de chaque fichier lorsque le client eMBox vous invite à désigner le fichier incrémentiel suivant.
Il vous fournit l'ID du fichier suivant, que vous pouvez trouver dans l'en-tête du fichier de sauvegarde incrémentielle.
Le client eMBox indique si la restauration a réussi.
(Conditionnel) Si la restauration échoue, consultez les erreurs dans le fichier journal.
Si la vérification de la restauration échoue, reportez-vous à Récupération de la base de données en cas d'échec de la vérification de la restauration.
REMARQUE : si le serveur que vous restaurez partage une réplique avec un serveur qui exécute une version de eDirectory antérieure à la version 8.5, le journal de restauration indique l'erreur -666 (version DS incompatible) pour cette réplique. Pour plus d'informations sur cette situation et la façon de procéder, reportez-vous à Le processus de vérification de la restauration offre une compatibilité ascendante avec eDirectory 8.5 et les versions ultérieures uniquement.
Déloguez-vous du serveur. Pour ce faire, entrez la commande suivante :
logout
Quittez le client eMBox. Pour ce faire, entrez la commande suivante :
Quitter
(Conditionnel) Si vous avez restauré les fichiers de sécurité NICI, redémarrez le serveur pour réinitialiser NICI une fois la restauration terminée.
Vérifiez que le serveur fonctionne normalement.
(Conditionnel) Si vous utilisez la consignation de transactions individuelles par fichier sur ce serveur, vous devez recréer la configuration de votre choix afin d'être certain que la fonction est activée et que les journaux sont enregistrés à un emplacement assurant la tolérance aux pannes. Après avoir activé les journaux de transactions individuelles, vous devez également effectuer une nouvelle sauvegarde complète.
Cette opération est nécessaire car, au cours d'une restauration, la configuration de la consignation de transactions individuelles reprend son état par défaut, c'est-à-dire qu'elle est désactivée et que l'emplacement correspondant reprend sa valeur par défaut. Vous devez effectuer la nouvelle sauvegarde complète afin de vous protéger contre toute défaillance susceptible de survenir avant la prochaine sauvegarde complète sans surveillance planifiée.
Pour plus d'informations sur les fichiers journal de transactions individuelles et sur leur emplacement, reportez-vous à Utilisation des journaux de transactions individuelles.
La restauration doit maintenant être achevée et NICI réinitialisé avec les fichiers correspondants restaurés, ce qui vous permet d'accéder aux informations codées. Si vous utilisez la fonction de consignation de transactions individuelles par fichier, vous vous êtes préparé contre toute nouvelle défaillance en réactivant cette fonction à l'issue de la restauration, puis en effectuant une nouvelle sauvegarde complète.
Les options de ligne de commande de eDirectory Backup eMTool sont réparties en six fonctions : backup, restore, restadv, getconfig, setconfig et cancel.
Les paramètres peuvent être introduits dans n'importe quel ordre dans la commande, après le nom de la fonction. Ils doivent cependant être séparés par un espace.
| Option et paramètres | Description |
|---|---|
| backup | Effectue une sauvegarde de la base de données et des fichiers associés. |
-f nom_fichier |
(Obligatoire) Chemin et nom du fichier de sauvegarde Indique le nom et l'emplacement du fichier de sauvegarde que Backup eMTool doit créer. Ce fichier doit figurer sur le serveur que vous sauvegardez. Par exemple, backup -f vol1:\backup\ndsbak.bak sauvegarde la base de données dans vol1:\backup\ndsbak.bak. |
-l nom_fichier |
(Obligatoire) Chemin et nom du fichier journal Indique le fichier journal dans lequel les résultats de la sauvegarde doivent être enregistrés. |
-b |
(Facultatif) Exécute une sauvegarde complète Exécute une sauvegarde complète de la base de données eDirectory. Cette option représente l'opération par défaut. Si vous n'indiquez ni -i ni -c, une sauvegarde complète est effectuée. |
-i |
(Facultatif) Exécute une sauvegarde incrémentielle Exécute une sauvegarde incrémentielle de la base de données eDirectory. Toutes les modifications apportées à la base de données depuis la dernière sauvegarde complète ou incrémentielle sont sauvegardées. |
-e |
(Facultatif) Inclut des fichiers de sécurité à la sauvegarde Ajoute les fichiers de sécurité NICI à la sauvegarde. Ceux-ci sont inclus dans la sauvegarde de la même façon que les fichiers indiqués dans le fichier d'inclusion utilisateur. La seule différence concerne l'étiquette du type de fichier, qui correspond à "nici" au lieu de "user." Si le serveur contient des données codées, le seul moyen de les décoder est de disposer des fichiers NICI qui se trouvaient dans le système lors de la sauvegarde. Ces fichiers sont liés à la base de données locale. AVERTISSEMENT : si vous utilisez NICI, veillez à inclure les fichiers NICI dans les sauvegardes. Dans le cas contraire, vous ne pouvez pas restaurer ces fichiers ni lire les données codées. |
-t |
(Facultatif) Sauvegarde les fichiers de flux Inclut les fichiers de flux lors de la sauvegarde de la base de données eDirectory. |
-u nom_fichier |
(Facultatif) L'utilisateur ajoute le chemin et le nom du fichier Indique un fichier d'inclusion qui contient les fichiers supplémentaires à sauvegarder. Vous pouvez créer ce fichier de configuration afin d'inclure dans la sauvegarde d'autres fichiers importants pour la restauration de la base de données eDirectory du serveur. Dans le fichier d'inclusion, indiquez le chemin d'accès complet de chaque fichier à sauvegarder, suivi d'un point-virgule (;). Par exemple, si vous voulez inclure les fichiers autoexec.ncf et hosts dans la sauvegarde pour un serveur NetWare, le fichier d'inclusion utilisateur peut se présenter comme suit : sys:\system\autoexec.ncf;sys:\etc\hosts; N'incluez pas d'espace ni de retour chariot dans la liste des fichiers. Pour vous assurer que les fichiers indiqués ont bien été sauvegardés, consultez le journal de sauvegarde ou l'en-tête du fichier de sauvegarde. (Reportez-vous à Format du fichier journal de sauvegarde et à Format de l'en-tête des fichiers de sauvegarde.) AVERTISSEMENT : lorsque vous ouvrez un fichier de sauvegarde, contentez-vous de consulter l'en-tête. N'essayez pas d'enregistrer ni de modifier le fichier, car il pourrait alors devenir tronqué. La plupart des applications ne peuvent pas enregistrer correctement les données binaires. |
-s taille_fichier |
(Facultatif) Taille maximale du fichier de sauvegarde (octets) Indique la taille maximale (en octets) du fichier de sauvegarde. Vous pouvez utiliser cette option si la taille des fichiers risque de poser un problème avec le support servant à enregistrer les fichiers de sauvegarde après leur création. Si la taille maximale est atteinte, un nouveau fichier de sauvegarde est créé avec le même nom, mais une extension de cinq chiffres hexadécimaux est ajoutée pour indiquer de quel fichier il s'agit. Cette extension est incrémentée pour chaque nouveau fichier. Par exemple, vous pouvez fixer la taille maximale des fichiers de sauvegarde à 1 Mo en utilisant les paramètres suivants dans la commande : backup -f vol1:/backup/mydib.bak -s 1000000. Si la base de données fait 3,5 Mo, vous obtenez le jeu de fichiers de sauvegarde suivant :
La taille minimale correspond à 500 Ko. Le premier fichier peut être plus volumineux, selon le nombre de fichiers inclus dans la sauvegarde. Il contient, sous l'étiquette backup, un attribut nommé number_of_files (nombre de fichiers). Il s'agit du nombre total de fichiers qui composent le jeu de sauvegarde. Dans l'exemple ci-dessus, ce nombre est 4. De plus, l'en-tête de chaque fichier de sauvegarde contient l'attribut backup_file. Il s'agit du nom original du fichier (Pour plus d'informations, reportez-vous à Format de l'en-tête des fichiers de sauvegarde.) Pour restaurer un ensemble de fichiers de sauvegarde comme celui de l'exemple ci-dessus, la commande est la suivante : restore -f vol1:/backup/mydib.bak -l chemin_et_nom_du_fichier_journal Backup eMTool reconnaît qu'il y a plusieurs fichiers et les recherche dans le même répertoire que le premier fichier, mais prend en compte les modifications de nom indiquées plus haut. SUGGESTION : en utilisant un logiciel de compression d'un éditeur tiers, vous pouvez également réduire considérablement la taille des fichiers de sauvegarde. Le taux de compression atteint environ 80 %. |
-w |
(Facultatif) Écrase le fichier de sauvegarde portant le même nom Écrase le fichier de sauvegarde avec le paramètre -f si un fichier du même nom existe déjà. Si cette option n'est pas utilisée et qu'un fichier du même nom existe déjà, Backup eMTool vous demande si vous voulez ou non écraser ce fichier (en mode interactif). En mode de traitement par lots, s'il existe un fichier du même nom et si le paramètre -w n'est pas spécifié, le comportement par défaut consiste à ne pas écraser le fichier, ce qui empêche la création d'une sauvegarde. Si vous effectuez une sauvegarde du système de fichiers peu après chaque sauvegarde complète ou incrémentielle de eDirectory, les fichiers de sauvegarde précédents doivent avoir été copiés sur une bande. Vous pouvez donc écraser le fichier de sauvegarde existant sans crainte. IMPORTANT : utilisez cette option dans vos fichiers de traitement par lots pour les sauvegardes sans surveillance. S'il existe déjà un fichier de sauvegarde portant le même nom (ce qui est probable si vous utilisez régulièrement le même fichier de traitement par lots), votre sauvegarde aboutit uniquement si vous employez l'option -w pour remplacer le fichier de sauvegarde existant. En mode de traitement par lots, s'il existe un fichier du même nom et si l'option -w n'est pas spécifiée, le comportement par défaut consiste à ne pas écraser le fichier, ce qui empêche la création d'une sauvegarde. (En mode interactif, si vous n'utilisez pas l'option -w, le client eMBox vous demande si vous voulez écraser le fichier.) |
-c |
(Facultatif) Exécute une sauvegarde à froid Exécute une sauvegarde complète de la base de données fermée. Une fois la sauvegarde terminée, la base de données est rouverte, sauf si les paramètres -o ou -o et -d sont utilisés. |
-o |
(Facultatif) Laisse la base de données fermée après une sauvegarde à froid Ne peut être utilisé que si le paramètre -c est également spécifié. Laisse la base de données fermée après une sauvegarde à froid. Cette option est utile lors de la mise à niveau d'une machine, ou du déplacement d'un serveur vers une nouvelle machine équipée du même système d'exploitation (comme expliqué dans Mise à niveau du matériel ou remplacement d'un serveur). |
-d |
(Facultatif) Désactive l'agent DS après une sauvegarde à froid Ne peut être utilisé que si les paramètres -c et -o le sont également. Désactive l'agent DS après une sauvegarde à froid. Cette option est utile lors de la mise à niveau d'une machine, ou du déplacement d'un serveur vers une nouvelle machine équipée du même système d'exploitation (comme expliqué dans Mise à niveau du matériel ou remplacement d'un serveur). L'utilisation de l'attribut Login désactivé sur le pseudo-serveur permet de désactiver l'agent DS, ce qui entraîne l'erreur -663 au démarrage de eDirectory. |
| restore | Effectue une restauration de la base de données et des fichiers associés. |
-f nom_fichier |
(Obligatoire) Chemin et nom du fichier de sauvegarde Indique la sauvegarde complète à partir de laquelle effectuer la restauration. Le fichier doit se trouver sur le serveur en cours de restauration. Par exemple, restore -f vol1:/backup/ndsbak.bak effectue la restauration à partir du fichier vol1:/backup/ndsbak.bak. Si la sauvegarde est constituée de plusieurs fichiers, tous les fichiers de l'ensemble doivent être copiés dans le même répertoire du serveur. |
-l nom_fichier |
(Obligatoire) Chemin et nom du fichier journal Indique le fichier journal dans lequel les résultats de la restauration doivent être enregistrés. |
-r |
(Facultatif) Restaure l'ensemble DIB Indique que la base de données eDirectory doit être restaurée. AVERTISSEMENT : si cette option n'est pas définie, la base de données eDirectory même n'est pas restaurée. Seuls les autres types de fichiers que vous indiquez, avec l'option -e pour les fichiers de sécurité NICI par exemple, sont restaurés. |
-d nom_rep |
(Facultatif) Répertoire du journal de transactions individuelles Indique le répertoire où sont stockés les journaux de transactions individuelles. Le chemin d'accès complet doit être indiqué et le répertoire doit se trouver sur le serveur restauré. Tous les journaux de transactions individuelles doivent se trouver dans le répertoire spécifié et porter le même nom que lors de leur création. Une fois la base de données restaurée, les modifications enregistrées dans ces journaux sont réappliquées afin de mettre à jour la base de données. Si le paramètre -d n'est pas utilisé, Backup eMTool ne réapplique aucune modification, même si la consignation de transactions individuelles par fichier était activée au moment de la sauvegarde. Pour identifier le premier fichier de transactions individuelles requis, ouvrez dans un éditeur de texte le dernier fichier de sauvegarde restauré et lisez l'attribut current_log de l'étiquette Backup. Le dernier fichier de sauvegarde restauré est le fichier spécifié par l'option -f ou le dernier fichier de sauvegarde incrémentielle qui doit être appliqué pendant la restauration (Pour plus d'informations sur les attributs listés dans l'en-tête, reportez-vous à Format de l'en-tête des fichiers de sauvegarde.) AVERTISSEMENT : lorsque vous ouvrez un fichier de sauvegarde, contentez-vous de consulter l'en-tête. N'essayez pas d'enregistrer ni de modifier le fichier, car il pourrait alors devenir tronqué. La plupart des applications ne peuvent pas enregistrer correctement les données binaires. |
-e |
(Facultatif) Restaure les fichiers de sécurité Restaure les fichiers de sécurité NICI inclus dans la sauvegarde de la base de données. AVERTISSEMENT : si vous utilisez NICI, veillez à inclure les fichiers correspondants dans les sauvegardes ainsi que dans les restaurations. Dans le cas contraire, vous ne pouvez pas lire les données codées une fois la restauration achevée. |
-u |
(Facultatif) Restaure les fichiers inclus par l'utilisateur Restaure les fichiers utilisateur inclus dans la sauvegarde de la base de données. Dans le cadre de la sauvegarde, vous pouvez créer un fichier texte contenant la liste des fichiers à sauvegarder avec la base de données, et définir ce fichier comme fichier inclus par l'utilisateur. Les fichiers concernés ne peuvent être restaurés que s'ils ont été inclus dans la sauvegarde. |
-a |
(Facultatif) Active l'ensemble DIB après vérification Renomme la base de données RST en base de données NDS une fois la vérification de la restauration effectuée correctement. (Pour obtenir une vue d'ensemble du processus, reportez-vous à Présentation du processus de restauration avec Backup eMTool.) |
-o |
(Facultatif) Ouvre la base de données à l'issue de la restauration Indique à Backup eMTool d'ouvrir la base de données une fois la restauration achevée. Si la vérification se déroule correctement, la base de données restaurée s'ouvre. Sinon, cette option entraîne l'ouverture de la base de données présente sur le serveur avant la restauration (Pour obtenir une vue d'ensemble du processus, reportez-vous à Présentation du processus de restauration avec Backup eMTool.) |
-n |
(Facultatif) Ne pas vérifier la base de données à l'issue de la restauration Indique à Backup eMTool de restaurer la base de données sans effectuer de vérification. Le vecteur de transition du serveur n'est pas comparé à celui qu'attendent les autres serveurs de l'anneau de répliques dont le serveur fait partie (pour toute information sur les vecteurs de transition, reportez-vous à Vecteurs de transition et processus de vérification de la restauration). La base de données RST n'est pas renommée en base de données NDS, à moins qu'une autre option ne soit définie à cet effet. IMPORTANT : nous vous recommandons de ne pas utiliser cette option à moins d'y être invité par le support de Novell. |
-v |
(Facultatif) Remplace la restauration Renomme la base de données RST en base de données NDS sans tenter de vérification. IMPORTANT : nous vous recommandons de ne pas utiliser cette option à moins d'y être invité par le support de Novell. |
-k |
(Facultatif) Supprime le verrouillage de la base de données Supprime le verrouillage de la base de données NDS. |
| restadv | Options de restauration avancées. (Remarque : l'agent DS est fermé pour toutes les options de restauration avancées.) |
-l nom_fichier |
(Obligatoire) Chemin et nom du fichier journal Indique le fichier journal dans lequel les résultats de la restauration doivent être enregistrés. |
-o |
(Facultatif) Ouvre la base de données à l'issue de la restauration Indique à Backup eMTool d'ouvrir la base de données une fois la restauration achevée. Si la vérification se déroule correctement, la base de données restaurée s'ouvre. Sinon, cette option entraîne l'ouverture de la base de données présente sur le serveur avant la restauration (Pour obtenir une vue d'ensemble du processus, reportez-vous à Présentation du processus de restauration avec Backup eMTool.) |
-n |
(Facultatif) Essaie de vérifier une restauration qui a échoué précédemment Essaie de vérifier une base de données RST restaurée précédemment. |
-m |
(Facultatif) Supprime les fichiers DIB restaurés Supprime la base de données RST si elle existe. |
-v |
(Facultatif) Remplace la restauration Renomme la base de données RST en base de données NDS sans tenter de vérification. IMPORTANT : nous vous recommandons de ne pas utiliser cette option à moins d'y être invité par le support de Novell. |
-k |
(Facultatif) Supprime le verrouillage de la base de données Supprime le verrouillage de la base de données NDS. |
| getconfig | Récupère la configuration actuelle des journaux de transactions individuelles. |
|
Aucune option n'est nécessaire. Affiche la configuration actuelle. Par exemple, sur un serveur pour lequel la consignation de transactions individuelles par fichier est désactivée, la commande getconfig renvoie des informations semblables aux suivantes : Roll forward log status OFF |
| setconfig | Définit la configuration des journaux de transactions individuelles. |
-L |
(Facultatif) Lance l'enregistrement de journaux de transactions individuelles Active la consignation de transactions individuelles par fichier. (désactivée par défaut). La consignation continue des transactions individuelles par fichier vous permet de restaurer un serveur dans l'état où il se trouvait avant son arrêt, plutôt que dans celui de la dernière sauvegarde complète ou incrémentielle. Vous devez activer cette fonction pour les serveurs qui font partie d'un anneau de répliques afin de pouvoir restaurer un serveur dans l'état de synchronisation attendu par les autres serveurs. L'administrateur doit intervenir une fois que la consignation des transactions individuelles a été activée. Si vous ne les surveillez pas, les journaux de transactions individuelles s'étendent jusqu'au point de saturer le volume/la partition de disque. Si ces journaux ne peuvent pas être créés par manque d'espace disque, eDirectory cesse de fonctionner sur le serveur concerné. Il est donc nécessaire de sauvegarder et de supprimer périodiquement les journaux inutilisés. Pour plus de détails, reportez-vous à Sauvegarde et suppression des journaux de transactions individuelles. Pour plus d'informations, reportez-vous à Utilisation des journaux de transactions individuelles. |
-l |
(Facultatif) Arrête l'enregistrement de journaux de transactions individuelles Désactive la consignation de transactions individuelles par fichier. (désactivée par défaut). La base de données réutilise le journal de transaction individuelle actuel, au lieu d'enregistrer un ensemble de journaux consécutifs. Si la consignation de transactions individuelles par fichier est désactivée, vous ne pouvez restaurer eDirectory qu'au point de la dernière sauvegarde complète ou incrémentielle. Si elle a été désactivée par mégarde, vous devez la réactiver puis effectuer une nouvelle sauvegarde de la base de données pour être en mesure d'effectuer une restauration complète. Pour plus d'informations, reportez-vous à Utilisation des journaux de transactions individuelles. |
-T |
(Facultatif) Lance la consignation des fichiers de flux (Ne s'applique que si la fonction de consignation de transactions individuelles par fichier est activée.) Si un fichier de flux est modifié, il est intégralement copié dans le journal de transaction individuelle. Les fichiers de flux sont des fichiers d'informations supplémentaires liés à la base de données. Les scripts de login en font partie, par exemple. Les journaux de transactions individuelles occupent l'espace disque plus rapidement lorsque les fichiers de flux sont consignés. Veillez par conséquent à contrôler l'espace libre sur le volume/la partition de disque où sont stockés les journaux de transactions individuelles. Si ces journaux ne peuvent pas être créés par manque d'espace disque, eDirectory cesse de fonctionner sur le serveur concerné. |
-t |
(Facultatif) Arrête la consignation des fichiers de flux Arrête la copie du fichier de flux entier dans le journal de transactions individuelles en cas de modification. Si la consignation des fichiers de flux est désactivée, vous pouvez utiliser les options de sauvegarde pour enregistrer ces fichiers lors des sauvegardes complètes et incrémentielles. Cette solution peut être suffisante si vos fichiers de flux changent peu souvent. En désactivant la consignation des fichiers de flux, vous pouvez ralentir l'extension des journaux de transactions individuelles. |
-r nom_rep |
(Facultatif) Définit le répertoire du journal de transactions individuelles Modifie le répertoire où sont stockés les journaux de transactions individuelles. Par exemple, si la commande utilisée est setconfig -r vol2:\rfl, un répertoire est créé sous vol2:\rfl et les journaux de transactions individuelles y sont placés. Le nom de ce répertoire est défini en fonction du nom de la base de données eDirectory actuelle. Pour les installations standard, c'est " NDS ". Le nom du répertoire résultant est donc vol2:\rfl\nds.rfl\. Si vous renommez la base de données eDirectory NDS en ND1, le répertoire des fichiers de transactions individuelles devient vol2:\rfl\nd1.rfl\. Vous pouvez trouver l'emplacement actuel des journaux à l'aide de la commande getconfig. Le répertoire est créé immédiatement après le changement d'emplacement, mais aucun journal de transaction individuelle n'est créé tant qu'aucune transaction n'a lieu dans la base de données. IMPORTANT : l'outil de sauvegarde ne permet pas de suivre les changements apportés au répertoire des journaux de transactions individuelles. Lorsque vous restaurez la base de données, vous devez collecter tous les journaux de transactions individuelles sur le serveur, dans un même répertoire. Pour plus d'informations, reportez-vous à Utilisation des journaux de transactions individuelles. |
-n taille_fichier |
(Facultatif) Définit la taille minimale du journal de transactions individuelles Définit la taille minimale des fichiers journal des transactions individuelles (en octets). Lorsque la taille minimale est atteinte, la base de données commence un nouveau journal de transactions individuelles à la fin de la transaction en cours. |
-m taille_fichier |
(Facultatif) Définit la taille maximale du journal de transactions individuelles Définit la taille maximale des fichiers journal des transactions individuelles (en octets). Si cette limite est atteinte et qu'une transaction est en cours, cette dernière se poursuit dans le fichier suivant. Cette valeur doit toujours être supérieure à la taille minimale. |
-s |
(Facultatif) Lance un nouveau journal de transactions individuelles Lance un nouveau journal de transactions individuelles à la fin de la transaction en cours. Le nouveau fichier est créé au début de la transaction suivante. |
| cancel | Annule toute opération de sauvegarde ou de restauration en cours. |
Aucune option n'est nécessaire. |