XCP-ng¶
In dit artikel
- XCP-ng. Belangrijkste functies
- Implementatiefuncties
- Aan de slag met XCP-ng na implementatie
- Autorisatie
- Werken met XO Lite
- Een virtuele machine maken
- XCP-ng Guest Tools installeren
- Beheer van virtuele machines
- Werken met opslag, ISO en netwerken
- Basis CLI-commando's
- Veelvoorkomende problemen en oplossingen
- Een server met XCP-ng bestellen via API
Informatie
XCP-ng (Xen Cloud Platform - New Generation) is een gratis open-source hypervisor gebaseerd op het Xen-project. XCP-ng is gemaakt als open alternatief voor Citrix XenServer nadat Citrix de functionaliteit van de gratis versie had beperkt. Het project biedt een volledig uitgerust virtualisatieplatform op enterprise-niveau zonder kunstmatige beperkingen, met ondersteuning voor live migratie, hoge beschikbaarheid, opslagbeheer en integratie met orkestratiesystemen. XCP-ng wordt gedistribueerd onder GPLv2 en compatibele vrije licenties.
XCP-ng. Belangrijkste functies¶
- Virtualisatie: XCP-ng ondersteunt het uitvoeren van meerdere virtuele machines op een enkele fysieke server met volledige isolatie en efficiënte resourceverdeling. Ondersteunde gastbesturingssystemen omvatten Linux, Windows en andere.
- Live migratie: mogelijkheid om draaiende virtuele machines tussen hosts te verplaatsen zonder downtime, waardoor servicecontinuïteit wordt gegarandeerd tijdens hardwareonderhoud.
- Hoge beschikbaarheid (HA): automatische herstart van virtuele machines op andere poolhosts in geval van serveruitval.
- Opslagbeheer: ondersteuning voor verschillende soorten opslagrepositories, waaronder lokale schijven, NFS, iSCSI, Ceph en andere.
- Snapshots en back-up: maken van directe snapshots van de status van virtuele machines voor snel herstel en back-up.
- Resourcepools: het combineren van meerdere XCP-ng-hosts in één pool voor centraal beheer en belastingverdeling.
- Netwerkcapaciteiten: ondersteuning voor VLAN, netwerkinterfacebonding, SR-IOV en softwaregedefinieerde netwerken.
- Webbeheerinterfaces: XCP-ng bevat de ingebouwde XO Lite-webinterface voor basisbeheer, terwijl de volledig uitgeruste Xen Orchestra (XO) geavanceerde automatisering, monitoring en back-upmogelijkheden biedt.
Beheeropties voor XCP-ng
Er zijn verschillende beheerinterfaces beschikbaar voor het werken met XCP-ng:
XO Lite (ingebouwd, gratis):
- Direct beschikbaar na installatie van XCP-ng op
https://<server_IP_adres>; - Basiswebinterface voor het maken en beheren van virtuele machines;
- Resource-monitoring en basisbewerkingen;
- Geschikt voor thuislabs en kleine projecten;
- Vereist geen extra configuratie.
Xen Orchestra from Sources (gratis, vereist installatie):
- Volledig uitgerust open-source beheersysteem;
- Automatische back-ups, replicatie, geavanceerde monitoring;
- Centraal beheer van meerdere hosts;
- Vereist het maken van een aparte virtuele machine en handmatige installatie (Ubuntu/Debian);
- Onderhoud en updates worden handmatig uitgevoerd;
- Ondersteuning via communityforums.
Xen Orchestra Appliance (XOA) (betaald abonnement, vereist implementatie):
- Kant-en-klare virtuele machine met vooraf geïnstalleerde Xen Orchestra;
- Geïmplementeerd via de knop Deploy XOA in de XO Lite-interface;
- Officiële technische ondersteuning van Vates (24/7);
- Automatische updates en SLA-garanties;
- Plannen voor kleine bedrijven: €2.000/jaar (ESSENTIAL, tot 3 hosts) of €4.000/jaar (ESSENTIAL+, volledige toegang) – details;
- Aanbevolen voor productieomgevingen met ondersteuningsvereisten.
De keuze van optie hangt af van de infrastructuurschaal en technische ondersteuningsvereisten. De ingebouwde XO Lite is voldoende om te beginnen, terwijl geavanceerdere functies beschikbaar zijn door de volledig uitgeruste Xen Orchestra te installeren.
Implementatiefuncties¶
| ID | OS-naam | Alias | Actief | BM | GPU | VPS | VDS | Familie | OS-groep | CloudInit | Beschikbaar |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 306 | XCP-ng 8.3 | - | Ja | + | + | + | - | XCP-ng | Overig | Nee | BESTELLEN |
Minimale serververeisten:
- RAM: 8 GB;
- HDD: 60 GB;
- Virtualisatie: ondersteuning voor geneste virtualisatie.
Aan de slag met XCP-ng na implementatie¶
Nadat u voor uw bestelling heeft betaald, ontvangt u een e-mailmelding op het adres dat u tijdens de registratie heeft opgegeven, waarin staat dat uw server klaar is. Deze e-mail bevat het VPS-IP-adres en inloggegevens. Klanten van ons bedrijf beheren hun apparatuur via het serverbeheerpaneel en de API — Invapi.
U vindt de autorisatiegegevens in het gedeelte Configuration >> Tags van het serverbeheerpaneel of in de e-mail die u heeft ontvangen:
- Gebruikersnaam:
root; - Wachtwoord: Verzonden naar uw e-mailadres nadat de server klaar is voor gebruik na software-implementatie.
Autorisatie¶
Er zijn twee methoden beschikbaar voor toegang tot de XCP-ng-server: via de XO Lite-webinterface en via SSH.
Verbinden via XO Lite¶
XO Lite is een ingebouwde webinterface voor het beheren van XCP-ng, direct toegankelijk vanaf de host.
-
Open een browser en ga naar
https://<server_IP_adres>:
-
Voer gebruikersnaam
rooten het wachtwoord uit de e-mail in en klik vervolgens op de knopLogin.
Informatie
De browser kan een waarschuwing tonen over een niet-vertrouwd certificaat - dit is normaal voor een zelfondertekend certificaat. Voeg een uitzondering toe om door te gaan.
Verbinden via SSH¶
- Open een terminal en verbinding maken met de server met het commando:
- Voer het wachtwoord in wanneer daarom wordt gevraagd. Na succesvolle verbinding bevindt u zich in de XCP-ng-commandoregel.
Verbinden via Native Console¶
U kunt ook de Native Console in het Invapi-beheerpaneel gebruiken om toegang te krijgen tot de hostconsole:

