dmf コマンド

目的

Network Data Administration Facility (NDAF) Admin Client 実行可能プログラムをインプリメントします。

構文

dmf verb object parameter flag

説明

dmf コマンドは、NDAF CLI をインプリメントします。NDAF CLI は NDAF (Network Data Administration Facility) Admin Client 実行可能プログラムのプログラム名です。 NDAF は、複数のマシンからなるネットワークにおいてファイルシステムの作成、配置、複製、継続管理、およびネームスペース統合を集中的に行うための AIX® ソリューションです。

dmf コマンドは NDAF のすべての CLI コマンドのプレフィックスになります。これらのコマンドは、次のような整合性のある構造を持っています。共通プレフィックス、実行可能プログラムの実際の名前 (dmf)、create や delete などの verb、アクションが適用されるオブジェクト、および後続のパラメーター (names など)。これらのパラメーターは定位置パラメーターです。

オブジェクト

dmf コマンドと一緒に使用されるオブジェクトは次のとおりです。

項目	説明
admin	dmadm (データ管理アドミニストレーター) デーモンを表し、admin サーバーの構成に使用されます。 dmadm デーモンが実行される 1 つのサーバー上には、このクラスのオブジェクトを 1 つだけ作成することができます。 dmadm デーモンが実行されるマシンでは、dms (データ管理サーバー) も実行されなければなりません。 admin オブジェクトが作成されると、同じ名前のサーバー・オブジェクトも作成されます。
server	システムの dms (データ管理サーバー) デーモンを表します。また、このサーバー上でホストされるデータ用および汎用サーバー構成用のデフォルト属性も設定します。
cell	セルを表します。セルは、管理およびネームスペースの単位で、admin サーバーによりホストされますが、その admin サーバーによりホストされる他のすべてのセルからは独立しています。セルには、dset からなる独自のネームスペースと、独自の NDAF 役割ベースのセキュリティー・オブジェクトが含まれます。セルは、セルをホストする admin サーバーに定義されている任意のサーバーに配置されます (NFS エクスポートにより表示されます)。
dset	NFS エクスポートされたデータ・パスからなる読み取りまたは書き込みデータ・セット (ローカル・ファイルシステムおよびクラスター・ファイルシステムでホストされるものを含む) を表します。このオブジェクト・クラスは、dset を作成し、その属性とセル内の可視性を管理します (dmf mount オペレーション)。
replica	dset の読み取り専用コピーを表します。コピーは複数のサーバーに配布できます。このオブジェクト・クラスは、レプリカを作成し、その属性、配置、およびセル内の可視性を管理します (dmf mount オペレーション)。
role	オブジェクト管理権限を委任するために NDAF プリンシパルのセットに割り当てられた特権のセットを表します。
status	admin サーバーが発行した要求の状況を表します。

verb

dmf コマンドと一緒に使用される verb は次のとおりです。

項目	説明
オブジェクトの作成および削除
create	論理オブジェクトを作成します。
destroy	オブジェクトとそのすべての内容を破棄します。
既存オブジェクトの検査
enumerate	作成された論理オブジェクトをリストします。
show	オブジェクトの属性を表示します。status オブジェクトと一緒に使用すると、dmf コマンドと show verb は、以前の dmf コマンド要求をリストします。
clear	要求ヒストリーをクリアします。status オブジェクトとのみ使用できます。
オブジェクト属性の更新
set	オブジェクトの非リスト属性の値を設定します。
add_to	オブジェクトのリスト・ベースの属性にキーと値の項目を追加します。
remove_from	オブジェクトのリスト・ベースの属性からキーと値の項目を除去します。
データの更新およびアクセス
update	replica オブジェクトにのみ使用できます。元のソース dset の内容を使用して、レプリカおよびそのクローンのロケーションをリフレッシュさせます。
source	レプリカのソース dset を変更します。
master	別のレプリカ・ロケーションをマスター・ロケーションとして選択します。これは元々レプリカが作成された最初の場所です。マスター・ロケーションは移動できません。
place	cell オブジェクト、replica オブジェクト、および dset オブジェクトにのみ使用できます。 cell オブジェクトの場合は、このアクションにより関連サーバーでの NFS マウント用にセルが使用可能になります。replica オブジェクトの場合は、このアクションにより関連サーバーで追加のコピー・ロケーションが作成されます。dset オブジェクトの場合は、このアクションを -m フラグと一緒に使用して、NDAF フレームワーク外にあるデータへのデータ委託を処理します。
unplace	cell オブジェクト、replica オブジェクト、および dset オブジェクトにのみ使用できます。 cell オブジェクトの場合は、このアクションにより関連サーバーでの NFS マウント用にセルが使用不可になります。replica オブジェクトの場合は、このアクションにより関連サーバーでコピー・ロケーションが除去されます。dset オブジェクトの場合は、このアクションを–m フラグと一緒に使用して、NDAF フレームワーク外にあるデータへのデータ委託を除去します。
mount	dset オブジェクトと replica オブジェクトとのみ使用できます。このオブジェクトをセルの統合ネームスペースに表示します。
unmount	dset オブジェクトと replica オブジェクトとのみ使用できます。このオブジェクトをセルの統合ネームスペースで非表示にします。
resolve	セル内でエクスポートされるパスに対応するオブジェクト (dset オブジェクトまたは replica オブジェクト) を検索します。
問題解決
repair	選択されたサーバーをアンエクスポートして再エクスポートし、内部データ表記を修正します。
validate	admin とオブジェクトのサーバー上の種々の内部オブジェクト・データベースでオブジェクトの整合性を検査します。
check_adm	NDAF 管理データベース内の不整合を検出して報告します。
check_serv	データ・サーバー・データベース内の不整合を検出して報告します。
check_adm_serv	admin データ・サーバー・データベースの整合性を検査します。

フラグ

