XCP-ng¶

In dit artikel

• XCP-ng. Belangrijkste functies
• Kenmerken bij implementatie
• 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

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 verdeling van resources. 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): automatisch herstarten van virtuele machines op andere poolhosts in geval van serveruitval.
• Opslagbeheer: ondersteuning voor verschillende soorten Storage Repositories, 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: combineren van meerdere XCP-ng-hosts in een enkele pool voor gecentraliseerd beheer en belastingverdeling.
• Netwerkcapaciteiten: ondersteuning voor VLAN, netwerkinterface-bonding, 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.

Kenmerken bij implementatie¶

Minimale servereisen:

• 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 kunt de autorisatiegegevens vinden in het gedeelte Configuration >> Tags van het serverbeheerpaneel of in de e-mail die u heeft ontvangen:

• Login: 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_address>:

  

• Voer login root en het wachtwoord uit de e-mail in en klik vervolgens op de knop Login.

Verbinden via SSH¶

• Open een terminal en maak verbinding met de server met het commando:

ssh root@<server_IP_address>

• Voer het wachtwoord in wanneer daarom wordt gevraagd. Na een 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:

xsconsole

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);
• Controle van de status van het gastbesturingssysteem.

Schijven en opslagrepositories

• Weergave van aangesloten schijven;
• Beheer van Storage Repository;
• 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 netwerkkaarten;
• BIOS- en firmwareversies.

Toetsenbord en tijdzone

• Configuratie van toetsenbordindeling;
• Instellen van systeemtijdzone.

Configuratie van externe services

• 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

• Genereren van technisch ondersteuningsrapport (bugrapport);
• Verzamelen van systeemlogboeken;
• Diagnostische informatie.

Local Command Shell

• 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.

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 (Storage Repositories);
• 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 networks (beschikbaar voor alle hosts in de pool) en Host internal networks 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 laden in de Storage Repository.

1. Verbind met de server via SSH

       ssh root@<server_IP_address>
   

2. Als xsconsole opent na het verbinden, keert u terug naar de reguliere commandoregel door het menu-item Local Command Shell te selecteren of Ctrl+C in te drukken.

3. Vind de UUID van de ISO-opslag

       xe sr-list content-type=iso
   

   Kopieer de UUID van de opslag met de naam "XCP-ng Tools".

4. Navigeer naar de ISO-opslagmap

       cd /opt/xensource/packages/iso
   

5. Download de ISO-image

   Downloaden van internet:

       wget https://repo.almalinux.org/almalinux/9/isos/x86_64/AlmaLinux-9-latest-x86_64-boot.iso
   

   Of uploaden vanaf lokale computer (uitvoeren op uw PC)

       scp /path/to/file.iso root@<server_IP>:/opt/xensource/packages/iso/
   

6. Scan de opslag opnieuw

       xe sr-scan uuid=<UUID_SR>
   

   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 VM in 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: specificeer VM-naam, beschrijving, firmwaretype (BIOS/UEFI);
  • 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 automatisch opstarten van VM bij het 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 de 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.

XCP-ng Guest Tools installeren¶

Na het installeren van het besturingssysteem is het zeer belangrijk om XCP-ng Guest Tools te installeren voor het correct functioneren van de virtuele machine.

Waarom Guest Tools nodig zijn¶

Guest Tools bieden:

• Correcte afsluiting en herstart van VM (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);

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:

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.

Vind de UUID van uw VM:

xe vm-list name-label="VM_NAME"

Of krijg een lijst van alle draaiende VM's:

xe vm-list power-state=running

Voorbeelduitvoer:

uuid ( RO)           : 0218d2ca-bfb7-fdfb-0c78-7a115a69ecdc
     name-label ( RW): AlmaLinux 9
    power-state ( RO): running

Verwijder de installatie-ISO (indien aangesloten):

xe vm-cd-eject uuid=<UUID_VM>

Plaats de guest-tools-ISO:

xe vm-cd-insert uuid=<UUID_VM> cd-name="guest-tools.iso"

Verifieer dat de ISO is vervangen:

xe vbd-list vm-uuid=<UUID_VM> type=CD

Voorbeelduitvoer:

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

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 reboot uit;
• Als u al in een draaiend systeem bent: Herstarten is niet nodig, 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:

mkdir -p /mnt/cdrom

Mount de guest-tools-ISO:

mount /dev/sr0 /mnt/cdrom

Als /dev/sr0 niet werkt, probeer dan alternatieve opties:

mount /dev/cdrom /mnt/cdrom

of

mount /dev/xvdd /mnt/cdrom

Controleer de inhoud:

ls -la /mnt/cdrom/Linux/

