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

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

ほとんどの場合、値を指定する変数では、Y の代わりに T 、N の代わりに F を使用できます。

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

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

環境変数	有効な値	デフォルト値	説明
DEBUG	`Y` または `N`	`N`	デバッグ情報を表示することを指定します。
FILESYSTEM	`string`	なし	バックアップされるデータのルートのパス名を指定します。
NDMP_VERSION	`return_only`	なし	NDMP_VERSION変数は変更しないでください。NDMP_VERSION変数はバックアップ処理によって作成され、NDMPのバージョンを返します。 ONTAPは、内部使用のため、および情報としてバックアップアプリケーションに渡すために、バックアップ時にNDMP_VERSION変数を設定します。NDMPセッションのNDMPバージョンは、この変数では設定されません。
PATHNAME_SEPARATOR	`return_value`	なし	パス名の区切り文字を指定します。この文字はバックアップ対象のファイルシステムによって異なります。ONTAPの場合は、「`/`」という文字がこの変数に代入されます。NDMPサーバーでは、この変数を設定してからテープバックアップ処理を開始します。
TYPE	`dump` または `smtape`	`dump`	テープバックアップおよびリストア処理の実行がサポートされているバックアップのタイプを指定します。
VERBOSE	`Y` または `N`	`N`	テープバックアップまたはリストア処理の実行中のログメッセージの数を増やします。

DEBUG

Y または N

N

デバッグ情報を表示することを指定します。

FILESYSTEM

string

なし

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

NDMP_VERSION

return_only

なし

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

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

PATHNAME_SEPARATOR

return_value

なし

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

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

TYPE

dump または smtape

dump

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

VERBOSE

Y または N

N

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

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

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

ACL_START

return_only

なし

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

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

BASE_DATE

0 、-1 、または DUMP_DATE の値

-1

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

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

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

DIRECT

Y または N

N

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

DARを利用するには、バックアップアプリケーションで位置情報を提供する必要があります。この変数を Y に設定すると、バックアップアプリケーションによって、ファイルまたはディレクトリー名と位置情報が指定されます。

DMP_NAME

string

なし

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

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

DUMP_DATE

return_value

なし

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

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

ENHANCED_DAR_ENABLED

Y または N

N

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

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

ONTAPで拡張DARがサポートされている。
バックアップ時にファイル履歴が有効である（HIST=Y）。
ndmpd.offset_map.enable オプションが on に設定されている。
リストア時にENHANCED_DAR_ENABLED変数が Y に設定されている。

EXCLUDE

pattern_string

なし

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

除外リストは、カンマで区切られたファイルまたはディレクトリー名のリストです。ファイルまたはディレクトリーの名前がリスト内の名前の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を使用できない場合は、リストア処理が停止します。

HIST

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 に設定すると、次のようにデータが失われる可能性があります。

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

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

IGNORE_QTREES

Y または N

N

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

LEVEL

0-31

0

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

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

LIST

Y または N

N

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

LIST_QTREES

Y または N

N

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

MULTI_SUBTREE_ NAMES

string

なし

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

複数のサブツリーは、改行で区切られた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

リストア処理でデータをドライブに書き込まないことを指定します。

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

RECURSIVE

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はテープからリストアされません。

UPDATE

Y または N

Y

LEVELに基づく増分バックアップを有効にするためにメタデータ情報を更新します。

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`	なし	SMTapeバックアップの終了時に、そのバックアップで使用したSnapshotコピーを識別する文字列識別子がDUMP_DATEに含まれます。このSnapshotコピーを、次回の増分バックアップの参照Snapshotコピーとして使用できます。結果のDUMP_DATEの値が、次回の増分バックアップのBASE_DATE値として使用されます。
SMTAPE_BACKUP_SET_ID	`string`	なし	ベースラインバックアップに関連付けられている増分バックアップのシーケンスを識別します。バックアップセット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変数が `Y` に設定されている場合は、バックアップ処理が完了すると、SMTapeで自動的に作成されたSnapshotコピーはSMTapeによって削除されます。ただし、バックアップアプリケーションが作成したSnapshotコピーは削除されません。
SMTAPE_BREAK_MIRROR	`Y` または `N`	`N`	SMTAPE_BREAK_MIRROR変数が `Y` に設定されている場合は、リストアが成功すると、種類が `DP` のボリュームは `RW` ボリュームに変更されます。

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

なし

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

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

SMTAPE_BACKUP_SET_ID

string

なし

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

バックアップセット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変数が Y に設定されている場合は、バックアップ処理が完了すると、SMTapeで自動的に作成されたSnapshotコピーはSMTapeによって削除されます。ただし、バックアップアプリケーションが作成したSnapshotコピーは削除されません。

SMTAPE_BREAK_MIRROR

Y または N

N

SMTAPE_BREAK_MIRROR変数が Y に設定されている場合は、リストアが成功すると、種類が DP のボリュームは RW ボリュームに変更されます。

ONTAP 9 マニュアル ( CA08871-402 )

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

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

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

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

本トピックの構成