클러스터 명령은 클러스터링을 설정하고 클러스터화된 리소스를 관리하는 데 사용됩니다.
|
현재 클러스터 구성 상태 및 리소스 등록 정보를 가져옵니다.
요청 예:
GET /api/hardware/v1/cluster HTTP/1.1 Authorization: Basic abcd45sMWE= Host: tanana: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": ["10.80.231.58"], "href": "/hardware/v1/cluster/resources/resources/net/ixgbe0", "owner": "tanana", "type": "singleton", "user_label": "Untitled Interface" }, "zfs/gold": { "details": ["821G"], "href": "/hardware/v1/cluster/resources/resources/zfs/gold", "owner": "tanana", "type": "singleton", "user_label": "" } }, "state": "AKCS_UNCONFIGURED" } }
클러스터 리소스에서 href 등록 정보를 따르면 해당 단일 클러스터 리소스에 대한 데이터를 가져올 수 있습니다. 이전 예에서 두 가지 리소스인 /hardware/v1/cluster/resources/resources/zfs/gold 및 /hardware/v1/cluster/resources/resources/net/ixgbe0를 사용할 수 있습니다.
시스템이 클러스터화되면 이 명령을 사용하여 각 클러스터 리소스에 대한 등록 정보를 수정할 수 있습니다. 자세한 내용은 CLI "구성 클러스터 리소스"를 참조하십시오.
클러스터에서 지원하는 명령은 failover, takeback 및 unconfigure입니다. 모든 명령은 추가된 명령 이름과 함께 클러스터 리소스에 대한 PUT 요청을 수행합니다. 성공 시 두 명령 모두 HTTP 상태 202(Accepted)를 반환합니다.
요청 예:
PUT /api/hardware/v1/cluster/failback HTTP/1.1 Authorization: Basic abcd123MWE= Host: zfssa.example.com:215
결과 예:
HTTP/1.1 202 Accepted X-Zfssa-Appliance-Api: 1.0
클러스터가 명령을 허용하는 올바른 상태가 아닌 경우 HTTP 상태 409(Conflict)가 반환됩니다.
이 명령은 클러스터 카드의 현재 링크 상태를 반환합니다. 출력은 aksh 명령 "구성 클러스터 링크"와 동일합니다. 클러스터 케이블 연결에 문제가 없는지 확인하기 위해 클러스터 설정을 실행하기 전에 이 명령을 실행하는 것이 좋습니다. 설정을 실행하기 전에 모든 링크는 AKCIOS_ACTIVE 상태여야 합니다.
요청 예:
GET /api/hardware/v1/cluster/links HTTP/1.1 Authorization: Basic abcd123MWE= Host: zfssa.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: zfssa.example.com:215 Accept: application/json {"nodename": "zfssa-storage-2", "password": "letmein"}
결과 예:
HTTP/1.1 202 Accepted X-Zfssa-Appliance-Api: 1.0