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

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

寄稿者

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

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

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

注記

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

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

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

デバッグ

「 Y 」または「 N 」

「 N 」

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

ファイルシステム

「だる」

「 NONE 」

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

NDMP_VERSION

'`re turn _only`

「 NONE 」

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

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

pathname_separator

「 RETER_VALUE 」

「 NONE 」

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

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

を入力します

「日」または「テープ」

「日」

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

詳細

「 Y 」または「 N 」

「 N 」

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

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

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

acl_start

'`re turn _only`

「 NONE 」

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

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

BASE_DATE

「 0 」、「 -1 」、または「日数」の値

「 -1 」

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

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

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

直接

「 Y 」または「 N 」

「 N 」

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

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

dmp_name

「だる」

「 NONE 」

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

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

DUMP_DATE

「 RETER_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 」に設定されている。

除外する

「 pattery_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. ボリューム・レベルのインクリメンタル「 ndmpcopy 」で「 IGNORE_CTime' 」が true に設定されている場合、ファイルが削除され、ソース上の qtree 間で移動されます。

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

この問題を回避するには ' ボリューム・レベルの NDMP ダンプまたは ndmpcopy で 'ignore_CTime を false に設定する必要があります

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

「だる」

「 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 変数が 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

「日」

「 -1 」

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

「 base_date 」は、参照 Snapshot 識別子の文字列表現です。SMTape では 'base_date' 文字列を使用して ' 参照 Snapshot コピーを検索します

ベースライン・バックアップには 'base_dat' は必要ありません増分バックアップの場合 ' 前回のベースラインバックアップまたは増分バックアップの dump_dat 変数の値は 'base_dat' 変数に割り当てられます

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

DUMP_DATE

「 RETER_VALUE 」

「 NONE 」

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

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

smtape _backup_set_ID

「だる」

「 NONE 」

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

バックアップセット ID は、ベースラインバックアップで生成される 128 ビットの一意の ID です。バックアップ・アプリケーションは ' 増分バックアップ中にこの ID を '`S MTAPE_BACKUP_SET_ID' 変数に代入します

smtape snapshot _name

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

「無効」です

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

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

smtape delete _snapshot

「 Y 」または「 N 」

「 N 」

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

smtape break _mirror

「 Y 」または「 N 」

「 N 」

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