Skip to main content
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

Variabili di ambiente supportate da ONTAP

Collaboratori
PDF

Le variabili di ambiente vengono utilizzate per comunicare informazioni su un'operazione di backup o ripristino tra un'applicazione di backup abilitata per NDMP e un sistema di storage. ONTAP supporta le variabili di ambiente, che hanno un valore predefinito associato. Tuttavia, è possibile modificare manualmente questi valori predefiniti.

Se si modificano manualmente i valori impostati dall'applicazione di backup, l'applicazione potrebbe comportarsi in modo imprevedibile. Questo perché le operazioni di backup o ripristino potrebbero non eseguire le operazioni previste dall'applicazione di backup. Tuttavia, in alcuni casi, una modifica prudente potrebbe aiutare a identificare o a risolvere i problemi.

Le tabelle seguenti elencano le variabili di ambiente il cui comportamento è comune a dump e SMTape e quelle che sono supportate solo per dump e SMTape. Queste tabelle contengono anche descrizioni del funzionamento delle variabili di ambiente supportate da ONTAP se utilizzate:

Nota

Nella maggior parte dei casi, le variabili che hanno il valore, Y accetta anche T e. N accetta anche F.

Variabili di ambiente supportate per dump e SMTape

Variabile di ambiente Valori validi Predefinito Descrizione

DEBUG

Y oppure N

N

Specifica che le informazioni di debug vengono stampate.

FILESYSTEM

string

none

Specifica il nome del percorso della directory principale dei dati di cui viene eseguito il backup.

NDMP_VERSION

return_only

none

Non modificare la variabile NDMP_VERSION. Creata dall'operazione di backup, la variabile NDMP_VERSION restituisce la versione NDMP.

ONTAP imposta la variabile NDMP_VERSION durante un backup per uso interno e per passare a un'applicazione di backup a scopo informativo. La versione NDMP di una sessione NDMP non è impostata con questa variabile.

PATHNAME_SEPARATOR

return_value

none

Specifica il carattere di separazione del nome del percorso.

Questo carattere dipende dal file system di cui viene eseguito il backup. Per ONTAP, il carattere “/” è assegnato a questa variabile. Il server NDMP imposta questa variabile prima di avviare un'operazione di backup su nastro.

TIPO

dump oppure smtape

dump

Specifica il tipo di backup supportato per eseguire operazioni di backup e ripristino su nastro.

DETTAGLIATO

Y oppure N

N

Aumenta i messaggi di log durante l'esecuzione di un'operazione di backup o ripristino su nastro.

Variabili di ambiente supportate per il dump

Variabile di ambiente Valori validi Predefinito Descrizione

ACL_START

return_only

none

Creata dall'operazione di backup, la variabile ACL_START è un valore di offset utilizzato da un ripristino ad accesso diretto o da un'operazione di backup NDMP ripristinabile.

Il valore di offset è l'offset di byte nel file dump in cui iniziano i dati ACL (Pass V) e vengono restituiti alla fine di un backup. Per un'operazione di ripristino ad accesso diretto che ripristini correttamente i dati di cui è stato eseguito il backup, il valore ACL_START deve essere passato all'operazione di ripristino all'inizio. Un'operazione di backup NDMP avviabile utilizza il valore ACL_START per comunicare con l'applicazione di backup in cui inizia la parte non avviabile del flusso di backup.

BASE_DATE

0, -1, o. DUMP_DATE valore

-1

Specifica la data di inizio dei backup incrementali.

Quando è impostato su -1, L'identificatore incrementale BASE_DATE è disattivato. Quando è impostato su 0 su un backup di livello 0, sono attivati backup incrementali. Dopo il backup iniziale, il valore della variabile DUMP_DATE del backup incrementale precedente viene assegnato alla variabile BASE_DATE.

Queste variabili sono un'alternativa ai backup incrementali basati SU LIVELLO/AGGIORNAMENTO.

DIRETTO

Y oppure N

N

Specifica che un ripristino deve avanzare rapidamente direttamente nella posizione sul nastro in cui risiedono i dati del file, invece di eseguire la scansione dell'intero nastro.

Affinché il ripristino dell'accesso diretto funzioni, l'applicazione di backup deve fornire informazioni di posizionamento. Se questa variabile è impostata su Y, l'applicazione di backup specifica i nomi dei file o delle directory e le informazioni di posizionamento.

