Les commandes cluster permettent de configurer le clustering et de gérer les ressources du cluster.
|
La commande cluster répertorie l'état de configuration et les propriétés des ressources actuels du cluster.
Exemple de demande :
GET /api/hardware/v2/cluster HTTP/1.1 Authorization: Basic Tm8gcGVla2luZyE= Host: zfs-storage.example.com:215 Accept: application/json
Exemple de résultat :
HTTP/1.1 200 OK
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
Content-Length: 529
X-Zfssa-Api: 1.0
{
"cluster": {
"state": "AKCS_OWNER",
"description": "Active (takeover completed)",
"peer_asn": "d23331e6-41f4-6a15-ac09-a4353e33b43a",
"peer_hostname": "peer-1",
"peer_state": "AKCS_STRIPPED",
"peer_description": "Ready (waiting for failback)",
"resources": [
{
"owner": "peer-1",
"type": "private",
"user_label": "peer-1",
"details": [
"ipaddr"
],
"href": "/api/hardware/v2/cluster/resources/net/vnic1"
},
{
"owner": "peer-1",
"type": "singleton",
"user_label": "",
"details": [
"8.03T"
],
"href": "/api/hardware/v2/cluster/resources/zfs/cas1"
},
{
"owner": "peer-2",
"type": "singleton",
"user_label": "",
"details": [
"18.7T"
],
"href": "/api/hardware/v2/cluster/resources/zfs/cas2"
}
]
}
}
Utilisez la propriété href d'une des ressources répertoriées par la commande cluster pour énumérer les propriétés de cette ressource particulière, comme indiqué dans l'exemple suivant :
GET /api/hardware/v2/cluster/resources/net/vnic1 HTTP/1.1
Utilisez la commande PUT avec la propriété href d'une des ressources répertoriées par la commande cluster pour définir les propriétés de cette ressource.
La commande cluster/links renvoi le statut de liaison actuel de la carte de cluster.
Avant d'effectuer la configuration initiale du cluster, utilisez cluster/links pour vérifier que tous les liens présentent l'état AKCIOS_ACTIVE. Lorsqu'une connexion n'est pas à l'état AKCIOS_ACTIVE, cela peut signifier que l'autre système est en cours de redémarrage/réinitialisation ou que la liaison n'est pas correctement câblée ou que les câbles du cluster ne sont pas correctement branchés dans leurs connecteurs. Pour obtenir des instructions sur le câblage de clusters, reportez-vous à la section Connexion de câbles de cluster dans le Guide de câblage des systèmes Oracle ZFS Storage Appliance.
Le résultat de la commande cluster/links diffère suivant le modèle de contrôleur. Pour les contrôleurs ZS9-2, le statut est renvoyé pour deux liaisons d'E/S de cluster. Pour tous les autres, le statut est renvoyé pour trois liaisons d'E/S de cluster. Pour obtenir une description des liaisons d'E/S de cluster, reportez-vous à la section E/S d’interconnexion de cluster du manuel Guide d’administration d’Oracle® ZFS Storage Appliance, version OS8.8.x.
Exemple de demande :
GET /api/hardware/v2/cluster/links HTTP/1.1 Authorization: Basic Tm8gcGVla2luZyE= Host: zfs-storage.example.com:215 Accept: application/json
Exemple de résultat pour Oracle ZFS Storage ZS9-2 :
HTTP/1.1 200 OK
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
Content-Length: 84
{
"links": {
"lio_dev/i40e0 = AKCIOS_ACTIVE\n
lio_dev/i40e1 = AKCIOS_ACTIVE"
}
}
Exemple de résultat pour les contrôleurs ZS7-2 ou ZS5-2 :
HTTP/1.1 200 OK
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
Content-Length: 181
{
"links": "\n\tclustron_ng3:0/clustron_uart:0 = AKCIOS_ACTIVE
\n\tclustron_ng3:0/clustron_uart:1 = AKCIOS_ACTIVE
\n\tclustron_ng3:0/dlpi:0 = AKCIOS_ACTIVE\n\n"
}
Les autres contrôleurs présentent une sortie links similaire. La seule différence réside dans la partie qui précède /clustron ou /dlpi. Ainsi, clustron3_ng3:0 dans l'exemple précédent est clustron3:0 pour les contrôleurs ZS5-4, clustron2:0 pour les contrôleurs ZS4-4 et clustron2_embedded:0 pour les contrôleurs ZS3-2.
La gestion de cluster inclut les commandes failback, takeover et unconfig. En cas de succès, les commandes renvoient le code de statut HTTP 202 (Accepted). Si l'état du cluster est incorrect pour accepter la commande, un code de statut HTTP 409 (Conflict) est renvoyé.
La reprise est automatiquement tentée dès qu'une défaillance du pair est détectée. Elle peut également être effectuée par un administrateur.
Le rétablissement doit être effectué par un administrateur. L'opération de rétablissement est asynchrone. Lorsque le client REST envoie une commande failback, le statut HTTP 202 est renvoyé une fois la demande reçue. Pour surveiller la progression du rétablissement, le client peut écouter les alertes ou interroger l'état du cluster.
Pour plus d'informations sur la reprise et le rétablissements, reportez-vous à la section Reprise et rétablissement du cluster du manuel Guide d’administration d’Oracle® ZFS Storage Appliance, version OS8.8.x.
Exemple de demande :
PUT /api/hardware/v2/cluster/failback HTTP/1.1
L'annulation de la configuration d'un noeud de cluster paramètre celui-ci pour un fonctionnement autonome. En règle générale, n'effectuez pas l'annulation de la configuration d'un noeud de cluster vous-même. L'annulation de la configuration d'un noeud de cluster est destructive. Elle ne se limite pas à la simple commande unconfig. Pour plus d'informations, reportez-vous à la section Annulation de la configuration d’un noeud de cluster du manuel Guide d’administration d’Oracle® ZFS Storage Appliance, version OS8.8.x.
Il s'agit d'une étape de la configuration initiale du cluster. Pour plus d'informations, reportez-vous à la section Mise à niveau d’un appareil autonome vers une configuration clustérisée (BUI) du manuel Guide d’administration d’Oracle® ZFS Storage Appliance, version OS8.8.x.
La commande cluster/setup permet d'effectuer la configuration initiale du cluster pour le système. Spécifiez des valeurs pour les propriétés nodename et password. Si la configuration réussit, le statut HTTP 202 Accepted est renvoyé.
Pour que la commande cluster/setup aboutissent, les deux conditions suivantes doivent être remplies :
Tous les liens de cluster présentent l'état AKCIOS_ACTIVE. Reportez-vous à Statut de liaison d'un cluster.
Le pair est sous tension mais non configuré.
Exemple de demande :
PUT /api/hardware/v2/cluster/setup HTTP/1.1
Authorization: Basic Tm8gcGVla2luZyE=
Host: zfs-storage.example.com:215
Accept: application/json
{"nodename": "zfs-storage-2", "password": "password"}