Navigeer naar de map:

cd /mnt/cdrom/Linux

Voer de installatie uit:

bash install.sh

Voorbeelduitvoer:

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.

Verifieer de installatie:

rpm -qa | grep xe-guest

xe-guest-utilities-7.30.0-12.legacy.x86_64

Controleer op het init.d-script:

ls /etc/init.d/ | grep xe

Moet tonen:

xe-linux-distribution

Belangrijk voor AlmaLinux 9 / RHEL 9 / Rocky 9:

systemctl status xe-linux-distribution
Unit xe-linux-distribution.service could not be found.

chkconfig xe-linux-distribution on
bash: chkconfig: command not found...

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

systemctl daemon-reload

systemctl enable xe-linux-distribution

systemctl start xe-linux-distribution

Controleer de servicestatus:

systemctl status xe-linux-distribution

Unmount de ISO:

cd ~
umount /mnt/cdrom

Start het systeem opnieuw op om wijzigingen toe te passen:

reboot

Voor Linux (Debian-gebaseerd: Ubuntu, Debian)¶

Log in op het systeem als root of gebruik sudo.

Maak een mountpunt:

sudo mkdir -p /mnt/cdrom

Mount de guest-tools-ISO:

sudo mount /dev/sr0 /mnt/cdrom

Navigeer naar de map:

cd /mnt/cdrom/Linux

Voer de installatie uit:

sudo bash install.sh

Verifieer de installatie:

dpkg -l | grep xe-guest

Controleer de servicestatus:

sudo systemctl status xe-linux-distribution

Unmount de ISO:

cd ~
sudo umount /mnt/cdrom

Start het systeem opnieuw op:

sudo reboot

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:

sudo dnf install -y epel-release

Installeer xe-guest-utilities:

sudo dnf install -y xe-guest-utilities

Schakel de service in:

sudo systemctl enable xe-linux-distribution

Start de service:

sudo systemctl start xe-linux-distribution

Controleer de status:

sudo systemctl status xe-linux-distribution

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:

systemctl status xe-linux-distribution

Of via init.d:

/etc/init.d/xe-linux-distribution status

Voorbeeld van correcte uitvoer:

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:

xe vm-param-get uuid=<UUID_VM> param-name=networks

Controleer de status van PV-drivers:

xe vm-param-get uuid=<UUID_VM> param-name=PV-drivers-version

Krijg algemene VM-informatie:

xe vm-param-list uuid=<UUID_VM> | grep -E "PV-drivers|networks"

Na het starten van de xe-linux-distribution-service moet de VM-Dashboard tonen (bijgewerkt na 10-30 seconden):

• IP address: VM-IP-adres;
• Guest tools: geïnstalleerde Guest Tools-versie (bijv. 7.30.0-12);
• OS name: 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

xe sr-list

xe sr-param-list uuid=<UUID_SR>

xe sr-list params=name-label,physical-size,physical-utilisation,uuid

Werken met ISO-opslag:

ISO SR vinden

xe sr-list content-type=iso

xe pbd-list sr-uuid=<UUID_SR>

cd /opt/xensource/packages/iso

ls -lh

wget https://example.com/os.iso

scp /path/to/file.iso root@<server_IP>:/opt/xensource/packages/iso/

xe sr-scan uuid=<UUID_SR>

xe vdi-list sr-uuid=<UUID_SR>

Beheer van lokale opslag¶

Virtuele schijven (VDI) bekijken:

xe vdi-list sr-uuid=

Vrije ruimte controleren:

df -h

Lijst met snapshots bekijken:

xe snapshot-list | grep snapshot

Snapshot verwijderen:

xe snapshot-uninstall snapshot-uuid=

Netwerkbeheer¶

Alle netwerken bekijken:

xe network-list

Gedetailleerde netwerkgegevens:

xe network-param-list uuid=

Fysieke interfaces (PIF) bekijken:

xe pif-list

Specifieke PIF-details:

xe pif-param-list uuid=

Host-IP-adres controleren:

ip addr show

Intern netwerk maken:

xe network-create name-label="Internal Network" name-description="Private VM network"

VLAN-netwerk maken:

xe network-create name-label="VLAN100" name-description="VLAN 100" vlan=100 pif-uuid=

Netwerkinterfaces van VM bekijken:

xe vif-list vm-uuid=

Nieuwe netwerkinterface voor VM maken:

xe vif-create vm-uuid= network-uuid= device=0

Basis CLI-commando's¶

Beheer van virtuele machines¶

Lijst van alle VM's:

xe vm-list

Alleen draaiende VM's:

xe vm-list power-state=running