De console biedt een configuratiemenu waarmee u netwerkparameters, authenticatie, beheer van virtuele machines en andere systeemparameters kunt configureren.
Werken met xsconsole¶
Bij het verbinden via SSH of VNC-console kunt u xsconsole gebruiken - de ingebouwde tekstbeheerconsole voor XCP-ng-configuratie en hostadministratie.
Om xsconsole te starten, voert u het commando in:

Na het opstarten opent het systeembeheermenu:

Belangrijkste xsconsole-gedeelten¶
Statusweergave
- Monitoring van hoststatus (CPU, geheugen, netwerk, opslag);
- Weergave van draaiende virtuele machines;
- Algemene systeemgegevens.
Netwerk- en beheerinterface
- Configuratie van netwerkinterfaces;
- Configuratie van IP-adres (statisch/DHCP);
- Configuratie van gateway en DNS-server.
Authenticatie
- Wijzigen van
root-wachtwoord; - Beheer van SSH-toegang;
- Accountconfiguratie.
Virtuele machines
- Weergave van lijst met virtuele machines;
- Basisbeheer van VM (starten, stoppen);
- Statuscontrole van gastsystemen.
Schijven en opslagrepositories
- Weergave van aangesloten schijven;
- Beheer van opslagrepository;
- SR maken en verwijderen.
Configuratie van resourcepool
- Een pool maken van meerdere hosts;
- Lid worden van een bestaande pool;
- Beheer van serverclusters.
Hardware- en BIOS-informatie
- Processor- en geheugeninformatie;
- Gegevens van netwerkkaart;
- BIOS- en firmwareversies.
Toetsenbord en tijdzone
- Configuratie van toetsenbordindeling;
- Instellen van systeemtijdzone.
Configuratie van externe service
- Configuratie van externe toegang;
- SSH-configuratie;
- Beheer van SSL-certificaten.
Back-up, herstellen en bijwerken
- Back-up van hostconfiguratie;
- Instellingen herstellen;
- Controleren en installeren van systeemupdates.
Technische ondersteuning
- Technisch ondersteuningsrapport genereren (bugrapport);
- Verzamelen van systeemlogboeken;
- Diagnostische informatie.
Lokale commandoshell
- Uitgang naar standaard bash-commandoregel;
- Voor het uitvoeren van willekeurige commando's en scripts.
Herstarten of afsluiten
- Host herstarten;
- Systeem correct afsluiten.
Navigatie in xsconsole¶
- Enter - menu-item selecteren/actie bevestigen;
- ↑/↓ - door menu-items bewegen;
- Tab - schakelen tussen formulierelementen;
- Esc of q - terugkeren naar vorig menu/afsluiten.
Tip
xsconsole is vooral handig voor de initiële serverconfiguratie, herstel van noodtoegang of netwerkconfiguratie wanneer de XO Lite-webinterface niet beschikbaar is. Om xsconsole af te sluiten en naar de reguliere commandoregel te gaan, selecteert u Local Command Shell.
Werken met XO Lite¶
Na autorisatie in XO Lite opent het hoofdpaneel (Dashboard):

