15.5 Utilisation de DSBK

DSBK est un analyseur de ligne de commande léger qui effectue une sauvegarde d'eDirectory et vous permet de lancer une sauvegarde à partir de la console du serveur sans avoir à vous connecter au préalable ni à configurer les services RBS. Il s'exécute en tant que script sous Linux et qu'utilitaire de console sous Windows.

Au terme d'une opération DSBK, les résultats sont écrits dans un fichier (dsbk.pipe sous Linux) dont vous pouvez programmer l'ouverture et l'affichage des résultats. Les quatre premiers octets de ce fichier contiennent les éventuels codes d'erreur générés pendant l'opération. En l'absence d'erreurs, ces quatre octets contiennent des zéros.

REMARQUE :Veillez à avoir pris connaissance de toutes les instructions fournies par NetIQ avant de finaliser la configuration de votre sauvegarde/restauration.

Avant d'exécuter des tâches de sauvegarde et de restauration, consultez la Liste de contrôle pour la sauvegarde 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 traite des sujets suivants :

15.5.1 Conditions préalables

  • Sous Linux, effectuez les opérations suivantes :

    1. Créez un fichier dsbk.conf dans /etc.

    2. Créez un fichier temporaire. Par exemple, /tmp/dsbk.tmp.

    3. Indiquez l'emplacement du fichier temporaire créé à l'étape précédente dans le fichier /etc/dsbk.conf.

  • Si vous prévoyez d'utiliser des fichiers journaux de transactions individuelles pour le serveur concerné, veillez à les activer avant d'effectuer une sauvegarde.

    Vous devez activer la fonction de consignation de transactions individuelles par fichier pour les serveurs faisant partie d'un anneau de répliques. Faute de quoi, des messages d'erreur s'afficheront lorsque vous tenterez de procéder à une restauration à partir des fichiers de sauvegarde et la base de données ne s'ouvrira 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 transaction individuelle avec DSBK.

  • Déterminez les autres fichiers à sauvegarder avec eDirectory et créez au besoin un fichier d'inclusion.

    Vous pouvez sauvegarder les fichiers de flux à l'aide de paramètres. Nous vous recommandons de sauvegarder systématiquement les fichiers NICI. Pour plus d'informations sur la sauvegarde de NICI, reportez-vous à la section Sauvegarde et restauration de NICI.

    Pour inclure d'autres fichiers, tels qu'autoexec.ncf, vous devez indiquer leurs noms et leurs chemins d'accès dans un fichier d'inclusion. Séparez les chemins d'accès et les noms de fichier par un point-virgule, sans inclure de retour chariot ni d'espace. Par exemple, sys:\system\autoexec.ncf;sys:\etc\hosts;.

  • Prévoyez d'effectuer une sauvegarde du système de fichiers peu après avoir sauvegardé eDirectory pour enregistrer les fichiers de sauvegarde d'eDirectory sur bande. L'outil de sauvegarde les enregistre uniquement sur le serveur.

    INDICATION :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, à l'aide de 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 %.

  • Consultez la description des options de la ligne de commande à la section Options de ligne de commande pour la sauvegarde et la restauration.

15.5.2 Utilisation de DSBK sur plusieurs plates-formes

Utilisation de DSBK sous Linux

La version Linux de DSBK exige un fichier de configuration. Le fichier de configuration contient une ligne unique qui pointe vers un autre fichier à créer et qui permet de transférer des commandes au module DSBK via l'utilitaire DSTrace.

Envisageons un exemple. Dans /etc/dsbk.conf, nous définissons une valeur de :

/tmp/dsbk.command

REMARQUE :assurez-vous que le propriétaire de l'instance dispose d'autorisations de lecture/écriture pour le fichier de commandes susmentionné.

Ce fichier est ensuite utilisé comme un intermédiaire pour le module DSBK.