NOME_DMP

string

none

Specifica il nome di un backup di una sottostruttura multipla.

Questa variabile è obbligatoria per i backup di più sottostruttura.

DUMP_DATE

return_value

none

Questa variabile non viene modificata direttamente. Viene creato dal backup se la variabile BASE_DATE è impostata su un valore diverso da -1.

La variabile DUMP_DATE viene derivata anteponendo il valore di livello a 32 bit a un valore di tempo a 32 bit calcolato dal software dump. Il livello viene incrementato dall'ultimo valore di livello passato alla variabile BASE_DATE. Il valore risultante viene utilizzato come valore BASE_DATE in un backup incrementale successivo.

ENHANCED_DAR_ENABLED

Y oppure N

N

Specifica se la funzionalità DAR avanzata è attivata. La funzionalità DAR avanzata supporta directory DAR e DAR di file con flussi NT. Offre miglioramenti delle performance.

Il DAR avanzato durante il ripristino è possibile solo se vengono soddisfatte le seguenti condizioni:

  • ONTAP supporta DAR avanzato.

  • La cronologia del file viene attivata (HIST=Y) durante il backup.

  • Il ndmpd.offset_map.enable l'opzione è impostata su on.

  • LA variabile ENHANCED_DAR_ENABLED è impostata su Y durante il ripristino.

ESCLUDI

pattern_string

none

Specifica i file o le directory che vengono esclusi durante il backup dei dati.

L'elenco exclude è un elenco separato da virgole di nomi di file o directory. Se il nome di un file o di una directory corrisponde a uno dei nomi nell'elenco, viene escluso dal backup.

Le seguenti regole si applicano quando si specificano i nomi nell'elenco di esclusione:

  • È necessario utilizzare il nome esatto del file o della directory.

  • L'asterisco (*), un carattere jolly, deve essere il primo o l'ultimo carattere della stringa.

    Ogni stringa può contenere fino a due asterischi.

  • Una virgola nel nome di un file o di una directory deve essere preceduta da una barra rovesciata.

  • L'elenco di esclusione può contenere fino a 32 nomi.

Nota

I file o le directory specificati per essere esclusi per il backup non sono esclusi se si imposta NON_QUOTA_TREE su Y simultaneamente.

ESTRARRE

Y, N, o. E

N

Specifica che le sottostruttura di un set di dati di cui è stato eseguito il backup devono essere ripristinate.

L'applicazione di backup specifica i nomi delle sottostrutture da estrarre. Se un file specificato corrisponde a una directory di cui è stato eseguito il backup, la directory viene estratta in modo ricorrente.

Per rinominare un file, una directory o un qtree durante il ripristino senza utilizzare DAR, è necessario impostare la variabile di ambiente DI ESTRAZIONE su E.

ESTRAI_ACL

Y oppure N

Y

Specifica che gli ACL del file di cui è stato eseguito il backup vengono ripristinati durante un'operazione di ripristino.

L'impostazione predefinita prevede il ripristino degli ACL durante il ripristino dei dati, ad eccezione dei DAR (DIRECT=Y).

FORZA

Y oppure N

N

Determina se l'operazione di ripristino deve controllare lo spazio del volume e la disponibilità di inode sul volume di destinazione.

Impostare questa variabile su Y consente all'operazione di ripristino di ignorare i controlli dello spazio del volume e della disponibilità di inode sul percorso di destinazione.

Se sul volume di destinazione non è disponibile spazio di volume o inode sufficienti, l'operazione di ripristino ripristina la quantità di dati consentita dallo spazio di volume di destinazione e dalla disponibilità di inode. L'operazione di ripristino si interrompe quando lo spazio del volume o gli inode non sono disponibili.

HIST

Y oppure N

N

Specifica che le informazioni sulla cronologia del file vengono inviate all'applicazione di backup.

La maggior parte delle applicazioni di backup commerciali imposta la variabile HIST su Y. Se si desidera aumentare la velocità di un'operazione di backup o risolvere un problema con la raccolta della cronologia dei file, è possibile impostare questa variabile su N.

Nota

Non impostare la variabile HIST su Y se l'applicazione di backup non supporta la cronologia dei file.

IGNORE_CTIME

Y oppure N

N