De XO Lite-interface bevat de volgende secties:
- DASHBOARD: algemeen overzicht van hoststatus, status van virtuele machines, opslaggebruik en meldingen;
- ALARMS: weergave van systeemwaarschuwingen en meldingen;
- STATS: statistieken voor prestaties en resourcegebruik;
- SYSTEM: systeeminstellingen van de host;
- NETWORK: beheer van netwerkinterfaces en virtuele netwerken;
- STORAGE: beheer van gegevensopslag (opslagrepositories);
- TASKS: logboek van lopende en voltooide taken;
- HOSTS: informatie over hosts in de pool;
- VMS: beheer van virtuele machines.
Netwerkbeheer¶
Het tabblad NETWORK toont beschikbare netwerken en hun parameters:

Hier kunt u Pool-wide-netwerken (beschikbaar voor alle hosts in de pool) en Host internal-netwerken bekijken, evenals nieuwe netwerkverbindingen maken.
Een virtuele machine maken¶
Voorbereiding: Een ISO-image laden¶
Voordat u een virtuele machine maakt, moet u een ISO-image van het besturingssysteem in de opslagrepository laden.
ISO laden via SSH
XO Lite ondersteunt het uploaden van ISO-images via de webinterface niet. Om een ISO te uploaden, moet u de commandoregel gebruiken:
-
Verbind met de server via SSH
-
Als xsconsole opent na het verbinden, keert u terug naar de reguliere commandoregel door het menu-item Local Command Shell te selecteren of
Ctrl+Cin te drukken. -
Zoek de UUID van de ISO-opslag
Kopieer de UUID van de opslag met de naam "XCP-ng Tools". -
Navigeer naar de ISO-opslagmap
-
Download de ISO-image
Downloaden van internet:
Of uploaden vanaf lokale computer (uitvoeren op uw pc)
-
Scan de opslag opnieuw
Waar<UUID_SR>de UUID is die in stap 3 is verkregen.Na deze handeling verschijnt de ISO-image in de lijst met beschikbare images bij het maken van een virtuele machine.
Een VM maken via XO Lite¶
-
Klik op de knop
New VMin de rechterbovenhoek van de interface. -
Vul in het geopende venster de parameters van de virtuele machine in:

- Template: selecteer het besturingssysteemtemplate (bijv. AlmaLinux 9);
- Install settings: kies installatiemethode:
- ISO/DVD: installatie vanaf ISO-image (aanbevolen) - selecteer de geladen ISO uit de lijst;
- PXE: netwerkinstallatie (vereist geconfigureerde PXE-server).
- System: geef VM-naam, beschrijving, firmwaretype (BIOS/UEFI) op;
- Memory: stel het aantal vCPUs en de hoeveelheid RAM in.
-
Configureer netwerkverbindingen en opslag:

- Network: selecteer netwerkinterface voor VM-verbinding;
- Storage: selecteer opslag en geef schijfgrootte op;
- Settings: schakel automatische VM-start bij opstarten in (optioneel).
-
Bekijk de definitieve configuratie in het gedeelte Summary en klik op de knop
Create.
Na het maken start de virtuele machine automatisch op en begint het opstarten vanaf de ISO-image. De XO Lite-interface opent de Dashboard-pagina van de gemaakte VM:

De Dashboard-pagina toont:
- Quick info: basisinformatie over VM (status, UUID, host, resources);
- CPU usage: grafiek van processorgebruik;
- RAM usage: grafiek van geheugengebruik;
- Network throughput: grafiek van netwerkactiviteit;
- VDI throughput: grafiek van schijfactiviteit;
- Change state: menu voor het beheren van de VM-status (starten, pauzeren, herstarten, afsluiten).
Om toegang te krijgen tot de console van de virtuele machine en de installatie van het besturingssysteem te beginnen, gaat u naar het tabblad CONSOLE.
Tip
Zorg bij netwerkinstallatie (Boot ISO) ervoor dat de virtuele machine internettoegang heeft via het geconfigureerde netwerk, aangezien installatiepakketten van het repository worden gedownload.
Selectie van ISO-image
Houd bij het selecteren van een ISO-image rekening met het imagetype:
Voor Linux (met AlmaLinux als voorbeeld):
- DVD/Full ISO (~4-10 GB) - volledig image, bevat alle pakketten, vereist geen internet
- AlmaLinux-9-latest-x86_64-dvd.iso;
- Ubuntu-22.04-server.iso.
- Boot/Minimal ISO (~1 GB) - minimaal image, vereist actieve internetverbinding om pakketten te downloaden
- AlmaLinux-9-latest-x86_64-boot.iso;
- Ubuntu-22.04-live-server.iso.
Aanbeveling: Gebruik voor betrouwbare installatie volledige ISO-images (DVD/Full), vooral als de VM een onstabiele of geen internetverbinding heeft.
Aanbevelingen voor firmwareselectie
- UEFI - aanbevolen voor moderne besturingssystemen:
- Linux: AlmaLinux 9+, Ubuntu 20.04+, Debian 11+;
- Windows: Windows Server 2016+, Windows 10/11.
- BIOS - voor compatibiliteit:
- Oudere besturingssysteemversies;
- Bij het tegenkomen van UEFI-opstartproblemen;
- Specifieke scenario's (legacy-applicaties).
Keuze van softwareselectie
Bij het installeren van Linux-distributies zijn verschillende omgevingsopties beschikbaar:
- Minimal Install - basisysteem zonder GUI (~400-600 pakketten, 5-10 minuten installatie)
- Aanbevolen voor servers en productie;
- Minimaal resourcegebruik.
- Server with GUI - volledig systeem met grafische interface (~1000-1500 pakketten, 15-30 minuten installatie)
- Handig voor leren en testen;
- Vereist meer resources (RAM, CPU, schijf).
Voor productieservers wordt Minimal Install aanbevolen.
XCP-ng Guest Tools installeren¶
Na het installeren van het besturingssysteem is het zeer belangrijk om XCP-ng Guest Tools te installeren zodat de virtuele machine correct functioneert.
Waarom Guest Tools nodig zijn¶
Guest Tools bieden:
- Correcte VM-afsluiting en herstart (zachte afsluiting);
- Weergave van IP-adres en VM-status in de XCP-ng-interface;
- Verbeterde netwerk- en schijfprestaties;
- Tijdsynchronisatie tussen host en gastbesturingssysteem;
- Ondersteuning voor snapshots met quiesce (consistente snapshots);
Belangrijk
Zonder geïnstalleerde Guest Tools kan de virtuele machine onstabiel werken, vooral wat betreft netwerkverbindingen en statusbeheer.
Installatievolgorde van Guest Tools¶
Stap 1: Voltooien van OS-installatie
Na het installeren van het besturingssysteem, wanneer een voltooimelding verschijnt of een herstartprompt wordt getoond:
Belangrijk
Start de virtuele machine niet direct opnieuw op. Eerst moet u de installatie-ISO vervangen door guest-tools.iso.
Uitzondering: Als u de VM al opnieuw heeft opgestart, is dat geen probleem - de ISO kan worden aangesloten na de eerste opstart van het geïnstalleerde systeem.
Stap 2: ISO vervangen door Guest Tools (op XCP-ng-host)
Verbind met de XCP-ng-host via SSH en voer de commando's uit.
Zoek de UUID van uw VM:
Of krijg een lijst van alle draaiende VM's:
Voorbeeldoutput:
uuid ( RO) : 0218d2ca-bfb7-fdfb-0c78-7a115a69ecdc
name-label ( RW): AlmaLinux 9
power-state ( RO): running
Verwijder de installatie-ISO (indien aangesloten):
Voeg de guest-tools-ISO in:
Verifieer dat de ISO is vervangen:
Voorbeeldoutput:
uuid ( RO) : 5f644369-7b28-a39d-6bc0-2221ec2b92d3
vm-uuid ( RO): 0218d2ca-bfb7-fdfb-0c78-7a115a69ecdc
vm-name-label ( RO): AlmaLinux 9
vdi-uuid ( RO): dd994bfa-83a6-482a-a2c4-f952a5d8ab81
empty ( RO): false
device ( RO): xvdd
device-parameter - dit is de apparaatnaam in het gastbesturingssysteem (in dit geval xvdd). Stap 3: VM opnieuw opstarten
- Als u nog niet opnieuw heeft opgestart na installatie: Druk in de VM-console op "Reboot System" of voer het commando
rebootuit; - Als u al in een draaiend systeem bent: Herstart is niet vereist, ga door naar Stap 4.
Stap 4: Guest Tools installeren in het gastbesturingssysteem
De installatieprocedure hangt af van het besturingssysteem:
Voor Linux (RHEL-gebaseerd: AlmaLinux, Rocky, CentOS, RHEL)¶
Log in op het systeem als root en voer de commando's uit.
Maak een mountpunt:
Mount de guest-tools-ISO:
Als /dev/sr0 niet werkt, probeer dan alternatieve opties:
of
Controleer de inhoud:
Navigeer naar de map:
Voer de installatie uit:
Voorbeeldoutput:
Detected 'AlmaLinux release 9.7 (Moss Jungle Cat)' (almalinux version 9).
The following changes will be made to this Virtual Machine:
* update arp_notify sysctl
* packages to be installed/upgraded:
- xe-guest-utilities-7.30.0-12.x86_64.rpm
Continue? [y/n] y
Druk op y en wacht tot de installatie is voltooid.
Opmerking
De installatie kan 30-60 seconden vastlopen op 100% - dit is normaal. Als het langer dan 2 minuten vastloopt, druk dan op Ctrl+C en controleer het resultaat.
Verifieer de installatie:
Moet iets als dit tonen:Controleer op het init.d-script:
Moet tonen:
Belangrijk voor AlmaLinux 9 / RHEL 9 / Rocky 9:
systemd-probleem in moderne distributies
Het install.sh-script installeert alleen het init.d-script, maar maakt geen systemd-eenheidsbestand. Dit betekent dat de commando's systemctl status xe-linux-distribution en chkconfig niet werken.
Symptomen:
Oplossing: Maak het systemd-eenheidsbestand handmatig. Voorbeeld van het maken van het bestand:
cat > /etc/systemd/system/xe-linux-distribution.service << 'EOF'
[Unit]
Description=XCP-ng Guest Utilities
After=network.target
[Service]
Type=oneshot
ExecStart=/etc/init.d/xe-linux-distribution start
ExecStop=/etc/init.d/xe-linux-distribution stop
RemainAfterExit=yes
[Install]
WantedBy=multi-user.target
EOF
Controleer de servicestatus:
Unmount de ISO:
Start het systeem opnieuw op om wijzigingen toe te passen:
Voor Linux (Debian-gebaseerd: Ubuntu, Debian)¶
Log in op het systeem als root of gebruik sudo.
Maak een mountpunt:
Mount de guest-tools-ISO:
Navigeer naar de map:
Voer de installatie uit:
Verifieer de installatie:
Controleer de servicestatus:
Unmount de ISO:
Start het systeem opnieuw op:
Alternatieve methode voor Linux: Installatie via repository¶
Als het mounten van ISO niet werkt of u Guest Tools wilt installeren via de pakketbeheerder.
Voor RHEL-gebaseerd (AlmaLinux, Rocky, CentOS) installeert u de EPEL-repository:
Installeer xe-guest-utilities:
Schakel de service in:
Start de service:
Controleer de status:
Opmerking
Installatie via repository vereist een actieve internetverbinding in de VM.
Stap 5: Werking van Guest Tools verifiëren
Na herstart en installatie van Guest Tools, verifieer hun werking.
In het gastbesturingssysteem (Linux) controleert u de servicestatus:
Of via init.d:
Voorbeeld van correcte output:
os_distro="almalinux"
os_majorver="9"
os_minorver="7"
os_uname="5.14.0-611.5.1.el9_7.x86_64"
os_name="AlmaLinux release 9.7 (Moss Jungle Cat)"
Op de XCP-ng-host controleert u de weergave van netwerkgegevens:
Controleer de status van PV-drivers:
Krijg algemene VM-informatie:
In de XO Lite-interfaceNa het starten van de xe-linux-distribution-service moet de VM-Dashboard tonen (bijgewerkt na 10-30 seconden):
- IP-adres: VM-IP-adres;
- Guest tools: geïnstalleerde Guest Tools-versie (bijv. 7.30.0-12);
- OS-naam: gedetecteerd besturingssysteem (bijv. AlmaLinux release 9.7):