Le résultat de la commande est écrit dans le fichier journal spécifique de l'instance eDirectory (instance par défaut : /var/opt/novell/eDirectory/log/ndsd.log) :

DSBK HELP
To get help on a specific function type "help <function name>"
 Current functions:
  backup
  restore
  restadv
  getconfig
  setconfig
  cancel

En configurant DSBK, les commandes peuvent être entrées dans un crontab pour exécuter régulièrement les commandes dsbk getconfig et dsbk backup, afin d'autoriser les sauvegardes complètes une fois par semaine et les sauvegardes incrémentielles les autres jours, ou toute autre combinaison souhaitée.

À l'aide des fichiers journaux de transaction individuelle (RFL) dans DSBK

  • Activez la fonctionnalité RFL à l'aide de la commande suivante :

    dsbk setconfig -L
    

    L'option -L démarre une nouvelle session de consignation de transactions individuelles par fichier.

  • Définissez un emplacement pour les fichiers journaux de transaction individuelle à créer à l'aide de la commande suivante :

    dsbk setconfig -L -r <roll forward log directory> 
    
  • Obtenez un emplacement pour les fichiers journaux de transaction individuelle à créer à l'aide de la commande suivante :

    dsbk getconfig 
    
  • Supprimez les anciens fichiers journaux du répertoire des fichiers journaux de transaction individuelle au cours d'une sauvegarde à l'aide de l'option - a :

    backup -f <file name> -l <file name> [-s <size>] [-u <file name>] [-e <password>] [-t] [-w] [-a]
    [-b|-i|-c] [-o] [-d] [--config-file <configuration file>]
    

INDICATION :lorsque vous utilisez l'utilitaire DSBK de manière interactive, ouvrez une seconde fenêtre de terminal en veillant à ce que tail -f <instance specific ndsd.log> soit en cours d'exécution, afin que le résultat des commandes saisies soit immédiatement lisible.

Une fois la sauvegarde effectuée, enregistrez-la à l'aide des utilitaires de sauvegarde du système de fichiers standard.

REMARQUE :pour plus d'informations sur les options de ligne de commande DSBK, reportez-vous à la section Options de ligne de commande pour la sauvegarde et la restauration.

Utilisation de DSBK sous Windows

Cette section décrit le fonctionnement de base de l'utilitaire DSBK sur la plate-forme Windows.

Pour utiliser DSBK sur un serveur Windows qui héberge eDirectory, procédez comme suit :

  1. Invoquez l'utilitaire via la console NetIQ eDirectory Services. dsbk.dlm est l'une des options disponibles dans la liste des services sous l'onglet Services. La sous-commande dsbk ainsi que tous les paramètres pour cette sous-commande sont spécifiés dans le champ Paramètres de démarrage.

  2. Affichez la configuration actuelle de la sauvegarde à l'aide du paramètre getconfig. Le résultat de toutes les commandes DSBK est annexé au fichier backup.out situé dans le dossier d'installation d'eDirectory sous Windows.

  3. Définissez un emplacement pour les fichiers journaux de transaction individuelle à créer à l'aide de la commande suivante :

    setconfig -r <roll forward log directory> -L
    

    L'option -L démarre une nouvelle session de consignation de transactions individuelles par fichier.

  4. Démarrez une sauvegarde de l'arborescence en entrant la commande suivante :

    backup -f <backup file> -l <logfile> -t -w -b -e <password>
    

    Utilisez les options suivantes :

    • -t : effectue une sauvegarde des fichiers de flux.

    • -w : remplace un fichier de sauvegarde existant portant le même nom.

    • -b : effectue une sauvegarde complète.

    • -e <mot_de_passe> : effectue une sauvegarde NICI à l'aide du mot de passe fourni.

    • -a : supprime les anciens fichiers journaux du répertoire des fichiers journaux de transaction individuelle au cours d'une sauvegarde continue à chaud.

    Par exemple, démarrez la sauvegarde comme suit :

    backup -f c:\dsbk.bak -l c:\backup.log -t -w -b -e novell
    

    Vous pouvez vérifier l'état de la sauvegarde effectuée dans le fichier backup.out.

    REMARQUE :pour plus d'informations sur les options de ligne de commande DSBK, reportez-vous à la section Options de ligne de commande pour la sauvegarde et la restauration.

