Skip to main content
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

ONTAPでサポートされる環境変数

共同作成者
PDF

環境変数は、 NDMP 対応のバックアップアプリケーションとストレージシステムの間でバックアップまたはリストア処理に関する情報をやり取りするために使用されます。ONTAP でサポートされる環境変数には、デフォルト値が関連付けられています。ただし、これらのデフォルト値は手動で変更できます。

バックアップアプリケーションによって設定された値を手動で変更すると、アプリケーションが想定外の動作をする可能性があります。これは、バックアップ アプリケーションの想定とは異なるバックアップまたはリストア処理が行われるためです。ただし、状況によっては、適切な変更によって問題の特定や回避に役立つ場合があります。

次の表に、動作がダンプとSMTapeで共通で、ダンプとSMTapeでのみサポートされる環境変数を示します。また、 ONTAP でサポートされる環境変数が使用された場合の動作の説明も記載されています。

メモ

ほとんどの場合、値を持つ変数 Y`も受け入れ、 `N`受け入れ `T`ます `F。

ダンプとSMTapeでサポートされる環境変数

環境変数 有効な値 デフォルト 説明

デバッグ

Y`または `N

N

デバッグ情報を出力するように指定します。

ファイルシステム

string

none

バックアップされるデータのルートのパス名を指定します。

NDMP_VERSION

return_only

none

NDMP_VERSION 変数は変更しないでください。NDMP_VERSION 変数はバックアップ処理によって作成され、 NDMP のバージョンを返します。

ONTAP は、内部使用のため、および情報としてバックアップアプリケーションに渡すために、バックアップ時に NDMP_VERSION 変数を設定します。NDMP セッションの NDMP バージョンは、この変数では設定されません。

pathname_separator

return_value

none

パス名の区切り文字を指定します。

この文字は、バックアップ対象のファイルシステムによって異なります。ONTAP の場合、文字 “/” はこの変数に割り当てられます。NDMP サーバでは、この変数を設定してからテープバックアップ処理を開始します。

タイプ

dump`または `smtape

dump

テープバックアップおよびリストア処理の実行がサポートされているバックアップのタイプを指定します。

詳細

Y`または `N

N

テープバックアップまたはリストア処理の実行中のログメッセージの数を増やします。

ダンプ用にサポートされる環境変数

環境変数 有効な値 デフォルト 説明

acl_start

return_only

none

ACL_START 変数は、バックアップ処理によって作成され、直接アクセスリストアまたは再開可能 NDMP バックアップ処理で使用されるオフセット値を示します。

オフセット値は、ダンプファイル内で ACL データ（ Pass V ）が始まるバイトオフセットであり、バックアップ終了時に返されます。直接アクセスリストア処理でバックアップデータを正しくリストアするには、開始時に ACL_START 値がリストア処理に渡されなければなりません。NDMP 再開可能バックアップ処理では、 ACL_START 値を使用して、バックアップストリームで再開できない部分の開始位置をバックアップアプリケーションに伝えます。

BASE_DATE

0 -1、、または `DUMP_DATE`値

-1

増分バックアップの開始日を指定します。

に設定する -1`と、BASE_DATEインクリメンタル指定子は無効になります。レベル0バックアップでに設定すると `0、増分バックアップが有効になります。最初のバックアップ後、前回の増分バックアップの DUMP_DATE 変数の値が BASE_DATE 変数に代入されます。

これらの変数は、 LEVEL または UPDATE に基づく増分バックアップに代わるものです。

直販

Y`または `N

N

リストアの際に、テープ全体をスキャンするのではなく、ファイルデータがある場所まで直接早送りするように指定します。

直接アクセスリカバリを使用するには、バックアップアプリケーションが位置情報を提供する必要があります。この変数がに設定されている場合、 `Y`バックアップアプリケーションはファイル名またはディレクトリ名と位置情報を指定します。

dmp_name

string

none

複数サブツリーバックアップの名前を指定します。

この変数は、複数サブツリーバックアップに必須です。

DUMP_DATE

