Cluster

El comando Cluster se usa para configurar la agrupación en clusters y gestionar recursos agrupados en clusters.

Solicitud Ruta /hardware/v1 Descripción GET /cluster Obtener propiedades del cluster y lista de recursos del cluster. GET /cluster/resources /<resource:path> Obtener propiedades para el recurso del cluster especificado. PUT /cluster/resources /<resource:path> Modificar el recurso del cluster especificado. PUT /cluster/failback Recuperar todos los recursos asignados al par de cluster. PUT /cluster/takeover Tomar el control de todos los recursos asignados al par de cluster. PUT /cluster/unconfigure Desconfigurar un dispositivo agrupado en cluster y configurarlo en modo independiente. GET /cluster/links Obtener el estado del enlace de la tarjeta del cluster. PUT /cluster/setup Ejecutar la configuración del cluster inicial.

Obtener propiedades del cluster

Obtiene el estado de la configuración del cluster actual y las propiedades del recurso.

Ejemplo de solicitud:

GET /api/hardware/v1/cluster HTTP/1.1
Authorization: Basic abcd45sMWE=
Host: tanana:215
Accept: application/json

Ejemplo de respuesta:

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"
    }
}

Obtener recurso del cluster

Mediante el seguimiento de la propiedad href de los recursos del cluster, es posible obtener los datos necesarios para ese solo recurso de cluster. En el ejemplo anterior, había dos recursos disponibles: /hardware/v1/cluster/resources/resources/zfs/gold and /hardware/v1/cluster/resources/resources/net/ixgbe0.

Modificar recurso del cluster

Cuando un sistema está agrupado en cluster, se pueden modificar las propiedades para cada recurso del cluster con este comando. Para obtener más información, consulte “configuration cluster resources” en la CLI.

Comandos de cluster

Los comandos admitidos por el cluster son failover, takeback y unconfigure. Todos los comandos toman una solicitud PUT para el recurso del cluster con el nombre del comando agregado. Cuando la solicitud es satisfactoria, ambos comandos devuelven el estado HTTP Status 202 (Accepted) (estado HTTP 202 [aceptado]).

Ejemplo de solicitud:

PUT /api/hardware/v1/cluster/failback HTTP/1.1
Authorization: Basic abcd123MWE=
Host: zfssa.example.com:215

Resultado de ejemplo:

HTTP/1.1 202 Accepted
X-Zfssa-Appliance-Api: 1.0

Si el cluster no está en el estado correcto para aceptar el comando, se devuelve HTTP Status 409 (Conflict) (estado HTTP 409 [conflicto]).

Enlaces de cluster

Este comando devuelve el estado actual de los enlaces de la tarjeta del cluster. La salida es la misma que la del comando aksh “configuration cluster links”. Se recomienda ejecutar este comando antes de ejecutar la configuración del cluster para asegurar que no haya problemas con el cableado del cluster. Todos los enlaces deben tener el estado AKCIOS_ACTIVE antes de ejecutar la configuración.

Ejemplo de solicitud:

GET /api/hardware/v1/cluster/links HTTP/1.1
Authorization: Basic abcd123MWE=
Host: zfssa.example.com:215
Accept: application/json

Ejemplo de respuesta:

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"
    }
}

Configurar cluster

El comando setup cluster configura la agrupación en clusters inicial del sistema. Todos los enlaces del cluster deben tener el estado AKCIOS_ACTIVE y el sistema equivalente debe estar energizado, pero sin configurar. De lo contrario, este comando fallará.

Ejemplo de solicitud:

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"}

Resultado de ejemplo:

HTTP/1.1 202 Accepted
X-Zfssa-Appliance-Api: 1.0