Gedetailleerde VM-informatie:

xe vm-param-list uuid=<UUID_VM>

VM starten:

xe vm-start uuid=<UUID_VM>

VM afsluiten:

xe vm-shutdown uuid=<UUID_VM>

VM herstarten:

xe vm-reboot uuid=<UUID_VM>

VM opschorten:

xe vm-suspend uuid=<UUID_VM>

VM geforceerd afsluiten:

xe vm-shutdown uuid=<UUID_VM> force=true

Snapshot maken:

xe vm-snapshot uuid=<UUID_VM> new-name-label="backup-$(date +%Y%m%d)"

Lijst met snapshots:

xe snapshot-list

Herstellen vanuit snapshot:

xe snapshot-revert snapshot-uuid=<UUID_snapshot>

Snapshot verwijderen:

xe snapshot-uninstall snapshot-uuid=<UUID_snapshot>

VM exporteren:

xe vm-export uuid=<UUID_VM> filename=/path/to/backup.xva

VM importeren:

xe vm-import filename=/path/to/backup.xva

Monitoring en diagnostiek¶

Hostinformatie:

xe host-list params=all

Procesmonitoring:

top

Geavanceerde procesmonitoring:

htop

Geheugengebruik controleren:

free -h

Vrij geheugen van host:

xe host-param-get uuid=<UUID_host> param-name=memory-free

CPU-gebruik door virtuele machines:

xe vm-list params=name-label,power-state,VCPUs-utilisation

Hoofd XCP-ng-logboek bekijken:

tail -f /var/log/xensource.log

Systeemlogboeken:

journalctl -xe

Systeemberichten bekijken:

tail -f /var/log/messages

Xen-logboeken:

xl dmesg

Bugrapport maken (bevat alle diagnostische informatie):

xen-bugtool -y

Beheer van ISO-images en CD-stations¶

Lijst van beschikbare ISO-images:

xe cd-list

Gedetailleerde informatie over ISO in SR:

xe vdi-list sr-uuid= content-type=iso

ISO koppelen aan VM:

xe vm-cd-insert uuid= cd-name=".iso"

ISO uit VM verwijderen:

xe vm-cd-eject uuid=

Aangesloten CD/ISO controleren aan VM:

xe vbd-list vm-uuid= type=CD

Navigeer naar ISO-map op host:

cd /opt/xensource/packages/iso

ISO downloaden van internet:

wget https://example.com/os.iso

SR opnieuw scannen na het laden van ISO:

xe sr-scan uuid=

Status van Guest Tools controleren¶

PV-driversversie controleren:

xe vm-param-get uuid= param-name=PV-drivers-version

Controleren of PV-drivers up-to-date zijn:

xe vm-param-get uuid= param-name=PV-drivers-up-to-date

Gastbesturingssysteemgegevens krijgen:

xe vm-param-get uuid= param-name=os-version

Detectie van PV-drivers controleren:

xe vm-param-get uuid= param-name=PV-drivers-detected

Netwerkgegevens van VM krijgen:

xe vm-param-get uuid= param-name=networks

Veelvoorkomende problemen en oplossingen¶

Probleem: VM start op in Emergency/Recovery-modus¶

Symptomen:

Er verschijnt een bericht "You are in emergency mode" of "Welcome to emergency mode";

Typische oorzaken:

• Fouten in opstartconfiguratie (fstab voor Linux);
• Beschadiging van bestandssysteem;
• Virtualisatieproblemen;
• Onjuiste afsluiting van VM.

Oplossing voor Linux:

Log in op het systeem met root-wachtwoord (of druk op Ctrl+D om door te gaan).

Controleer systeemlogboeken:

journalctl -xb | grep -i error

Controleer kernelberichten:

dmesg | grep -i error

Controleer bestandssysteem:

cat /etc/fstab

Controleer schijfgebruik:

df -h

Controleer blokapparaten:

lsblk

Als het probleem in fstab zit (bijv. ontbrekende swap of schijf), bewerk dan het bestand:

nano /etc/fstab

Commentaar de problematische regel uit door # aan het begin toe te voegen. Voorbeeld:

# /dev/mapper/almalinux-swap none swap defaults 0 0

Als u het bestandssysteem moet controleren, mount de partitie dan eerst uit:

umount /dev/xvda2

Controleer en repareer bestandssysteem:

fsck -y /dev/xvda2

Start systeem opnieuw op:

systemctl reboot

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;
• Beschadiging van GRUB-bootloader;
• UEFI/BIOS-incompatibiliteit.

Oplossing 1: Opstartvolgorde controleren en wijzigen

Controleer op XCP-ng-host huidige boot order:

