5.5.15. Gestion de la haute disponibilité de GCaps

5.5.15.1. Introduction

Cette procédure décrit la haute disponibilité entre 2 GCaps.

Pour plus d'informations, se référer au paragraphe high-availability.

5.5.15.2. Prérequis

Utilisateur : setup
Commandes utilisées dans cette procédure :
- show advanced-configuration high-availability status
- set advanced-config high-availability

5.5.15.3. Opérations préliminaires

Se connecter sur le GCap (voir Procédure de connexion sur le GCap via SSH).
Arrêter le moteur de détection (voir monitoring-engine).

5.5.15.4. Procédure pour afficher l'état de la haute disponibilité (redondance des GCaps)

Entrer la commande suivante.

(gcap-cli) show advanced-configuration high-availability status

Valider.

Le système affiche l'état de la haute disponibilité avec les compteurs suivants :

status : état du GCap.
- unhealthy : le GCap n'est pas connecté au GCap voisin
- Not configured : il n'y pas de haute disponibilité configuré sur ce système
paired GCap : adresse IPv6 du GCap voisin.
leader : état de l'élection parmi Leader/Follower.
time since last status : temps écoulé depuis le dernier healthcheck du GCap voisin.
Leader since : date à laquelle le GCap est devenu Leader.

Cas de l'absence de la haute disponibilité (redondance des GCaps)

Current high-availability status:

status: Not configured
paired gcap: Unknown
leader: Follower
time since last status: Unknown
Follower since: Unknown

Cas de la haute disponibilité (redondance des GCaps) avec perte de connexion entre les GCaps

Current high-availability status:

status: Operational [unhealthy]
paired gcap: fe80::233
leader: Leader
time since last status: Unknown
Leader since: 2022-01-21T15:35:09Z

5.5.15.5. Procédure pour configurer la haute disponibilité sur le premier GCap

Entrer la commande suivante.
```
(gcap-cli) set advanced-configuration high-availability peer-ip fe80::XXX 
public-ip fe80::YYY multicast-group ff02::200 
peer-pubkey 2wtmY/oCaoUGreyr2CROnKAIoEgTXkSOedXlXDvUfBU=   
shared-secret Xxf4fknh4KoOH2zgrI4Wyw==
```
Note

Explication des paramètres :
- set advanced-configuration high-availability : commande pour configurer la haute disponibilité
- peer-ip fe80::XXXadresse IPv6 du GCap voisin parmi:
  
  Link-local : si les GCap sont dans le même sous-réseau. Plage FE80::/10. Ex : FE80::100/64.
  
  ULA (Unique Local Address) : si les GCap sont dans des sous-réseaux différents. Plage FD00::/7. Ex : FD00::100/64.
  
  Global Unicast : si les GCap doivent communiquer via internet. Plage 2001::/3. Ex : 2001::1/64.
- public-ip fe80::YYYadresse IPv6 du GCap parmi:
  
  Link-local : si les GCap sont dans le même sous-réseau. Plage FE80::/10. Ex : FE80::100/64.
  
  ULA (Unique Local Address) : si les GCap sont dans des sous-réseaux différents. Plage FD00::/7. Ex : FD00::100/64.
  
  Global Unicast : si les GCap doivent communiquer via internet. Plage 2001::/3. Ex : 2001::1/64
- multicast-group ff02::200 : adresse IPv6 multicast pour la communication entre les GCaps. Plage FF00::/8. Ex : FF02::200.
- peer-pubkey 2wtmYCaoUGreyr2CROnKAIoEgTXkSOedXlXDvUfBU= : Clé publique du GCap voisin visible via la commande show advanced-configuration high-availability pubkey.
- shared-secret Xxf4fknh4KoOH2zgrI4Wyw== : secret de 16 octets encodé en base64 qui doit être identique entre les 2 GCaps.

Valider.

Le système affiche le résultat.

Updating HA configuration
High availability configuration successfully updated

5.5.15.6. Exemple pour configurer la haute disponibilité sur le deuxième GCap

Entrer la commande suivante.

(gcap-cli) set advanced-configuration high-availability peer-ip fe80::YYY public-ip fe80::XXX multicast-group ff02::200 peer-pubkey xehXnrigZ0IZZEvWbWri8XegNh0KaAQk8vC6mKj27Ug= shared-secret Xxf4fknh4KoOH2zgrI4Wyw==

Le système affiche le résultat.

Updating HA configuration
High availability configuration successfully updated

5.5.15.7. Exemple pour activer la haute disponibilité sur chaque GCap

Entrer la commande suivante.

(gcap-cli) set advanced-configuration high-availability enable confirm

Le système affiche le résultat.

Interfaces naming rules updated, reloading configuration
Operation successful.
High availability configuration successfully updated