클러스터

클러스터 명령은 클러스터링을 설정하고 클러스터화된 리소스를 관리하는 데 사용됩니다.

요청 경로 /hardware/v1 설명 GET /cluster 클러스터 등록 정보 및 클러스터 리소스 목록을 가져옵니다. GET /cluster/resources /<resource:path> 지정된 클러스터 리소스에 대한 등록 정보를 가져옵니다. PUT /cluster/resources /<resource:path> 지정된 클러스터 리소스를 수정합니다. PUT /cluster/failback 클러스터 피어에 지정된 모든 리소스를 페일백합니다. PUT /cluster/takeover 클러스터 피어에 지정된 모든 리소스를 인계합니다. PUT /cluster/unconfigure 클러스터화된 어플라이언스를 독립형 모드로 구성 해제합니다. GET /cluster/links 클러스터 카드 링크 상태를 가져옵니다. PUT /cluster/setup 초기 클러스터 설정을 실행합니다.

클러스터 등록 정보 가져오기

현재 클러스터 구성 상태 및 리소스 등록 정보를 가져옵니다.

요청 예:

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