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.
Étant donné que le client eMBox peut être exécuté en mode de traitement par lots, vous pouvez 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 aux sections 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, consultez la Liste de contrôle pour la sauvegarde de eDirectory pour une vue d'ensemble des éléments à considérer lors de la préparation d'une stratégie de sauvegarde efficace pour eDirectory.
Cette section fournit les informations suivantes :
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. Les résultats de la sauvegarde sont consignés dans le fichier journal que vous indiquez.
Avant d'exécuter des tâches de sauvegarde et de restauration, consultez la Liste de contrôle pour la sauvegarde de eDirectory pour une vue d'ensemble des éléments à considérer 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 néanmoins une sauvegarde complète, image fidèle de l'état de la base au début de la sauvegarde.
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 la section Mise à niveau du matériel ou remplacement d'un serveur).
Pour exécuter ces tâches sans surveillance, reportez-vous à la section 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.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 à la section Utilisation du client à ligne de commande eMBox.
Vous devez activer la fonction de consignation de transactions individuelles par fichier pour les serveurs faisant 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 fichiers journaux de transactions individuelles, reportez-vous à la section Utilisation des fichiers journaux de transactions individuelles. Pour savoir comment les activer, reportez-vous à la section Configuration des fichiers journaux de transactions individuelles à l'aide du client eMBox.
Vous pouvez sauvegarder les fichiers NICI et 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 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;).
HINT: pour faciliter le transfert des fichiers de sauvegarde sur un autre périphérique 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 utiliser un logiciel tiers pour les compresser après leur création. Le taux de compression atteint environ 80 %.
Pour plus d'informations, reportez-vous à la section Rétrocompatibilité du processus de vérification de la restauration avec eDirectory 8.5 et 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 expliqué dans la section Configuration 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 à sauvegarder. Pour ce faire, entrez
login -s nom_serveur_ou_adresse_IP -p numéro_port -u nom_utilisateur.contexte -w mot_de_passe
Par exemple, sous Windows, vous entrez
login -s 151.155.111.1 -p 8009 -u admin.ma_société -w mon_mot_de_passe
Si un message d'erreur indique qu'il est impossible d'établir une connexion sécurisée, vérifiez si votre machine possède les fichiers JSSE listés à la section Établissement d'une connexion sécurisée avec le client eMBox.
Pour savoir quel numéro de port utiliser, reportez-vous à la section Recherche des numéros de port eDirectory.
Le client eMBox indique si le login a réussi.
Entrez la commande de sauvegarde à 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 -t -w
Les paramètres doivent être séparés les uns des autres par un espace. L'ordre des paramètres n'a pas d'importance.
Par exemple, sous Windows, vous entrez
backup -b -f c:\backups\8_20_2001.bak -l c:\backups\backup.log -u c:\backups\mon_fichier_inclusion.txt -t -w
Cet exemple de commande permet d'effectuer une sauvegarde complète (-b), le fichier de sauvegarde étant enregistré sous c:\ backups\8_20_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, si un fichier portant le même nom existe, 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 en entrant la commande suivante :
exit
Veillez à effectuer une sauvegarde du système de fichiers peu après avoir sauvegardé eDirectory, afin d'enregistrer les fichiers de sauvegarde sur bande par mesure de sécurité. (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 à la section Exécution du client à ligne de commande eMBox en mode de traitement par lots.
La procédure ci-dessous met en oeuvre un fichier système de traitement par lots.
NOTE: sous NetWare, vous pouvez utiliser un logiciel de planification tiers ou cron.nlm, disponible sur le site Web du support 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 à la section Utilisation du client à ligne de commande eMBox.
Vous devez activer la fonction de consignation de transactions individuelles par fichier pour les serveurs faisant 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 fichiers journaux de transactions individuelles, reportez-vous à la section Utilisation des fichiers journaux de transactions individuelles. Pour savoir comment les activer, reportez-vous à la section Configuration des fichiers journaux de transactions individuelles à l'aide du client eMBox.
Vous pouvez sauvegarder les fichiers NICI et 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 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;).
HINT: pour faciliter le transfert des fichiers de sauvegarde eDirectory sur un autre périphérique de stockage, vous pouvez spécifier la taille maximale de ces fichiers. Vous pouvez également utiliser un logiciel tiers pour les compresser après leur création. 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 nom_utilisateur.contexte -w mot_de_passe -t backup.backup -b -f nom_et_chemin_fichier_de_sauvegarde -l nom_et_chemin_fichier_journal_sauvegarde -u nom_et_chemin_fichier_inclusion -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 nom_utilisateur.contexte -w mot_de_passe -t backup.backup -b -f nom_et_chemin_fichier_de_sauvegarde -l nom_et_chemin_fichier_journal_sauvegarde -u nom_et_chemin_fichier_inclusion -t -w
Pour obtenir des exemples et des explications supplémentaires, reportez-vous à la section 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 à la section Recherche des numéros de port eDirectory. Si vous voulez utiliser une connexion sécurisée, reportez-vous à la section Établissement d'une connexion sécurisée avec le client eMBox. Pour plus d'informations sur l'utilisation d'un fichier de traitement par lots propre au client eMBox, reportez-vous à la section 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 d'enregistrer les fichiers de sauvegarde de eDirectory sur bande par mesure de sécurité.
Backup eMTool les place uniquement sur le serveur.
Vérifiez périodiquement les résultats consignés dans le fichier journal que vous avez spécifié, pour vous assurer de la réussite des sauvegardes sans surveillance.
Voici deux exemples :
java -nsac -cp sys:\system\embox\eMBoxClient.jar embox -s 10.10.1.200 -p 8008 -u admin.mon_conteneur -w mon_mot_de_passe -n -t backup.backup -b -f sys:\system\backup\backup.bak -l sys:\system\backup\backup.log -u sys:\system\backup\fichier_inclusion.txt -t -w
Les options suivantes figurent dans cet exemple de fichier de traitement par lots.
WARNING: 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 par lots est exécuté sans surveillance.
IMPORTANT: si un fichier de sauvegarde portant le même nom existe déjà (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, si un fichier du même nom existe 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 souhaitez é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 mon_serveur -p 8008 -u admin.mon_org -w mon_mot_de_passe -n -t backup.backup -b -f c:\backup\backup.bak -u c:\backup\includes\fichier_inclusion.txt -l c:\backup\backup.log -e -t -w
Les options suivantes figurent dans cet exemple de fichier de traitement par lots.
IMPORTANT: si un fichier de sauvegarde portant le même nom existe déjà (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, si un fichier du même nom existe 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 souhaitez é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.
NOTE: 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 fichiers 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 faisant 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 à la section Utilisation des fichiers 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 à la section 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 expliqué dans la section 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 nom_utilisateur.contexte -w mot_de_passe
Par exemple, sous Windows, vous entrez
login -s 151.155.111.1 -p 8009 -u admin.ma_société -w mon_mot_de_passe
Si un message d'erreur indique qu'il est impossible d'établir une connexion sécurisée, vérifiez si votre machine possède les fichiers JSSE listés à la section Établissement d'une connexion sécurisée avec le client eMBox.
Pour savoir quel numéro de port utiliser, reportez-vous à la section 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_fichiers_journaux_transactions_individuelles -n taille_minimale_fichier -m taille_maximale_fichier
Les paramètres doivent être séparés les uns des autres 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 fichiers journaux sont enregistrés dans rflvolume:\logs. (En principe, vous devriez réserver un volume/une partition de disque à ces fichiers 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.
WARNING: 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 un périphérique de stockage différents de ceux de eDirectory. Le répertoire des fichiers 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 fichiers journaux de transactions individuelles. Si vous ne le surveillez pas, le répertoire des fichiers journaux s'étend jusqu'à saturer le volume/la partition de disque. Si ces fichiers 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 fichiers journaux de transactions individuelles inutilisés. Pour plus de détails, reportez-vous à la section Sauvegarde et suppression des fichiers journaux de transactions individuelles.
Déloguez-vous du serveur. Pour ce faire, entrez la commande suivante :
logout
Quittez le client eMBox en entrant la commande suivante :
exit
Le client eMBox vous permet de 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. Les résultats de la restauration sont consignés dans le fichier journal que vous indiquez.
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 à la section 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 à la section Utilisation du client à ligne de commande eMBox.
Reportez-vous aux sections 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'un périphérique de stockage, vous devez réinstaller eDirectory sur le nouveau périphérique. 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, procédez comme suit :
Vérifiez que vous avez collecté les fichiers de sauvegarde nécessaires, comme expliqué dans la section 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 expliqué dans la section 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 à restaurer. Pour ce faire, entrez
login -s nom_serveur_ou_adresse_IP -p numéro_port -u nom_utilisateur.contexte -w mot_de_passe
Par exemple, sous Windows, vous entrez
login -s 151.155.111.1 -p 8009 -u admin.ma_société -w mon_mot_de_passe
Si un message d'erreur indique qu'il est impossible d'établir une connexion sécurisée, vérifiez si votre machine possède les fichiers JSSE listés à la section Établissement d'une connexion sécurisée avec le client eMBox.
Pour savoir quel numéro de port utiliser, reportez-vous à la section Recherche des numéros de port eDirectory.
Le client eMBox indique si le login a réussi.
Entrez la commande de restauration à 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_fichiers_journaux_transactions_individuelles -l chemin_et_nom_de_fichier_journal_de_restauration
Les paramètres doivent être séparés les uns des autres 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 proprement dite ; sinon, seuls les autres types de fichiers sont restaurés. Si vous souhaitez qu'à la fin de la restauration, la base de données soit ouverte et active, veillez à spécifier les paramètres -a et -o.
Si vous restaurez des fichiers journaux de transactions individuelles, veillez à inclure leur chemin d'accès complet, y compris le répertoire créé automatiquement par eDirectory, généralement dénommé \nds.rfl. (Pour plus d'informations sur ce répertoire, reportez-vous à la section Emplacement des fichiers 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
Cet exemple de commande indique que la base de données proprement dite 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 fichiers journaux de transactions individuelles et le paramètre -l, le fichier journal dans lequel les résultats de la restauration sont consignés.
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 à la section Récupération de la base de données en cas d'échec de la vérification de la restauration.
NOTE: si le serveur que vous restaurez partage une réplique avec un serveur qui exécute une version de eDirectory antérieure à 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 à la section Rétrocompatibilité du processus de vérification de la restauration avec eDirectory 8.5 et versions ultérieures uniquement.
Déloguez-vous du serveur. Pour ce faire, entrez la commande suivante :
logout
Quittez le client eMBox en entrant la commande suivante :
exit
(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 fichiers journaux sont enregistrés dans un emplacement assurant la tolérance aux pannes. Après avoir activé les fichiers 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 consignation de transactions individuelles par fichier reprend sa configuration par défaut, autrement dit elle est désactivée et l'emplacement par défaut est rétabli. Vous devez effectuer une 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 journaux de transactions individuelles et leur emplacement, reportez-vous à la section Utilisation des fichiers journaux de transactions individuelles.
La restauration est à présent terminé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) Nom et chemin d'accès 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) Nom et chemin d'accès du fichier journal Indique le fichier journal dans lequel consigner les résultats de la sauvegarde. |
-b |
(Facultatif) Effectuer une sauvegarde complète Effectue une sauvegarde complète de la base de données eDirectory. Il s'agit de l'option par défaut. Si vous n'indiquez ni -i ni -c, une sauvegarde complète est effectuée. |
-i |
(Facultatif) Effectuer une sauvegarde incrémentielle Effectue 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. |
-t |
(Facultatif) Sauvegarder les fichiers de flux Inclut les fichiers de flux lors de la sauvegarde de la base de données eDirectory. |
-u nom_fichier |
(Facultatif) Nom et chemin d'accès du fichier d'inclusion utilisateur 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, en tant qu'administrateur, vous souhaitez 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 fichier journal de sauvegarde ou l'en-tête du fichier de sauvegarde. (Reportez-vous aux sections Format du fichier journal de sauvegarde et Format de l'en-tête des fichiers de sauvegarde.) WARNING: 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 limite des fichiers 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 taille de la base de données est de 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 à la section Format de l'en-tête des fichiers de sauvegarde.) Pour restaurer un ensemble de fichiers de sauvegarde comme dans l'exemple ci-dessus, la commande est la suivante : restore -f vol1:/backup/mydib.bak -l chemin_et_nom_du_fichier_journal Backup eMTool identifie la présence de plusieurs fichiers et les recherche dans le même répertoire que le premier, mais prend en compte les modifications de nom indiquées plus haut. HINT: en utilisant un logiciel de compression tiers, vous pouvez également réduire considérablement la taille des fichiers de sauvegarde. Le taux de compression atteint environ 80 %. |
-w |
(Facultatif) Écraser 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 souhaitez écraser ce fichier (en mode interactif). En mode de traitement par lots, si un fichier du même nom existe déjà 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. si un fichier de sauvegarde portant le même nom existe déjà (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, si un fichier du même nom existe 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 souhaitez écraser le fichier.) |
-c |
(Facultatif) Effectuer 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) Laisser la base de données fermée après la 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 la section Mise à niveau du matériel ou remplacement d'un serveur). |
-d |
(Facultatif) Désactiver l'agent DS après la sauvegarde à froid Ne peut être utilisé que si les paramètres -c et -o sont également spécifiés. 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 la section 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) Nom et chemin d'accès 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 du jeu doivent être copiés dans le même répertoire du serveur. |
-l nom_fichier |
(Obligatoire) Nom et chemin d'accès du fichier journal Indique le fichier journal dans lequel consigner les résultats de la restauration. |
-r |
(Facultatif) Restaurer l'ensemble DIB Indique que la base de données eDirectory doit être restaurée. WARNING: si cette option n'est pas définie, la base de données eDirectory proprement dite n'est pas restaurée. Seuls les autres types de fichiers spécifiés seront restaurés. |
-d nom_rép |
(Facultatif) Répertoire des fichiers journaux de transactions individuelles Indique le répertoire où sont stockés les fichiers 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 fichiers 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 fichiers 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 transaction individuelle 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 de sauvegarde complète 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 à la section Format de l'en-tête des fichiers de sauvegarde.) WARNING: 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. |
-u |
(Facultatif) Restaurer les fichiers 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 le définir comme fichier d'inclusion utilisateur. Les fichiers concernés ne peuvent être restaurés que s'ils ont été inclus dans la sauvegarde. |
-a |
(Facultatif) Activer DIB après vérification Renomme la base de données RST en NDS une fois la restauration correctement vérifiée. (Pour obtenir une vue d'ensemble du processus, reportez-vous à la section Présentation du processus de restauration avec Backup eMTool.) |
-o |
(Facultatif) Ouvrir la base de données à la fin de l'opération 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 à la section Présentation du processus de restauration avec Backup eMTool.) |
-n |
(Facultatif) Ne pas vérifier la base de données après 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 il fait partie. (Pour plus d'informations sur les vecteurs de transition, reportez-vous à la section Vecteurs de transition et processus de vérification de la restauration). La base de données RST n'est pas renommée en NDS, sauf si une autre option est définie à cet effet. IMPORTANT: nous vous recommandons de ne pas utiliser cette option à moins d'y être invité par le support technique de Novell. |
-v |
(Facultatif) Remplacer la restauration Renomme la base de données RST en NDS sans tenter de vérification. IMPORTANT: nous vous recommandons de ne pas utiliser cette option à moins d'y être invité par le support technique de Novell. |
-k |
(Facultatif) Supprimer 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) Nom et chemin d'accès du fichier journal Indique le fichier journal dans lequel consigner les résultats de la restauration. |
-o |
(Facultatif) Ouvrir la base de données à la fin de l'opération 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 à la section Présentation du processus de restauration avec Backup eMTool.) |
-n |
(Facultatif) Tenter de vérifier une restauration qui a précédemment échoué Tente de vérifier une base de données RST restaurée précédemment. |
-m |
(Facultatif) Supprimer les fichiers DIB restaurés Supprime la base de données RST éventuellement présente. |
-v |
(Facultatif) Remplacer la restauration Renomme la base de données RST en NDS sans tenter de vérification. IMPORTANT: nous vous recommandons de ne pas utiliser cette option à moins d'y être invité par le support technique de Novell. |
-k |
(Facultatif) Supprimer 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 fichiers 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 fichiers journaux de transactions individuelles. |
-L |
(Facultatif) Début de l'enregistrement des fichiers journaux de transactions individuelles Active la consignation de transactions individuelles par fichier (désactivée par défaut). La consignation continue de transactions individuelles par fichier vous permet de rendre à un serveur l'état qu'il avait avant son arrêt, plutôt que 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 de transactions individuelles par fichier a été activée. Si vous ne les surveillez pas, les fichiers journaux de transactions individuelles s'étendent jusqu'au point de saturer le volume/la partition de disque. Si ces fichiers 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 fichiers journaux inutilisés. Pour plus de détails, reportez-vous à la section Sauvegarde et suppression des fichiers journaux de transactions individuelles. Pour plus d'informations, reportez-vous à la section Utilisation des fichiers journaux de transactions individuelles. |
-l |
(Facultatif) Arrêt de l'enregistrement des fichiers 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 fichier journal de transaction individuelle actuel, au lieu d'enregistrer un ensemble de fichiers 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 pouvoir effectuer une restauration complète. Pour plus d'informations, reportez-vous à la section Utilisation des fichiers journaux de transactions individuelles. |
-T |
(Facultatif) Début du chargement 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 fichier 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 fichiers 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 fichiers journaux de transactions individuelles. Si ces fichiers journaux ne peuvent pas être créés par manque d'espace disque, eDirectory cesse de fonctionner sur le serveur concerné. |
-t |
(Facultatif) Arrêt de l'enregistrement des fichiers de flux Arrête la copie du fichier de flux entier dans le fichier journal de transaction individuelle 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. Si vous désactivez la consignation des fichiers de flux, la taille des fichiers journaux de transactions individuelles augmentera moins rapidement. |
-r nom_rép |
(Facultatif) Définition du répertoire du fichier journal de transaction individuelle Modifie le répertoire où sont stockés les fichiers 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 fichiers journaux de transactions individuelles y sont enregistré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, il s'agit de « 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 journaux de transactions individuelles devient vol2:\rfl\nd1.rfl\. Vous pouvez trouver l'emplacement actuel des fichiers journaux à l'aide de la commande getconfig. Le répertoire est créé immédiatement après le changement d'emplacement, mais aucun fichier 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 fichiers journaux de transactions individuelles. Lorsque vous restaurez la base de données, vous devez collecter tous les fichiers journaux de transactions individuelles sur le serveur, dans un même répertoire. Pour plus d'informations, reportez-vous à la section Utilisation des fichiers journaux de transactions individuelles. |
-n taille_fichier |
(Facultatif) Définition de la taille minimale du fichier journal de transaction individuelle Définit la taille minimale des fichiers journaux de transactions individuelles (en octets). Lorsque la taille minimale est atteinte, la base de données commence un nouveau fichier journal de transaction individuelle dès que la transaction en cours est terminée. |
-m taille_fichier |
(Facultatif) Définition de la taille maximale du fichier journal de transaction individuelle Définit la taille maximale des fichiers journaux de 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) Création d'un nouveau fichier journal de transaction individuelle Lance un nouveau fichier journal de transaction individuelle à 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. |