項目	説明
-a	文字列パラメーターを付加されて、コマンドの送信先の admin サーバーを識別します。区切り文字としてコロンを使用して、通信ポートを追加することができます。デフォルトでは、ポート 28000 が使用されます。
-c	文字列パラメーターを付加されて、このコマンドの対象であるオブジェクトを保持するコンテナーを識別します。通常、コンテナーはセルですが、サーバーになることもあります。
-d	非同期に実行される要求を起動します。コマンドは要求が起動されるとすぐに戻ります。
-e	サーバー作成時に、作成されるオブジェクトが外部 NDAF サーバーを参照するものであって、実際に NDAF データ・サーバーを実行するものではないことを指定します。
-f	destroy または unplace verb と一緒に使用されると、確認プロンプトを出さずにコマンドを強制実行します。
-m	作成される dset のデータが NDAF の外部で管理されることを指定します (これは通常クラスター・マシンに使用されます)。
-o	文字列パラメーターが付加されて、このコマンドの処理対象であるオブジェクトの名前を指定します (dset オブジェクト、replica オブジェクト、または role オブジェクト)。
-r	admin サーバーが生成した要求に UUID (ID) が割り当てたコンソールに、CLI の出力を表示させます。これは dmf show status コマンドによる要求の完了のトラッキングに便利です。
-w	タイムアウトする前に CLI が操作の非同期部分の完了を待機する時間を指定します (デフォルトは 120 秒です)。このフラグは数値パラメーターをとります。単位は秒です。

注: Kerberos プリンシパルとともに使用する場合は、dmf コマンドを実行するユーザーの名前がデフォルトで Kerberos プリンシパルとして使用されます。kinit コマンドを異なるプリンシパル名で発行する場合は、dmf コマンドを起動する前に DMF_PRINCIPAL 環境変数をこのプリンシパル名に設定しておく必要があります。

verb の詳細説明

オブジェクトの作成および削除

create

この verb の構文は次のとおりです。

dmf create object [params]

create verb は、論理オブジェクトを作成します。一緒に指定するパラメーターは、オブジェクトのコンテナーを指すものでなければなりません。作成するオブジェクトの型により、必要なパラメーターの数が異なります。

パラメーター

項目	説明
object	作成するオブジェクトの型を指定します。以下の値があります (それ以外のパラメーターはオブジェクトに依存します)。
	admin admin サーバーにパラメーターとして与える名前が必要です。このオブジェクト・パラメーターの構文は次のとおりです。 `dmf create admin name [-r] [-a admin_server]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 name 作成する admin サーバーの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。注: `dmf create admin my_admin` と入力すると、my_admin サーバー・オブジェクトも作成されます。
	server サーバーの名前、サーバーの DNS 名または IP アドレスとポートが必要です。このオブジェクト・パラメーターの構文は次のとおりです。 `dmf create server name dns_target [-e] [-r] [-a admin_server]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 dns_target サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -e オブジェクトが NDAF の外部にあることを指定します。 name 作成するデータ・サーバーの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。
	cell セルに与える名前が必要です。このオブジェクト・パラメーターの構文は次のとおりです。 `dmf create cell name [-w timeout] [-r] [-a admin_server]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 name 作成するセルの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。 -w timeout コマンドが完了前に待機できる時間を指定します。
	dset dset の名前、ホスティング・サーバー、および (オプションで) サーバー上のローカル・パスが必要です。このオブジェクト・パラメーターの構文は次のとおりです。 `dmf create dset name server [path] [-r] [-a admin_server] [-c container]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container コンテナー (セル名) を指定します。 name 作成する dset の名前を指定します。 path サーバー上のローカル・パスを指定します。 path パラメーターを省略すると、サーバーは dset をデフォルト・プールに書き込みます。作成される dset オブジェクトのパスが dmf show dset コマンドを使用して検査されます。 -r 要求に割り当てられた uuid (ID) を表示します。 server サーバー名を指定します。
	replica レプリカの名前、ホスティング・サーバー、および (オプションで) サーバー上のローカル・パスが必要です。このオブジェクト・パラメーターの構文は次のとおりです。 `dmf create replica name server [path] [-d \| -w timeout] ¥ [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container コンテナー (セル名) を指定します。 -d コマンドを非同期で実行すべきことを指定します。 name 作成するレプリカの名前を指定します。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 path サーバー上のローカル・パスを指定します。 path パラメーターを省略すると、サーバーはレプリカをデフォルトのレプリカ用プールに書き込みます。作成される replica オブジェクトのパスが dmf show replica コマンドを使用して検査されます。 -r 要求に割り当てられた uuid (ID) を表示します。 server サーバー名を指定します。 -w timeout コマンドが完了前に待機できる時間を指定します。
	role 作成するロールの名前が必要です。このオブジェクト・パラメーターの構文は次のとおりです。 `dmf create role name [-r] [-a admin_server] [-c container]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container コンテナー (セル名) を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。

destroy

この verb の構文は次のとおりです。

dmf destroy object [params]

destroy verb は、オブジェクトとそのすべての内容を破棄します。指定されたオブジェクトに依存するオブジェクトも破棄されます。例えば、dset が破棄されると、その内容もすべて破棄されます。セルが破棄されると、そのセルの dset とレプリカもすべて破棄されます。 address パラメーターは、破棄するオブジェクトを指します。

パラメーター

項目	説明
object	破棄するオブジェクトの型を指定します。以下の値があります (それ以外のパラメーターはオブジェクトに依存します)。
	admin このオブジェクト・パラメーターの構文は次のとおりです。 `dmf destroy admin [-r] [-f] [-a admin_server]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -f アクションを確認なしで強制実行します。 -r 要求に割り当てられた uuid (ID) を表示します。
	server このオブジェクト・パラメーターの構文は次のとおりです。 `dmf destroy server [-r] [-f] [-a admin_server] [-c container]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container サーバー名を指定します。 -f アクションを確認なしで強制実行します。 -r 要求に割り当てられた uuid (ID) を表示します。
	cell このオブジェクト・パラメーターの構文は次のとおりです。 `dmf destroy cell [-r] [-f] [-a admin_server] [-c container]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 -f アクションを確認なしで強制実行します。 -r 要求に割り当てられた uuid (ID) を表示します。
	dset このオブジェクト・パラメーターの構文は次のとおりです。 `dmf destroy dset [-r] [-f] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 -f アクションを確認なしで強制実行します。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。
	replica このオブジェクト・パラメーターの構文は次のとおりです。 `dmf destroy replica [-r] [-f] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 -f アクションを確認なしで強制実行します。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。
	role このオブジェクト・パラメーターの構文は次のとおりです。 `dmf destroy role [-r] [-f] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 -f アクションを確認なしで強制実行します。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。

