クラスタコマンドは、クラスタ化の設定およびクラスタ化されたリソースの管理に使用されます。
|
現在のクラスタ構成状態とリソースのプロパティーを取得します。
リクエストの例:
GET /api/hardware/v1/cluster HTTP/1.1 Authorization: Basic abcd45sMWE= 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": {
"description": "Clustering is not configured",
"peer_asn": "",
"peer_description": "",
"peer_hostname": "",
"peer_state": "",
"resources": {
"net/ixgbe0": {
"details": ["ipaddr-1"],
"href": "/hardware/v1/cluster/resources/resources/net/ixgbe0",
"owner": "admin1",
"type": "singleton",
"user_label": "Untitled Interface"
},
"zfs/zfs-storage-1": {
"details": ["821G"],
"href": "/hardware/v1/cluster/resources/resources/zfs/zfs-storage-1",
"owner": "admin1",
"type": "singleton",
"user_label": ""
}
},
"state": "AKCS_UNCONFIGURED"
}
}
クラスタリソースからの href プロパティーに従うことで、その単一クラスタリソースのデータを取得できます。前の例では、/hardware/v1/cluster/resources/resources/zfs/zfs-storage-1 および /hardware/v1/cluster/resources/resources/net/ixgbe0 という 2 つのリソースが使用可能です。
システムがクラスタ化されている場合、このコマンドを使用して各クラスタリソースのプロパティーを変更できます。詳細については、CLI「configuration cluster resources」を参照してください。
クラスタでサポートされているコマンドは、failback、takeover、および unconfigure です。すべてのコマンドは、クラスタリソースにコマンド名を付加したものに対する PUT リクエストを使用します。成功すると、コマンドは HTTP ステータス 202 (Accepted) を返します。
フェイルバック操作は非同期です。REST クライアントが PUT コマンドを使用してフェイルバックリクエストを送信した場合、リクエストが正常に受信されると HTTP ステータス 202 (Accepted) が返されます。クライアントは、アラートを待機するかクラスタ状態をポーリングすることによって、フェイルバックの進行状況をモニターする必要があります。
リクエストの例:
PUT /api/hardware/v1/cluster/failback HTTP/1.1 Authorization: Basic abcd123MWE= Host: zfs-storage.example.com:215
結果例:
HTTP/1.1 202 Accepted X-Zfssa-Appliance-Api: 1.0
クラスタがコマンドを受け入れる適切な状態ではない場合、HTTP ステータス 409 (Conflict) が返されます。
このコマンドは、クラスタカードの現在のリンクステータスを返します。出力は、aksh コマンド「configuration cluster links」と同じです。クラスタの配線に問題がないことを保証するために、このコマンドはクラスタ設定を実行する前に実行することをお勧めします。設定を実行する前に、すべてのリンクが AKCIOS_ACTIVE 状態である必要があります。
リクエストの例:
GET /api/hardware/v1/cluster/links HTTP/1.1 Authorization: Basic abcd123MWE= 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: 181
{
"links": {
"clustron2_embedded:0/clustron_uart:0 = AKCIOS_TIMEDOUT\n
clustron2_embedded:0/clustron_uart:1 = AKCIOS_TIMEDOU\n
clustron2_embedded:0/dlpi:0 = AKCIOS_TIMEDOUT"
}
}
setup cluster コマンドは、システムの初期クラスタ化を設定します。すべてのクラスタリンクが AKCIOS_ACTIVE 状態である必要があり、ピアシステムに電源が投入されていても構成されていない必要があります。そうでないと、コマンドは失敗します。
リクエストの例:
PUT /api/hardware/v1/cluster/setup HTTP/1.1
Authorization: Basic abcd123MWE=
Host: zfs-storage.example.com:215
Accept: application/json
{"nodename": "zfs-storage-2", "password": "password"}
結果例:
HTTP/1.1 202 Accepted X-Zfssa-Appliance-Api: 1.0