cluster コマンドは、クラスタ化を設定し、クラスタ化されたリソースを管理します。
|
cluster コマンドは、現在のクラスタ構成状態とリソースのプロパティーを一覧表示します。
リクエストの例:
GET /api/hardware/v2/cluster HTTP/1.1 Authorization: Basic Tm8gcGVla2luZyE= Host: zfs-storage.example.com:215 Accept: application/json
結果例:
HTTP/1.1 200 OK X-Zfssa-Appliance-Api: 1.0 Content-Type: application/json Content-Length: 529 X-Zfssa-Api: 1.0 { "cluster": { "state": "AKCS_OWNER", "description": "Active (takeover completed)", "peer_asn": "d23331e6-41f4-6a15-ac09-a4353e33b43a", "peer_hostname": "peer-1", "peer_state": "AKCS_STRIPPED", "peer_description": "Ready (waiting for failback)", "resources": [ { "owner": "peer-1", "type": "private", "user_label": "peer-1", "details": [ "ipaddr" ], "href": "/api/hardware/v2/cluster/resources/net/vnic1" }, { "owner": "peer-1", "type": "singleton", "user_label": "", "details": [ "8.03T" ], "href": "/api/hardware/v2/cluster/resources/zfs/cas1" }, { "owner": "peer-2", "type": "singleton", "user_label": "", "details": [ "18.7T" ], "href": "/api/hardware/v2/cluster/resources/zfs/cas2" } ] } }
次の例に示すように、cluster コマンドで一覧表示されたリソースの 1 つから href プロパティーを使用して、その特定のクラスタリソースのみのプロパティーを一覧表示します。
GET /api/hardware/v2/cluster/resources/net/vnic1 HTTP/1.1
cluster コマンドで一覧表示されたリソースの 1 つから href プロパティーを指定した PUT リクエストを使用して、そのクラスタリソースのプロパティーを設定します。
cluster/links コマンドは、クラスタカードの現在のリンクステータスを返します。
クラスタの初期設定を実行する前に、cluster/links を使用して、すべてのリンクが AKCIOS_ACTIVE 状態になっていることを確認します。AKCIOS_ACTIVE 状態ではない接続とは、もう一方のシステムが再起動/リブートしていることを意味します。または、リンクが正しく配線されていないか、クラスタケーブルがコネクタでセキュアではないこともあります。クラスタ配線の手順については、Oracle ZFS Storage Appliance 配線ガイドのクラスタケーブルの接続を参照してください。
cluster/links コマンドの出力は、コントローラモデルごとに異なります。ZS9-2 コントローラの場合、2 つのクラスタ I/O リンクのステータスが返されます。他のすべてのコントローラの場合、3 つのクラスタ I/O リンクのステータスが返されます。クラスタ I/O リンクの説明は、Oracle ZFS Storage Appliance 管理ガイド、Release OS8.8.x の クラスタ相互接続 I/Oを参照してください。
リクエストの例:
GET /api/hardware/v2/cluster/links HTTP/1.1 Authorization: Basic Tm8gcGVla2luZyE= Host: zfs-storage.example.com:215 Accept: application/json
Oracle ZFS Storage ZS9-2 の結果の例:
HTTP/1.1 200 OK X-Zfssa-Appliance-Api: 1.0 Content-Type: application/json Content-Length: 84 { "links": { "lio_dev/i40e0 = AKCIOS_ACTIVE\n lio_dev/i40e1 = AKCIOS_ACTIVE" } }
ZS7-2 または ZS5-2 コントローラの結果の例:
HTTP/1.1 200 OK X-Zfssa-Appliance-Api: 1.0 Content-Type: application/json Content-Length: 181 { "links": "\n\tclustron_ng3:0/clustron_uart:0 = AKCIOS_ACTIVE \n\tclustron_ng3:0/clustron_uart:1 = AKCIOS_ACTIVE \n\tclustron_ng3:0/dlpi:0 = AKCIOS_ACTIVE\n\n" }
その他のコントローラでも同様の links 出力が表示されます。唯一の違いは、/clustron または /dlpi に先行する部分です。たとえば、前述の例の clustron3_ng3:0 は、ZS5-4 コントローラでは clustron3:0 に、ZS4-4 コントローラでは clustron2:0 に、ZS3-2 コントローラでは clustron2_embedded:0 になります。
クラスタ管理には、failback、takeover、および unconfig があります。成功すると、コマンドは HTTP ステータス 202 (Accepted) を返します。クラスタがコマンドを受け入れる適切な状態ではない場合、HTTP ステータス 409 (Conflict) が返されます。
テイクオーバーは、ピアの障害が検出されるたびに自動的に試みられます。テイクオーバーは、管理者が実行することもできます。
フェイルバックは、管理者が実行する必要があります。フェイルバック操作は非同期です。REST クライアントが failback コマンドを送信すると、リクエストが正常に受信された場合は HTTP ステータス 202 が返されます。フェイルバックの進行状況をモニターするために、クライアントはアラートを待機したり、クラスタ状態をポーリングしたりできます。
テイクオーバーおよびフェイルバックの詳細は、Oracle ZFS Storage Appliance 管理ガイド、Release OS8.8.x の クラスタのテイクオーバーとフェイルバックを参照してください。
リクエストの例:
PUT /api/hardware/v2/cluster/failback HTTP/1.1
クラスタノードを構成解除すると、ノードがスタンドアロン操作に構成されます。原則として、ユーザー自身でクラスタノードを構成解除しないでください。クラスタノードの構成解除は破壊的な操作です。構成解除には、単なる unconfig コマンド以上の影響があります。詳細については、Oracle ZFS Storage Appliance 管理ガイド、Release OS8.8.x の クラスタノードの構成解除を参照してください。
設定は、初期クラスタ構成の 1 つのステップです。詳細については、Oracle ZFS Storage Appliance 管理ガイド、Release OS8.8.x の クラスタ化構成へのスタンドアロンアプライアンスのアップグレード (BUI)を参照してください。
cluster/setup コマンドは、システムの初期クラスタ構成を実行します。nodename および password プロパティーの値を指定します。設定に成功すると、HTTP ステータス 202 (Accepted) が返されます。
cluster/setup コマンドは、次の両方の条件が揃わないと失敗します。
すべてのクラスタリンクが AKCIOS_ACTIVE 状態です。クラスタリンクのステータスを参照してください。
ピアの電源はオンになっていますが、構成されていません。
リクエストの例:
PUT /api/hardware/v2/cluster/setup HTTP/1.1 Authorization: Basic Tm8gcGVla2luZyE= Host: zfs-storage.example.com:215 Accept: application/json {"nodename": "zfs-storage-2", "password": "password"}