<book_title> を検索 ...

Cluster Server 8.0.2 付属エージェントリファレンスガイド - Linux

Last Published: 2023-07-18

Product(s): InfoScale & Storage Foundation (8.0.2)

Platform: Linux

GoogleDisk エージェント

GoogleDisk エージェントを使用すると、インスタンス間でのアプリケーションのフェールオーバー中にディスクのフェールオーバーも実行できるように、GCP で HA 用のデータディスクを設定できます。

HA 用に設定したアプリケーションのデータを保存するため、InfoScale では GCP VM インスタンスについて次のストレージタイプをサポートしています。

ゾーンの永続ディスク: 標準および SSD
リージョンの永続ディスク: 標準および SSD

GoogleDisk エージェントは、GCP データディスクをオンラインにし、状態を監視し、オフラインに切り替えます。GoogleDisk エージェントは、GCP Python SDK を使用して、データディスクが仮想マシンに接続されているかどうかを判断します。

前提条件

Google サービスアカウントには、少なくとも次の権限が必要です。
- compute.projects.get (プロジェクトレベルで、プロジェクトのメタデータをフェッチするため)
- compute.instances.get (インスタンスレベルで、インスタンスのメタデータをフェッチするため)
- compute.instances.attachDisk (インスタンスレベルで、インスタンスにディスクを接続するため)
- compute.instances.detachDisk (インスタンスレベルで、インスタンスからディスクを切断するため)
- compute.zoneOperations.get (ゾーン内で操作の状態を確認するため)
- compute.disks.get (ディスクの現在のユーザーのリストを取得するため)
Google API にアクセスするには、InfoScale クラスタノードに google-api-python-client Python モジュールがあることが必要です。
次のコマンドを実行して、各クラスタノードに Python SDK for GCP をインストールします。
# /opt/VRTSpython/bin/pip install google-api-python-client
まずディスクを作成してから、そのリソースを設定する必要があります。そうしないと、オンライン操作は失敗します。
図: サービスグループ依存関係の例で示されているように、サービスグループに依存関係を追加します。

図: サービスグループ依存関係の例

エージェント関数

Open	現在の GCP VM インスタンス名とゾーン、およびインスタンスが属するプロジェクトを、そのメタデータを使用してフェッチします。
Online	GCP ディスクを VM インスタンスに接続します。
Offline	VM インスタンスから GCP ディスクを切断します。
Monitor	GCP データディスクが現在の VM インスタンス、またはクラスタ内外の他の VM インスタンスに接続されているかどうかを確認します。また、ディスクが接続されるモードを識別し、それに応じて状態の値を返します。
Clean	VM インスタンスから GCP ディスクを切断します。

状態の定義

ONLINE	GCP ディスクが現在の VM インスタンスに接続されていることを示します。
OFFLINE	次のいずれかを示します。 GCP ディスクがどの VM インスタンスでも使用されていない。ディスクは現在の VM インスタンスからは切断されたが、クラスタ内の別の VM インスタンスに読み取り/書き込みモードで接続されている。ディスクがクラスタ内外の他の VM インスタンスに読み取り専用モードで接続されている。
FAULTED	GCP ディスクが、VCS 制御外の VM インスタンスから予期せず切断されたことを示します。
UNKNOWN	次の場合に UNKNOWN を返します。必要な Google Python SDK が現在の VM インスタンスにインストールされていない。必須の属性値のフェッチに失敗する。 ReadOnly 属性の値が、GCP ディスクが VM インスタンスに接続されているモードと一致しない。このような状況は、ディスクを使用するアプリケーションの問題につながる可能性があります。役割が正しく設定されていない、または VM インスタンスと正しく関連付けられていないため、ディスク情報をフェッチできない。無効な DiskName が指定されている。指定したゾーンディスクの DiskName が、VM インスタンスがあるゾーン内に見つからない。ゾーンディスクが他のゾーンにある。ディスクがクラスタ外の VM インスタンスに読み取り/書き込みモードで接続されている。

属性

表: 必須属性

属性	説明
DiskName	ディスクの名前。データ形式と値のタイプ: 文字列 - スカラー
ReadOnly	ディスクを接続するモード。 0: READ_WRITE 1: READ_ONLY デフォルト値: 0 (READ_WRITE) データ形式と値のタイプ: ブール - スカラー
RegionalDisk	ディスクのタイプ: 0: ゾーンディスク 1: リージョンディスクメモ: リージョンディスクは、ゾーンをまたいでフェールオーバーでき、READ_WRITE モードでのみ接続できます。デフォルト値: 0 (ゾーンディスク) データ形式と値のタイプ: ブール - スカラー

属性

説明

DiskName

ディスクの名前。

データ形式と値のタイプ: 文字列 - スカラー

ReadOnly

ディスクを接続するモード。

0: READ_WRITE
1: READ_ONLY

デフォルト値: 0 (READ_WRITE)

データ形式と値のタイプ: ブール - スカラー

RegionalDisk

ディスクのタイプ:

0: ゾーンディスク
1: リージョンディスク

メモ:

リージョンディスクは、ゾーンをまたいでフェールオーバーでき、READ_WRITE モードでのみ接続できます。

デフォルト値: 0 (ゾーンディスク)

データ形式と値のタイプ: ブール - スカラー

表: オプションの属性

属性	説明
ProjectID	VM インスタンスが属するプロジェクト。データ形式と値のタイプ: 文字列 - スカラー
Zone	インスタンスが属するゾーン。データ形式と値のタイプ: 文字列 - スカラー
VMName	エージェントが実行される GCP VM インスタンスの名前。データ形式と値のタイプ: 文字列 - スカラー

属性

説明

ProjectID

VM インスタンスが属するプロジェクト。

データ形式と値のタイプ: 文字列 - スカラー

Zone

インスタンスが属するゾーン。

データ形式と値のタイプ: 文字列 - スカラー

VMName

エージェントが実行される GCP VM インスタンスの名前。

データ形式と値のタイプ: 文字列 - スカラー

リソースタイプの定義

type GoogleDisk (
	   static int FaultOnMonitorTimeouts = 0
   	static str ArgList[] = { DiskName, ReadOnly, 
      RegionalDisk, ProjectID, Zone, VMName, 
      tempProjectName, tempVMName, tempZone }
   	boolean ReadOnly = 0
   	boolean RegionalDisk = 0
   	str DiskName
   	str ProjectID
   	str Zone
   	str VMName
   	temp str tempProjectName
   	temp str tempZone
   	temp str tempVMName
)

設定例

GoogleDisk VVRSG-GoogleDisk (
   	DiskName = sql-disk
)

デバッグログレベル

GoogleDisk エージェントは、DBG_1 と DBG_2 のデバッグログレベルを使用します。