IPMI

Comment configurer et utiliser l’intégration IPMI dans VergeOS pour le contrôle à distance de l’alimentation du serveur, les tests de connectivité, la gestion des identifiants et l’accès à l’interface web IPMI.

IPMI est une norme universelle, prise en charge par presque tout le matériel, pour gérer et accéder aux serveurs. Il est accessible même lorsqu'un serveur est hors tension et permet de contrôler à distance les serveurs et de surveiller l'état du matériel, y compris des éléments tels que la température, la consommation électrique, la tension, les erreurs matérielles, etc. VergeOS s'intègre à IPMI pour fournir un contrôle à distance de l'alimentation du serveur (mise sous tension, cycle d'alimentation, etc.) et un accès pratique via l'interface utilisateur VergeOS.

Comme IPMI concerne le matériel physique, il ne s'applique qu'aux nœuds de niveau hôte (et non aux nœuds locataires).

Tester la connectivité IPMI

1. Accédez à Infrastructure > Nœuds dans le menu supérieur.

2. Double-cliquez sur le nœud souhaité pour accéder au tableau de bord du nœud.

3. Sous le IPMI sous-menu, cliquez sur Tester dans le menu de gauche.

État de la connexion IPMI

Le tableau de bord du nœud indiquera l'état IPMI statut et la date/heure de la dernière connexion:

• État IPMI - "OK" indique que la dernière tentative de connexion a réussi. Si la dernière tentative a échoué, un message d'erreur s'affiche.

• Dernière connexion IPMI - affiche la dernière date/heure à laquelle le système VergeOS s'est connecté avec succès à IPMI. (S'il n'y a jamais eu de connexion IPMI réussie, le champ affichera "NA".)

Modifier les identifiants de connexion IPMI stockés

Les instructions suivantes expliquent comment modifier les identifiants IPMI qu'un nœud utilisera pour interagir avec IPMI. La modification de ces champs n'effectue pas d'administration des utilisateurs IPMI ; connectez-vous à votre interface web IPMI pour ajouter ou modifier des utilisateurs IPMI.

1. Depuis le tableau de bord du nœud, cliquez sur Modifier dans le menu de gauche.

2. Saisissez un utilisateur IPMI. (L'utilisateur IPMI doit disposer de privilèges de niveau administrateur.)

3. Saisissez mot de passe IPMI.

4. Cliquez sur Envoyer pour enregistrer les modifications sur le nœud.

Accéder à l'interface web IPMI

Une connexion réussie à l'interface web IPMI via l'interface utilisateur VergeOS nécessite qu'un nom d'utilisateur/mot de passe IPMI valide soit stocké et qu'une configuration réseau appropriée soit en place pour que le système interagisse avec l'IPMI du nœud.

1. Accédez à Infrastructure > Nœuds dans le menu supérieur.

2. Double-cliquez sur le nœud souhaité pour accéder au tableau de bord du nœud.

3. Sous le IPMI dans le sous-menu du menu de gauche, cliquez sur Se connecter.

4. Un nouvel onglet du navigateur s'ouvre sur la page de connexion de l'interface web IPMI.

Gérer les identifiants IPMI via l'API REST

Les identifiants IPMI peuvent également être lus et mis à jour via l'API REST de VergeOS. C'est utile pour gérer les identifiants sur de nombreux nœuds ou à partir de scripts d'automatisation.

Trouver la clé du nœud

Les appels API qui ciblent un nœud utilisent la clé de ligne du nœud ($key). Listez les nœuds pour trouver la clé :

GET /api/v4/nodes

Pour localiser un nœud spécifique par nom :

GET /api/v4/nodes?filter=name eq 'node1'

La réponse inclut la $key valeur ainsi que des champs tels que name, ipmi_address, et ipmi_status.

Lire les informations IPMI

Récupérer l'enregistrement d'un seul nœud :

GET /api/v4/nodes/{key}

Champs liés à IPMI dans la réponse :

Champ	Description
ipmi_address	L'adresse IP ou le nom d'hôte du BMC.
ipmi_user	Le nom d'utilisateur du BMC.
ipmi_password	Écriture seule ; non inclus dans les réponses de lecture.
ipmi_status	L'état de la connexion : prêt, connexion en cours, hors ligne, ou erreur.
ipmi_sel_free / ipmi_sel_used	Compteurs de capacité du journal des événements système.

Définir les identifiants IPMI

Mettre à jour les identifiants stockés avec une PUT requête :

PUT /api/v4/nodes/{key}

{
  "ipmi_user": "admin",
  "ipmi_password": "newpassword"
}

L'enregistrement des identifiants lance automatiquement un test de connectivité ; une action de test distincte n'est pas nécessaire. Si le test ne peut pas être exécuté — par exemple, si le nœud n'a pas d'adresse IPMI — l'API renvoie une erreur et la mise à jour n'est pas enregistrée. Pour vérifier la mise à jour, relisez l'enregistrement du nœud et confirmez ipmi_status est prêt.

Déclencher des actions IPMI

Pour exécuter un test de connectivité ou effacer le journal des événements système sans modifier les identifiants, envoyez une action de nœud :

POST /api/v4/node_actions

{
  "$row": "/v4/nodes/{key}",
  "action": "ipmi_test"
}

Les actions IPMI disponibles sont ipmi_test et clear_sel.

IPMI s'applique uniquement aux nœuds de niveau hôte, et ipmi_password ne peut pas être relu via l'API.