Vous pouvez activer la fonctionnalité RFL à l'aide de la commande suivante :

setconfig -r <roll forward log directory> -L

15.5.3 Sauvegarde manuelle avec DSBK

DSBK 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.

DSBK permet d'effectuer plusieurs tâches, notamment :

  • effectuer une sauvegarde complète ou incrémentielle lorsque la base de données est ouverte (sauvegarde continue à chaud) ;

    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é.

  • effectuer une sauvegarde à froid (la base de données est fermée et une sauvegarde complète est créée) ;.

    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é à la section Mise à niveau du matériel ou remplacement d'un serveur).

  • paramétrer la base de données pour qu'elle reste fermée et verrouillée après une sauvegarde ;.

  • définir la taille maximale du fichier de sauvegarde.

Procédure

Pour sauvegarder la base de données eDirectory sur un serveur à l'aide de DSBK, procédez comme suit :

  1. Entrez la commande dsbk backup, en suivant le modèle général ci-dessous :

    dsbk backup -b -f nom_et_chemin_fichier_sauvegarde -l nom_et_chemin_fichier_sauvegarde -u nom_et_chemin_fichier_inclusion -t -w

    Chaque paramètre doit être délimité par un espace. L'ordre des paramètres n'a pas d'importance.

    Par exemple, sous Windows, entrez la commande suivante :

    dsbk backup -b -f c:\backups\8_20_2001.bak -l c:\backups\backup.log -u c:\backups\myincludefile.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 :

    • les fichiers mentionnés dans un fichier d'inclusion (-u c:\backups\mon_fichier_inclusion.txt) préalablement créé par l'administrateur ;

    • les fichiers de flux (-t).

    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, l'outil de sauvegarde le remplace.

    Le résultat est enregistré dans le fichier ndsd.log, lequel indique si la sauvegarde a réussi.

    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é. L'outil de sauvegarde les enregistre uniquement sur le serveur.

15.5.4 Automatisation de la sauvegarde d'eDirectory

Pour automatiser la sauvegarde d'eDirectory, enregistrez la commande suivante dans un fichier de traitement par lots :

dhostcon.exe 192.168.1.1 load dsbk backup -b -f <Backup File> -l <Log File> -t -w

Par exemple,

c:\novell\nds\dhostcon.exe 192.168.1.1 load dsbk backup -b -f edirbackup.bak -l c:\novell\edir-backup.log -t -w 

Enregistrez ce fichier à l'emplacement où vous avez installé eDirectory.

15.5.5 Configuration des fichiers journaux de transaction individuelle avec DSBK

DSBK permet de modifier les paramètres des fichiers journaux de transaction individuelle. Vous pouvez effectuer les tâches suivantes :

  • rechercher la configuration actuelle ;

  • activer ou désactiver la fonction de consignation de transactions individuelles par fichier ;

    Vous devez activer la fonction de consignation de transactions individuelles par fichier pour les serveurs faisant partie d'un anneau de répliques. Faute de quoi, des messages d'erreur s'afficheront lorsque vous tenterez de procéder à une restauration à partir des fichiers de sauvegarde et la base de données ne s'ouvrira pas.

  • modifier le répertoire des fichiers journaux de transactions individuelles ;

  • définir la taille minimale et maximale des fichiers journaux de transactions individuelles ;

  • rechercher le fichier journal de transaction individuelle actuel ainsi que le dernier fichier journal inutilisé ;

  • activer ou désactiver la consignation des fichiers de flux pour les fichiers journaux de transactions individuelles.