return_value

none

この変数を直接変更することはありません。BASE_DATE変数が以外の値に設定されている場合、バックアップによって作成され `-1`ます。

DUMP_DATE 変数は、ダンプソフトウェアによって計算された 32 ビットの時刻値の前に 32 ビットのレベル値を付けることによって生成されます。レベルは、 BASE_DATE 変数に最後に渡されたレベル値から増分されます。作成された値は、次回の増分バックアップの BASE_DATE 値として使用されます。

ENHANCED_DAR_ENABLED 環境

Y`または `N

N

拡張 DAR 機能が有効になっているかどうかを示します。拡張DAR機能は、ディレクトリDARおよびNTストリームを含むファイルのDARをサポートします。パフォーマンスが向上します。

リストア時に拡張 DAR 機能を使用できるのは、次の条件が満たされている場合のみです。

  • ONTAP で拡張 DAR がサポートされている。

  • バックアップ時にファイル履歴が有効である（ HIST=Y ）。

  • この `ndmpd.offset_map.enable`オプションはに設定されてい `on`ます。

  • リストア時にENHANCED_DAR_ENABLED変数がに設定されている Y。

シヨカイ

pattern_string

none

データのバックアップ時に除外するファイルまたはディレクトリを指定します。

除外リストは、ファイル名またはディレクトリ名をカンマで区切ったリストです。ファイルまたはディレクトリの名前がリスト内の名前の 1 つに一致した場合、バックアップから除外されます。

除外リストで名前を指定する際に適用されるルールは次のとおりです。

  • 正確なファイル名またはディレクトリ名を使用する必要があります。

  • ワイルドカード文字であるアスタリスク（ * ）は、文字列の最初または最後の文字にする必要があります。

    使用できるアスタリスクの数は文字列ごとに 2 つです。

  • ファイル名またはディレクトリ名のカンマの前にバックスラッシュを付ける必要があります。

  • 除外リストに含めることができる名前は 32 個までです。

メモ

NON_QUOTA_TREEを同時に設定した場合、バックアップから除外するように指定したファイルまたはディレクトリは除外されません Y。

展開する

Y、 N、または E

N

バックアップデータセットのサブツリーをリストアするように指定します。

バックアップアプリケーションでは、抽出するサブツリーの名前を指定します。指定されたファイルが、内容がバックアップされたディレクトリに一致する場合、ディレクトリは再帰的に抽出されます。

DARを使用せずにリストア時にファイル、ディレクトリ、またはqtreeの名前を変更するには、EXTRACT環境変数をに設定する必要があります E。

extract_acl

Y`または `N

Y

リストア処理でバックアップファイルの ACL がリストアされるように指定します。

デフォルトでは、 DAR （ DIRECT=Y ）を除いて、データをリストアするときに ACL がリストアされます。

[-force]

Y`または `N

N

デスティネーションボリュームで使用可能なボリュームスペースと inode をリストア処理で確認する必要があるかどうかを指定します。

この変数をに設定する `Y`と、デスティネーションパスで使用可能なボリュームスペースとinodeのチェックがリストア処理でスキップされます。

デスティネーションボリュームのボリュームスペースまたは inode が不足している場合は、デスティネーションボリュームで使用可能なボリュームスペースと inode で許容される量のデータがリストア処理によってリカバリされます。ボリュームスペースと inode を使用できない場合は、リストア処理が停止します。

霧

Y`または `N

N

ファイル履歴情報をバックアップアプリケーションに送信するように指定します。

ほとんどの市販のバックアップアプリケーションでは、HIST変数がに設定されてい Y`ます。バックアップ処理の速度を上げる場合や、ファイル履歴の収集に関する問題のトラブルシューティングを行う場合は、この変数をに設定します `N。

メモ

バックアップアプリケーションでファイル履歴がサポートされていない場合は、HIST変数をに設定しないで `Y`ください。

IGNORE_CTime

Y`または `N

N

前回の増分バックアップ以降に変更されたのが ctime 値だけである場合は、ファイルを増分バックアップしないことを指定します。