xe vm-param-get uuid=<UUID_VM> param-name=HVM-boot-params

Mogelijke volgorde-waarden: - cdn - HDD ©, CD (d), Netwerk (n) - dcn - CD (d), HDD ©, Netwerk (n) - c - Alleen HDD

Voor OS-installatie, stel CD als eerste in:

xe vm-param-set uuid=<UUID_VM> HVM-boot-params:order=dcn

Na OS-installatie, stel opstarten alleen vanaf HDD in:

xe vm-param-set uuid=<UUID_VM> HVM-boot-params:order=c

Verwijder installatie-ISO indien nog aangesloten:

xe vm-cd-eject uuid=<UUID_VM>

Start VM opnieuw op:

xe vm-reboot uuid=<UUID_VM> --force

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.

Vind beschikbare partities:

ls

Vind partitie met /boot (meestal msdos1 of gpt1):

ls (hd0,msdos1)/

Controleer boot-inhoud:

ls (hd0,msdos1)/boot/

U zou vmlinuz, initramfs-bestanden en de grub2-map moeten zien.

Voor BIOS-systemen voert u uit:

set root=(hd0,msdos1)

set prefix=(hd0,msdos1)/grub2

insmod normal

normal

Voor UEFI-systemen voert u uit:

set root=(hd0,gpt1)

set prefix=(hd0,gpt1)/boot/grub2

insmod normal

normal

Na het opstarten van het systeem, herstelt u GRUB.

Voor RHEL-gebaseerd (AlmaLinux, Rocky, CentOS):

sudo grub2-mkconfig -o /boot/grub2/grub.cfg

Voor UEFI-systemen:

sudo grub2-mkconfig -o /boot/efi/EFI/almalinux/grub.cfg

Voor Debian-gebaseerd (Ubuntu, Debian):

sudo update-grub

Installeer GRUB opnieuw indien nodig (voor BIOS):

sudo grub2-install /dev/xvda

Oplossing 3: Schakelen tussen UEFI en BIOS

Als problemen aanhouden, controleert u op XCP-ng-host de huidige modus:

xe vm-param-get uuid=<UUID_VM> param-name=HVM-boot-params

Schakel over naar BIOS (kan OS-herinstallatie vereisen):

xe vm-param-remove uuid=<UUID_VM> param-name=HVM-boot-params param-key=firmware

Of stel BIOS expliciet in:

xe vm-param-set uuid=<UUID_VM> HVM-boot-params:firmware=bios

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:

1. Installeer Guest Tools (zie sectie hierboven) - dit lost 90% van de netwerkproblemen op

2. Controleer netwerkinterfacestatus in gastbesturingssysteem

   Voor Linux controleert u interfacestatus:

   ip link show
   

   Controleer IP-adressen:

   ip addr show
   

   Voor systemen met NetworkManager:

   nmcli device status
   

   Controleer verbindingen:

   nmcli connection show
   

   Voor systemen met systemd-networkd:

   networkctl status
   

   Controleer routing:

   ip route show
   

3. Schakel interface in en configureer

   Voor RHEL-gebaseerd met NetworkManager schakelt u interface in:

   sudo nmcli device set eth0 managed yes
   

   Breng verbinding omhoog:

   sudo nmcli connection up eth0
   

   Of herstart NetworkManager:

   sudo systemctl restart NetworkManager
   

   Voor Debian-gebaseerd controleert u configuratie (Ubuntu 18.04+):

   cat /etc/netplan/00-installer-config.yaml
   

   Voor Debian/oude Ubuntu:

   cat /etc/network/interfaces
   

   Schakel interface in:

   sudo ip link set eth0 up
   

   Vraag IP aan via DHCP:

   sudo dhclient eth0
   

4. Controleer XCP-ng-instellingen

   Controleer op XCP-ng-host virtuele netwerkinterfaces van VM:

   xe vif-list vm-uuid=<UUID_VM>
   

   Controleer beschikbare netwerken:

   xe network-list
   

   Als VIF ontbreekt of onjuist is, krijg dan netwerk-UUID:

   xe network-list name-label="Pool-wide network associated with eth0"
   

   Maak nieuwe VIF:

   xe vif-create vm-uuid=<UUID_VM> network-uuid=<UUID_NETWORK> device=0
   

5. Controleer firewall

   Voor Linux (firewalld) controleert u status:

   sudo systemctl status firewalld
   

   Schakel tijdelijk uit voor testen:

   sudo systemctl stop firewalld
   

   Voor Linux (iptables) controleert u regels:

   sudo iptables -L -n
   

   Wis regels tijdelijk voor testen:

   sudo iptables -F
   