Pour plus d'informations sur la consignation de transactions individuelles par fichier, reportez-vous à la Section 15.3, Utilisation des fichiers journaux de transactions individuelles.

Procédure

  1. Recherchez la configuration actuelle en entrant

    dsbk 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 C:\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 ***
    
  2. Modifiez les paramètres à l'aide de la commande setconfig et suivez le modèle général ci-dessous :

    dsbk setconfig [-L|-l] [-T|-t] -r chemin_fichiers_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.

    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.

    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 un périphérique de stockage différents de ceux d'eDirectory. Le répertoire des fichiers journaux de transactions individuelles doit résider sur le serveur us 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 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. Reportez-vous à la section Sauvegarde et suppression des journaux de transactions individuelles.

15.5.6 Restauration à partir de fichiers de sauvegarde avec DSBK

DSBK 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. Les résultats de la restauration sont consignés dans le fichier journal que vous indiquez.

DSBK vous permet en outre d'utiliser des options de restauration avancées non disponibles dans iManager. Celles-ci sont présentées dans le tableau Options de ligne de commande pour la sauvegarde et la restauration, sous restore et restadv.

Conditions supplémentaires

  • Assurez-vous que eDirectory est installé et en service sur le serveur sur lequel vous effectuez la 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.

  • Consultez la description des options de la ligne de commande à la section Options de ligne de commande pour la sauvegarde et la restauration.

  • Consultez la description du processus de restauration à la section Présentation du processus de restauration avec l'outil de restauration.

Procédure

