> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/fr/administration-systeme/ipmi.md). # 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. {% hint style="info" %} 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). {% endhint %} ## 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 {% hint style="success" %} 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. {% endhint %} 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 {% hint style="info" %} 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. {% endhint %} 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é : ```http GET /api/v4/nodes ``` Pour localiser un nœud spécifique par nom : ```http 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 : ```http 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 : ```http PUT /api/v4/nodes/{key} ``` ```json { "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 : ```http POST /api/v4/node_actions ``` ```json { "$row": "/v4/nodes/{key}", "action": "ipmi_test" } ``` Les actions IPMI disponibles sont `ipmi_test` et `clear_sel`. {% hint style="info" %} IPMI s'applique uniquement aux nœuds de niveau hôte, et `ipmi_password` ne peut pas être relu via l'API. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/run-the-platform/fr/administration-systeme/ipmi.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.