Specifica che non viene eseguito il backup incrementale di un file se è stato modificato solo il relativo valore ctime rispetto al backup incrementale precedente.

Alcune applicazioni, come il software antivirus, modificano il valore ctime di un file all'interno dell'inode, anche se il file o i relativi attributi non sono stati modificati. Di conseguenza, un backup incrementale potrebbe eseguire il backup dei file che non sono stati modificati. Il IGNORE_CTIME la variabile deve essere specificata solo se i backup incrementali richiedono una quantità di tempo o spazio inaccettabile a causa della modifica del valore ctime.

Nota

Il NDMP dump set di comandi IGNORE_CTIME a. false per impostazione predefinita. Impostarlo su true può causare la seguente perdita di dati:

  1. Se IGNORE_CTIME viene impostato su true con un livello di volume incrementale `ndmpcopy`il risultato è l'eliminazione dei file, che vengono spostati tra i qtree in origine.

  2. Se IGNORE_CTIME viene impostato su true durante un dump incrementale a livello di volume, con conseguente eliminazione dei file, che vengono spostati tra i qtree di origine durante il ripristino incrementale.

Per evitare questo problema, IGNORE_CTIME deve essere impostato su false durante il livello del volume NDMP dumps oppure ndmpcopy.

IGNORE_QTREE

Y oppure N

N

Specifica che l'operazione di ripristino non ripristina le informazioni qtree dai qtree di cui è stato eseguito il backup.

LIVELLO

0-31

0

Specifica il livello di backup.

Il livello 0 copia l'intero set di dati. I livelli di backup incrementali, specificati da valori superiori a 0, copiano tutti i file (nuovi o modificati) dall'ultimo backup incrementale. Ad esempio, un livello 1 esegue il backup di file nuovi o modificati dal backup di livello 0, un livello 2 esegue il backup di file nuovi o modificati dal backup di livello 1 e così via.

ELENCO

Y oppure N

N

Elenca i nomi dei file di cui è stato eseguito il backup e i numeri di inode senza ripristinare effettivamente i dati.

LIST_QTREE

Y oppure N

N

Elenca i qtree di cui è stato eseguito il backup senza ripristinare effettivamente i dati.

NOMI_SOTTOSTRUTTURA_MULTIPLI

string

none

Specifica che il backup è un backup a più sottostruttura.

Nella stringa sono specificate più sottostruttura, ovvero un elenco di nomi di sottostruttura separati da una nuova riga e con terminazione nulla. I sottostruttura sono specificati dai nomi dei percorsi relativi alla directory root comune, che deve essere specificata come ultimo elemento dell'elenco.

Se si utilizza questa variabile, è necessario utilizzare anche la variabile DMP_NAME.

NDMP_UNICODE_ FH

Y oppure N

N

Specifica che un nome Unicode è incluso in aggiunta al nome NFS del file nelle informazioni sulla cronologia del file.

Questa opzione non viene utilizzata dalla maggior parte delle applicazioni di backup e non deve essere impostata a meno che l'applicazione di backup non riceva questi nomi di file aggiuntivi. È necessario impostare anche la variabile HIST.

NO_ACL

Y oppure N

N

Specifica che gli ACL non devono essere copiati durante il backup dei dati.

STRUTTURA_NON_QUOTA

Y oppure N

N

Specifica che i file e le directory nei qtree devono essere ignorati durante il backup dei dati.

Quando è impostato su Y, Gli elementi in qtree nel set di dati specificato dalla variabile DI FILESYSTEM non vengono sottoposti a backup. Questa variabile ha un effetto solo se la variabile DI FILESYSTEM specifica un intero volume. La variabile NON_QUOTA_TREE funziona solo su un backup di livello 0 e non funziona se viene specificata la variabile MULTI_SUBTREE_NAMES.

Nota

I file o le directory specificati per essere esclusi per il backup non sono esclusi se si imposta NON_QUOTA_TREE su Y simultaneamente.

NOWRITE

Y oppure N

N

Specifica che l'operazione di ripristino non deve scrivere i dati sul disco.

Questa variabile viene utilizzata per il debug.

RICORRENTE

Y oppure N

Y

Specifica che le voci della directory durante un ripristino DAR devono essere espanse.

