nec clusterpro x for windows (11.20)...22 サービスリソースの起動サービス...

Commvault V11 クラスタクライアント構成手順 NEC CLUSTERPRO X for Windows (11.20)

Version 1.0 October 2020

2

目次更新履歴 ......................................................................................................................................................................................................... 3

はじめに ............................................................................................................................................................................................................. 4

本ドキュメントについて ............................................................................................................................................................................. 4

免責事項について .................................................................................................................................................................................... 4

著作権 ......................................................................................................................................................................................................... 4

ドキュメントで説明する構成について ...................................................................................................................................................... 5

Job 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

ログの確認 ............................................................................................................................................................................................... 29

CommServe 上の登録情報の確認 .......................................................................................................................................... 30

3

更新履歴

バージョン日付変更点

1.0 2020/10/29 初版作成

4

はじめに

本ドキュメントについて

本ドキュメントは、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 株式会社が所有しております。記載された会社名

および製品名等は該当する各社の商標または登録商標です。

http://documentation.commvault.com/commvault

5

ドキュメントで説明する構成について

本ドキュメントでは、2 台の Windows ホストからなる、共有ディスク型の HA クラスターに対して Commvault のエ

ージェント (クライアントモジュール) を導入、構成する手順を説明します。

6

Job Results Directory について

Commvault のバックアップでは、バックアップジョブの実行内容等の情報を格納するための領域として Job

Results Directory と呼ばれるフォルダを使用しています。

クラスタ環境においては、フェイルオーバー後に増分バックアップが正しく継続できるようにするために、Job Results

Directory はアクティブなノードからアクセスできる場所に構成する必要があります。

本ドキュメントでは、共有ディスク (F: ドライブ) 上に Job Results Directory を構成しています。

Job Results Directory の詳細についてはこちらをご参照ください。

https://documentation.commvault.com/commvault/v11/article?p=6580.htm

7

Commvault へのクラスタの登録

クラスタを構成する各ノードに対して、Commvault のエージェントをインストールした直後の状態では、クラスタの情

報は登録されていませんので、手動でクラスタを登録する必要があります。

以下では、kwcpwin01 および kwcpwin02 から構成される kwcpwin クラスタクライアントを登録しています。

1. CommCell ブラウザの [クライアントコンピュータ] ノードを右クリックして、[新しいクライアント] を選択します。

2. [クライアント追加] ダイアログが表示されたら、[Windows クラスタ] をクリックします。

8

3. [新しい Windows クラスタクライアント] ダイアログが表示されたら、[クライアント名] フィールドに Commvault

上での識別名、[ホスト名] フィールドにクラスタのホスト名を入力して [次へ] をクリックします。

4. 内容を確認して [完了] をクリックします。

9

5. クラスタクライアントの作成が完了すると、[(クライアント名) の詳細クライアントプロパティ] ダイアログが表示され

ます。クラスタを構成するホストを選択して [追加] をクリックします。

10

6. [選択] リストにクラスタを構成するノードが追加されたことを確認して [エージェント] タブをクリックします。

7. [すべてを追加] をクリックしてすべてのエージェントを選択します。

11

8. [選択] リストにエージェントが追加されたことを確認して、[ジョブ構成] タブを選択します。

12

9. [ジョブ結果ディレクトリ] に共有ディスク上のフォルダ (F:\JobResults) を入力して [OK] をクリックします。

10. [(クライアント名) のクライアントコンピュータプロパティ] ダイアログが表示されたら、[OK] をクリックします。

11. クラスタクライアントの構成が完了したことを伝える [情報] ダイアログが表示されたら、[OK] をクリックします。

12. CommCell ブラウザの [クライアントコンピュータ] ノード以下に、構成したクラスタクライアントが表示されてい

ることを確認します。

13

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


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


3. sc stop コマンドを発行して、Commvault Cluster Plugin サービスを停止します。

C:\Windows\system32>sc stop "GxClusPlugIn (kwcpwin) (Instance001)"



STATE : 3 STOP_PENDING

(STOPPABLE, PAUSABLE, IGNORES_SHUTDOWN)

WIN32_EXIT_CODE : 0 (0x0)

SERVICE_EXIT_CODE : 0 (0x0)

CHECKPOINT : 0x0

WAIT_HINT : 0x0


4. sc query コマンドを発行して、Commvault Cluster Plugin サービスが停止していることを確認します。

C:\Windows\system32>sc query "GxClusPlugIn (kwcpwin) (Instance001)"



STATE : 1 STOPPED


14


CHECKPOINT : 0x0

WAIT_HINT : 0x0


15

フェイルオーバーグループの構成

CLUSTERPRO のフェイルオーバーグループに Commvault Cluster Plugin サービスを登録します。

1. Cluster WebUI を起動し、設定モードに移動します。

2. [グループ] フィールドにある [リソースの追加] をクリックします。

3. [グループのリソース定義] ダイアログが表示されたら、[タイプ] から [サービスリソース] を選択し、[名前] フィール

ドにリソースの名前を入力して [次へ] をクリックします(デフォルトの service を使用してます)。

16

4. [依存関係] 画面は何も設定せず、デフォルトの設定のまま [次へ] をクリックします。

5. [復旧動作] 画面は何も設定せず、デフォルトの設定のまま [次へ] をクリックします。

17

6. [詳細] 画面が表示されたら、[接続] をクリックしてサービスの一覧を取得します。

7. 一覧から Commvault Cluster Plugin サービスの表示名 (Commvault Cluster Plugin (kwcpwin)

(Instance001)) を選択して [完了] をクリックします。

18

8. [完了] をクリックします。

9. サービスの起動設定を確認するダイアログが表示されたら、[閉じる] をクリックします。

19

10. 設定を反映させるために、[設定の反映] をクリックします。

