ndmpadm - NDMP (Network Data Management Protocol) の動作の管理
/usr/sbin/ndmpadm [-? ] subcommand [options] [direct-object]
ndmpadm コマンドを使用して ndmpd(8) デーモンへ照会を行い、アクティブなセッションのステータスの取得、セッションの終了、バックアップデバイスの照会、および現在の NDMP (Network Data Management Protocol) サービスの変数やプロパティーの設定と取得を行うことができます。ndmpadm は、サブコマンドのセットとして実装されており、その多くは独自の直接オブジェクトを保持します。詳細については、各サブコマンドのセクションを参照してください。一部のサブコマンドでは、オプションをサポートしています。詳細については、該当するサブコマンドの説明を参照してください。
ndmpadm コマンドは、次のサブコマンドをサポートします。
指定された認証パスワード処理を無効にします。
指定された認証パスワード処理を有効にします。
NDMP 構成プロパティーの値を取得します。
アクティブなセッションを終了します。
NDMP 構成プロパティーの値を設定します。
サーバーに接続されているテープデバイスの一覧を取得します。
アクティブな NDMP セッションの詳細を表示します。
次のオプションがサポートされています。
すべてのサブコマンドとオプションの一覧を表示します。
ndmpadm コマンドは、次のサブコマンドをサポートします。
add-elig サブコマンドの構文は次のとおりです。
# ndmpadm add-elig {-t <res_type>} [<res_id> ...]
このサブコマンドは、タイプ <res_type> の 1 つ以上のリソースを NDMP の対象とします。オペランド <res_id> は、対象とするリソースを識別します。ただし、<res_id> が省略されている場合は、add-elig によってリソースタイプ <res_type> の制限が解除され、そのタイプのすべてのリソースが実質的に NDMP の対象となります。
delete-elig サブコマンドの構文は次のとおりです。
# ndmpadm delete-elig {-t <res_type>} [<res_id> ...]
このサブコマンドは、タイプ <res_type> の 1 つ以上のリソースを NDMP の対象リソースリストから削除します。オペランド <res_id> は、削除するリソースを識別します。<res_id> によって show-elig で一覧表示されないリソースに名前が付けられる場合は、delete-elig サブコマンドに失敗します。このサブコマンドの呼び出し時に <res_id> が省略された場合は、指定されたタイプのすべてのリソースが NDMP の対象とすることが停止されるため、後続の show-elig で <none> が出力されます。
disable サブコマンドの構文は次のとおりです。
# ndmpadm disable -a auth-type
このサブコマンドは、NDMP クライアントのリモートアクセスに関して auth-type で指定された認証タイプを無効にします。auth-type の有効な値は、cram-md5 または cleartext です。
enable サブコマンドの構文は次のとおりです。
# ndmpadm enable -a auth-type -u username
このサブコマンドは、確認のためにユーザーにパスワードの入力を 2 回求めます。その後、NDMP クライアントアクセス用に指定されたユーザー名とパスワードを使って、指定された認証タイプをアクティブにします。ユーザー名の最大長は 559 文字で、最大パスワード長は 256 文字です。auth-type の有効な値は、cram-md5 または cleartext です。
get サブコマンドの構文は次のとおりです。
# ndmpadm get [-p] [property] [[-p] property=value]...
プロパティー名は、set サブコマンドで使用されるものと同じです。これらについては後述します。プロパティーを指定しない場合は、get サブコマンドによりすべての構成プロパティーが返されます。
kill-sessions サブコマンドを使って、ID に指定された番号のセッションを終了できます。
kill-sessions サブコマンドの構文は次のとおりです。
# ndmpadm kill-sessions ID
set サブコマンドの構文は次のとおりです。
# ndmpadm set [-p] property=value [[-p] property=value]...
set サブコマンドを使って設定可能なプロパティーについては、ndmp(5) のマニュアルページを参照してください。
show-devices サブコマンドの構文は次のとおりです。
# ndmpadm show-devices
このサブコマンドは、システムに現在接続されているテープドライブおよびライブラリの名前、製造元、シリアル番号、その他の情報を一覧表示します。
show-elig サブコマンドの構文は次のとおりです。
# ndmpadm show-elig {-t <res_type>}
NDMP の対象であるタイプ <res_type> のリソースを一覧表示します。対象でないリソースは、NDMP バックアップ/復元で使用できません。show-elig で一覧表示されないリソースを参照するバックアップ/復元を実行しようとすると、失敗します。
show-elig で一覧表示される次のリソース ID は、次のような特別な意味を持っています。
指定されたタイプのリソースは NDMP の対象ではありません。
指定されたタイプのリソースは NDMP の対象です。
show-sessions サブコマンドは、セッションの詳細を表示します。show-sessions サブコマンドの構文は次のとおりです。
# ndmpadm show-sessions [-i tape,scsi,data,diskpool,mover,fileserver] [ID]
show-sessions サブコマンドでは次の引数をサポートしています。
データを取得するインタフェースのタイプを特定します。インタフェースを指定しない場合、show-sessions ではすべてのインタフェースタイプの情報が表示されます。
データを表示する特定のセッションを指定します。ID を指定しない場合は、show-sessions ではすべてのセッションのデータが表示されます。
次のコマンドは、すべての接続のステータスを取得します。
# ndmpadm show-devices使用例 2 特定の接続タイプのステータスを取得する
次のコマンドは、テープおよび SCSI インタフェースのステータスを取得します。
# ndmpadm show-sessions -i scsi,tape使用例 3 プロトコルのバージョンを制限する
次のコマンドは、使用する NDMP プロトコルをバージョン 3 に制限します。
# ndmpadm set -p version=3使用例 4 現在のバージョン番号を取得する
次のコマンドは、現在実行中の NDMP のバージョン番号を取得します。
# ndmpadm get -p version使用例 5 特定のセッションを接続解除する
次のコマンドはセッション 5 を接続解除します。セッション番号は、以前に ndmpadm show-sessions コマンドから取得した番号です。
# ndmpadm kill-session 5使用例 6 NDMP プロパティーの値をすべて取得する
次のコマンドは、NDMP プロパティーの値をすべて取得します。
# ndmpadm get使用例 7 CRAM-MD5 認証を有効にする
次のコマンドは、CRAM-MD5 認証を有効にします。
# ndmpadm enable -a cram-md5 -u admin Enter new password:***** Re-enter password:*****使用例 8 平文パスワード認証を無効にする
次のコマンドは、平文パスワード認証を無効にします。
# ndmpadm disable -a cleartext
正常終了。
エラー (ndmpd デーモンが実行されていないなど) が発生したため、ndmpadm がデーモンと通信できませんでした。
無効なコマンド行オプションが指定されました。
属性についての詳細は、マニュアルページの attributes(7) を参照してください。
|
dump(1), tar(1), ndmp(5), attributes(7), smf(7), ndmpd(8), ndmpstat(8), svccfg(8), syslogd(8)
ndmpd(8) デーモンは、サービス管理機能 (smf(7)) によって、次のサービス識別子として管理されます。
svc:/system/ndmpd
プロパティーの設定や取得など、このサービスに関する管理アクションは、svccfg(8) を使用しても実行できます。たとえば、次の方法で DAR (Direct Access Recovery) モードを有効にできます。
# svccfg -s svc:/system/ndmpd svc:/system/ndmpd> setprop ndmpd/dar-support = yes
プロパティーの一覧を取得するには、次のようにします。
# svccfg -s svc:/system/ndmpd svc:/system/ndmpd> listprop