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

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

共同作成者
PDF

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

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

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

メモ

ほとんどの場合、値を持つ変数、 Y 同意します T および N 同意します 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 同時に。

抽出（ Extract ）

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 コマンドセット IGNORE_CTIME 終了： false デフォルトではに設定します true 次のデータが失われる可能性があります。

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

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

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

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）も参照してください。再帰変数が無効になっている場合（に設定） N`テープからリストアされるのは、元のソースパスにあるすべてのディレクトリに対する権限とACLだけで、ディレクトリの内容はリストアされません。再帰変数がに設定されている場合 `N または、recover_full_paths変数がに設定されている `Y`リカバリパスは元のパスで終了する必要があります。

メモ

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識別子の文字列表現です。を使用する `BASE_DATE` 文字列を指定すると、SMTapeによって参照Snapshotコピーが検索されます。
`BASE_DATE` は、ベースラインバックアップには必要ありません。増分バックアップの場合は、の値 `DUMP_DATE` 前回のベースラインバックアップまたは増分バックアップの変数がに割り当てられます `BASE_DATE` 変数（Variable）：

バックアップアプリケーションによってが割り当てられます DUMP_DATE 前回のSMTapeのベースラインバックアップまたは増分バックアップの値。

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コピー `Y`バックアップ処理が完了すると、SMTapeによってこのSnapshotコピーが削除されます。ただし、バックアップアプリケーションで作成された Snapshot コピーは削除されません。

smtape break _mirror

Y または N

N

SMTAPE_BREAK_MIRROR変数がに設定されている場合 Y、タイプのボリューム DP がに変更されます RW リストアが成功したあとのボリューム。