11. クラスタサスペンド操作の確認ダイアログが表示されたら、[OK] をクリックします。

20

12. クラスタリジューム操作の確認ダイアログが表示されたら、[OK] をクリックします。

13. 設定が反映されたこと (Added が消えたこと) を確認します。

21

サービスリソースの起動

フェイルオーバーグループに登録したサービスリソースを起動します。

サービスリソース起動前の Commvault Cluster Plugin サービスの状態確

認

1. フェイルオーバーグループがアクティブ状態のノード (kwcpwin01) の、Commvault Cluster Plugin サービス

のステータスを確認します。 C:\Windows\system32>sc query "GxClusPlugIn (kwcpwin) (Instance001)"



STATE : 1 STOPPED



CHECKPOINT : 0x0

WAIT_HINT : 0x0


2. フェイルオーバーグループが非アクティブ状態のノード (kwcpwin02) の、Commvault Cluster Plugin サー

ビスのステータスを確認します。

C:\Windows\system32>sc query "GxClusPlugIn (kwcpwin) (Instance001)"



STATE : 1 STOPPED



CHECKPOINT : 0x0

WAIT_HINT : 0x0


22

サービスリソースの起動

サービスリソースを起動します

1. Cluster WebUI を起動し、操作モードに移動します。

2. [ステータス] タブをクリックします。

3. failover グループ、および service リソースを展開します。

23

4. 起動をクリックします。

5. 確認ダイアログが表示されたら、[起動] をクリックします。

24

6. 正常に起動し、[起動済] となったことを確認します。

25

サービスリソース起動後の状態確認

Commvault Cluster Plugin サービスの状態

1. フェイルオーバーグループがアクティブ状態のノード (kwcpwin01) の、Commvault Cluster Plugin サービス

のステータスを確認します。STATE の値が RUNNING になっていることが確認できます。 C:\Windows\system32>sc query "GxClusPlugIn (kwcpwin) (Instance001)"



STATE : 4 RUNNING




CHECKPOINT : 0x0

WAIT_HINT : 0x0


2. フェイルオーバーグループが非アクティブ状態のノード (kwcpwin02) の、Commvault Cluster Plugin サー

ビスのステータスを確認します。STATE の値は STOPPED のままです。 C:\Windows\system32>sc query "GxClusPlugIn (kwcpwin) (Instance001)"



STATE : 1 STOPPED



CHECKPOINT : 0x0

WAIT_HINT : 0x0


ログの確認

1. GxClusterPlugin.log を確認して、cvclusternotify.exe コマンドが実行されていることを確認します。 1368 140 20/10/29 09:05:48.777 ::MainThread() Running startup script

1368 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 を使用した確認方法を

記載します。

(Commvault のコマンドラインからクライアントの設定項目を取得する方法はこちらをご参照ください。)

1. 設定項目取得用の XML ファイルを作成します。 PS C:\> type C:\getClientProp.xml

https://documentation.commvault.com/commvault/v11/article?p=19769.htm

26

<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:\>

27

フェイルオーバー

フェイルオーバーの実施

フェイルオーバーを実施します。

1. Cluster WebUI を起動し、操作モードに移動します。

2. [ステータス] タブをクリックします。

3. failover グループの [グループ移動] をクリックします。

4. [移動] をクリックします。

28

5. グループが移動したことを確認します。

29

フェイルオーバー後の状態確認

Commvault Cluster Plugin サービスの状態

1. フェイルオーバーにより非アクティブ状態となったノード (kwcpwin01) の、Commvault Cluster Plugin サービ

スのステータスを確認します。STATE の値が STOPPED になっていることが確認できます。 C:\Windows\system32>sc query "GxClusPlugIn (kwcpwin) (Instance001)"



STATE : 1 STOPPED



CHECKPOINT : 0x0

WAIT_HINT : 0x0


2. フェイルオーバーによりアクティブ状態となったノード (kwcpwin02) の、Commvault Cluster Plugin サービス

のステータスを確認します。STATE の値が RUNNING になっていることが確認できます。 C:\Windows\system32>sc query "GxClusPlugIn (kwcpwin) (Instance001)"



STATE : 4 RUNNING




CHECKPOINT : 0x0

WAIT_HINT : 0x0


ログの確認

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


kwcpwin -shutdown]

2. フェイルオーバーによりアクティブ状態となったノード (kwcpwin02) の、GxClusterPlugin.log を確認します。

ｃcvclusternotify.exe がこのノードでのサービス起動 (-start) を通知します。

5184 a34 20/10/29 09:17:18.830 ::MainThread() Running startup script

5184 a34 20/10/29 09:17:18.830 ::ExecuteAndWait() Starting script ["C:\Program


kwcpwin -start]

30

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:\>

Copyright © 2020 Commvault | All Rights Reserved. Commvault, Commvault and logo, the "CV" logo, Commvault Systems, Solving Forward, SIM, Singular Information Management, Simpana, Commvault Galaxy, Unified Data Management, QiNetix, Quick Recovery, QR, CommNet, GridStor, Vault Tracker, InnerVault, Quick Snap, QSnap, IntelliSnap, Recovery Director, CommServe, CommCell, ROMS, Commvault Edge, Simpana OnePass, and CommValue are trademarks or registered trademarks of Commvault Systems, Inc. All other third party brands, products, service names, trademarks, or registered service marks are the property of and used to identify the products or services of their respective owners. All specifications are subject to change without notice.

Commvault Systems Japan 株式会社

〒 141-6008 東京都品川区大崎 2-1-1 ThinkPark Tower 8F

https://www.commvault.co.jp

nec clusterpro x for windows (11.20)...22 サービス リソースの起動 サービス...

Documents

nec clusterpro x for windows (11.20)...22 サービスリソースの起動サービス...