既存オブジェクトの検査

enumerate

この verb の構文は次のとおりです。

dmf enumerate object selector [params ]

enumerate verb は、コンテナー内のオブジェクト (セル内の dset など) のリストを取得します。 2 つの部分からなるパラメーターが必要です。

params パラメーターはオプションであり省略できます。このパラメーターは、? を使用して 1 つの文字と突き合わせ、* を使用して複数の文字と突き合わせるテキスト一致パターン内のフィルターです。このパラメーターは、フィルターに一致するオブジェクトにリストを制限するために使用されます。

オブジェクト	セレクター	パラメーター
admin	cell 該当する admin に作成されたセルのリスト。 server 該当する admin に依存するサーバーのリスト。	このオブジェクト・パラメーターの構文は次のとおりです。 `dmf enumerate admin type [pattern] [-r] [-a admin_server]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 pattern オプションの突き合わせテキスト・パターン。有効な値は ? と * です。 -r 要求に割り当てられた uuid (ID) を表示します。 type 戻すオブジェクトの型を指定します。有効な値は、`server`、`cell`、および `admin` です。
サーバー	dset そのサーバー上に作成された dset のリスト。 replica そのサーバー上に作成されたレプリカのリスト。	このオブジェクト・パラメーターの構文は次のとおりです。 `dmf enumerate server type [pattern] [-r] [-a admin_server] [-c container]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container サーバー名を指定します。 pattern オプションの突き合わせテキスト・パターン。有効な値は ? と * です。 -r 要求に割り当てられた uuid (ID) を表示します。 type 戻すオブジェクトの型を指定します。有効な値は dset と replica です。
cell	dset そのセルの一部である dset のリスト。 replica そのセルの一部であるレプリカのリスト。 role そのセルについて定義されたロールのリスト。	このオブジェクト・パラメーターの構文は次のとおりです。 `dmf enumerate cell type [pattern] [-r] [-a admin_server] [-c container]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 pattern オプションの突き合わせテキスト・パターン。有効な値は ? と * です。 -r 要求に割り当てられた uuid (ID) を表示します。 type 戻すオブジェクトの型を指定します。有効な値は、dset、replica、および role です。
dset	server その dset が配置されているサーバーのリスト。	このオブジェクト・パラメーターの構文は次のとおりです。 `dmf enumerate dset server [pattern] [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 pattern オプションの突き合わせテキスト・パターン。有効な値は ? と * です。 -r 要求に割り当てられた uuid (ID) を表示します。
replica	server そのレプリカが配置されているサーバーのリスト。	このオブジェクト・パラメーターの構文は次のとおりです。 `dmf enumerate replica server [pattern] [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 pattern オプションの突き合わせテキスト・パターン。有効な値は ? と * です。 -r 要求に割り当てられた uuid (ID) を表示します。

show

この verb の構文は次のとおりです。

dmf show object [params]

show verb は、オブジェクトの属性を表示します。status オブジェクトと一緒に使用すると、このアクションにより admin サーバーの要求ヒストリーがリストされます。

パラメーター

項目	説明
object	破棄するオブジェクトの型を指定します。以下の値があります (それ以外のパラメーターはオブジェクトに依存します)。
	admin このオブジェクト・パラメーターの構文は次のとおりです。 `dmf show admin [-r] [-a admin_server]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -r 要求に割り当てられた uuid (ID) を表示します。
	server このオブジェクト・パラメーターの構文は次のとおりです。 `dmf show server [-r] [-a admin_server] [-c container]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container サーバー名を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。
	cell このオブジェクト・パラメーターの構文は次のとおりです。 `dmf show cell [-r] [-a admin_server] [-c container]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。
	dset このオブジェクト・パラメーターの構文は次のとおりです。 `dmf show dset [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。
	replica このオブジェクト・パラメーターの構文は次のとおりです。 `dmf show replica [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。
	role このオブジェクト・パラメーターの構文は次のとおりです。 `dmf show role [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。
	status このオブジェクト・パラメーターの構文は次のとおりです。 `dmf show status depth [-r] [-a admin_server]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 depth 戻すレコードの数を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。

clear

この verb の構文は次のとおりです。

dmf clear status [-r] [-a admin_server]

説明:

項目	説明
-a admin_server	admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。
-r	要求に割り当てられた uuid (ID) を表示します。

clear verb は、status オブジェクトと一緒に使用すると admin の要求ヒストリーをクリアします。その場合、ヒストリーのアクティビティーはすべて失われます。

オブジェクト属性の更新

set

この verb の構文は次のとおりです。

dmf set object key=value [params]

set verb は、オブジェクトの非リスト属性の値を設定します。 add_to verb の場合と異なり、これらは単一属性です。 set verb のパラメーターは、キーと値のペアです。

パラメーター

項目	説明
key	key パラメーターは、オブジェクト・タイプに応じて、以下のいずれかの値になります。 DmMinRpcPort (サーバーに適用) サーバー間のデータ転送に使用する最小 RPC ポート番号を指定します。 DmMaxRpcPort (サーバーに適用) サーバー間のデータ転送に使用する最大 RPC ポート番号を指定します。 DmDefaultRepPath (サーバーに適用) パスが指定されない場合に、サーバーに対して着信レプリカを置くローカル・パスを指定します。 DmDefaultDsetPath (サーバーに適用) パスが指定されない場合に、新規 dset を作成するサーバー上のローカル・パスを指定します。 DmDTAPort (サーバーに適用) 別のサーバーからデータ転送を開始するために使用するデータ・サーバーのポートを指定します。 DmLogLevel (サーバーとセルに適用) ログ・ファイルのロギングのレベルを設定します。デフォルトは notice (通知)です。使用可能な値は次のとおりです。 critical (クリティカル) error (エラー) warning (警告) notice (通知) information (情報) DmLocsMax (セル、レプリカ、dset に適用) オブジェクトの NFS クライアントに返すロケーション委託の最大数を指定します。選択されたロケーションは、クライアントへのロケーションのネットワーク親和性に基づきます。 DmCreateDs (ロールに適用) この値が 0 に設定されている場合、このロールは dset の作成を禁止します。デフォルト値は 1 です。 DmDestroyDs (ロールに適用) この値が 0 に設定されている場合、このロールは dset の消滅を禁止します。デフォルト値は 1 です。 DmModifyDs (ロールに適用) この値が 0 に設定されている場合、このロールは dset の変更を禁止します。デフォルト値は 1 です。 DmDuplicateDs (ロールに適用) この値が 0 に設定されている場合、このロールは dset の複製を禁止します。デフォルト値は 1 です。 DmCreateRole (ロールに適用) この値が 0 に設定されている場合、このロールはロールの作成を禁止します。デフォルト値は 1 です。 DmDestroyRole (ロールに適用) この値が 0 に設定されている場合、このロールはロールの消滅を禁止します。デフォルト値は 1 です。 DmModifyRole (ロールに適用) この値が 0 に設定されている場合、このロールはロールの変更を禁止します。デフォルト値は 1 です。
key (続き)	DmOwner (dset とレプリカに適用) dset ルート・ディレクトリーに設定する所有者を指定します。デフォルト値は root です。 DmGroup (dset とレプリカに適用) dset ルート・ディレクトリーに設定するグループを指定します。デフォルト値は root です。 DmMode (dset とレプリカに適用) dset ルート・ディレクトリーに設定するモードを指定します。
object	オブジェクトの型を指定します。以下の値があります (それ以外のパラメーターはオブジェクトに依存します)。
	server このオブジェクト・パラメーターの構文は次のとおりです。 `dmf set server key=value [-r] [-a admin_server] [-c container]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container サーバー名を指定します。 key=value 属性と、その属性に割り当てる値を指定します。有効なキーは、DmMinRpcPort、DmMaxRpcPort、DmDefaultRepPath、 DmDefaultDsetPath、DmDTAPort、DmLogLevel です。 -r 要求に割り当てられた uuid (ID) を表示します。
	cell このオブジェクト・パラメーターの構文は次のとおりです。 `dmf set cell key=value [-r] [-a admin_server] [-c container]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 key=value 属性と、その属性に割り当てる値を指定します。有効なキーは、DmLogLevel および DmLocsMax です。 -r 要求に割り当てられた uuid (ID) を表示します。
	dset このオブジェクト・パラメーターの構文は次のとおりです。 `dmf set dset key=value [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 key=value 属性と、その属性に割り当てる値を指定します。有効なキーは、DmOwner、DmGroup、DmMode、DmLocsMax です。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。
	replica このオブジェクト・パラメーターの構文は次のとおりです。 `dmf set replica key=value [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 key=value 属性と、その属性に割り当てる値を指定します。有効なキーは、DmOwner、DmGroup、DmMode、DmLocsMax です。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。
	role このオブジェクト・パラメーターの構文は次のとおりです。 `dmf set role key=value [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 key=value 属性と、その属性に割り当てる値を指定します。有効なキーは、 DmCreateDs、DmDestroyDs、DmModifyDs、DmDuplicateDs、DmCreateRole、DmDestroyRole、DmModifyRole です。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。

add_to

この verb の構文は次のとおりです。

dmf add_to object key=value [params]

add_to verb は、オブジェクトのリスト・ベースの属性にキーと値の項目を追加します。 add_to verb の追加パラメーターにより、影響を受ける NDAF オブジェクトが指定されます。

パラメーター

項目	説明
key	key パラメーターは、オブジェクト・タイプに応じて、以下のいずれかの値になります。 DmPrincipal この NDAF オブジェクトの所有者であるユーザーのリストを変更するために使用されます。デフォルトでは、オブジェクトを作成したユーザーのみが DmPrincipal です。 DmClientDnsName サーバー・オブジェクトに使用されます。dset またはレプリカにこのサーバー上のロケーションがある場合は、この DnsName が NFSv4 を介した要求時にこの dset またはレプリカのロケーション・リストに表示されます。 DmOwningRole このオブジェクトに対してアクセス権限の委任を制御するロールを定義します。 DmTransferTable dset とレプリカのロケーション間のデータ転送に使用するプロトコルのリストを定義します。デフォルトでは、標準のコピー・プロトコルが使用されます。rsync プロトコルをリストに追加することもできます。このプロトコルは、ソースとターゲットの機能に応じて、データ転送中にネゴシエーションされます。有効な DmTransferTable リストの値は、copy と rsync です。
object	オブジェクトの型を指定します。以下の値があります (それ以外のパラメーターはオブジェクトに依存します)。
	admin このオブジェクト・パラメーターの構文は次のとおりです。 `dmf add_to admin key=value [-r] [-a admin_server]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 key=value 属性と、その属性に割り当てる値を指定します。有効なキーは DmPrincipal です。 -r 要求に割り当てられた uuid (ID) を表示します。
	server このオブジェクト・パラメーターの構文は次のとおりです。 `dmf add_to server key=value [-r] [-a admin_server] [-c container]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container サーバー名を指定します。 key=value 属性と、その属性に割り当てる値を指定します。有効なキーは、DmPrincipal、DmClientDnsName、および DmTransferTable です。 -r 要求に割り当てられた uuid (ID) を表示します。
	cell このオブジェクト・パラメーターの構文は次のとおりです。 `dmf add_to cell key=value [-r] [-a admin_server] [-c container] ]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 key=value 属性と、その属性に割り当てる値を指定します。有効なキーは DmPrincipal です。 -r 要求に割り当てられた uuid (ID) を表示します。
	dset このオブジェクト・パラメーターの構文は次のとおりです。 `dmf add_to dset key=value [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 key=value 属性と、その属性に割り当てる値を指定します。有効なキーは、DmPrincipal、DmOwningRole、および DmTransferTable です。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。
	replica このオブジェクト・パラメーターの構文は次のとおりです。 `dmf add_to replica key=value [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 key=value 属性と、その属性に割り当てる値を指定します。有効なキーは、DmPrincipal、DmOwningRole、および DmTransferTable です。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。
	role このオブジェクト・パラメーターの構文は次のとおりです。 `dmf add_to role key=value [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 key=value 属性と、その属性に割り当てる値を指定します。有効なキーは、DmPrincipal、DmOwningRole、DmServer、および DmMember です。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。

remove_from

この verb の構文は次のとおりです。

dmf remove_from object key=value [params]

remove_from verb は、オブジェクトのリスト・ベースの属性からキーと値の項目を除去します。 remove_from verb の追加パラメーターにより、影響を受ける NDAF オブジェクトが指定されます。

dmf show コマンドを使用すると、属性リストを検査できます。

パラメーター

項目	説明
key	key はオブジェクト・タイプに応じて、以下のいずれかの値になります。 DmPrincipal この NDAF オブジェクトの所有者であるユーザーのリストを変更するために使用されます。デフォルトでは、オブジェクトを作成したユーザーのみが DmPrincipal です。 DmClientDnsName サーバー・オブジェクトに使用されます。dset またはレプリカにこのサーバー上のロケーションがある場合は、この DnsName が NFSv4 を介した要求時にこの dset またはレプリカのロケーション・リストに表示されます。 DmOwningRole このオブジェクトに対してアクセス権限の委任を制御するロールを定義します。 DmTransferTable dset とレプリカのロケーション間のデータ転送に使用するプロトコルのリストを定義します。デフォルトでは、標準のコピー・プロトコルが使用されます。rsync プロトコルをリストに追加することもできます。このプロトコルは、ソースとターゲットの機能に応じて、データ転送中にネゴシエーションされます。
object	オブジェクトの型を指定します。以下の値があります (それ以外のパラメーターはオブジェクトに依存します)。
	admin このオブジェクト・パラメーターの構文は次のとおりです。 `dmf remove_from admin key=value [-r] [-a admin_server]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 key=value 属性と、その属性に割り当てる値を指定します。有効なキーは DmPrincipal です。 -r 要求に割り当てられた uuid (ID) を表示します。
	server このオブジェクト・パラメーターの構文は次のとおりです。 `dmf remove_from server key=value [-r] [-a admin_server] [-c container]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container サーバー名を指定します。 key=value 属性と、その属性に割り当てる値を指定します。有効なキーは、DmPrincipal、DmClientDnsName、および DmTransferTable です。 -r 要求に割り当てられた uuid (ID) を表示します。
	cell このオブジェクト・パラメーターの構文は次のとおりです。 `dmf remove_from cell key=value [-r] [-a admin_server] [-c container]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 key=value 属性と、その属性に割り当てる値を指定します。有効なキーは DmPrincipal です。 -r 要求に割り当てられた uuid (ID) を表示します。
	dset このオブジェクト・パラメーターの構文は次のとおりです。 `dmf remove_from dset key=value [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 key=value 属性と、その属性に割り当てる値を指定します。有効なキーは、DmPrincipal、DmOwningRole、および DmTransferTable です。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。
	replica このオブジェクト・パラメーターの構文は次のとおりです。 `dmf remove_from replica key=value [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 key=value 属性と、その属性に割り当てる値を指定します。有効なキーは、DmPrincipal、DmOwningRole、および DmTransferTable です。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。
	role このオブジェクト・パラメーターの構文は次のとおりです。 `dmf remove_from role key=value [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 key=value 属性と、その属性に割り当てる値を指定します。有効なキーは、DmPrincipal、DmOwningRole、DmServer、および DmMember です。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。

データの更新およびアクセス

update

この verb の構文は次のとおりです。

dmf update replica [-d | -w timeout] [-r] [-a admin_server] [-c container] [ -o object]

説明:

項目	説明
-a admin_server	admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。
-c container	セル名を指定します。
-d	コマンドを非同期で実行すべきことを指定します。
-o object	このコマンドの処理対象となるオブジェクトの名前を指定します。
-r	要求に割り当てられた uuid (ID) を表示します。
-w timeout	コマンドが完了前に待機できる時間を指定します。

update verb は、元のソース dset の内容を使用して、レプリカおよびそのクローンのロケーションをリフレッシュさせます。

注: update 操作時のデータ転送にコピーまたは rsync プロトコルを使用できます。使用するプロトコルを指定するには、『add_to』セクションの変形可能フィールドを参照してください。

source

この verb の構文は次のとおりです。

dmf source replica source_dset [-r] [-a admin_server] [ -c container] [-o object]

説明:

項目	説明
-a admin_server	admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。
-c container	セル名を指定します。
-o object	このコマンドの処理対象となるオブジェクトの名前を指定します。
source_dset	レプリカの新規ソースになる dset を指定します。
-r	要求に割り当てられた uuid (ID) を表示します。

source verb は、レプリカのソース dset を変更します。

master

この verb の構文は次のとおりです。

dmf master replica server [ path] [-r] [-a admin_server] [-c container] [-o object]

説明:

項目	説明
-a admin_server	admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。
-c container	セル名を指定します。
-o object	このコマンドの処理対象となるオブジェクトの名前を指定します。
path	レプリカ・ロケーションのパスを指定します。
-r	要求に割り当てられた uuid (ID) を表示します。
server	サーバー名を指定します。

master verb は、別のレプリカ・ロケーションをマスター・ロケーションとして選択します。これはレプリカのマスター・ロケーションの変更が必要な場合に使用します。マスター・ロケーションは、いずれかの update コマンドで更新された最初のロケーションです。その他のロケーションは、後で非同期に更新されます。マスター・ロケーションは移動できません。また、マスター・ロケーションは、データ更新を他のロケーションに送信するために使用します。このため、このロケーションは、適切なデータ転送パフォーマンスを提供するために慎重に選択する必要があります。

place

この verb の構文は次のとおりです。

place verb は、サーバーにオブジェクトを配置します。セル、レプリカ、または dset に適用できます。パラメーターはオブジェクトの型により異なります。セルとレプリカまたは dset では、アクションが異なります。

セルの場合、place verb はサーバーを通してセルが可視になるようにするために使用します。セルはサーバーの nfsroot の下にエクスポートされ、マウント済み dset およびレプリカへの参照が入ります。 dmf place cell コマンドのパラメーターは、サーバーの名前です。このパラメーターを指定した場合、セルのルート・ネームスペースがそのサーバーに配置されます。

レプリカの場合、place verb はサーバー上の指定された位置にレプリカのクローンを作成します。レプリカがセルにマウントされた場合、このクローン位置への参照が、NFS クライアントに戻される参照リストに追加されます。このリスト内の参照の順序は、ネットワーク親和性によって決まります。レプリカのクローン位置は、いずれも更新アクション要求が出されると非同期に更新されます。 dmf place replica コマンドは、サーバーと、オプションでサーバー上のローカル・パスを、パラメーターとしてとります。次に例を示します。

dmf place replica my_server local_path -a my_admin -c 
my_cell -o my_replica

dset の場合、place verb は、GPFS などのクラスター・ファイルシステム環境で使用され、クラスター内の異なるサーバーに dset の一貫したビューを提供します。 -m フラグを指定しなければなりません。ターゲット dset に対する NDAF 管理またはアクションは行われません。次に例を示します。

dmf place dset my_external_server external_server_path -m 
-a my_admin -c my_cell -o my_dset

place dset アクションは、GPFS などのクラスター・ファイルシステム環境でのみ使用可能です。その環境では、システムによる基礎データの一貫したビューを前提としており、NDAF によるビューは前提としません。

パラメーター

項目説明

項目	説明
cell	このオブジェクト・パラメーターの構文は次のとおりです。 `dmf place cell server [-r] [-a admin_server] [-c container]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。 server サーバー名を指定します。
dset	このオブジェクト・パラメーターの構文は次のとおりです。 `dmf place dset server [path] [-d \| -w timeout] [-r] [-m] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -d コマンドを非同期で実行すべきことを指定します。 -m 作成される dset のデータが NDAF の外部で管理される (クラスター・マシンに使用される) ことを指定します。 path データが常駐する場所のパスを指定します。 -r 要求に割り当てられた uuid (ID) を表示します。 server サーバー名を指定します。 -w timeout コマンドが完了前に待機できる時間を指定します。
replica	このオブジェクト・パラメーターの構文は次のとおりです。 `dmf place replica server [path] [-d \| -w timeout] [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -d コマンドを非同期で実行すべきことを指定します。 path データが常駐する場所のパスを指定します。 -r 要求に割り当てられた uuid (ID) を表示します。 server サーバー名を指定します。 -w timeout コマンドが完了前に待機できる時間を指定します。

cell

このオブジェクト・パラメーターの構文は次のとおりです。

dmf place cell server  [-r] [-a admin_server] [-c container]

説明:

-a admin_server: admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。
-c container: セル名を指定します。
-r: 要求に割り当てられた uuid (ID) を表示します。
server: サーバー名を指定します。

dset

このオブジェクト・パラメーターの構文は次のとおりです。

dmf place dset server  [path] [-d | -w timeout] [-r] [-m] [-a admin_server] 
[-c container] [-o object]

説明:

-a admin_server: admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。
-c container: セル名を指定します。
-o object: このコマンドの処理対象となるオブジェクトの名前を指定します。
-d: コマンドを非同期で実行すべきことを指定します。
-m: 作成される dset のデータが NDAF の外部で管理される (クラスター・マシンに使用される) ことを指定します。
path: データが常駐する場所のパスを指定します。
-r: 要求に割り当てられた uuid (ID) を表示します。
server: サーバー名を指定します。
-w timeout: コマンドが完了前に待機できる時間を指定します。

replica

このオブジェクト・パラメーターの構文は次のとおりです。

dmf place replica server  [path] [-d | -w timeout] [-r] [-a admin_server] 
[-c container] [-o object]

説明:

-a admin_server: admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。
-c container: セル名を指定します。
-o object: このコマンドの処理対象となるオブジェクトの名前を指定します。
-d: コマンドを非同期で実行すべきことを指定します。
path: データが常駐する場所のパスを指定します。
-r: 要求に割り当てられた uuid (ID) を表示します。
server: サーバー名を指定します。
-w timeout: コマンドが完了前に待機できる時間を指定します。

unplace

この verb の構文は次のとおりです。

セルとレプリカの両方をサーバーから配置解除できます。このアクションは、セル、dset、またはレプリカ上で dmf unplace が使用されるかどうかで異なります。

セル・オブジェクトの場合、unplace アクションにより、NFS ユーザーがサーバー上でセルをマウントできないようにします。

dmf unplace cell server [ -r] [-f] [-a admin_server ] [-c container]

説明:

項目	説明
-a admin_server	admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。
-c container	セル名を指定します。
-f	アクションを確認なしで強制実行します。
-r	要求に割り当てられた uuid (ID) を表示します。
server	サーバー名を指定します。

unplace cell verb は、サーバーからセルを除去します。 dset またはレプリカのデータは除去されません。また、コマンド・ラインで指定されたサーバー上のこのデータへのパスもアンエクスポートされません。このサーバーの他のクライアントは、依然としてデータにアクセスできます。 unplace cell verb は、そのサーバー上の NFS を介してセルをアンエクスポートします。他のサーバー上では、オブジェクトは可視のままです。

dset オブジェクトの場合は、unplace アクションにより NDAF 外にあるデータへの委託が除去されます。

dmf unplace dset server [path] [-r] [-f] [–m] [-a admin_server] [-c container] [–o object]

説明:

項目	説明
-a admin_server	admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。
-c container	セル名を指定します。
-f	アクションを確認なしで強制実行します。
-m	作成される dset のデータが NDAF の外部で管理される (クラスター・マシンに使用される) ことを指定します。
-o object	このコマンドの処理対象となるオブジェクトの名前を指定します。
path	データが常駐し、除去される場所のパスを指定します。
-r	要求に割り当てられた uuid (ID) を表示します。
server	サーバー名を指定します。

unplace dset verb により、NDAF 外にあるデータへの委託が除去されます。 unplace dset verb は、dset またはレプリカからデータを除去しません。また、コマンド・ラインで指定されたサーバー上のこのデータへのパスもアンエクスポートされません。このサーバーの他のクライアントは、依然としてデータにアクセスできます。

レプリカの場合、unplace アクションは、レプリカのロケーションを除去します。

dmf unplace replica server [path] [-r] [-f] [-a admin_server] [-c container] [–o object]

説明:

項目	説明
-a admin_server	admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。
-c container	セル名を指定します。
-o object	このコマンドの処理対象となるオブジェクトの名前を指定します。
-f	アクションを確認なしで強制実行します。
path	データが常駐し、除去される場所のパスを指定します。
-r	要求に割り当てられた uuid (ID) を表示します。
server	サーバー名を指定します。

レプリカの場合、unplace verb はそのサーバー上のレプリカのクローンのロケーションを除去します。このロケーションはアンエクスポートされ、その内容は破棄されます。このロケーションへの参照は、セル内のこのレプリカについて NFS が戻す参照リストから除去されます。このレプリカのその他のロケーションは同じままです。最初のレプリカ・ロケーション (create で作成されたロケーション) は、レプリカのマスター・ロケーション と呼ばれます。このロケーションは、別のロケーションがマスター・ロケーションとして選択されて最初のロケーションに置き換わらない限り、配置解除することはできません (詳しくは、 master verb を参照してください)。

サーバー上のレプリカのロケーションが 1 つだけの場合は、パスの指定は必須ではありません。複数のパスが使用可能な場合は、エラー・メッセージが戻されます。

注:

セルは admin から配置解除できません。
レプリカの最後のロケーションは配置解除できません。代りに destroy verb を使用してください。

mount

この verb の構文は次のとおりです。

dmf mount object [params]

mount verb は、統合ネームスペースに dset またはレプリカをマウントして、セル内で NFS クライアントに可視にします。実際には、dset (作成時に NFSv4 にエクスポートされたもの) またはレプリカへの NFSv4 参照がセルに追加されます。

パラメーター

項目説明

object 作成するオブジェクトの型を指定します。以下の値があります (それ以外のパラメーターはオブジェクトに依存します)。

項目	説明
object	作成するオブジェクトの型を指定します。以下の値があります (それ以外のパラメーターはオブジェクトに依存します)。
	dset このオブジェクト・パラメーターの構文は次のとおりです。 `dmf mount dset mount_path [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 mount_path ネームスペース内のマウント・パスを指定します。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。
	replica このオブジェクト・パラメーターの構文は次のとおりです。 `dmf mount replica mount_path [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 mount_path ネームスペース内のマウント・パスを指定します。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。

dset このオブジェクト・パラメーターの構文は次のとおりです。

dmf mount dset mount_path [-r] [-a admin_server] [-c container] [-o object]

説明:

-a admin_server: admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。
-c container: セル名を指定します。
mount_path: ネームスペース内のマウント・パスを指定します。
-o object: このコマンドの処理対象となるオブジェクトの名前を指定します。
-r: 要求に割り当てられた uuid (ID) を表示します。

replica このオブジェクト・パラメーターの構文は次のとおりです。

dmf mount replica mount_path [-r] [-a admin_server] [-c container] [-o object]

説明:

-a admin_server: admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。
-c container: セル名を指定します。
mount_path: ネームスペース内のマウント・パスを指定します。
-o object: このコマンドの処理対象となるオブジェクトの名前を指定します。
-r: 要求に割り当てられた uuid (ID) を表示します。

unmount

この verb の構文は次のとおりです。

dmf unmount object [params]

unmount verb により、dset レプリカ委託がセルの統合ネームスペースから除去されます。その結果、これらは NFS クライアントのセルには表示されません。パラメーターは dset の既存マウント・ポイントです。

注: NFS クライアントが既に参照を解決している場合、その NFS クライアントはアンマウント後でもこの参照にアクセスすることができます。参照が複製された dset であった場合は、アンマウントの結果として参照が除去される前に、そのレプリカが更新済みになっていることがあります。

パラメーター

項目説明

object 作成するオブジェクトの型を指定します。以下の値があります (それ以外のパラメーターはオブジェクトに依存します)。

項目	説明
object	作成するオブジェクトの型を指定します。以下の値があります (それ以外のパラメーターはオブジェクトに依存します)。
	dset このオブジェクト・パラメーターの構文は次のとおりです。 `dmf unmount dset mount_path [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 mount_path ネームスペース内のマウント・パスを指定します。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。
	replica このオブジェクト・パラメーターの構文は次のとおりです。 `dmf unmount replica mount_path [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 mount_path ネームスペース内のマウント・パスを指定します。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。

dset このオブジェクト・パラメーターの構文は次のとおりです。

dmf unmount dset mount_path [-r] [-a admin_server] [-c container] [-o object]

説明:

-a admin_server: admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。
-c container: セル名を指定します。
mount_path: ネームスペース内のマウント・パスを指定します。
-o object: このコマンドの処理対象となるオブジェクトの名前を指定します。
-r: 要求に割り当てられた uuid (ID) を表示します。

replica このオブジェクト・パラメーターの構文は次のとおりです。

dmf unmount replica mount_path [-r] [-a admin_server] [-c container] [-o object]

説明:

-a admin_server: admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。
-c container: セル名を指定します。
mount_path: ネームスペース内のマウント・パスを指定します。
-o object: このコマンドの処理対象となるオブジェクトの名前を指定します。
-r: 要求に割り当てられた uuid (ID) を表示します。

resolve

この verb の構文は次のとおりです。

dmf resolve cell path [ -r] [-a admin_server] [-c container]

説明:

項目	説明
-a admin_server	admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。
-c container	セル名を指定します。
path	検索するパスを指定します。
-r	要求に割り当てられた uuid (ID) を表示します。

resolve verb は、セル内のパスに対応する dset またはレプリカを検索します。パラメーターは、検索するパスです (与えられているパスは、dmf mount コマンドで指定された NDAF マウント・ポイントのパスです)。

問題解決

repair

この verb の構文は次のとおりです。

dmf repair server [-r] [-V] [-U] [-R] [-a <admin_server>] [-c <container>]

説明:

項目	説明
-r	要求に割り当てられた uuid (ID) を表示します。
-V	ロケーションを検証することを指定します (デフォルト)。
-U	不良ロケーションをアンエクスポートすることを指定します。
-R	不良ロケーションを修復することを指定します。
-a value	ポートがコロン区切りを使用して追加される可能性のある admin サーバーの DNS 名または IP アドレスを指定します。
-c value	サーバー名を指定します。

dmf repair コマンドは、データ・サーバーで dset とレプリカのリカバリーを行います。このコマンドを使用して、NDAF dset データと状態データがバックアップされる場合に、壊れたファイルシステムを復元したり、データ・サーバーを別のシステムに移行します。

-V フラグは、選択されたデータ・サーバー上の dset とレプリカのロケーションを検査するために使用します。フラグが設定されていない場合は、これがデフォルト・アクションです。

-V フラグにより矛盾が報告された場合は、-R フラグを使用して内部 dset とレプリカのディスクリプターを修復できます。また、これは dset とレプリカのロケーションを再エクスポートします。

ロケーションが壊れている場合は、repair (-R) アクションを行う前に、それらのロケーションのアンエクスポートを要求できます。これを行うには、dmf repair コマンドを -U (アンマウント) フラグと一緒に実行します。アンエクスポート・アクションが行われると、バックアップからのファイルシステムを破棄、再作成、およびリカバリーすることができます。最後に、dmf repair server コマンドを -R オプションと一緒に使用して、サーバーをリカバリーし、ファイルシステム内の dset を再エクスポートします。

validate

この verb の構文は次のとおりです。

dmf validate object [params]

validate verb は、admin 上およびオブジェクトのサーバー上のオブジェクトの整合性を検査します。 admin サーバー・デーモンに照会が送られ、このデーモンが admin のデータベースとオブジェクトのサーバーのデータベースを照会します。検出された整合性のある内容はすべて戻されます。

パラメーター

項目	説明
object	検査するオブジェクトの型を指定します。以下の値があります (それ以外のパラメーターはオブジェクトに依存します)。
	server このオブジェクト・パラメーターの構文は次のとおりです。 `dmf validate server [-r] [-a admin_server] [-c container]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container サーバー名を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。
	dset このオブジェクト・パラメーターの構文は次のとおりです。 `dmf validate dset [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。
	replica このオブジェクト・パラメーターの構文は次のとおりです。 `dmf validate replica [-r] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server admin サーバーの DNS 名または IP アドレスを指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。
	role このオブジェクト・パラメーターの構文は次のとおりです。 `dmf validate role [-r] [-f] [-a admin_server] [-c container] [-o object]` 説明: -a admin_server 作成するデータ・サーバーの名前を指定します。区切り文字としてコロンを使用して、ポートを追加することができます。 -c container セル名を指定します。 -f アクションを確認なしで強制実行します。 -o object このコマンドの処理対象となるオブジェクトの名前を指定します。 -r 要求に割り当てられた uuid (ID) を表示します。

check_adm

この verb の構文は次のとおりです。

dmf check_adm admin [-a machine]

check_adm verb は、NDAF 管理データベース内の不整合を検出して報告します。

このツールは、各レコードを比較して、不一致が検出されるたびにエラー・レポートを作成します。クライアント・コマンドが正しく実行されている限り、戻りコードは 0 です。それ以外の場合、例えば CLI と admin サーバー間の通信に問題があった場合は、非ヌルのエラーが戻されます。

注: 他の NDAF 操作の実行中に check_adm verb を使用すると、不正確な結果が報告されることがあるため、そのような使用は避けてください。

check_serv

この verb の構文は次のとおりです。

dmf check_serv server [-a machine] [-c server]

check_serv verb は、データ・サーバー・データベース内の不整合を検出して報告します。

注: 他の NDAF 操作の実行中に check_serv verb を使用すると、不正確な結果が報告されることがあるため、そのような使用は避けてください。

check_adm_serv

この verb の構文は次のとおりです。

dmf check_adm_serv admin [ -a machine] [-c server]

dmf check_adm_serv admin [ -a machine]

または

dmf check_adm_serv server [-a machine] [-c server]

check_adm_serv verb は、管理データ・サーバー・データベースの整合性を検査します。

注: 他の NDAF 操作の実行中に check_adm_serv verb を使用すると、不正確な結果が報告されることがあるため、そのような使用は避けてください。

終了状況

項目	説明
0	コマンドは正常に完了しました。
>0	エラーが発生しました。

例

admin オブジェクトとそれにリンクされたデータ・サーバーを、dms デーモンおよび dmadm デーモンが実行されるホスト名に作成するには、次のように入力します。
```
dmf create admin my_admin -a admin_host
```
統合内に新しいサーバーを論理的に作成 (統合にサーバーを追加) し、新しいサーバーの名前を server_name、DNS 名を server_dns_name とするには、次のように入力します。
```
dmf create server server_name server_dns_name -a admin_host
```
該当のマシン上で dms デーモンが稼働している必要があります。
admin サーバーにセルを作成し、そのセルを NFS クライアントがマウントするネームスペースのルートにするには、次のように入力します。
```
dmf create cell my_cell -a admin_host
```
セル内に dset を作成し、その dset の名前を my_dset にするには、次のように入力します。
```
dmf create dset my_dset server_name server_path -a admin_host
 -c my_cell
```
dset のデータは server_path の server_dns_name に存在することになります。

dset のレプリカを作成するには、次のように入力します。

dmf create replica my_replica server_name replica_path -a admin_host
 -c my_cell -o my_dset

位置

/usr/bin/dmf

セキュリティー

RBAC ユーザーおよび Trusted AIX ユーザーへの注意: このコマンドは特権命令を実行できます。特権命令を実行できるのは特権ユーザーのみです。権限および特権についての詳細情報は、「セキュリティー」の『特権コマンド・データベース』を参照してください。このコマンドに関連した特権および権限のリストについては、lssecattr コマンドまたは getcmdattr サブコマンドの項を参照してください。