Veritas NetBackup™ コマンドリファレンスガイド
- 概要
- 付録 A. NetBackup コマンド
名前
nbsqladm — SQL Server インテリジェントバックアップポリシーの SQL Server インスタンスを設定します
概要
nbsqladm [-S master_server] -list_instances [instance_name] [-host name] [-active | -inactive] [-registered | -unregistered]
nbsqladm [-S master_server] -add_instance instance_name -host name [-instance_group name | -local_credentials | -user name -domain name] [-force]
nbsqladm [-S master_server] -register_instance instance_name [-host name] [-instance_group name | -local_credentials | -user name -domain name] [-force]
nbsqladm [-S master_server] -delete_instance instance_name [-host name]
nbsqladm [-S master_server] -modify_instance instance_name [-new_instance instance_name] -host name [-new_host name] [-instance_group name | -local_credentials | -user name -domain name] [-active | -inactive] [-force]
nbsqladm [-S master_server] -remove_from_instance_group instance_name [-instance_group name] [-host name]
nbsqladm [-S master_server] -initiate_availability_group_browse instance_name -host name
nbsqladm [-S master_server] -initiate_discovery
nbsqladm [-S master_server] -list_instance_groups [instance_group_name]
nbsqladm [-S master_server] -add_instance_group instance_group_name [-local_credentials | -user name -domain name]
nbsqladm [-S master_server] -delete_instance_group name
nbsqladm [-S master_server] -modify_instance_group name [-new_instance_group name] [[-local_credentials | -user name -domain name] [-validate]]
nbsqladm [-S master_server] -list_availability_groups [-ag_name name] [-cluster cluster_name] [-ag_id availability_group_ID]
nbsqladm [-S master_server] -add_availability_group -ag_name name {-cluster cluster_name | -ag_id availability_group_ID} [-instance instance_name -host name]
nbsqladm [-S master_server] -delete_availability_group -ag_name name {-cluster cluster_name | -ag_id availability_group_ID}
nbsqladm [-S master_server] -list_replicas -ag_name name {-cluster cluster_name | -ag_id availability_group_ID}
nbsqladm [-S master_server] -add_replica -ag_name name {-cluster cluster_name | -ag_id availability_group_ID} -instance instance_name -host name [-force]
nbsqladm [-S master_server] -delete_replica -ag_name name {-cluster cluster_name | -ag_id availability_group_ID} -instance instance_name -host name
nbsqladm [-S master_server] -list_dbas
nbsqladm [-S master_server] -add_dba host_nameuser_name
nbsqladm [-S master_server] -delete_dba host_nameuser_name
nbsqladm [-S master_server] -auto_registration instance_group_name
nbsqladm [-S master_server] -disable_auto_registration
UNIX システムでは、このコマンドへのディレクトリパスは /usr/openv/netbackup/bin/ です。
Windows システムでは、このコマンドへのディレクトリパスは install_path\NetBackup\bin\ です。
説明
nbsqladm コマンドは SQL Server インテリジェントポリシーで使うための SQL Server インスタンス、インスタンスグループ、可用性グループを構成します。サポートされる可用性グループには、基本、高度、読み取りスケールがあります。また、このコマンドをマスターサーバーで使用し、DBA に対して特定のホストでの nbsqladm の使用を認可できます。
オプション
- -add_availability_group -ag_name name {-cluster cluster_name | -ag_id availability_group_ID} -instance instance_name -host name
NetBackup カタログに可用性グループを追加します。可用性グループのみを追加し、後でインスタンスを追加できます。これにより、可用性グループのトポロジーをすばやく構築できます。高度および基本可用性グループについては、-cluster cluster_name で Windows Server Failover Clustering (WSFC) クラスタの名前を指定します。読み取りスケールの可用性グループについては、-ag_id availability_group_ID を指定します。
インスタンスを含めてすべての AG トポロジーを追加するには、-instance instance_name -host name オプションを使用します。
- -add_dba host_name user_name
指定された DBA (user_name) に、特定のホスト (host_name) 上での nbsqladm コマンドの使用を認可します。マスターサーバー上のみで使用できます。
複数の NIC がある場合、SQL Server ホストのプライベートインターフェース名を指定します。
SQL Server クラスタでは、クラスタ内の各ノードについて DBA を認可します。(SQL Server クラスタの仮想名を使用して DBA を認可しないでください。)-host 名には SQL Server クラスタ内のノード名の 1 つを提供します。
複数の NIC がある SQL Server クラスタの場合、SQL Server クラスタ内のノードそれぞれのプライベートインターフェース名を使用して DBA を承認します。
- -add_instance instance_name -host name [-instance_group name | -local_credentials | -user name -domain name] [-force]
NetBackup カタログにインスタンスを追加します。可用性グループのインスタンスを追加した後、-add_replica オプションを使用します。
- -add_instance_group instance_group_name [-local_credentials | -user name -domain name]
NetBackup カタログにインスタンスグループを追加します。-local_credentials または -user name -domain name オプションでインスタンスグループにクレデンシャルを追加できます。
- -auto_registration instance_group_name
指定されたインスタンスグループの自動登録を有効にします。新しく検出されたインスタンスが自動的にグループのクレデンシャルで登録され、インスタンスグループに追加されます。以前に検出されたインスタンスをインスタンスグループに含める場合は、それらのインスタンスを手動で追加する必要があります。1 つのインスタンスグループのみの自動登録を有効にできます。
- -add_replica -ag_name name {-cluster cluster_name | -ag_id availability_group_ID} -instance instance_name -host name [-force]
NetBackup カタログに可用性グループのレプリカを追加します。このオプションは、可用性グループのインスタンスを追加した後に使用します。高度および基本可用性グループについては、-cluster cluster_name で Windows Server Failover Clustering (WSFC) クラスタの名前を指定します。読み取りスケールの可用性グループについては、-ag_id availability_group_ID を指定します。
- -delete_dba host_name user_name
指定されたホスト (host_name) と DBA (user_name) に対する nbsqladm コマンドを使用するための認可を解除します。マスターサーバー上のみで使用できます。
複数の NIC がある場合、SQL Server ホストのプライベートインターフェース名を指定します。
SQL Server クラスタでは、クラスタ内の各ノードについて DBA の認可を解除します(SQL Server クラスタの仮想名を使用して DBA の認可を解除することはできません)。-host_name では、SQL Server クラスタ内のノード名の 1 つを指定します。
複数の NIC がある SQL Server クラスタの場合、SQL Server クラスタ内のノードそれぞれの仮想プライベート名を使用して認可を解除します。
- -delete_availability_group -ag_name name {-cluster cluster_name | -ag_id availability_group_ID}
可用性グループを NetBackup カタログから削除します。高度および基本可用性グループについては、-cluster cluster_name で Windows Server Failover Clustering (WSFC) クラスタの名前を指定します。読み取りスケールの可用性グループについては、-ag_id availability_group_ID を指定します。
- -delete_instance instance_name [-host name]
インスタンスを NetBackup カタログから削除します。
- -delete_instance_group name
インスタンスグループを削除します。
- -delete_replica -ag_name name {-cluster cluster_name | -ag_id availability_group_ID}
可用性グループのレプリカを NetBackup カタログから削除します。高度および基本可用性グループについては、-cluster cluster_name で Windows Server Failover Clustering (WSFC) クラスタの名前を指定します。読み取りスケールの可用性グループについては、-ag_id availability_group_ID を指定します。
- -disable_auto_registration
自動登録を無効にすると、新しく検出されたインスタンスが自動的に登録されてインスタンスグループに追加されることがなくなります。
- -force
インスタンスまたはレプリカインスタンスの登録とインスタンスクレデンシャルの検証の省略を NetBackup に強制します。NetBackup for SQL Server は、登録されていないまたは無効なクレデンシャルを持っているインスタンスを保護できません。
- -host name
SQL Server データベースが存在するホストの名前を指定します。
複数の NIC がある場合、SQL Server ホストのプライベートインターフェース名を指定します。SQL Server クラスタの場合、ホスト名に対して、SQL Server クラスタの仮想名を指定します。複数の NIC がある SQL Server クラスタの場合、SQL Server クラスタの仮想プライベート名を指定します。
- -instance instance_name または -new_instance instance_name
SQL Server インスタンスの名前を指定します。
複数の NIC がある場合、SQL Server ホストのプライベートインターフェース名を指定します。SQL Server クラスタの場合、ホスト名に対して、SQL Server クラスタの仮想名を指定します。複数の NIC がある SQL Server クラスタの場合、SQL Server クラスタの仮想プライベート名を指定します。
- -instance_group name
インスタンスを追加または削除するインスタンスグループの名前を指定します。
またはインスタンスを登録するのに使用するインスタンスグループを示します。代替的に、インスタンスグループのクレデンシャルまたは特定のクレデンシャルでインスタンスを登録できます。-local_credentials オプションと -user name -domain name オプションも参照してください。
クレデンシャルには特定のセキュリティ権限が必要です。詳しくは、『NetBackup for SQL Server 管理者ガイド』を参照してください。
- -initiate_availability_group_browse instance_name -host name
読み取りスケール可用性グループの検出を開始します。instance_name とホストに関連付けられているすべての可用性グループが検出されます。
- -initiate_discovery
検出処理を開始し、前回の検出以降に環境に追加された SQL Server インスタンスを検出します。
- -list_availability_groups [-ag_name name] [-cluster cluster_name] [-ag_id availability_group_ID]
NetBackup カタログの SQL Server 可用性グループを一覧表示します。特定の名前の可用性グループを一覧表示するには、-ag_name name を使用します。特定の Windows Server Failover Clustering (WSFC) クラスタに属する高度および基本可用性グループを一覧表示するには、-cluster cluster_name を使用します。読み取りスケール可用性グループを一覧表示するには、-ag_id availability_group_ID を使用します。
- -list_dbas
nbsqladm を使えるすべてのデータベース管理者(DBA)のリストを表示します。マスターサーバー上のみで使用できます。
- -list_instances [instance_name] [-host name] [-active | -inactive] [-registered | -unregistered]
NetBackup カタログ内のすべての SQL Server インスタンスをリストします。
instance_name または -host name を使用し、特定のインスタンスを一覧表示します。-registered または -unregistered を使用し、登録済みまたは未登録の SQL Server インスタンスを一覧表示します。-active オプションと -inactive オプションは、NetBackup に対してアクティブな (バックアップに使用できる) インスタンスと非アクティブなインスタンスを表示します。
- -list_instance_groups [instance_group_name]
存在する SQL Server インスタンスグループを一覧表示します。特定のインスタンスグループを一覧表示するには、instance_group_name を使用します。
- -list_replicas -ag_name name {-cluster cluster_name | -ag_id availability_group_ID}
NetBackup カタログ内のすべての可用性グループのレプリカを一覧表示します。-ag_name name オプションで可用性グループを指定します。特定の Windows Server Failover Clustering (WSFC) クラスタに属する高度および基本可用性グループのレプリカを一覧表示するには、-cluster cluster_name を使用します。読み取りスケール可用性グループについては、-ag_id availability_group_ID を使用します。
- -local_credentials
NetBackup のインストールに使われたクレデンシャルでインスタンスを登録することを示します。代替的に、インスタンスグループのクレデンシャルまたは特定のクレデンシャルでインスタンスを登録できます。-instance_group name オプションと -user name -domain name オプションも参照してください。
クレデンシャルには特定のセキュリティ権限が必要です。詳しくは、『NetBackup for SQL Server 管理者ガイド』を参照してください。
インスタンスグループを修正するために -validate オプションと組み合わせて使用すると、グループ内の各インスタンスのクレデンシャルを検証することもできます。
- -modify_instance instance_name [-new_instance instance_name] -host name [-new_host name] [-instance_group name | -local_credentials | -user name -domain name] [-active | -inactive] [-force]
指定されたインスタンスの属性を変更します。
NetBackup で無効にしたインスタンスをバックアップできるようにするには、-active を使用します。または、-inactive を使用してインスタンスを NetBackup で非アクティブにすることもできます。たとえば、インスタンスが保守中の場合です。
- -modify_instance_group [-new_instance_group name] [[-local_credentials | -user name -domain name] [-validate]]
指定されたインスタンスグループの属性を変更します。-new_instance instance_name オプションはインスタンスの名前を変更します。-new_host name オプションはデータベースが存在するホストを更新します。
-new_instance_group name はインスタンスグループの名前を変更します。-local_credentials または -user name -domain name を使用し、インスタンスグループのクレデンシャルを追加または変更します。-validate オプションはインスタンスグループ内の各インスタンスのグループクレデンシャルを検証します。このオプションは -local_credentials または -user name -domain name と組み合わせて使用します。
- -register_instance instance_name [-instance_group name | -local_credentials | -user name -domain name] [-force]
インスタンスのクレデンシャルを登録します。-instance_group name、-local_credentials、-user name -domain name の説明を参照してください。
SQL Server クラスタまたは複数の NIC の場合、インスタンスを登録する前にそのインスタンスが正しいホスト名で追加済みであることを確認してください。複数の NIC がある場合、ホスト名は SQL Server ホストのプライベートインターフェース名です。SQL Server クラスタはインスタンス管理で 1 つのエントリのみを必要とします。ホスト名は SQL Server クラスタの仮想名になります。複数の NIC がある SQL Server クラスタの場合、ホスト名は SQL Server クラスタの仮想プライベート名です。
- -remove_from_instance_group instance_name [-instance_group name] [-host name]
インスタンスグループからインスタンスを削除します。
- -S master_server
追加、変更、または削除するインスタンスまたはインスタンスグループのマスターサーバーを指定します。あるいは、特定のコマンドを実行するマスターサーバーを示すために使用します。
- -user name -domain name
提供する特定のクレデンシャルとともにインスタンスを登録することを示します。代替的に、インスタンスグループのクレデンシャルまたはローカルのクレデンシャルでインスタンスを登録できます。-instance_group name オプションと -local_credentials オプションを参照してください。
クレデンシャルには特定のセキュリティ権限が必要です。詳しくは、『NetBackup for SQL Server 管理者ガイド』を参照してください。
インスタンスグループを修正するために -validate オプションと組み合わせて使用すると、グループ内の各インスタンスのクレデンシャルを検証することもできます。
例
例1 -クレデンシャルを検証せずに、インスタンスグループ marketing にローカルクレデンシャルを追加します。
nbsqladm -modify_instance_group marketing -local_credentials
例2 - ドメイン corp 内のユーザー adminuser のクレデンシャルをインスタンスグループ marketing に追加します。また、グループ内の各インスタンスのクレデンシャルを検証します。
nbsqladm -modify_instance_group marketing -user adminuser -domain corp -validate