Variables d'environnement prises en charge par ONTAP
Les variables d'environnement servent à communiquer des informations sur une opération de sauvegarde ou de restauration entre une application de sauvegarde NDMP et un système de stockage. ONTAP prend en charge les variables d'environnement qui ont une valeur par défaut associée. Toutefois, vous pouvez modifier manuellement ces valeurs par défaut.
Si vous modifiez manuellement les valeurs définies par l'application de sauvegarde, il se peut que l'application se comporte de façon imprévisible. En effet, les opérations de sauvegarde ou de restauration ne peuvent pas faire ce que l'application de sauvegarde attend d'elles. Mais dans certains cas, une modification judicieuse pourrait aider à identifier ou à gérer des problèmes.
Les tableaux ci-dessous répertorient les variables d'environnement dont le comportement est commun à dump et SMTape, ainsi que les variables prises en charge uniquement pour dump et SMTape. Ces tableaux contiennent également des descriptions du fonctionnement des variables d'environnement prises en charge par ONTAP, le cas échéant :
Dans la plupart des cas, les variables qui ont la valeur, |
Variables d'environnement prises en charge pour dump et SMTape
Variable d'environnement | Valeurs valides | Valeur par défaut | Description |
---|---|---|---|
DÉBOGAGE |
|
|
Spécifie que les informations de débogage sont imprimées. |
SYSTÈME DE FICHIERS |
|
|
Indique le chemin d'accès de la racine des données en cours de sauvegarde. |
NDMP_VERSION |
|
|
Vous ne devez pas modifier la variable NDMP_VERSION. Créée par l'opération de sauvegarde, la variable NDMP_VERSION renvoie la version NDMP. ONTAP définit la variable NDMP_VERSION lors d'une sauvegarde à des fins d'utilisation interne et de la transmission à une application de sauvegarde à titre d'information. La version NDMP d'une session NDMP n'est pas définie avec cette variable. |
SÉPARATEUR_CHEMIN |
|
|
Spécifie le caractère séparateur de nom de chemin d'accès. Ce caractère dépend du système de fichiers à sauvegarder. Pour ONTAP, le caractère “/” est attribué à cette variable. Le serveur NDMP définit cette variable avant de démarrer une opération de sauvegarde sur bande. |
TYPE |
|
|
Indique le type de sauvegarde pris en charge pour effectuer des opérations de sauvegarde et de restauration sur bande. |
PROLIXE |
|
|
Augmente les messages du journal lors de l'exécution d'une opération de sauvegarde sur bande ou de restauration. |
Variables d'environnement prises en charge pour dump
Variable d'environnement | Valeurs valides | Valeur par défaut | Description | ||
---|---|---|---|---|---|
ACL_START |
|
|
Créée par l'opération de sauvegarde, la variable ACL_START est une valeur de décalage utilisée par une opération de restauration à accès direct ou de sauvegarde NDMP redémarrable. La valeur de décalage est le décalage d'octet dans le fichier de vidage où les données ACL (Pass V) commencent et sont renvoyées à la fin d'une sauvegarde. Pour qu'une opération de restauration d'accès direct restaure correctement les données sauvegardées, la valeur ACL_START doit être transmise à l'opération de restauration lorsqu'elle démarre. Une opération de sauvegarde NDMP redémarrable utilise la valeur ACL_START pour communiquer à l'application de sauvegarde où la partie non redémarrable du flux de sauvegarde commence. |
||
DATE_DE_BASE |
|
|
Spécifie la date de début des sauvegardes incrémentielles. Lorsqu'il est réglé sur Ces variables constituent une alternative aux sauvegardes incrémentielles BASÉES SUR LE NIVEAU/MISE À JOUR. |
||
DIRECTE |
|
|
Indique qu'une restauration doit être envoyée rapidement vers l'emplacement de la bande sur lequel se trouvent les données du fichier au lieu d'analyser la bande entière. Pour que la restauration puisse fonctionner, l'application de sauvegarde doit fournir des informations de positionnement. Si cette variable est définie sur |
||
NOM_DMP |
|
|
Indique le nom d'une sauvegarde de plusieurs sous-arborescences. Cette variable est obligatoire pour les sauvegardes de plusieurs sous-arborescences. |
||
DUMP_DATE |
|
|
Vous ne modifiez pas cette variable directement. Elle est créée par la sauvegarde si la variable BASE_DATE est définie sur une valeur autre que La variable DUMP_DATE est dérivée par la préattente de la valeur de niveau 32 bits vers une valeur de temps de 32 bits calculée par le logiciel dump. Le niveau est incrémenté à partir de la valeur du dernier niveau passée dans la variable BASE_DATE. La valeur obtenue est utilisée comme valeur BASE_DATE sur une sauvegarde incrémentielle ultérieure. |
||
ENHANCED_DAR_ENABLED |
|
|
Indique si la fonctionnalité DAR améliorée est activée. La fonctionnalité DAR améliorée prend en charge les fichiers de DAR et DAR avec les flux NT. Elle permet d'améliorer les performances. La DAR améliorée pendant la restauration n'est possible que si les conditions suivantes sont remplies :
|
||
EXCLURE |
|
|
Spécifie les fichiers ou les répertoires qui sont exclus lors de la sauvegarde des données. La liste d'exclusion est une liste séparée par des virgules de noms de fichier ou de répertoire. Si le nom d'un fichier ou d'un répertoire correspond à l'un des noms de la liste, il est exclu de la sauvegarde. Les règles suivantes s'appliquent lors de la spécification de noms dans la liste d'exclusion :
|
||
EXTRAIRE |
|
|
Indique que les sous-arborescences d'un ensemble de données sauvegardées doivent être restaurées. L'application de sauvegarde spécifie les noms des sous-arborescences à extraire. Si un fichier spécifié correspond à un répertoire dont le contenu a été sauvegardé, le répertoire est extrait de façon récursive. Pour renommer un fichier, un répertoire ou un qtree pendant la restauration sans utiliser DAR, vous devez définir la variable d'environnement D'EXTRACTION sur |
||
EXTRAIRE_ACL |
|
|
Spécifie que les listes de contrôle d'accès du fichier sauvegardé sont restaurées lors d'une opération de restauration. La valeur par défaut est de restaurer les listes de contrôle d’accès lors de la restauration des données, à l’exception de DDARS (DIRECT=y). |
||
DE FORCE |
|
|
Détermine si l'opération de restauration doit vérifier l'espace du volume et la disponibilité des inode sur le volume de destination. Réglage de cette variable sur Si un espace volume suffisant ou des inodes ne sont pas disponibles sur le volume de destination, l'opération de restauration récupère autant de données que l'espace du volume de destination et la disponibilité d'inodes. L'opération de restauration s'arrête lorsque l'espace de volume ou les inodes ne sont pas disponibles. |
||
HIST |
|
|
Indique que les informations de l'historique des fichiers sont envoyées à l'application de sauvegarde. La plupart des applications de sauvegarde commerciales définissent la variable HIST sur
|
||
IGNORE_CTIME |
|
|
Spécifie qu'un fichier n'est pas sauvegardé de façon incrémentielle si seule sa valeur de temps de restauration a changé depuis la sauvegarde incrémentielle précédente. Certaines applications, telles que les logiciels d'analyse antivirus, modifient la valeur de temps de lecture d'un fichier au sein de l'inode, même si le fichier ou ses attributs n'ont pas changé. Par conséquent, une sauvegarde incrémentielle peut sauvegarder des fichiers qui n'ont pas été modifiés. Le
|
||
IGNORE_QTREES |
|
|
Spécifie que l'opération de restauration ne restaure pas les informations qtree à partir de qtrees sauvegardés. |
||
NIVEAU |
|
|
Spécifie le niveau de sauvegarde. Le niveau 0 copie l'ensemble du jeu de données. Les niveaux de sauvegarde incrémentielle, spécifiés par les valeurs supérieures à 0, copient tous les fichiers (nouveaux ou modifiés) depuis la dernière sauvegarde incrémentielle. Par exemple, un niveau 1 sauvegarde les fichiers nouveaux ou modifiés depuis la sauvegarde de niveau 0, un niveau 2 sauvegarde les fichiers nouveaux ou modifiés depuis la sauvegarde de niveau 1, etc. |
||
LISTE |
|
|
Répertorie les noms de fichiers sauvegardés et les numéros d'inode sans restaurer les données. |
||
LISTE_QTREE |
|
|
Le répertorie les qtrees sauvegardés sans réellement restaurer les données. |
||
NOMS_DE_SOUS-ARBRE_MULTIPLES |
|
|
Indique que la sauvegarde est une sauvegarde à plusieurs sous-arborescences. Plusieurs sous-arborescences sont spécifiées dans la chaîne, qui est une liste de noms de sous-arborescences séparées par une nouvelle ligne et comportant des valeurs NULL. Les sous-arbres sont spécifiés par des noms de chemin par rapport à leur répertoire racine commun, qui doivent être spécifiés comme dernier élément de la liste. Si vous utilisez cette variable, vous devez également utiliser la variable DMP_NAME. |
||
NDMP_UNICODE_ FH |
|
|
Indique qu'un nom Unicode est inclus en plus du nom NFS du fichier dans les informations de l'historique des fichiers. Cette option n'est pas utilisée par la plupart des applications de sauvegarde et ne doit pas être définie sauf si l'application de sauvegarde est conçue pour recevoir ces noms de fichiers supplémentaires. La variable HIST doit également être définie. |
||
NO_ACL |
|
|
Spécifie que les listes de contrôle d'accès ne doivent pas être copiées lors de la sauvegarde des données. |
||
NON_QUOTA_TREE |
|
|
Spécifie que les fichiers et les répertoires des qtrees doivent être ignorés lors de la sauvegarde des données. Lorsqu'il est réglé sur
|
||
NON WRITE |
|
|
Spécifie que l'opération de restauration ne doit pas écrire de données sur le disque. Cette variable est utilisée pour le débogage. |
||
RÉCURSIF |
|
|
Indique que les entrées de répertoire lors d'une restauration DAR sont développées. Les variables d'environnement DIRECTES et OPTIMISÉES_DAR_ENABLED doivent être activées (définies sur
Par exemple, les chemins de restauration suivants sont valides car tous les chemins de reprise se trouvent dans
Les chemins de récupération suivants ne sont pas valides :
|
||
RECOVER_FULL_PATHS |
|
|
Indique que le chemin de récupération complet aura ses autorisations et listes de contrôle d'accès restaurées après le DAR. DIRECT et ENHANCED_DAR_ENABLED doivent être activés (défini sur |
||
MISE À JOUR |
|
|
Met à jour les informations de métadonnées pour permettre une sauvegarde incrémentielle BASÉE SUR LE NIVEAU. |
Variables d'environnement prises en charge par SMTape
Variable d'environnement | Valeurs valides | Valeur par défaut | Description |
---|---|---|---|
DATE_DE_BASE |
|
|
Spécifie la date de début des sauvegardes incrémentielles. `BASE_DATE` Est une représentation de chaîne des identificateurs d'instantané de référence. À l'aide du `BASE_DATE` String, SMTape localise la copie Snapshot de référence. `BASE_DATE` n'est pas requis pour les sauvegardes de base. Pour une sauvegarde incrémentielle, la valeur de `DUMP_DATE` variable de la sauvegarde de base ou incrémentielle précédente est attribuée à `BASE_DATE` variable. L'application de sauvegarde affecte |
DUMP_DATE |
|
|
À la fin d'une sauvegarde SMTape, DUMP_DATE contient un identifiant de chaîne qui identifie la copie Snapshot utilisée pour cette sauvegarde. Cette copie Snapshot peut être utilisée comme copie Snapshot de référence pour une sauvegarde incrémentielle ultérieure. La valeur résultante de DUMP_DATE est utilisée comme valeur BASE_DATE pour les sauvegardes incrémentielles suivantes. |
SMTAPE_BACKUP_SET_ID |
|
|
Identifie la séquence des sauvegardes incrémentielles associées à la sauvegarde de base. L'ID du jeu de sauvegardes est un ID unique de 128 bits généré au cours d'une sauvegarde de base. L'application de sauvegarde attribue cet ID en tant qu'entrée au |
SMTAPE_SNAPSHOT_NAME |
Toute copie Snapshot valide disponible dans le volume |
|
Lorsque la variable SMTAPE_SNAPSHOT_NAME est définie sur une copie Snapshot, cette copie Snapshot et ses anciennes copies Snapshot sont sauvegardées sur bande. Pour la sauvegarde incrémentielle, cette variable spécifie la copie Snapshot incrémentielle. LA variable BASE_DATE fournit la copie Snapshot de base. |
SMTAPE_DELETE_SNAPSHOT |
|
|
Pour une copie Snapshot créée automatiquement par SMTape, lorsque la variable SMTAPE_DELETE_SNAPSHOT est définie sur |
SMTAPE_BREAK_MIRROR |
|
|
Lorsque la variable SMTAPE_BREAK_MIRROR est définie sur |