Veritas NetBackup™ コマンドリファレンスガイド
- 概要
- 付録 A. NetBackup コマンド
名前
nbhostmgmt — ホスト ID のホスト名へのマッピングを管理するために使用します。
概要
nbhostmgmt -add -hostid hostid | -host host -mappingname mappingname [-isshared] [-reason reason] [-server master_server]
nbhostmgmt -addhost -host host [-reason reason] [-server master_server]
nbhostmgmt -allowautoreissuecert -hostid hostid | -host host -autoreissue 0|1 [-reason reason] [-server master_server]
nbhostmgmt -delete -hostid hostid | -host host -mappingname mappingname [-reason reason] [-server master_server]
nbhostmgmt -list [-short | -json | -json_compact] [-hostid hostid | -host host | -approved | -pending | -conflict] [-server master_server]
nbhostmgmt -addcomment -hostid hostid | -host host -comment comment [-server master_server]
nbhostmgmt -deletecomment -hostid hostid | -host host [-server master_server]
nbhostmgmt -help
UNIX システムでは、このコマンドへのディレクトリパスは /usr/openv/netbackup/bin/admincmd/ です。
Windows システムでは、このコマンドへのディレクトリパスは install_path\NetBackup\bin\admincmd\
です。
説明
nbhostmgmt コマンドを使用して、ホスト ID のホスト名または IP アドレスへのマッピングを管理します。ホストは別名で識別できます。このコマンドは、別名をそれぞれのホスト ID にマッピングする場合に使用します。このコマンドを使用してマッピングを追加、削除、リストします。このコマンドは、ルートユーザーのみが実行できます。
nbhostmgmt コマンドを実行する前に、bpnbat - login - loginType WEB コマンドを実行する必要があります。bpnbat コマンドにより、Web サービスのログオンが認証されます。
オプション
- -add | -a
このオプションは、ホスト ID のホスト名または IP アドレスへのマッピングを指定したホストで追加して承認する場合に使用します。
メモ:
最初の共有を追加するには、-isshared オプションを指定せずに -add を使用します。その他すべての共有を追加するには、-isshared オプションを指定します。
- -addcomment | -ac
このオプションは、プライマリホストにコメントを追加する場合に使用します。nbhostmgmt -list オプションを使用してコメントを表示できます。追加したコメントはプライマリホストにのみ関連付けられ、他のマッピング済みホスト名には関連付けられません。コメントは編集できません。既存のコメントは上書きまたは削除のみが可能です。
- -ah | -addhost
ホストデータベースでホストを追加するには、このオプションを使用します。
このオプションでは、NetBackup 管理者が autoreissue パラメータを設定できるように、ホストエントリを追加できます。autoreissue パラメータでは、再発行トークンを要求せずに証明書をホストで配備できます。自動イメージレプリケーション (AIR) 設定での Bare Metal Restore 中に、ホストエントリをターゲットドメインのホストデータベースで追加する必要があります。
ベリタスは、Bare Metal Restore AIR 設定などの特定のシナリオ以外では、ホストを手動で追加することは推奨しません。
- -aa | -allowautoreissuecert
このオプションを使用すると、指定したホストまたはホスト ID に対して autoreissue パラメータを設定できます。autoreissue パラメータでは、再発行トークンを要求せずに証明書をホストで配備できます。autoreissue パラメータは、プライマリホストにのみ関連付けられ、代替マップ名には関連付けられません。
- -approved |-ap
このオプションは、承認されたマッピング済みのホスト名または IP アドレスをリストする場合に使用します。
- -comment | -c
このオプションは、プライマリホストに追加するコメントの内容を指定する場合に使用します。コメントを追加するホストまたはホスト ID を指定する必要があります。コメントに空白が含まれている場合は、二重引用符でコメントを囲む必要があります ("...")。comment フィールドには最大 2048 文字入力できます。
- -conflict | -cf
このオプションは、エントリが他のマッピングと競合しているマッピング済みのホスト名または IP アドレスをリストする場合に使用します。
- -delete | -d
このオプションは、ホスト ID のホスト名または IP アドレスへのマッピングを削除する場合に使用します。
- -deletecomment | -dc
このオプションは、指定したホストまたはホスト ID のコメントを削除する場合に使用します。このオプションでは、プライマリホストに関連付けられたコメントを削除します。
nbhostmgmt-deletecomment オプションを使用してホストに存在しないコメントを削除しようとすると、正常に更新するための対応するエントリが nbauditreport に表示されます。
- -help | -h
コマンドラインの使用方法を示すメッセージを表示します。
- -host | -n
プライマリホスト名、代替のマッピング済みホスト名、または IP アドレスを指定します。add と delete の操作では、代替のマッピング済みホスト名または IP アドレスが単一のホスト ID と関連付けられていることを確認します。
- -hostid | -i
NetBackup ホスト ID を指定します。
- -isshared | -is
共有としてマッピング名を追加することを示します。
メモ:
最初の共有を追加するには、-isshared オプションを指定せずに -add を使用します。その他すべての共有を追加するには、-isshared オプションを指定します。
- -json | -j
このオプションは、
json
形式で複数行にわたってデータを生成します。
- -json_compact | -jc
このオプションは、
json
形式で 1 行のデータを生成します。
- -list | -li
このオプションは、さまざまなフィルタに基づいてマッピング済みのホスト名または IP アドレスをリストする場合に使用します。名前またはアドレスが承認済み、承認の保留中、競合しているかに基づいてリストできます。
- -mappingname | -hm
追加または削除するホスト名または IP アドレスを指定します。
- -pending | -p
このオプションは、承認が保留中のマッピング済みのホスト名または IP アドレスをリストする場合に使用します。
- -reason | -r
このオプションは、コマンド処理の理由を指定する場合に使用します。入力した文字列がキャプチャされ、監査レポートに表示されます。この文字列は二重引用符 ("...") で囲んでください。reason フィールドには最大 512 文字入力できます。ダッシュの文字 (-) で始めたり、一重引用符 (') を含めることはできません。
- -server | -s
通信を確立する必要がある NetBackup マスターサーバーの名前を示します。-server オプションのデフォルト値は、
bp.conf
ファイルにリストされている最初のサーバー名です。
- -short | -l
このオプションは、ホスト ID とマッピング済みのホスト名のみをリストする場合に使用します。
例
例 1: ホスト ID のホスト名へのマッピングを追加します。
#nbhostmgmt - add -hostid 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0 - mappingname testhost1 testhost1 is successfully mapped to 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0.
例 2: ホスト名を指定して、ホスト ID のホスト名へのマッピングを追加します。
#nbhostmgmt -add -host testhost1 -mappingname testhost2 testhost2 is successfully mapped to 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0.
例 3: 保留中のマッピングを承認します。この例では、マッピング済みホスト名 host3 への testhost3 のマッピングを承認します。
#nbhostmgmt - add -host host3 - mappingname testhost3 testhost3 is successfully updated.
例 4: ホスト ID を指定して、ホスト ID のホスト名へのマッピングを削除します。
#nbhostmgmt - delete -hostid 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0 - mappingname testhost1 Mapping between testhost1 and 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0 is removed.
例 5: ホストを指定して、ホスト ID のホスト名へのマッピングを削除します。
#nbhostmgmt - delete -host fs001 - mappingname testhost4 Mapping between testhost4 and 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0 is removed.
例 6: 指定したマスターサーバーからホストを指定して、ホスト ID のホスト名へのマッピングを削除します。
#nbhostmgt -delete -server nbmaster01 -host fs001 -mappingname testhost3 Mapping between testhost3 and 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0 is removed.
例 6: 指定したホスト名の詳細をリストします。以下の例で、複数のホストで共通のマッピングを共有している場合の出力の相違を示します。
マッピングを共有していない場合の出力を示します。
nbhostmgmt - list - host testhost1 Host ID : 00aa0aa0-a000-000a-00a0-000aaaa00a0a Host : server300.example.com Master Server : server300.example.com OS Type : UNIX Operating System : RedHat Linux(3.10.0-327.el7.x86_64) NetBackup EEBs : Hardware Description : GenuineIntel Intel(R) Xeon(R) CPU E5-2660 0 @ 2.20GHz, 16 CPUs CPU Architecture : x86_64 Version : NetBackup_8.1 Secure : Yes Mapped HostName Approved Conflict Auto-discovered Shared testhost1 Yes No No No Created On Last Updated On May 25, 2017 10:09:45 AM May 25, 2017 10:09:45 AM
マッピングを共有している場合の出力を示します。
nbhostmgmt - list - host sharedhost1 Host ID : aa00a000-0000-0000-00a0-0a00a000a0aa Host : server301.example.com Master Server : server301.example.com OS Type : UNIX Operating System : RedHat Linux(3.10.0-327.el7.x86_64) NetBackup EEBs : Hardware Description : GenuineIntel Intel(R) Xeon(R) CPU E5-2660 0 @ 2.20GHz, 16 CPUs CPU Architecture : x86_64 Version : NetBackup_8.1 Secure : False Mapped HostName Approved Conflict Auto-discovered Shared sharedhost1 Yes No No Yes Created On Last Updated On May 25, 2017 10:09:45 AM May 25, 2017 10:09:45 AM Host ID : 00aa0aa0-a000-000a-00a0-000aaaa00a0a Host : server300.example.com Master Server : server300.example.com OS Type : UNIX OS Version : RedHat Linux(3.10.0-327.el7.x86_64) NetBackup EEBs : Hardware Description : GenuineIntel Intel(R) Xeon(R) CPU E5-2660 0 @ 2.20GHz, 16 CPUs CPU Architecture : x86_64 Version : NetBackup_8.1 Secure : Yes Mapped HostName Approved Conflict Auto-discovered Shared sharedhost1 Yes No No Yes Created On Last Updated On May 25, 2017 10:09:45 AM May 25, 2017 10:09:45 AM
関連項目
bpnbat(1m)を参照してください。