Pour restaurer une base de données eDirectory sur un serveur à l'aide de DSBK :

  1. Vérifiez que vous avez collecté les fichiers de sauvegarde nécessaires, comme expliqué à la Section 15.4, Préparation d'une restauration.

  2. Entrez la commande dsbk restore, en suivant le modèle général ci-dessous :

    dsbk restore -r -a -o -f chemin_et_nom_fichier_sauvegarde_complète -d emplacement_fichiers_journaux_transactions_individuelles -l chemin_et_nom_journal_restauration

    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 pour restaurer la base de données eDirectory proprement dite. Sinon, seuls les autres types de fichiers seront restaurés. Si vous souhaitez que la base de données soit ouverte et activée une fois la restauration terminée, veillez à spécifier les paramètres -a et -o.

    Si vous restaurez des fichiers journaux de transaction individuelle, 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 :

    dsbk restore -r -a -o -f $HOME/backup/nds.bak -d $HOME/backup/rfldir/nds.rfl -l $HOME/backup/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. 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 transaction individuelle et le paramètre -l, le fichier journal dans lequel les résultats de la restauration sont consignés.

    DSBK restaure la sauvegarde complète. Le résultat est enregistré dans le fichier ndsd.log, lequel indique si la restauration a réussi.

  3. (Conditionnel) Si la restauration échoue, consultez les erreurs dans le fichier journal.

    Si la vérification de la restauration échoue, reportez-vous à la Section 15.7, 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 d'eDirectory antérieure à 8.5, le journal de restauration indique l'erreur –666 (version DS incompatible) pour cette réplique.

  4. (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, puis restaurez DIB.

  5. Vérifiez que le serveur fonctionne normalement.

  6. (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 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 15.3, 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.

15.5.7 Options de ligne de commande pour la sauvegarde et la restauration

Les options de ligne de commande de l'outil de sauvegarde d'eDirectory 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

Nom et emplacement du fichier de sauvegarde que l'outil de sauvegarde doit créer. Ce fichier doit figurer sur le serveur que vous sauvegardez. Par exemple, la commande backup -f C:\backup\ndsbak.bak permet de sauvegarder la base de données dans C:\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 ne spécifiez 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 (;).

N'insérez pas d'espaces ni de retours 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.

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 vous risqueriez de l'altérer. La plupart des applications n'enregistrent pas les données binaires correctement.

-s taille_fichier

(Facultatif) Taille maximale du fichier de sauvegarde (Mo)

Taille maximale (en Mo) 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 à 10 Mo en utilisant les paramètres suivants dans la commande :backup -f C:\backup\mydib.bak -s 10. Si la taille de la base de données est de 35 Mo, vous obtenez les fichiers de sauvegarde suivants :

  • C:\backup\mydib.bak, dont la taille s'élève à 9,6 Mo
  • C:\backup\mydib.bak.00001, dont la taille s'élève à 9,6 Mo
  • C:\backup\mydib.bak.00002, dont la taille s'élève à 9,6 Mo
  • C:\backup\mydib.bak.00003, dont la taille s'élève à 5,6 Mo

La plus petite taille possible est d'environ 1 Mo. Le premier fichier peut être plus volumineux, selon le nombre de fichiers inclus dans la sauvegarde.

Le premier fichier contient, sous l'étiquette backup, un attribut nommé number_of_files. Il s'agit du nombre total de fichiers qui composent le jeu de sauvegarde. Dans l'exemple ci-dessus, ce nombre s'élèverait à 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 C:/backup/mydib.bak -l chemin_et_nom_du_fichier_journal

L'outil de sauvegarde 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.

INDICATION :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 spécifié avec le paramètre -f si un fichier du même nom existe déjà. En mode interactif, si cette option n'est pas utilisée et qu'un fichier du même nom existe déjà, l'outil de sauvegarde vous demande si vous souhaitez écraser ce fichier. En mode de traitement par lots, s'il existe un fichier du même nom et que 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 d'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 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 écraser le fichier de sauvegarde existant.

En mode de traitement par lots, s'il existe un fichier du même nom et que 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 ne spécifiez pas le paramètre -w, DSBK 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 effectuée, la base de données est rouverte, sauf si les paramètres -o ou -o et -d sont spécifiés.

-o

(Facultatif) Laisser la base de données fermée après la sauvegarde à froid

Ce paramètre 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é à la Section 19.4, Mise à niveau du matériel ou remplacement d'un serveur).

-d

(Facultatif) Désactiver l'agent DS après la sauvegarde à froid

Ce paramètre 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é à la Section 19.4, Mise à niveau du matériel ou remplacement d'un serveur).

Pour désactiver l'agent DS, l'attribut connexion désactivée doit être paramétré sur le pseudo-serveur. Cela aura pour conséquence l'apparition de l'erreur -663 au démarrage d'eDirectory.

-e mot_de_passe

Effectuer une sauvegarde de NICI

mot_de_passe correspond au mot de passe à utiliser pour sauvegarder NICI. Ce même mot de passe doit être spécifié pour restaurer les fichiers NICI.

--config-file fichier_configuration

(Facultatif) Permet de spécifier l'instance d'eDirectory à sauvegarder.

fichier_configuration correspond au chemin absolu du fichier de configuration de l'instance d'eDirectory à sauvegarder. Par exemple :

--config-file /etc/opt/novell/eDirectory/conf/nds.conf

Ce paramètre s'applique uniquement aux environnements Linux.

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, la commande restore -f C:/backup/ndsbak.bak permet d'effectuer la restauration à partir du fichier C:/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.

AVERTISSEMENT :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é, l'outil de sauvegarde ne réapplique aucune modification, même si la consignation de transaction individuelle par fichier était activée au moment de la sauvegarde.

Pour identifier le premier fichier journal 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 à appliquer 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.

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 vous risqueriez de l'altérer. La plupart des applications n'enregistrent pas les données binaires correctement.

-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 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 l'outil de restauration.

-o

(Facultatif) Ouvrir la base de données à la fin de l'opération

Ce paramètre indique à l'outil de sauvegarde d'ouvrir la base de données une fois l'opération terminé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 l'outil de restauration.

-s

Ce paramètre indique à l'outil de sauvegarde de ne pas réinitialiser le fichier journal de transaction individuelle une fois la restauration terminée. Il est principalement utilisé lorsque les fichiers RFL se trouvent à l'emplacement par défaut.

-n

(Facultatif) Ne pas vérifier la base de données après la restauration

Ce paramètre indique à l'outil de sauvegarde de restaurer la base de données sans effectuer de vérification. Le vecteur de transition de ce 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 NetIQ.

-v

(Facultatif) Remplacer 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 technique de NetIQ.

-k

(Facultatif) Supprimer le verrouillage de la base de données

Supprime le verrouillage de la base de données NDS.

-i

Liste de fichiers incrémentiels classés dans l'ordre et séparés par des virgules.

-e mot_de_passe

Restaurer les fichiers NICI sauvegardés

mot_de_passe correspond au mot de passe qui a été utilisé lorsque les fichiers NICI ont été sauvegardés. Si vous spécifiez un mot de passe erroné alors que vous tentez de restaurer les fichiers NICI, un message d'erreur s'affiche.

--config-file fichier_configuration

(Facultatif) Permet de spécifier l'instance d'eDirectory à restaurer.

fichier_configuration correspond au chemin absolu du fichier de configuration de l'instance d'eDirectory à restaurer. Par exemple :

--config-file /etc/opt/novell/eDirectory/conf/nds.conf

Ce paramètre s'applique uniquement aux environnements Linux.

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

Ce paramètre indique à l'outil de sauvegarde d'ouvrir la base de données une fois l'opération terminé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 l'outil de restauration.

-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 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 technique de NetIQ.

-k

(Facultatif) Supprimer le verrouillage de la base de données

Supprime le verrouillage de la base de données NDS.

-i

Liste de fichiers incrémentiels classés dans l'ordre et séparés par des virgules.

IMPORTANT :cette option ne s'applique qu'à DSBK.

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
Stream file logging status OFF
Current roll forward log directory C:\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 ***

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 rendre à un serveur 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 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. Reportez-vous à la section Sauvegarde et suppression des journaux de transactions individuelles.

Pour plus d'informations, reportez-vous à la Section 15.3, 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 être en mesure d'effectuer une restauration complète.

Pour plus d'informations, reportez-vous à la Section 15.3, 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 connexion en sont un 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 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 ne changent pas fréquemment.

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 transaction individuelle 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 transaction individuelle devient vol2:\rfl\nd1.rfl\.

Vous pouvez trouver l'emplacement actuel des journaux en entrant 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 modifications apportées au répertoire des fichiers journaux de transaction individuelle. 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 15.3, Utilisation des fichiers journaux de transactions individuelles.

-n

(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.

REMARQUE :cette option ne s'applique pas à DSBK.

--config-file fichier_configuration

(Facultatif) Permet de spécifier l'instance d'eDirectory pour laquelle vous souhaitez définir la configuration des fichiers journaux de transaction individuelle.

fichier_configuration correspond au chemin absolu du fichier de configuration de l'instance eDirectory pour laquelle vous souhaitez définir la configuration des fichiers journaux de transaction individuelle. Par exemple :

--config-file /etc/opt/novell/eDirectory/conf/nds.conf

Ce paramètre s'applique uniquement aux environnements Linux.

15.5.8 Exécution de DSBK en tant que tâche cron

Le script dsbk ne contient pas le chemin complet du fichier binaire DSTrace. Par conséquent, si vous exécutez le script en tant que tâche cron en utilisant les paramètres par défaut, le script échoue. Toutefois, ne modifiez pas le script /opt/novell/eDirectory/bin/dsbk pour ajouter le chemin d'accès, car les correctifs d'eDirectory qui seront appliqués par la suite écraseront ce fichier et annuleront toutes les modifications apportées au script.

Avant d'exécuter dsbk comme une tâche cron, définissez plutôt la variable d'environnement PATH du fichier crontab de manière à inclure le répertoire dans lequel se trouve ndstrace. La tâche cron peut alors localiser et exécuter l'application ndstrace.