Cluster

La commande Cluster permet de configurer le clustering et de gérer les ressources du cluster.

Demande Chemin /hardware/v1 Description GET /cluster Obtention des propriétés de cluster et de la liste des ressources de cluster GET /cluster/resources /<resource:path> Obtention des propriétés pour la ressource de cluster spécifiée PUT /cluster/resources /<resource:path> Modification de la ressource de cluster spécifiée PUT /cluster/failback Rétablissement de toutes les ressources affectées au pair de cluster PUT /cluster/takeover Reprise de toutes les ressources affectées au pair de cluster PUT /cluster/takeover Annulation de la configuration en mode autonome d'un appareil clustérisé GET /cluster/links Obtention du statut de liaison de carte de cluster PUT /cluster/setup Exécution via la configuration initiale du cluster

Get Cluster Properties

Obtient le statut de configuration et les propriétés des ressources actuels du cluster.

Exemple de demande :

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

Exemple de réponse :

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

Get Cluster Resource

En suivant la propriété href des ressources de cluster, vous pouvez accéder aux données de cette ressource de cluster individuelle. Dans l'exemple suivant, deux ressources sont disponibles : /hardware/v1/cluster/resources/resources/zfs/gold et /hardware/v1/cluster/resources/resources/net/ixgbe0

Modify Cluster Resource

Lorsqu'un système est clustérisé, cette commande permet de modifier les propriétés pour chaque ressource de cluster. Pour plus d'informations, reportez-vous aux ressources du cluster de configuration de la CLI.

Commandes de cluster

Les commandes prises en charge par le cluster sont failover, takeback et unconfigure. Toutes les commandes effectuent une demandePUT dans la ressource de cluster portant le nom de la commande ajoutée. En cas de succès, les deux commandes renvoient le code de statut HTTP 202 (Accepted).

Exemple de demande :

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

Exemple de résultat :

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

Si l'état du cluster est incorrect pour accepter la commande, un code de statut HTTP 409 (Conflict) est renvoyé.

Cluster Links

Cette commande renvoie le statut de liaison actuel de la carte de cluster. La sortie est la même que pour la commande aksh de configuration des liaisons de cluster. Nous vous recommandons d'exécuter cette commande avant d'effectuer la configuration de cluster afin de vous assurer que le câblage du cluster ne rencontre aucun problème. Avant d'exécuter la configuration, tous les liens doivent présenter l'état AKCIOS_ACTIVE.

Exemple de demande :

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

Exemple de réponse :

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

La commande Setup Cluster permet de configurer le clustering initial du système. Pour qu'elle aboutisse, l'état de toutes les liaisons de cluster doit être défini sur AKCIOS_ACTIVE et le système de pairs doit être sous tension mais non configuré.

Exemple de demande :

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

Exemple de résultat :

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