Server hinzufügen und verwalten
Weitere Proxmox-Hosts und -Cluster anbinden, Zugangsdaten erneuern und Server-Einträge samt API-Token entfernen.
Über einen Server-Eintrag verbindet sich VexCore HV mit der API eines Proxmox-Hosts. VexCore HV arbeitet ausschließlich mit API-Tokens: Benutzername und Passwort brauchen Sie nur einmal, um das Token anzulegen. Das Passwort wird nicht gespeichert.
Server hinzufügen
Dialog öffnen
Klicken Sie auf der Seite Cluster auf Add Server. Um den Eintrag gleich einem Cluster zuzuordnen, klappen Sie den Cluster auf und klicken dort auf Add Server.
Verbindung eintragen
| Feld | Inhalt |
|---|---|
| Server Name | Ein Name für die Anzeige, z. B. Rechenzentrum Nord. |
| Host URL | Die Adresse der Proxmox-API mit Port, z. B. https://192.0.2.20:8006. |
| Cluster (optional) | Der Cluster in VexCore HV, zu dem der Eintrag gehört – siehe Cluster gruppieren. |
| Ignore TLS certificate errors (self-signed) | Eingeschaltet lassen, solange Proxmox sein selbst signiertes Zertifikat verwendet. |
| Username / Password | Ein Proxmox-Benutzer, der API-Tokens anlegen und Berechtigungen setzen darf, z. B. root@pam. Ohne Realm wird @pam angenommen. |
Verbindung testen
Klicken Sie auf Test Connection. VexCore HV meldet sich an, legt ein API-Token <Benutzer>!vexcore-hv-<zufällig> mit der Rolle Administrator auf / an und liest die Nodes:
Connected! Found 3 node(s). Nodes in use after saving: 4 of 5.Mehrere Tests im selben Dialog verwenden dasselbe Token.
Speichern
Klicken Sie auf Add Server. Der Eintrag erscheint auf der Seite Cluster, und seine Nodes zählen ab sofort für Ihren Plan.
Schließen Sie den Dialog mit Cancel, ohne zu speichern, entfernt VexCore HV das beim Test angelegte Token wieder aus Proxmox. Bleibt ein Dialog ohne Abbrechen liegen (z. B. Browser geschlossen), räumt VexCore HV das Token nach 24 Stunden selbst auf.
Wenn der Test fehlschlägt
| Meldung | Ursache |
|---|---|
This cluster has 3 nodes; your Community plan allows 1. … | Der neue Eintrag brächte mehr Nodes, als Ihr Plan erlaubt. Es wird kein Token angelegt. Open License führt zu Testphase und Upgrade, siehe Pläne und Limits. |
| Anmeldefehler | Benutzername, Realm oder Passwort stimmen nicht, oder der Benutzer darf keine Tokens anlegen. |
| Zeitüberschreitung oder Verbindungsfehler | Adresse oder Port stimmen nicht, oder eine Firewall blockiert den Zugriff von VexCore HV auf Port 8006 des Hosts. |
| Zertifikatsfehler | Proxmox verwendet ein selbst signiertes Zertifikat, und Ignore TLS certificate errors ist ausgeschaltet. |
Derselbe Proxmox zweimal
Zeigt eine Adresse auf einen Proxmox-Host oder -Cluster, der schon eingetragen ist, warnt der Dialog:
This Proxmox is already added as Rechenzentrum Nord. You can still add it — it gets its own API token, and its nodes count only once.Das ist erlaubt, z. B. als zweiter Zugang über einen anderen Node desselben Clusters. Ordnen Sie dann beide Einträge demselben Cluster zu.
Node-Erkennung und Token-Rechte
Für das Node-Limit erkennt VexCore HV jeden Node an seiner Proxmox-Server-ID. Die Seite Cluster zeigt pro Eintrag, welches Merkmal verwendet wird (Node ID: …).
Schränken Sie die Rechte des Tokens später in Proxmox ein, behalten Sie Sys.Audit auf /nodes. Ohne dieses Recht weicht VexCore HV auf den Zertifikats-Fingerabdruck oder auf Cluster- und Node-Namen aus, und die Seite zeigt den Hinweis „grant Sys.Audit on /nodes for the server ID“.
Eintrag bearbeiten
Klicken Sie neben dem Eintrag auf Edit.
- Name, Adresse, Cluster, TLS-Einstellung ändern: Ändern Sie die Felder und klicken Sie auf Save Changes. Ändern Sie die Adresse auf einen anderen Proxmox, gilt die Node-Prüfung wie beim Hinzufügen.
- Neues API-Token anlegen: Tragen Sie zusätzlich Username und Password ein, klicken Sie auf Test Connection und dann auf Save Changes. Der Eintrag verwendet danach das neue Token. Hat VexCore HV das bisherige Token selbst angelegt und verwendet es kein anderer Eintrag, entfernt VexCore HV es aus Proxmox. Andere Tokens, z. B. von Hand angelegte, bleiben bestehen.
Eintrag entfernen
Klicken Sie neben dem Eintrag auf Delete und bestätigen Sie mit Confirm.
Darunter steht Also remove its API token … from Proxmox:
| Hinweis | Bedeutung |
|---|---|
| „Unticked, the token stays on Proxmox.“ | VexCore HV hat das Token angelegt. Mit Haken wird es aus Proxmox entfernt. |
| „… still use(s) this token, so it stays on Proxmox.“ | Ein anderer Eintrag verwendet dasselbe Token. Es bleibt bestehen. |
| „VexCore didn't create this token …“ | Das Token stammt nicht von VexCore HV, z. B. aus der Installation. VexCore HV entfernt es nie. Löschen Sie es bei Bedarf in Proxmox unter Datacenter → Permissions → API Tokens. |
| „Proxmox isn't reachable right now.“ | Der Eintrag wird trotzdem entfernt. Mit Haken entfernt VexCore HV das Token, sobald Proxmox wieder erreichbar ist. |
Nach dem Entfernen zählen die Nodes des Eintrags nicht mehr für Ihren Plan, sofern kein anderer Eintrag sie erreicht. Ihre VMs, Container und Backups in Proxmox bleiben unberührt.