ONTAP でサポートされる環境変数
-
このドキュメント ページのPDF
-
ボリューム管理
- CLI を使用した論理ストレージ管理
-
NAS ストレージ管理
-
CLIを使用したSMBの管理
- SMB を使用したファイルアクセスの管理
-
CLIを使用したSMBの管理
- セキュリティとデータ暗号化
-
ボリューム管理
PDF版ドキュメントのセット
Creating your file...
環境変数は、 NDMP 対応のバックアップアプリケーションとストレージシステムの間でバックアップまたはリストア処理に関する情報をやり取りするために使用されます。ONTAP でサポートされる環境変数には、デフォルト値が関連付けられています。ただし、これらのデフォルト値は手動で変更できます。
バックアップアプリケーションによって設定された値を手動で変更すると、アプリケーションが想定外の動作をする可能性があります。これは、バックアップアプリケーションで想定されているバックアップまたはリストアとは異なる処理が行われるためです。ただし、変更を適切に行うと、問題の特定や回避に役立つ場合があります。
次の表は、動作がダンプと SMTape で共通であり、ダンプと SMTape でのみサポートされる環境変数を示しています。また、 ONTAP でサポートされる環境変数が使用された場合の動作の説明も記載されています。
ほとんどの場合、値を持つ変数、 |
ダンプと SMTape 用にサポートされる環境変数
環境変数 | 有効な値: | デフォルト | 説明 |
---|---|---|---|
デバッグ |
|
|
デバッグ情報を出力するように指定します。 |
ファイルシステム |
|
|
バックアップされるデータのルートのパス名を指定します。 |
NDMP_VERSION |
|
|
NDMP_VERSION 変数は変更しないでください。NDMP_VERSION 変数はバックアップ処理によって作成され、 NDMP のバージョンを返します。 ONTAP は、内部使用のため、および情報としてバックアップアプリケーションに渡すために、バックアップ時に NDMP_VERSION 変数を設定します。NDMP セッションの NDMP バージョンは、この変数では設定されません。 |
pathname_separator |
|
|
パス名の区切り文字を指定します。 この文字は、バックアップ対象のファイルシステムによって異なります。ONTAP の場合、文字 “/” はこの変数に割り当てられます。NDMP サーバでは、この変数を設定してからテープバックアップ処理を開始します。 |
を入力します |
|
|
テープバックアップおよびリストア処理の実行がサポートされているバックアップのタイプを指定します。 |
詳細 |
|
|
テープバックアップまたはリストア処理の実行中のログメッセージの数を増やします。 |
ダンプ用にサポートされる環境変数
環境変数 | 有効な値: | デフォルト | 説明 | ||
---|---|---|---|---|---|
acl_start |
|
|
ACL_START 変数は、バックアップ処理によって作成され、直接アクセスリストアまたは再開可能 NDMP バックアップ処理で使用されるオフセット値を示します。 オフセット値は、ダンプファイル内で ACL データ( Pass V )が始まるバイトオフセットであり、バックアップ終了時に返されます。直接アクセスリストア処理でバックアップデータを正しくリストアするには、開始時に ACL_START 値がリストア処理に渡されなければなりません。NDMP 再開可能バックアップ処理では、 ACL_START 値を使用して、バックアップストリームで再開できない部分の開始位置をバックアップアプリケーションに伝えます。 |
||
BASE_DATE |
|
|
増分バックアップの開始日を指定します。 に設定すると これらの変数は、 LEVEL または UPDATE に基づく増分バックアップに代わるものです。 |
||
直接 |
|
|
リストアの際に、テープ全体をスキャンするのではなく、ファイルデータがある場所まで直接早送りするように指定します。 直接アクセスリカバリを使用するには、バックアップアプリケーションが位置情報を提供する必要があります。この変数がに設定されている場合 `Y`では、バックアップアプリケーションによって、ファイル名またはディレクトリ名と位置情報が指定されます。 |
||
dmp_name |
|
|
複数サブツリーバックアップの名前を指定します。 この変数は、複数サブツリーバックアップに必須です。 |
||
DUMP_DATE |
|
|
この変数を直接変更することはありません。BASE_DATE変数が以外の値に設定されている場合、バックアップによって作成されます DUMP_DATE 変数は、ダンプソフトウェアによって計算された 32 ビットの時刻値の前に 32 ビットのレベル値を付けることによって生成されます。レベルは、 BASE_DATE 変数に最後に渡されたレベル値から増分されます。作成された値は、次回の増分バックアップの BASE_DATE 値として使用されます。 |
||
ENHANCED_DAR_ENABLED 環境 |
|
|
拡張 DAR 機能が有効になっているかどうかを示します。拡張 DAR 機能では、ディレクトリ DAR および NT ストリームを含むファイルの DAR をサポートします。パフォーマンスが向上します。 リストア時に拡張 DAR 機能を使用できるのは、次の条件が満たされている場合のみです。
|
||
除外する |
|
|
データのバックアップ時に除外するファイルまたはディレクトリを指定します。 除外リストは、ファイル名またはディレクトリ名をカンマで区切ったリストです。ファイルまたはディレクトリの名前がリスト内の名前の 1 つに一致した場合、バックアップから除外されます。 除外リストで名前を指定する際に適用されるルールは次のとおりです。
|
||
抽出( Extract ) |
|
|
バックアップデータセットのサブツリーをリストアするように指定します。 バックアップアプリケーションでは、抽出するサブツリーの名前を指定します。指定されたファイルが、内容がバックアップされたディレクトリに一致する場合、ディレクトリは再帰的に抽出されます。 DARを使用せずにリストア時にファイル、ディレクトリ、またはqtreeの名前を変更するには、EXTRACT環境変数をに設定する必要があります |
||
extract_acl |
|
|
リストア処理でバックアップファイルの ACL がリストアされるように指定します。 デフォルトでは、 DAR ( DIRECT=Y )を除いて、データをリストアするときに ACL がリストアされます。 |
||
[-force] |
|
|
デスティネーションボリュームで使用可能なボリュームスペースと inode をリストア処理で確認する必要があるかどうかを指定します。 この変数をに設定します デスティネーションボリュームのボリュームスペースまたは inode が不足している場合は、デスティネーションボリュームで使用可能なボリュームスペースと inode で許容される量のデータがリストア処理によってリカバリされます。ボリュームスペースと inode を使用できない場合は、リストア処理が停止します。 |
||
霧 |
|
|
ファイル履歴情報をバックアップアプリケーションに送信するように指定します。 ほとんどの市販のバックアップアプリケーションでは、HIST変数がに設定されています
|
||
IGNORE_CTime |
|
|
前回の増分バックアップ以降に変更されたのが ctime 値だけである場合は、ファイルを増分バックアップしないことを指定します。 ウィルススキャンソフトウェアなどの一部のアプリケーションは、ファイルやファイル属性が変更されていなくても、 inode 内のファイルの ctime 値を変更します。その結果、変更されていないファイルが増分バックアップによってバックアップされることがあります。。
|
||
IGNORE_qtrees |
|
|
リストア処理でバックアップ qtree から qtree 情報をリストアしないことを指定します。 |
||
「レベル」 |
|
|
バックアップレベルを指定します。 レベル 0 では、データセット全体がコピーされます。0 より大きい値で指定された増分バックアップレベルでは、前回の増分バックアップ以降に新規作成または変更されたすべてのファイルがコピーされます。たとえば、レベル 1 では、レベル 0 バックアップ以降に新規または変更されたファイルがバックアップされ、レベル 2 ではレベル 1 バックアップ以降に新規または変更されたファイルがバックアップされます。 |
||
リスト |
|
|
データを実際にはリストアせずに、バックアップファイル名と inode 番号を一覧表示します。 |
||
リスト qtree |
|
|
データを実際にはリストアせずに、バックアップ qtree を一覧表示します。 |
||
multi_subtree_names |
|
|
バックアップが複数のサブツリーであることを指定します。 複数のサブツリーは、改行で区切られた null で終わるサブツリー名のリストの文字列で指定されます。サブツリーは、共通のルートディレクトリを基準とした相対パス名で指定されます。このパス名は、リストの最後の要素として指定する必要があります。 この変数を使用する場合は、 DMP_NAME 変数も使用する必要があります。 |
||
NDMP_Unicode_FH |
|
|
ファイルの NFS 名のほかに Unicode 名もファイル履歴情報に含めるように指定します。 このオプションは、ほとんどのバックアップアプリケーションでは使用されないため、バックアップアプリケーションがこれらの追加のファイル名を受け取るように設計されている場合以外は設定しないでください。HIST 変数も設定する必要があります。 |
||
no_ACLs |
|
|
データのバックアップ時に ACL をコピーしないように指定します。 |
||
NON_QUOTA_TREE |
|
|
データのバックアップ時に qtree 内のファイルおよびディレクトリを無視するように指定します。 に設定すると `Y`では、FILESYSTEM変数で指定されたデータセット内のqtreeの項目はバックアップされません。この変数は、 FILESYSTEM 変数でボリューム全体が指定された場合のみ有効になります。NON_QUOTA_TREE 変数は、レベル 0 バックアップでのみ機能し、 MULTI_SUBTREE_NAMES 変数が指定された場合は機能しません。
|
||
NOWRITE |
|
|
リストア処理でデータをディスクに書き込まないように指定します。 この変数はデバッグに使用されます。 |
||
再帰的 |
|
|
DAR リストア中にディレクトリエントリが拡張されるように指定します。 DIRECTおよびENHANCED_DAR_ENABLED環境変数を有効にする(に設定する)必要があります
たとえば、次の例は、すべてのリカバリパスが内にあるため、有効なリカバリパスです
次のリカバリパスは無効です。
|
||
RECOVER_FULL_paths |
|
|
フルリカバリパスの権限および ACL が、 DAR のあとでリストアされるように指定します。 DIRECTおよびENHANCED_DAR_ENABLEDを有効にする(に設定する)必要があります |
||
更新 |
|
|
レベルベースの増分バックアップを有効にするために、メタデータ情報を更新します。 |
SMTape 用にサポートされる環境変数
環境変数 | 有効な値: | デフォルト | 説明 |
---|---|---|---|
BASE_DATE |
|
|
増分バックアップの開始日を指定します。 `BASE_DATE` は、参照Snapshot識別子の文字列表現です。を使用する `BASE_DATE` 文字列を指定すると、SMTapeによって参照Snapshotコピーが検索されます。 `BASE_DATE` は、ベースラインバックアップには必要ありません。増分バックアップの場合は、の値 `DUMP_DATE` 前回のベースラインバックアップまたは増分バックアップの変数がに割り当てられます `BASE_DATE` 変数(Variable): バックアップアプリケーションによってが割り当てられます |
DUMP_DATE |
|
|
SMTape バックアップの終了時、 DUMP_DATE には、そのバックアップに使用される Snapshot コピーを識別する文字列識別子が含まれています。この Snapshot コピーを、次回の増分バックアップの参照 Snapshot コピーとして使用できます。 結果の DUMP_DATE の値が、次回の増分バックアップの BASE_DATE 値として使用されます。 |
smtape _backup_set_ID |
|
|
ベースラインバックアップに関連付けられた増分バックアップのシーケンスを識別します。 バックアップセット ID は、ベースラインバックアップで生成される 128 ビットの一意の ID です。バックアップアプリケーションは、このIDをに入力として割り当てます |
smtape snapshot _name |
ボリューム内にある有効な Snapshot コピー |
|
SMTAPE_SNAPSHOT_NAME 変数を Snapshot コピーに設定すると、その Snapshot コピーと古い Snapshot コピーがテープにバックアップされます。 増分バックアップの場合は、この変数によって増分 Snapshot コピーが指定されます。BASE_DATE 変数はベースライン Snapshot コピーを指定します。 |
smtape delete _snapshot |
|
|
SMTAPE_DELETE_SNAPSHOT変数をに設定すると、SMTapeで自動的に作成されるSnapshotコピー `Y`バックアップ処理が完了すると、SMTapeによってこのSnapshotコピーが削除されます。ただし、バックアップアプリケーションで作成された Snapshot コピーは削除されません。 |
smtape break _mirror |
|
|
SMTAPE_BREAK_MIRROR変数がに設定されている場合 |