Beheer van virtuele machines¶
Het tabblad VMS toont een lijst van alle virtuele machines met beheermogelijkheden:

Beschikbare acties:
- Change state: VM starten, stoppen, herstarten;
- Migrate: VM migreren naar een andere host;
- Copy: een kopie van de virtuele machine maken;
- Edit config: VM-configuratie bewerken;
- Snapshot: een statussnapshot maken;
- Export: VM exporteren naar een bestand;
- Delete: virtuele machine verwijderen.
Werken met opslag, ISO en netwerken¶
Beheer van opslagrepositories (SR)¶
Alle opslag bekijken:
Lijst van alle SR's
Gedetailleerde informatie over specifieke SR Schijfruimtegebruik bekijkenWerken met ISO-opslag:
ISO SR zoeken
Pad naar ISO SR ophalen Navigeer naar ISO-map (meestal /opt/xensource/packages/iso) Beschikbare ISO's bekijken ISO downloaden van internet ISO uploaden vanaf lokale computerLet op
U moet SR opnieuw scannen na het toevoegen van ISO
Beheer van lokale opslag¶
Virtuele schijven (VDI) bekijken:
Vrije ruimte controleren:
Lijst met snapshots bekijken:
Snapshot verwijderen:
Netwerkbeheer¶
Alle netwerken bekijken:
Gedetailleerde netwerkgegevens:
Fysieke interfaces (PIF) bekijken:
Specifieke PIF-details:
Host-IP-adres controleren:
Intern netwerk maken:
VLAN-netwerk maken:
Netwerkinterfaces van VM bekijken:
Nieuwe netwerkinterface voor VM maken:
Basis CLI-commando's¶
Beheer van virtuele machines¶
Lijst van alle VM's:
Alleen draaiende VM's:
Gedetailleerde VM-informatie:
VM starten:
VM afsluiten:
VM herstarten:
VM opschorten:
VM geforceerd afsluiten:
Snapshot maken:
Lijst met snapshots:
Herstellen vanuit snapshot:
Snapshot verwijderen:
VM exporteren:
VM importeren:
Monitoring en diagnostiek¶
Hostinformatie:
Procesmonitoring:
Geavanceerde procesmonitoring:
Geheugengebruik controleren:
Vrij geheugen van host:
CPU-gebruik door virtuele machines:
Hoofd XCP-ng-logboek bekijken:
Systeemlogboeken:
Systeemberichten bekijken:
Xen-logboeken:
Bugrapport maken (bevat alle diagnostische informatie):
Rapportlocatie
Resultaat wordt opgeslagen in /var/opt/xen/bug-report/
Beheer van ISO-images en CD-stations¶
Lijst van beschikbare ISO-images:
Gedetailleerde informatie over ISO in SR:
ISO aan VM koppelen:
ISO uit VM verwijderen:
Aangesloten CD/ISO aan VM controleren:
Navigeer naar ISO-map op host:
ISO downloaden van internet:
SR opnieuw scannen na het laden van ISO:
Status van Guest Tools controleren¶
PV-driversversie controleren:
Controleren of PV-drivers up-to-date zijn:
Gastbesturingssysteemgegevens ophalen:
Detectie van PV-drivers controleren:
Netwerkgegevens van VM ophalen:
Veelvoorkomende problemen en oplossingen¶
Probleem: VM start op in nood-/herstelmodus¶
Symptomen:
Er verschijnt een bericht "You are in emergency mode" of "Welcome to emergency mode";
Typische oorzaken:
- Fouten in opstartconfiguratie (fstab voor Linux);
- Bestandssysteemcorruptie;
- Virtualisatieproblemen;
- Onjuiste VM-afsluiting.
Oplossing voor Linux:
Log in op het systeem met root-wachtwoord (of druk op Ctrl+D om door te gaan).
Controleer systeemlogboeken:
Controleer kernelberichten:
Controleer bestandssysteem:
Controleer schijfgebruik:
Controleer blokapparaten:
Als het probleem in fstab zit (bijv. ontbrekende swap of schijf), bewerk dan het bestand:
Commentaar de problematische regel uit door # aan het begin toe te voegen. Voorbeeld:
Als u het bestandssysteem moet controleren, mount de partitie eerst uit:
Controleer en repareer bestandssysteem:
Start systeem opnieuw op:
Probleem: GRUB laadt niet of hangt¶
Symptomen:
- VM hangt op TianoCore (UEFI)-scherm;
- "Welcome to GRUB" verschijnt en er gebeurt niets;
- Zwarte scherm met cursor na BIOS/UEFI.
Typische oorzaken:
- Onjuiste
boot order; - ISO nog steeds aangesloten als eerste opstartapparaat;
- Corruptie van GRUB-bootloader;
- UEFI/BIOS-incompatibiliteit.
Oplossing 1: Opstartvolgorde controleren en wijzigen
Controleer op XCP-ng-host huidige boot order:
Mogelijke volgorde-waarden: - cdn - HDD ©, CD (d), Netwerk (n) - dcn - CD (d), HDD ©, Netwerk (n) - c - Alleen HDD
Voor OS-installatie, stel CD eerst in:
Na OS-installatie, stel opstarten vanaf HDD alleen in:
Verwijder installatie-ISO indien nog aangesloten:
Start VM opnieuw op:
Oplossing 2: Opstarten via GRUB Rescue (voor Linux)
Als u in de GRUB-commandoregel belandt (grub>-prompt verschijnt), voert u de volgende commando's uit.
Zoek beschikbare partities:
Output zal iets als dit zijn:(hd0) (hd0,msdos2) (hd0,msdos1) Zoek partitie met /boot (meestal msdos1 of gpt1):
Controleer boot-inhoud:
U zou vmlinuz, initramfs-bestanden en de grub2-map moeten zien.
Voor BIOS-systemen voert u uit:
Voor UEFI-systemen voert u uit:
Na het opstarten van het systeem, herstelt u GRUB.
Voor RHEL-gebaseerd (AlmaLinux, Rocky, CentOS):
Voor UEFI-systemen:
Voor Debian-gebaseerd (Ubuntu, Debian):
Installeer GRUB opnieuw indien nodig (voor BIOS):
Oplossing 3: Schakelen tussen UEFI en BIOS
Als problemen aanhouden, controleert u op XCP-ng-host de huidige modus:
Schakel over naar BIOS (kan OS-herinstallatie vereisen):
Of stel BIOS expliciet in:
Probleem: Netwerk werkt niet na installatie¶
Symptomen:
- VM krijgt geen IP-adres;
- Netwerkinterface toont "disconnected" of "no carrier";
- Ping werkt niet;
- IP-adres niet weergegeven in XCP-ng-interface;
Typische oorzaken:
- Guest Tools niet geïnstalleerd (hoofdoorzaak);
- Onjuiste netwerkconfiguratie in VM;
- Problemen met virtuele netwerkadapter;
- Firewall blokkeert verbinding.
Oplossing:
-
Installeer Guest Tools (zie sectie hierboven) - dit lost 90% van de netwerkproblemen op
-
Controleer netwerkinterfacestatus in gastbesturingssysteem
Voor Linux controleert u interfacestatus:
Controleer IP-adressen:
Voor systemen met NetworkManager:
Controleer verbindingen:
Voor systemen met systemd-networkd:
Controleer routing:
-
Schakel interface in en configureer
Voor RHEL-gebaseerd met NetworkManager schakelt u interface in:
Breng verbinding omhoog:
Of herstart NetworkManager:
Voor Debian-gebaseerd controleert u configuratie (Ubuntu 18.04+):
Voor Debian/oude Ubuntu:
Schakel interface in:
Vraag IP aan via DHCP:
-
Controleer XCP-ng-instellingen
Controleer op XCP-ng-host virtuele netwerkinterfaces van VM:
Controleer beschikbare netwerken:
Als VIF ontbreekt of onjuist is, krijg dan netwerk-UUID:
Maak nieuwe VIF:
-
Controleer firewall
Voor Linux (firewalld) controleert u status:
Schakel tijdelijk uit voor testen:
Voor Linux (iptables) controleert u regels:
Wis regels tijdelijk voor testen:
Probleem: Zeer trage OS-installatie¶
Symptomen:
- Installatie duurt enkele uren in plaats van 15-30 minuten;
- Pakketkopiëren is zeer traag;
- VM hangt op "Installing packages" of "Configuring"-stadium.
Typische oorzaken:
- Trage host-schijfsubsystem (HDD in plaats van SSD);
- Overbelaste opslagrepository;
- Onvoldoende VM-resources (CPU, RAM);
- Host-prestatieproblemen.
Oplossingen:
-
Gebruik Minimal Install voor Linux:
- Minimal bevat ~400-600 pakketten in plaats van 1000-1500 (Server with GUI);
- Installatie duurt 5-10 minuten in plaats van uren;
- Voor productieservers is GUI meestal niet nodig;
- U kunt benodigde pakketten na installatie installeren.
-
Verhoog VM-resources tijdelijk
Verhoog op XCP-ng-host (voordat u start of tijdens installatie) RAM:
Verhoog vCPU:
-
Controleer schijfprestaties
Controleer op XCP-ng-host I/O:
Controleer schijflast:
Controleer SR-status:
Krijg SR-details:
-
Gebruik snellere opslag:
- Als meerdere SR's beschikbaar zijn, gebruik dan
SSD-based storage; - Overweeg migratie naar een andere SR.
- Als meerdere SR's beschikbaar zijn, gebruik dan
Probleem: Kan geen ISO aansluiten¶
Symptomen:
- Foutmelding "The VM has no empty CD drive (VBD)";
- Foutmelding "No matching VMs found";
- ISO verschijnt niet in beschikbare lijst.
Oplossing 1: VM heeft geen leeg CD-station
Controleer bestaande VBD's (Virtual Block Devices):
Als CD-station bezet is door een andere ISO, verwijder deze dan:
Voeg nu de benodigde ISO in:
Als CD-station volledig afwezig is, zoek dan eerst de benodigde ISO-UUID:
Maak VBD handmatig:
Oplossing 2: Geen overeenkomende VM's gevonden
Probleem: gebruik van Control Domain-UUID in plaats van VM.
Controleer VM-lijst correct (Control Domain uitsluiten):
Zorg ervoor dat u de juiste UUID gebruikt door te controleren:
Moet zijn: is-control-domain ( RO): false
Oplossing 3: ISO verschijnt niet in lijst
Controleer of ISO is geladen:
Als ISO niet in lijst staat, zoek dan SR voor ISO:
Navigeer naar ISO-map:
Controleer bestandspresence:
Als bestand ontbreekt, download dan van internet:
Of vanaf lokale computer (uitvoeren op uw pc):
Scan SR opnieuw:
Controleer opnieuw:
Probleem: VM sluit niet correct af¶
Symptomen:
xe vm-shutdownwerkt niet of hangt- VM kan alleen worden afgesloten via
--force - Time-outfouten in logboeken
Oorzaken:
- Guest Tools niet geïnstalleerd of niet werkend
- OS reageert niet op ACPI-gebeurtenissen
- Geblokkeerde processen in gastbesturingssysteem
Oplossing:
-
Installeer/controleer Guest Tools (hoofdoorzaak)
-
Controleer Guest Tools-status
Controleer op XCP-ng-host PV-driversversie:
Controleer drivers-actualiteit:
-
Gebruik correcte afsluitcommando's
Zachte afsluiting (vereist Guest Tools):
Geforceerde afsluiting (equivalent aan het indrukken van de aan/uit-knop):
Harde afsluiting (equivalent aan het trekken van de stekker, alleen gebruiken als laatste redmiddel):
Algemene diagnostische tips
Controleer altijd logboeken wanneer problemen optreden.
In gastbesturingssysteem (Linux) controleert u recente gebeurtenissen:
Controleer kernelberichten:
Bekijk systeemlogboek (RHEL-gebaseerd):
Bekijk systeemlogboek (Debian-gebaseerd):
Op XCP-ng-host bekijkt u hoofdlogboek:
Controleer Xen-hypervisorberichten:
Controleer systeemgebeurtenissen:
Diagnostisch rapport maken op XCP-ng-host:
Resultaat wordt opgeslagen in /var/opt/xen/bug-report/
Opmerking
Gedetailleerde informatie over XCP-ng-configuratie en -administratie is beschikbaar in de officiële documentatie.
Opmerking
XCP-ng Forum - communityforum voor hulp.
Een server met XCP-ng bestellen via API¶
Om een server met RouterOS te installeren via de API, volgt u deze instructies.