Commvault V11
クラスタ クライアント構成手順
NEC CLUSTERPRO X for Windows
(11.20)
Version 1.0
October 2020
目次
更新履歴 ... 3 はじめに ... 4 本ドキュメントについて ... 4 免責事項について ... 4 著作権 ... 4 ドキュメントで説明する構成について ... 5Job Results Directory について ... 6
Commvault へのクラスタの登録 ... 7
Commvault Cluster Plugin サービスの停止 ... 13
フェイルオーバー グループの構成 ... 15
サービス リソースの起動 ... 21
サービス リソース起動前の Commvault Cluster Plugin サービスの状態確認 ... 21
サービス リソースの起動 ... 22
サービス リソース起動後の状態確認 ... 25
Commvault Cluster Plugin サービスの状態 ... 25
ログの確認 ... 25
CommServe 上の登録情報の確認 ... 25
フェイルオーバー ... 27
フェイルオーバーの実施 ... 27
フェイルオーバー後の状態確認 ... 29
Commvault Cluster Plugin サービスの状態 ... 29
更新履歴
バージョン 日付 変更点
はじめに
本ドキュメントについて
本ドキュメントは、NEC CLUSTERPRO 環境に Commvault をインストールし、クラスタ クライアントを構成するた めの手順を理解していただくことを目的として作成しております。本ドキュメントに記載されていない Commvault ソ フトウェアに関する詳細情報、互換性情報およびその他の技術情報につきましては、弊社ドキュメントサイト ( http://documentation.commvault.com/commvault ) をご参照ください。
本ドキュメントの手順は NEC CLUSTERPRO X 4.2 および Commvault V11 Feature Release 20 (11.20) をベ ースに記載しております。異なるバージョンでは手順が異なる可能性があります。
免責事項について
本ドキュメントは情報提供と便宜を目的として、現状有姿のままで提供されます。Commvault は事前の通知な しに本ドキュメントの内容を修正、変更する権利を留保します。本ドキュメントにおいて使用されている構成は架空 のものであり、説明のためだけに使用されます。実在するものとは一切関係ありません。また、本ドキュメントの内容 の正確性や使用に関しては Commvault は何ら保証しません。著作権
© 2020 すべての著作権は Commvault Systems Japan 株式会社が所有しております。記載された会社名 および製品名等は該当する各社の商標または登録商標です。
ドキュメントで説明する構成について
本ドキュメントでは、2 台の Windows ホストからなる、共有ディスク型の HA クラスターに対して Commvault のエ ージェント (クライアント モジュール) を導入、構成する手順を説明します。
Job Results Directory について
Commvault のバックアップでは、バックアップ ジョブの実行内容等の情報を格納するための領域として Job Results Directory と呼ばれるフォルダを使用しています。
クラスタ環境においては、フェイルオーバー後に増分バックアップが正しく継続できるようにするために、Job Results Directory はアクティブなノードからアクセスできる場所に構成する必要があります。
本ドキュメントでは、共有ディスク (F: ドライブ) 上に Job Results Directory を構成しています。 Job Results Directory の詳細については こちら をご参照ください。
Commvault へのクラスタの登録
クラスタを構成する各ノードに対して、Commvault のエージェントをインストールした直後の状態では、クラスタの情 報は登録されていませんので、手動でクラスタを登録する必要があります。
以下では、kwcpwin01 および kwcpwin02 から構成される kwcpwin クラスタ クライアントを登録しています。
1. CommCell ブラウザの [クライアント コンピュータ] ノードを右クリックして、[新しいクライアント] を選択します。
3. [新しい Windows クラスタ クライアント] ダイアログが表示されたら、[クライアント名] フィールドに Commvault 上での識別名、[ホスト名] フィールドにクラスタのホスト名を入力して [次へ] をクリックします。
5. クラスタ クライアントの作成が完了すると、[(クライアント名) の詳細クライアント プロパティ] ダイアログが表示され ます。クラスタを構成するホストを選択して [追加] をクリックします。
6. [選択] リストにクラスタを構成するノードが追加されたことを確認して [エージェント] タブをクリックします。
9. [ジョブ結果ディレクトリ] に共有ディスク上のフォルダ (F:\JobResults) を入力して [OK] をクリックします。
10. [(クライアント名) のクライアント コンピュータ プロパティ] ダイアログが表示されたら、[OK] をクリックします。
11. クラスタ クライアントの構成が完了したことを伝える [情報] ダイアログが表示されたら、[OK] をクリックします。
12. CommCell ブラウザの [クライアント コンピュータ] ノード以下に、構成したクラスタ クライアントが表示されてい ることを確認します。
Commvault Cluster Plugin サービスの停止
クラスタ クライアントを構成した Windows サーバー上では、Commvault Cluster Plugin サービスが構成されて います。本サービスを CLUSTERPRO の管理下で動作させるために、起動しているサービスを停止します。 本タスクは、クラスタの両ノードで実行します。
1. sc query コマンドを発行して、Commvault Cluster Plugin サービスのサービス名を確認します。 C:\Windows\system32>sc query | findstr GxClusPlugIn
SERVICE_NAME: GxClusPlugIn (kwcpwin) (Instance001)
C:\Windows\system32>
2. sc qc コマンドを発行して、Commvault Cluster Plugin サービスが手動起動 (DEMAND_START) になっ ていることを確認します。
C:\Windows\system32>sc qc "GxClusPlugIn (kwcpwin) (Instance001)" [SC] QueryServiceConfig SUCCESS
SERVICE_NAME: GxClusPlugIn (kwcpwin) (Instance001) TYPE : 10 WIN32_OWN_PROCESS
START_TYPE : 3 DEMAND_START
ERROR_CONTROL : 1 NORMAL BINARY_PATH_NAME : "C:\Program
Files\Commvault\ContentStore\Base\GxWinClusterPlugin.exe" -inst Instance001 -cn kwcpwin
LOAD_ORDER_GROUP : TAG : 0
DISPLAY_NAME : Commvault Cluster Plugin (kwcpwin) (Instance001) DEPENDENCIES :
SERVICE_START_NAME : LocalSystem C:\Windows\system32>
3. sc stop コマンドを発行して、Commvault Cluster Plugin サービスを停止します。 C:\Windows\system32>sc stop "GxClusPlugIn (kwcpwin) (Instance001)" SERVICE_NAME: GxClusPlugIn (kwcpwin) (Instance001)
TYPE : 10 WIN32_OWN_PROCESS STATE : 3 STOP_PENDING
(STOPPABLE, PAUSABLE, IGNORES_SHUTDOWN) WIN32_EXIT_CODE : 0 (0x0)
SERVICE_EXIT_CODE : 0 (0x0) CHECKPOINT : 0x0 WAIT_HINT : 0x0 C:\Windows\system32>
SERVICE_EXIT_CODE : 0 (0x0) CHECKPOINT : 0x0 WAIT_HINT : 0x0 C:\Windows\system32>
フェイルオーバー
グループの構成
CLUSTERPRO のフェイルオーバー グループに Commvault Cluster Plugin サービスを登録します。 1. Cluster WebUI を起動し、設定モードに移動します。
2. [グループ] フィールドにある [リソースの追加] をクリックします。
3. [グループのリソース定義] ダイアログが表示されたら、[タイプ] から [サービスリソース] を選択し、[名前] フィール ドにリソースの名前を入力して [次へ] をクリックします(デフォルトの service を使用してます)。
4. [依存関係] 画面は何も設定せず、デフォルトの設定のまま [次へ] をクリックします。
6. [詳細] 画面が表示されたら、[接続] をクリックしてサービスの一覧を取得します。
7. 一覧から Commvault Cluster Plugin サービスの表示名 (Commvault Cluster Plugin (kwcpwin) (Instance001)) を選択して [完了] をクリックします。
8. [完了] をクリックします。
10. 設定を反映させるために、[設定の反映] をクリックします。
12. クラスタ リジューム操作の確認ダイアログが表示されたら、[OK] をクリックします。
サービス
リソースの起動
フェイルオーバー グループに登録したサービス リソースを起動します。
サービス リソース起動前の Commvault Cluster Plugin サービスの状態確
認
1. フェイルオーバー グループがアクティブ状態のノード (kwcpwin01) の、Commvault Cluster Plugin サービス のステータスを確認します。
C:\Windows\system32>sc query "GxClusPlugIn (kwcpwin) (Instance001)" SERVICE_NAME: GxClusPlugIn (kwcpwin) (Instance001)
TYPE : 10 WIN32_OWN_PROCESS STATE : 1 STOPPED WIN32_EXIT_CODE : 0 (0x0) SERVICE_EXIT_CODE : 0 (0x0) CHECKPOINT : 0x0 WAIT_HINT : 0x0 C:\Windows\system32>
2. フェイルオーバー グループが非アクティブ状態のノード (kwcpwin02) の、Commvault Cluster Plugin サー ビスのステータスを確認します。
C:\Windows\system32>sc query "GxClusPlugIn (kwcpwin) (Instance001)" SERVICE_NAME: GxClusPlugIn (kwcpwin) (Instance001)
TYPE : 10 WIN32_OWN_PROCESS STATE : 1 STOPPED WIN32_EXIT_CODE : 0 (0x0) SERVICE_EXIT_CODE : 0 (0x0) CHECKPOINT : 0x0 WAIT_HINT : 0x0 C:\Windows\system32>
サービス リソースの起動
サービス リソースを起動します1. Cluster WebUI を起動し、操作モードに移動します。 2. [ステータス] タブをクリックします。
4. 起動 をクリックします。
サービス
リソース起動後の状態確認
Commvault Cluster Plugin サービスの状態
1. フェイルオーバー グループがアクティブ状態のノード (kwcpwin01) の、Commvault Cluster Plugin サービス のステータスを確認します。STATE の値が RUNNING になっていることが確認できます。
C:\Windows\system32>sc query "GxClusPlugIn (kwcpwin) (Instance001)" SERVICE_NAME: GxClusPlugIn (kwcpwin) (Instance001)
TYPE : 10 WIN32_OWN_PROCESS
STATE : 4 RUNNING
(STOPPABLE, PAUSABLE, IGNORES_SHUTDOWN) WIN32_EXIT_CODE : 0 (0x0)
SERVICE_EXIT_CODE : 0 (0x0) CHECKPOINT : 0x0 WAIT_HINT : 0x0 C:\Windows\system32>
2. フェイルオーバー グループが非アクティブ状態のノード (kwcpwin02) の、Commvault Cluster Plugin サー ビスのステータスを確認します。STATE の値は STOPPED のままです。
C:\Windows\system32>sc query "GxClusPlugIn (kwcpwin) (Instance001)" SERVICE_NAME: GxClusPlugIn (kwcpwin) (Instance001)
TYPE : 10 WIN32_OWN_PROCESS STATE : 1 STOPPED WIN32_EXIT_CODE : 0 (0x0) SERVICE_EXIT_CODE : 0 (0x0) CHECKPOINT : 0x0 WAIT_HINT : 0x0 C:\Windows\system32>
ログの確認
1. GxClusterPlugin.log を確認して、cvclusternotify.exe コマンドが実行されていることを確認します。 1368 140 20/10/29 09:05:48.777 ::MainThread() Running startup script1368 140 20/10/29 09:05:48.777 ::ExecuteAndWait() Starting script ["C:\Program Files\Commvault\ContentStore\Base\cvclusternotify.exe" -inst Instance001 -cn kwcpwin -start]
CommServe 上の登録情報の確認
クラスタを構成するホストのどちらのホストがアクティブになっているかは Commvault 側でも管理されています。クラス タ クライアントの設定項目として管理されているので確認をします。以下では PowerShell を使用した確認方法を
<App_GetClientPropertiesRequest> <association> <entity> <clientName /> </entity> </association> </App_GetClientPropertiesRequest> PS C:\> 2. Commvault のコマンドラインがインストールされたフォルダに移動します。 PS C:\> cd 'C:\Program Files\Commvault\ContentStore\Base\' PS C:\>
3. qlogin コマンドを使用して、Commvault にログインします (以下では admin ユーザーでログインしています)。 PS C:\> .\qlogin
Enter User Name: admin
Password: [password]
User logged in successfully.
PS C:\>
4. qoperation execute コマンドと設定項目取得用の XML ファイルを使用して、クラスタ クライアント (kwcpwin) の設定項目を取得します。XML データが戻されますが、一旦変数に格納します。
PS C:\> .\qoperation execute -af c:\getClientProp.xml -clientName kwcpwin | Set-Variable clientProp PS C:\> 5. 取得した XML データの中にある、App_GetClientPropertiesResponse / clientProperties / ActivePhysicalNode / hostName 要素の内容を確認します。 PS C:\> $clientPropXML = [xml]$clientProp PS C:\> $clientPropXML.App_GetClientPropertiesResponse.clientProperties.ActivePh ysicalNode.hostName kwcpwin01.kw.cv.local PS C:\>
フェイルオーバー
フェイルオーバーの実施
フェイルオーバーを実施します。 1. Cluster WebUI を起動し、操作モードに移動します。 2. [ステータス] タブをクリックします。 3. failover グループの [グループ移動] をクリックします。 4. [移動] をクリックします。フェイルオーバー後の状態確認
Commvault Cluster Plugin サービスの状態
1. フェイルオーバーにより非アクティブ状態となったノード (kwcpwin01) の、Commvault Cluster Plugin サービ スのステータスを確認します。STATE の値が STOPPED になっていることが確認できます。
C:\Windows\system32>sc query "GxClusPlugIn (kwcpwin) (Instance001)" SERVICE_NAME: GxClusPlugIn (kwcpwin) (Instance001)
TYPE : 10 WIN32_OWN_PROCESS STATE : 1 STOPPED WIN32_EXIT_CODE : 0 (0x0) SERVICE_EXIT_CODE : 0 (0x0) CHECKPOINT : 0x0 WAIT_HINT : 0x0 C:\Windows\system32>
2. フェイルオーバーによりアクティブ状態となったノード (kwcpwin02) の、Commvault Cluster Plugin サービス のステータスを確認します。STATE の値が RUNNING になっていることが確認できます。
C:\Windows\system32>sc query "GxClusPlugIn (kwcpwin) (Instance001)" SERVICE_NAME: GxClusPlugIn (kwcpwin) (Instance001)
TYPE : 10 WIN32_OWN_PROCESS
STATE : 4 RUNNING
(STOPPABLE, PAUSABLE, IGNORES_SHUTDOWN) WIN32_EXIT_CODE : 0 (0x0) SERVICE_EXIT_CODE : 0 (0x0) CHECKPOINT : 0x0 WAIT_HINT : 0x0 C:\Windows\system32>
ログの確認
1. フェイルオーバーにより非アクティブ状態となったノード (kwcpwin01) の、GxClusterPlugin.log を確認します。 ｃcvclusternotify.exe がこのノードでのサービス停止 (-shutdown) を通知します。1368 140 20/10/29 09:17:13.421 ::MainThread() Running shutdown script
1368 140 20/10/29 09:17:13.421 ::ExecuteAndWait() Starting script ["C:\Program
Files\Commvault\ContentStore\Base\cvclusternotify.exe" -inst Instance001 -cn kwcpwin -shutdown]
2. フェイルオーバーによりアクティブ状態となったノード (kwcpwin02) の、GxClusterPlugin.log を確認します。 ｃcvclusternotify.exe がこのノードでのサービス起動 (-start) を通知します。
5184 a34 20/10/29 09:17:18.830 ::MainThread() Running startup script
CommServe 上の登録情報の確認
起動時と同じコマンドを発行して、Commvault に登録されているアクティブ ノードの情報が変わったことを確認しま す。
1. qoperation execute コマンドと設定項目取得用の XML ファイルを使用して、クラスタ クライアント (kwcpwin) の設定項目を取得します。XML データが戻されますが、一旦変数に格納します。
PS C:\> .\qoperation execute -af c:\getClientProp.xml -clientName kwcpwin | Set-Variable clientProp PS C:\> 2. 取得した XML データの中にある、App_GetClientPropertiesResponse / clientProperties / ActivePhysicalNode / hostName 要素の内容を確認します。 PS C:\> $clientPropXML = [xml]$clientProp PS C:\> $clientPropXML.App_GetClientPropertiesResponse.clientProperties.ActivePh ysicalNode.hostName kwcpwin02.kw.cv.local PS C:\>
Commvault Systems Japan 株式会社
〒 141-6008 東京都品川区大崎 2-1-1 ThinkPark Tower 8F https://www.commvault.co.jp