ウィルススキャンソフトウェアなどの一部のアプリケーションは、ファイルやファイル属性が変更されていなくても、 inode 内のファイルの ctime 値を変更します。その結果、変更されていないファイルが増分バックアップによってバックアップされることがあります。この `IGNORE_CTIME`変数を指定する必要があるのは、ctime値が変更されたために増分バックアップに許容できない時間またはスペースが使用されている場合だけです。

メモ

この `NDMP dump`コマンドは、デフォルトでに `false`設定され `IGNORE_CTIME`ます。に設定する `true`と、次のデータが失われる可能性があります。

  1. ボリュームレベルの増分でがtrueに設定されている `ndmpcopy`場合、 `IGNORE_CTIME`ファイルが削除され、ソースのqtree間で移動されます。

  2. ボリュームレベルの増分ダンプでがtrueに設定されている場合 IGNORE_CTIME、ファイルが削除され、増分リストア時にソースのqtree間で移動されます。

この問題を回避するには、 IGNORE_CTIME`ボリュームレベルまたは `ndmpcopy`でをfalseに設定する必要があります `NDMP dumps。

IGNORE_qtrees

Y`または `N

N

リストア処理でバックアップ qtree から qtree 情報をリストアしないことを指定します。

「レベル」

0-31

0

バックアップレベルを指定します。

レベル 0 では、データセット全体がコピーされます。0 より大きい値で指定された増分バックアップレベルでは、前回の増分バックアップ以降に新規作成または変更されたすべてのファイルがコピーされます。たとえば、レベル 1 では、レベル 0 バックアップ以降に新規または変更されたファイルがバックアップされ、レベル 2 ではレベル 1 バックアップ以降に新規または変更されたファイルがバックアップされます。

リスト

Y`または `N

N

データを実際にはリストアせずに、バックアップファイル名と inode 番号を一覧表示します。

リスト qtree

Y`または `N

N

データを実際にはリストアせずに、バックアップ qtree を一覧表示します。

multi_subtree_names

string

none

バックアップが複数のサブツリーであることを指定します。

複数のサブツリーは、改行で区切られた null で終わるサブツリー名のリストの文字列で指定されます。サブツリーは、共通のルートディレクトリを基準とした相対パス名で指定されます。このパス名は、リストの最後の要素として指定する必要があります。

この変数を使用する場合は、 DMP_NAME 変数も使用する必要があります。

NDMP_Unicode_FH

Y`または `N

N

ファイルの NFS 名のほかに Unicode 名もファイル履歴情報に含めるように指定します。

このオプションは、ほとんどのバックアップアプリケーションでは使用されないため、バックアップアプリケーションがこれらの追加のファイル名を受け取るように設計されている場合以外は設定しないでください。HIST 変数も設定する必要があります。

no_ACLs

Y`または `N

N

データのバックアップ時に ACL をコピーしないように指定します。

NON_QUOTA_TREE

Y`または `N

N

データのバックアップ時に qtree 内のファイルおよびディレクトリを無視するように指定します。

に設定する `Y`と、FILESYSTEM変数で指定されたデータセット内のqtree内の項目はバックアップされません。この変数は、 FILESYSTEM 変数でボリューム全体が指定された場合のみ有効になります。NON_QUOTA_TREE 変数は、レベル 0 バックアップでのみ機能し、 MULTI_SUBTREE_NAMES 変数が指定された場合は機能しません。

メモ

NON_QUOTA_TREEを同時に設定した場合、バックアップから除外するように指定したファイルまたはディレクトリは除外されません Y。

NOWRITE

Y`または `N

N

リストア処理でデータをディスクに書き込まないように指定します。

この変数はデバッグに使用されます。

再帰的

Y`または `N

Y

DAR リストア中にディレクトリエントリが拡張されるように指定します。