Probleem: Zeer trage OS-installatie¶

Symptomen:

• Installatie duurt enkele uren in plaats van 15-30 minuten;
• Kopiëren van pakketten is zeer traag;
• VM hangt op "Installing packages" of "Configuring"-stadium.

Typische oorzaken:

• Trage host-schijfsysteem (HDD in plaats van SSD);
• Overbelaste Storage Repository;
• Onvoldoende VM-resources (CPU, RAM);
• Prestatieproblemen van host.

Oplossingen:

1. 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.

2. Verhoog VM-resources tijdelijk

   Verhoog op XCP-ng-host (voordat u start of tijdens installatie) RAM:

   xe vm-param-set uuid=<UUID_VM> memory-static-max=8GiB memory-dynamic-max=8GiB
   

   Verhoog vCPU:

   xe vm-param-set uuid=<UUID_VM> VCPUs-max=4 VCPUs-at-startup=4
   

3. Controleer schijfprestaties

   Controleer op XCP-ng-host I/O:

   iostat -x 1
   

   Controleer schijflast:

   iotop
   

   Controleer SR-status:

   xe sr-list
   

   Krijg SR-details:

   xe sr-param-list uuid=<UUID_SR>
   

4. Gebruik snellere opslag:

   • Als meerdere SR's beschikbaar zijn, gebruik dan SSD-based storage;
   • Overweeg migratie naar een andere SR.

Probleem: Kan geen ISO koppelen¶

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):

xe vbd-list vm-uuid=<UUID_VM>

Als CD-station bezet is door een andere ISO, verwijder deze dan:

xe vm-cd-eject uuid=<UUID_VM>

Plaats nu de benodigde ISO:

xe vm-cd-insert uuid=<UUID_VM> cd-name="guest-tools.iso"

Als CD-station volledig afwezig is, vind dan eerst de benodigde ISO-UUID:

xe cd-list name-label="guest-tools.iso"

Maak VBD handmatig:

xe vbd-create vm-uuid=<UUID_VM> vdi-uuid=<UUID_ISO> device=3 bootable=false mode=RO type=CD

Oplossing 2: Geen overeenkomende VM's gevonden

Probleem: gebruik van Control Domain-UUID in plaats van VM.

Controleer VM-lijst correct (Control Domain uitsluiten):

xe vm-list is-control-domain=false

Zorg ervoor dat u de juiste UUID gebruikt door te controleren:

xe vm-param-list uuid=<UUID_VM> | grep "is-control-domain"

Moet zijn: is-control-domain ( RO): false

Oplossing 3: ISO verschijnt niet in lijst

Controleer of ISO is geladen:

xe cd-list

Als ISO niet in lijst staat, vind dan SR voor ISO:

xe sr-list content-type=iso

Navigeer naar ISO-map:

cd /opt/xensource/packages/iso

Controleer bestandspresence:

ls -lh

Als bestand ontbreekt, download dan van internet:

wget https://example.com/your-iso.iso

Of vanaf lokale computer (uitvoeren op uw PC):

scp /local/path/file.iso root@<IP-host>:/opt/xensource/packages/iso/

Scan SR opnieuw:

xe sr-scan uuid=<UUID_SR>

Controleer opnieuw:

xe cd-list

Probleem: VM sluit niet correct af¶

Symptomen:

• xe vm-shutdown werkt 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:

1. Installeer/controleer Guest Tools (hoofdoorzaak)

2. Controleer Guest Tools-status

   Controleer op XCP-ng-host PV-driversversie:

   xe vm-param-get uuid=<UUID_VM> param-name=PV-drivers-version
   

   Controleer actualiteit van drivers:

   xe vm-param-get uuid=<UUID_VM> param-name=PV-drivers-up-to-date
   

3. Gebruik correcte afsluitcommando's

   Zachte afsluiting (vereist Guest Tools):

   xe vm-shutdown uuid=<UUID_VM>
   

   Geforceerde afsluiting (gelijkwaardig aan het indrukken van de aan/uit-knop):

   xe vm-shutdown uuid=<UUID_VM> --force
   

Harde afsluiting (gelijkwaardig aan het uitpluggen van de stekker, alleen gebruiken als laatste redmiddel):

xe vm-destroy uuid=<UUID_VM>

journalctl -xe

dmesg | tail -50

tail -f /var/log/messages

tail -f /var/log/syslog

tail -f /var/log/xensource.log

xl dmesg

journalctl -xe

xen-bugtool -y

Een server met XCP-ng bestellen via API¶

Om een server met XCP-ng te installeren via de API, volgt u deze instructies.