Le variabili di ambiente DIRECT e ENHANCED_DAR_ENABLED devono essere attivate (impostate su Y). Se la variabile RICORRENTE è disattivata (impostare su N), solo le autorizzazioni e gli ACL per tutte le directory nel percorso di origine originale vengono ripristinati dal nastro, non dal contenuto delle directory. Se la variabile RICORRENTE è impostata su N Oppure la variabile RECOVER_FULL_PATHS è impostata su Y, il percorso di ripristino deve terminare con il percorso originale.

Nota

Se la variabile RICORRENTE è disattivata e se sono presenti più percorsi di ripristino, tutti i percorsi di ripristino devono essere contenuti entro il più lungo dei percorsi di ripristino. In caso contrario, viene visualizzato un messaggio di errore.

Ad esempio, i seguenti sono percorsi di ripristino validi perché tutti i percorsi di ripristino sono inclusi foo/dir1/deepdir/myfile:

  • /foo

  • /foo/dir

  • /foo/dir1/deepdir

  • /foo/dir1/deepdir/myfile

I seguenti sono percorsi di ripristino non validi:

  • /foo

  • /foo/dir

  • /foo/dir1/myfile

  • /foo/dir2

  • /foo/dir2/myfile

RECOVERY_FULL_PATHS

Y oppure N

N

Specifica che il percorso di ripristino completo avrà le relative autorizzazioni e gli ACL ripristinati dopo il DAR.

DIRECT e ENHANCED_DAR_ENABLED devono essere attivati (impostare su Y). Se RECOVER_FULL_PATHS è impostato su Y, il percorso di ripristino deve terminare con il percorso originale. Se nel volume di destinazione sono già presenti directory, le relative autorizzazioni e gli ACL non verranno ripristinati dal nastro.

AGGIORNARE

Y oppure N

Y

Aggiorna le informazioni sui metadati per abilitare il backup incrementale basato SUL LIVELLO.

Variabili di ambiente supportate per SMTape

Variabile di ambiente Valori validi Predefinito Descrizione

BASE_DATE

DUMP_DATE

-1

Specifica la data di inizio dei backup incrementali.

`BASE_DATE` è una rappresentazione in stringa degli identificatori di snapshot di riferimento. Utilizzando la `BASE_DATE` stringa, SMTape individua l'istantanea di riferimento.
`BASE_DATE` non è richiesto per i backup di riferimento. Per un backup incrementale, il valore di `DUMP_DATE` la variabile rispetto alla linea di base precedente o al backup incrementale viene assegnata a `BASE_DATE` variabile.

L'applicazione di backup assegna DUMP_DATE Valore di una precedente linea di base SMTape o backup incrementale.

DUMP_DATE

return_value

none

Al termine di un backup SMTape, DUMP_DATE contiene un identificatore di stringa che identifica lo snapshot utilizzato per quel backup. Questo snapshot può essere utilizzato come snapshot di riferimento per un successivo backup incrementale.

Il valore risultante di DUMP_DATE viene utilizzato come valore BASE_DATE per i backup incrementali successivi.

SMTAPE_BACKUP_SET_ID

string

none

Identifica la sequenza di backup incrementali associata al backup di riferimento.

L'ID set di backup è un ID univoco a 128 bit generato durante un backup di base. L'applicazione di backup assegna questo ID come input a SMTAPE_BACKUP_SET_ID variabile durante un backup incrementale.

NOME_SNAPSHOT_SMTAPE

Qualsiasi istantanea valida disponibile nel volume

Invalid

Quando la variabile SMTAPE_SNAPSHOT_NAME è impostata su uno snapshot, tale snapshot e i relativi snapshot precedenti vengono sottoposti a backup su nastro.

Per il backup incrementale, questa variabile specifica lo snapshot incrementale. La variabile BASE_DATE fornisce lo snapshot di base.

SMTAPE_DELETE_SNAPSHOT

Y oppure N

N

Per uno snapshot creato automaticamente da SMTape, quando la variabile SMTAPE_DELETE_SNAPSHOT è impostata su Y, al termine dell'operazione di backup, SMTape elimina questo snapshot. Tuttavia, uno snapshot creato dall'applicazione di backup non verrà eliminato.

SMTAPE_BREAK_MIRROR

Y oppure N

N

Quando la variabile SMTAPE_BREAK_MIRROR è impostata su Y, il volume di tipo DP viene modificato in a. RW dopo un ripristino riuscito.