DIRECTおよびENHANCED_DAR_ENABLED環境変数も有効（に設定）する必要があります Y。RECURSIVE変数が無効になっている（に設定されている）場合は N、ディレクトリの内容ではなく、元のソースパス内のすべてのディレクトリの権限とACLのみがテープからリストアされます。RECURSIVE変数がに設定されている場合、またはRECOVER_FULL_PATHS変数がに設定されて `Y`いる場合、 `N`リカバリパスは元のパスで終了する必要があります。

メモ

RECURSIVE 変数が無効で、複数のリカバリパスがある場合には、すべてのリカバリパスを最長のリカバリパス内に含める必要があります。それ以外の場合は、エラーメッセージが表示されます。

たとえば、すべてのリカバリパスがに含まれているため、次のリカバリパスは有効 `foo/dir1/deepdir/myfile`です。

  • /foo

  • /foo/dir

  • /foo/dir1/deepdir

  • /foo/dir1/deepdir/myfile

次のリカバリパスは無効です。

  • /foo

  • /foo/dir

  • /foo/dir1/myfile

  • /foo/dir2

  • /foo/dir2/myfile

RECOVER_FULL_paths

Y`または `N

N

フルリカバリパスの権限および ACL が、 DAR のあとでリストアされるように指定します。

DIRECTおよびENHANCED_DAR_ENABLEDも有効（に設定）する必要があります Y。recover_full_pathsがに設定されている場合、 `Y`リカバリパスは元のパスで終了する必要があります。デスティネーションボリュームにすでにディレクトリが存在する場合は、権限および ACL はテープからリストアされません。

更新

Y`または `N

Y

レベルベースの増分バックアップを有効にするために、メタデータ情報を更新します。

SMTape 用にサポートされる環境変数

環境変数 有効な値 デフォルト 説明

BASE_DATE

DUMP_DATE

-1

増分バックアップの開始日を指定します。

`BASE_DATE`は、参照Snapshot識別子の文字列表現です。SMTapeでは、文字列を使用して `BASE_DATE`参照Snapshotコピーを特定します。
`BASE_DATE`は、ベースラインバックアップには必要ありません。増分バックアップの場合は、前回のベースラインバックアップまたは増分バックアップの変数の値が `DUMP_DATE`変数に代入され `BASE_DATE`ます。

バックアップアプリケーションは、前回のSMTapeのベースラインバックアップまたは増分バックアップの値を割り当て `DUMP_DATE`ます。

DUMP_DATE

return_value

none

SMTape バックアップの終了時、 DUMP_DATE には、そのバックアップに使用される Snapshot コピーを識別する文字列識別子が含まれています。この Snapshot コピーを、次回の増分バックアップの参照 Snapshot コピーとして使用できます。

結果の DUMP_DATE の値が、次回の増分バックアップの BASE_DATE 値として使用されます。

smtape _backup_set_ID

string

none

ベースラインバックアップに関連付けられた増分バックアップのシーケンスを識別します。

バックアップセット ID は、ベースラインバックアップで生成される 128 ビットの一意の ID です。バックアップアプリケーションは、増分バックアップ時にこのIDを変数に入力として割り当て `SMTAPE_BACKUP_SET_ID`ます。

smtape snapshot _name

ボリューム内にある有効な Snapshot コピー

Invalid

SMTAPE_SNAPSHOT_NAME 変数を Snapshot コピーに設定すると、その Snapshot コピーと古い Snapshot コピーがテープにバックアップされます。

増分バックアップの場合は、この変数によって増分 Snapshot コピーが指定されます。BASE_DATE 変数はベースライン Snapshot コピーを指定します。

smtape delete _snapshot

Y`または `N

N

SMTAPE_DELETE_SNAPSHOT変数をに設定すると、SMTapeで自動的に作成されるSnapshotコピーについては、バックアップ処理の完了後にSMTape `Y`によって削除されます。ただし、バックアップアプリケーションで作成された Snapshot コピーは削除されません。

smtape break _mirror

Y`または `N

N

SMTAPE_BREAK_MIRROR変数をに設定する `Y`と、リストアが成功すると、タイプがのボリュームが `DP`ボリュームに変更され `RW`ます。