XCP-ng¶

In dit artikel

• XCP-ng. Belangrijkste functies
• Implementatiefuncties
• Aan de slag met XCP-ng na de deployment
• Autorisatie
• Werken met XO Lite
• Een virtuele machine maken
• Het installeren van XCP-ng Guest Tools
• Virtuele Machine Beheer
• Werken met Opslag, ISO en Netwerken
• Basis CLI Commando's
• Virtuele Machine Beheer
• Werken met Opslag, ISO en Netwerken
• Basis CLI Commando's
• Veelvoorkomende problemen en oplossingen
• Een server bestellen met XCP-ng via de API

XCP-ng. Belangrijkste functies¶

• Virtualization: XCP-ng ondersteunt het draaien van meerdere virtuele machines op één fysieke server met volledige isolatie en efficiënte resourceverdeling. Ondersteunde gast-OS'en zijn onder andere Linux, Windows en andere.
• Live Migration: de mogelijkheid om draaiende virtuele machines tussen hosts te verplaatsen zonder downtime, wat continuïteit van de dienstverlening garandeert tijdens hardwareonderhoud.
• High Availability (HA): automatische herstart van virtuele machines op andere pool hosts in het geval van een serverstoring.
• Storage Management: ondersteuning voor verschillende soorten Storage Repositories, waaronder lokale schijven, NFS, iSCSI, Ceph en andere.
• Snapshots and Backup: het maken van instant snapshots van de status van virtuele machines voor snelle herstel- en backupprocessen.
• Resource Pools: het combineren van meerdere XCP-ng hosts in één pool voor centraal beheer en lastverdeling.
• Network Capabilities: ondersteuning voor VLAN, network interface bonding, SR-IOV en software-defined networks.
• Web Management Interfaces: XCP-ng bevat de ingebouwde XO Lite webinterface voor basisbeheer, terwijl de uitgebreide Xen Orchestra (XO) geavanceerde automatisering-, monitoring- en backupmogelijkheden biedt.

Implementatiefuncties¶

Minimale serververeisten:

• RAM: 8 GB;
• HDD: 60 GB;
• Virtualization: ondersteuning voor nested virtualization.

Aan de slag met XCP-ng na de deployment¶

Nadat u voor uw bestelling heeft betaald, ontvangt u een e-mailmelding op het adres dat u tijdens de registratie hebt opgegeven, met de melding dat uw server klaar is. Deze e-mail bevat het VPS IP-adres en de inloggegevens. De klanten van ons bedrijf beheren hun apparatuur via het serverbeheerpaneel en de API — Invapi.

U kunt de autorisatiedetails vinden in de sectie Configuration >> Tags van het serverbeheerpaneel of in de e-mail die u heeft ontvangen:

• Login: root;
• Password: Wordt naar uw e-mailadres verzonden nadat de server klaar is voor gebruik na de software-deployment.

Autorisatie¶

Er zijn twee methoden beschikbaar voor toegang tot de XCP-ng server: via de XO Lite webinterface en via SSH.

Verbinding maken via XO Lite¶

XO Lite is een ingebouwde webinterface voor het beheren van XCP-ng, toegankelijk rechtstreeks vanaf de host.

• Open een browser en navigeer naar https://<server_IP_address>:

  

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

Verbinding maken 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 command line.

Verbinding maken via de Native Console¶

U kunt ook de Native Console in het Invapi control paneel gebruiken om toegang te krijgen tot de host-console:

De console biedt een configuratiemenu waarmee u netwerkparameters, authenticatie, virtuele machinebeheer en andere systeemparameters kunt configureren.

Werken met xsconsole¶

Wanneer u via SSH of de VNC-console verbinding maakt, kunt u xsconsole gebruiken - de ingebouwde tekstbeheerconsole voor XCP-ng configuratie en host-administratie.

Om xsconsole te starten, voert u het commando uit:

xsconsole

Na het opstarten wordt het systeembeheermenu geopend:

Belangrijkste xsconsole secties¶

Status Display

• Host status monitoring (CPU, geheugen, netwerk, opslag);
• Bekijk draaiende virtuele machines;
• Algemene systeeminformatie.

Network and Management Interface

• Configuratie van de netwerkinterface;
• IP-adres configuratie (statisch/DHCP);
• Gateway en DNS-server configuratie.

Authentication

• Wijzigen van het root wachtwoord;
• Beheer van SSH-toegang;
• Account configuratie.

Virtual Machines

• Bekijk de lijst met virtuele machines;
• Basis VM-beheer (starten, stoppen);
• Controle van de status van het gastsysteem.

Disks and Storage Repositories

• Bekijk verbonden schijven;
• Beheer van Storage Repositories;
• Aanmaken en verwijderen van SR.

Resource Pool Configuration

• Een pool maken van meerdere hosts;
• Lid worden van een bestaande pool;
• Beheer van serverclusters.

Hardware and BIOS Information

• Processor- en geheugeninformatie;
• Gegevens van de netwerkkaart;
• BIOS- en firmwareversies.

Keyboard and Timezone

• Configuratie van de toetsenbordindeling;
• Instelling van de systeem-tijdzone.

Remote Service Configuration

• Configuratie van de externe toegang;
• SSH-configuratie;
• SSL-certificaatbeheer.

Backup, Restore and Update

• Backup van de host-configuratie;
• Herstel van instellingen;
• Controleren en installeren van systeemupdates.

Technical Support

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

Local Command Shell

• Afsluiten naar de standaard bash command line;
• Voor het uitvoeren van willekeurige commando's en scripts.

Reboot or Shutdown

• Host reboot;
• Correct afsluiten van het systeem.

Navigatie in xsconsole¶

• Enter - selecteer menu-item/bevestig actie;
• ↑/↓ - door menu-items bewegen;
• Tab - schakelen tussen formulierelementen;
• Esc of q - terugkeren naar het vorige menu/afsluiten.

Werken met XO Lite¶

Na de autorisatie in XO Lite wordt het hoofdbeheerpaneel (Dashboard) geopend:

De XO Lite interface bevat de volgende secties:

• DASHBOARD: algemeen overzicht van de host-status, virtuele machine status, opslaggebruik en meldingen;
• ALARMS: bekijk systeemwaarschuwingen en meldingen;
• STATS: prestatie- en resourcegebruik statistieken;
• SYSTEM: host systeeminstellingen;
• NETWORK: netwerkinterface en virtueel netwerkbeheer;
• STORAGE: gegevensopslagbeheer (Storage Repositories);
• TASKS: logboek van lopende en voltooide taken;
• HOSTS: informatie over hosts in de pool;
• VMS: virtuele machine beheer.

Netwerkbeheer¶

Het tabblad NETWORK toont beschikbare netwerken en hun parameters:

Hier kunt u Pool-brede netwerken (beschikbaar voor alle hosts in de pool) en Host interne netwerken bekijken, evenals nieuwe netwerkverbindingen aanmaken.

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. Maak verbinding met de server via SSH

       ssh root@<server_IP_address>
   

2. Als de xsconsole wordt geopend na de verbinding, sluit dan af naar de reguliere command line door het menu-item Local Command Shell te selecteren of Ctrl+C te drukken.

3. Zoek de UUID van de ISO-opslag

       xe sr-list content-type=iso
   

   Kopieer de UUID van de opslag genaamd "XCP-ng Tools".

4. Navigeer naar de ISO-opslagmap

       cd /opt/xensource/packages/iso
   

5. Download het ISO-image

   Downloaden van het internet:

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

   Of uploaden vanaf uw lokale computer (uitvoeren op uw PC)

       scp /pad/naar/bestand.iso root@<server_IP>:/opt/xensource/packages/iso/
   

6. De opslag scannen (rescan)

       xe sr-scan uuid=<UUID_SR>
   

   Waarbij <UUID_SR> de UUID is die in stap 3 is verkregen.

   Daarna verschijnt het ISO-image in de lijst met beschikbare images wanneer u een virtuele machine maakt.

Een VM maken via XO Lite¶

• Klik op de New VM knop in de rechterbovenhoek van de interface.

• Vul in het geopende venster de parameters van de virtuele machine in:

  

  • Template: selecteer de template van het besturingssysteem (bijv. AlmaLinux 9);
  • Install settings: kies de installatiemethode:
    • ISO/DVD: installatie vanaf een ISO-image (aanbevolen) - selecteer de geladen ISO uit de lijst;
    • PXE: netwerkinstallatie (vereist een geconfigureerde PXE-server).
  • System: specificeer de VM-naam, beschrijving, firmware type (BIOS/UEFI);
  • Memory: stel het aantal vCPUs en de hoeveelheid RAM in.

• Configureer netwerkverbindingen en opslag:

  

  • Network: selecteer de netwerkinterface voor de VM-verbinding;
  • Storage: selecteer opslag en specificeer de schijf grootte;
  • Settings: schakel automatisch opstarten van de VM bij boot in (optioneel).

• Controleer de definitieve configuratie in de sectie Summary en klik op de Create knop.

Na het aanmaken zal de virtuele machine automatisch opstarten en het booten vanaf het ISO-image zal beginnen. De XO Lite interface zal de Dashboard-pagina van de aangemaakte VM openen:

De Dashboard-pagina toont:

• Quick info: basis VM-informatie (status, UUID, host, resources);
• CPU usage: processorgebruik grafiek;
• RAM usage: geheugengebruik grafiek;
• Network throughput: netwerkactiviteit grafiek;
• VDI throughput: schijfactiviteit grafiek;
• Change state: VM-status beheer menu (start, pause, reboot, shutdown).

Om toegang te krijgen tot de virtuele machine console en de installatie van het besturingssysteem te starten, gaat u naar het tabblad CONSOLE.

Het installeren van XCP-ng Guest Tools¶

Nadat u het besturingssysteem heeft geïnstalleerd, is het cruciaal belangrijk om XCP-ng Guest Tools te installeren zodat de virtuele machine correct functioneert.

Waarom Guest Tools nodig zijn¶

Guest Tools bieden:

• Correcte VM shutdown en reboot (soft shutdown);
• Weergave van het IP-adres en de VM-status in de XCP-ng interface;
• Verbeterde netwerk- en schijfprestaties;
• Tijd-synchronisatie tussen de host en het gast-OS;
• Ondersteuning voor snapshots met quiesce (consistente snapshots);

Volgorde van Guest Tools installatie¶

Stap 1: De OS-installatie voltooien

Nadat u het besturingssysteem heeft geïnstalleerd, wanneer een voltooiingsbericht verschijnt of een reboot-prompt wordt getoond:

Stap 2: De ISO vervangen door Guest Tools (op de XCP-ng host)

Maak via SSH verbinding met de XCP-ng host en voer de commando's uit.

Zoek 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

Voorbeeld output:

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

Wijs de installatie-ISO uit (indien aangesloten):

xe vm-cd-eject uuid=<UUID_VM>

Voeg de guest-tools ISO in:

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

Controleer of de ISO is vervangen:

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

Voorbeeld output:

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: De VM herstarten

• Als u na de installatie nog niet heeft herstart: Druk in de VM-console op "Reboot System" of voer het commando reboot uit;
• Als u al in een draaiend systeem bent: Een herstart is niet vereist, ga door naar Stap 4.

Stap 4: Guest Tools installeren in het gast-OS

De installatieprocedure hangt af van het besturingssysteem:

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

Log in als root in het systeem en voer de commando's uit.

Maak een mountpunt aan:

mkdir -p /mnt/cdrom

Mount de guest-tools ISO:

mount /dev/sr0 /mnt/cdrom

Als /dev/sr0 niet werkt, probeer 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

Voorbeeld output:

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

Zou het volgende moeten 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 unit file handmatig aan. Voorbeeld van het aanmaken 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 status van de service:

systemctl status xe-linux-distribution

De ISO unmounten:

cd ~
umount /mnt/cdrom

Herstart het systeem om wijzigingen toe te passen:

reboot

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

Log in als root in het systeem of gebruik sudo.

Maak een mountpunt aan:

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 status van de service:

sudo systemctl status xe-linux-distribution

De ISO unmounten:

cd ~
sudo umount /mnt/cdrom

Herstart het systeem:

sudo reboot

Alternatieve methode voor Linux: Installatie via Repository¶

Als het mounten van de ISO niet werkt of als u Guest Tools wilt installeren via de pakketbeheerder.

Installeer voor RHEL-gebaseerd (AlmaLinux, Rocky, CentOS) 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: Controleren van de werking van Guest Tools

Controleer na de herstart en de installatie van de Guest Tools de werking ervan.

In het gast-OS (Linux) controleer de status van de service:

systemctl status xe-linux-distribution

Of via init.d:

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

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 controleer de weergave van de netwerkinformatie:

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

Controleer de status van de 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 het VM Dashboard het volgende weergeven (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):

Virtuele Machine Beheer¶

Het tabblad VMS toont een lijst van alle virtuele machines met beheersmogelijkheden:

Beschikbare acties:

• Change state: starten, stoppen, reboot VM;
• Migrate: de VM migreren naar een andere host;
• Copy: een kopie maken van de virtuele machine;
• Edit config: de VM-configuratie bewerken;
• Snapshot: een status-snapshot maken;
• Export: de VM exporteren naar een bestand;
• Delete: de virtuele machine verwijderen.

Werken met Opslag, ISO en Netwerken¶

Beheer van Storage Repositories (SR)¶

Bekijk alle opslag:

Lijst alle SR's op

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:

Zoek de ISO SR

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 /pad/naar/bestand.iso root@<IP-host>:/opt/xensource/packages/iso/

xe sr-scan uuid=<UUID_SR>

xe vdi-list sr-uuid=<UUID_SR>

Beheer van Lokale Opslag¶

Bekijk virtuele schijven (VDI):

xe vdi-list sr-uuid=

Controleer de vrije ruimte:

df -h

Bekijk de lijst met snapshots:

xe snapshot-list | grep snapshot

Verwijder een snapshot:

xe snapshot-uninstall snapshot-uuid=

Netwerkbeheer¶

Bekijk alle netwerken:

xe network-list

Gedetailleerde netwerkinformatie:

xe network-param-list uuid=

Bekijk fysieke interfaces (PIF):

xe pif-list

Specifieke PIF details:

xe pif-param-list uuid=

Controleer het host IP-adres:

ip addr show

Maak een intern netwerk aan:

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

Maak een VLAN-netwerk aan:

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

Bekijk VM netwerkinterfaces:

xe vif-list vm-uuid=

Maak een nieuwe netwerkinterface aan voor de VM:

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

Basis CLI Commando's¶

Virtuele Machine Beheer¶

Lijst alle VM's op:

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

xe vm-shutdown uuid=<UUID_VM>

VM herstarten:

xe vm-reboot uuid=<UUID_VM>

VM pauzeren (suspend):

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 snapshots op:

xe snapshot-list

Herstellen van 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=/pad/naar/backup.xva

VM importeren:

xe vm-import filename=/pad/naar/backup.xva

Monitoring en Diagnostiek¶

Host-informatie:

xe host-list params=all

Procesmonitoring:

top

Geavanceerde procesmonitoring:

htop

Controleer het geheugengebruik:

free -h

Host vrij geheugen:

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

CPU-gebruik per virtuele machine:

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

Bekijk het hoofd-XCP-ng logboek:

tail -f /var/log/xensource.log

Systeemlogs:

journalctl -xe

Bekijk systeemberichten:

tail -f /var/log/messages

Xen-logs:

xl dmesg

Maak een bugrapport aan (bevat alle diagnostische informatie):

xen-bugtool -y

Beheer van ISO-images en CD-schijven¶

Lijst beschikbare ISO-images op:

xe cd-list

Gedetailleerde informatie over een ISO in de SR:

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

Koppel een ISO aan een VM:

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

Koppel een ISO los van een VM:

xe vm-cd-eject uuid=

Controleer de aangesloten CD/ISO op een VM:

xe vbd-list vm-uuid= type=CD

Navigeer naar de ISO-map op de host:

cd /opt/xensource/packages/iso

Download ISO van het internet:

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

Scan de SR na het laden van een ISO:

xe sr-scan uuid=

Controleer opnieuw:

xe cd-list

Controleren van de status van Guest Tools¶

Controleer de versie van de PV-drivers:

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

Controleer of de PV-drivers up-to-date zijn:

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

Krijg informatie over het gast-OS:

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

Controleer de detectie van PV-drivers:

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

Krijg VM netwerkinformatie:

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

Virtuele Machine Beheer¶

Het tabblad VMS toont een lijst van alle virtuele machines met beheersmogelijkheden:

Beschikbare acties:

• Change state: starten, stoppen, reboot VM;
• Migrate: de VM migreren naar een andere host;
• Copy: een kopie maken van de virtuele machine;
• Edit config: de VM-configuratie bewerken;
• Snapshot: een status-snapshot maken;
• Export: de VM exporteren naar een bestand;
• Delete: de virtuele machine verwijderen.

Werken met Opslag, ISO en Netwerken¶

Beheer van Storage Repositories (SR)¶

Bekijk alle opslag:

Lijst alle SR's op

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:

Zoek de ISO SR

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 /pad/naar/bestand.iso root@<IP-host>:/opt/xensource/packages/iso/

xe sr-scan uuid=<UUID_SR>

xe vdi-list sr-uuid=<UUID_SR>

Beheer van Lokale Opslag¶

Bekijk virtuele schijven (VDI):

xe vdi-list sr-uuid=

Controleer de vrije ruimte:

df -h

Bekijk de lijst met snapshots:

xe snapshot-list | grep snapshot

Verwijder een snapshot:

xe snapshot-uninstall snapshot-uuid=

Netwerkbeheer¶

Bekijk alle netwerken:

xe network-list

Gedetailleerde netwerkinformatie:

xe network-param-list uuid=

Bekijk fysieke interfaces (PIF):

xe pif-list

Specifieke PIF details:

xe pif-param-list uuid=

Controleer het host IP-adres:

ip addr show

Maak een intern netwerk aan:

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

Maak een VLAN-netwerk aan:

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

Bekijk VM netwerkinterfaces:

xe vif-list vm-uuid=

Maak een nieuwe netwerkinterface aan voor de VM:

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

Basis CLI Commando's¶

Virtuele Machine Beheer¶

Lijst alle VM's op:

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

xe vm-shutdown uuid=<UUID_VM>

VM herstarten:

xe vm-reboot uuid=<UUID_VM>

VM pauzeren (suspend):

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 snapshots op:

xe snapshot-list

Herstellen van 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=/pad/naar/backup.xva

VM importeren:

xe vm-import filename=/pad/naar/backup.xva

Monitoring en Diagnostiek¶

Host-informatie:

xe host-list params=all

Procesmonitoring:

top

Geavanceerde procesmonitoring:

htop

Controleer het geheugengebruik:

free -h

Host vrij geheugen:

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

CPU-gebruik per virtuele machine:

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

Bekijk het hoofd-XCP-ng logboek:

tail -f /var/log/xensource.log

Systeemlogs:

journalctl -xe

Bekijk systeemberichten:

tail -f /var/log/messages

Xen-logs:

xl dmesg

Maak een bugrapport aan (bevat alle diagnostische informatie):

xen-bugtool -y

Beheer van ISO-images en CD-schijven¶

Lijst beschikbare ISO-images op:

xe cd-list

Gedetailleerde informatie over een ISO in de SR:

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

Koppel een ISO aan een VM:

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

Koppel een ISO los van een VM:

xe vm-cd-eject uuid=

Controleer de aangesloten CD/ISO op een VM:

xe vbd-list vm-uuid= type=CD

Navigeer naar de ISO-map op de host:

cd /opt/xensource/packages/iso

Download ISO van het internet:

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

Scan de SR na het laden van een ISO:

xe sr-scan uuid=

Controleer opnieuw:

xe cd-list

Controleren van de status van Guest Tools¶

Controleer de versie van de PV-drivers:

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

Controleer of de PV-drivers up-to-date zijn:

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

Krijg informatie over het gast-OS:

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

Controleer de detectie van PV-drivers:

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

Krijg VM netwerkinformatie:

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

Veelvoorkomende problemen en oplossingen¶

Probleem: VM start op in Emergency/Recovery Mode¶

Symptomen:

Bericht verschijnt "You are in emergency mode" of "Welcome to emergency mode";

Typische oorzaken:

• Boot-configuratiefouten (fstab voor Linux);
• Filesystem corruptie;
• Virtualisatieproblemen;
• Onjuiste VM shutdown.

Oplossing voor Linux:

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

Controleer de systeemlogs:

journalctl -xb | grep -i error

Controleer de kernelberichten:

dmesg | grep -i error

Controleer het bestandssysteem:

cat /etc/fstab

Controleer het schijfgebruik:

df -h

Controleer de blokapparaten:

lsblk

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

nano /etc/fstab

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

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

Als u het bestandssysteem wilt controleren, ontkoppel dan eerst de partitie:

umount /dev/xvda2

Controleer en herstel het bestandssysteem:

fsck -y /dev/xvda2

Herstart het systeem:

systemctl reboot

Probleem: GRUB laadt niet of blijft hangen¶

Symptomen:

• VM blijft hangen op het TianoCore (UEFI) scherm;
• "Welcome to GRUB" verschijnt en er gebeurt niets;
• Zwart scherm met cursor na BIOS/UEFI.

Typische oorzaken:

• Onjuiste boot order;
• ISO is nog steeds aangesloten als eerste boot-apparaat;
• GRUB bootloader corruptie;
• UEFI/BIOS incompatibiliteit.

Oplossing 1: Controleer en wijzig de Boot Order

Controleer de huidige boot order op de XCP-ng host:

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 de OS-installatie, stel boot in vanaf alleen HDD:

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

Koppel de installatie-ISO los indien nog aangesloten:

xe vm-cd-eject uuid=<UUID_VM>

Herstart de VM:

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

Oplossing 2: Booten via GRUB Rescue (voor Linux)

Als u in de GRUB command line terechtkomt (grub> prompt verschijnt), voer de volgende commando's uit.

Zoek beschikbare partities:

ls

Zoek de partitie met /boot (meestal msdos1 of gpt1):

ls (hd0,msdos1)/

Controleer de boot-inhoud:

ls (hd0,msdos1)/boot/

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

Voer voor BIOS-systemen het volgende uit:

set root=(hd0,msdos1)

set prefix=(hd0,msdos1)/grub2

insmod normal

normal

Voer voor UEFI-systemen het volgende uit:

set root=(hd0,gpt1)

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

insmod normal

normal

Nadat het systeem is opgestart, herstel 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 de problemen aanhouden, controleer dan de huidige modus op de XCP-ng host:

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

Schakel over naar BIOS (kan een OS-reinstallatie vereisen):

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

Of stel expliciet BIOS 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 wordt niet weergegeven in de XCP-ng interface;

Typische oorzaken:

• Guest Tools niet geïnstalleerd (hoofdoorzaak);
• Onjuiste netwerkconfiguratie in de VM;
• Problemen met de virtuele netwerkadapter;
• Firewall blokkeert de verbinding.

Oplossing:

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

2. Controleer de status van de netwerkinterface in het gast-OS

   Voor Linux controleer de interface-status:

   ip link show
   

   Controleer de 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 de interface in en configureer deze

   Voor RHEL-gebaseerd met NetworkManager schakel de interface in:

   sudo nmcli device set eth0 managed yes
   

   Activeer de verbinding:

   sudo nmcli connection up eth0
   

   Of herstart NetworkManager:

   sudo systemctl restart NetworkManager
   

   Voor Debian-gebaseerd controleer de configuratie (Ubuntu 18.04+):

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

   Voor Debian/oudere Ubuntu:

   cat /etc/network/interfaces
   

   Schakel de interface in:

   sudo ip link set eth0 up
   

   Vraag een IP aan via DHCP:

   sudo dhclient eth0
   

4. Controleer de XCP-ng instellingen

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

   xe vif-list vm-uuid=<UUID_VM>
   

   Controleer beschikbare netwerken:

   xe network-list
   

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

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

   Maak een nieuwe VIF aan:

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

5. Controleer de firewall

   Voor Linux (firewalld) controleer de status:

   sudo systemctl status firewalld
   

   Tijdelijk uitschakelen voor testen:

   sudo systemctl stop firewalld
   

   Voor Linux (iptables) controleer de regels:

   sudo iptables -L -n
   

   Tijdelijk regels wissen voor testen:

   sudo iptables -F
   

Probleem: Zeer trage OS-installatie¶

Symptomen:

• Installatie duurt meerdere uren in plaats van 15-30 minuten;
• Kopiëren van pakketten gaat erg langzaam;
• VM blijft hangen bij de fase "Installing packages" of "Configuring".

Typische oorzaken:

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

Oplossingen:

1. Gebruik Minimal Install voor Linux:

   • Minimal bevat ~400-600 pakketten in plaats van 1000-1500 (Server met GUI);
   • Installatie duurt 5-10 minuten in plaats van uren;
   • Voor productieservers is een GUI meestal niet nodig;
   • U kunt de benodigde pakketten na de installatie installeren.

2. Verhoog tijdelijk de VM-resources

   Verhoog het RAM op de XCP-ng host (vóór het starten of tijdens de installatie):

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

   Verhoog de vCPU:

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

3. Controleer de schijfprestaties

   Controleer de I/O op de XCP-ng host:

   iostat -x 1
   

   Controleer de schijfbelasting:

   iotop
   

   Controleer de SR-status:

   xe sr-list
   

   Krijg SR-details:

   xe sr-param-list uuid=<UUID_SR>
   

4. Gebruik snellere opslag:

   • Als er meerdere SR's beschikbaar zijn, gebruik dan SSD-gebaseerde opslag;
   • Overweeg om te migreren naar een andere SR.

Probleem: Kan ISO niet koppelen¶

Symptomen:

• Foutmelding "The VM has no empty CD drive (VBD)";
• Foutmelding "No matching VMs found";
• ISO verschijnt niet in de beschikbare lijst.

Oplossing 1: VM heeft geen lege CD-schijf

Controleer de bestaande VBD's (Virtual Block Devices):

xe vbd-list vm-uuid=<UUID_VM>

Als de CD-schijf bezet is door een andere ISO, koppel deze dan los:

xe vm-cd-eject uuid=<UUID_VM>

Voeg nu de benodigde ISO in:

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

Als de CD-schijf volledig ontbreekt, zoek dan eerst de benodigde ISO UUID:

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

Maak handmatig een VBD aan:

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: het gebruik van de Control Domain UUID in plaats van de VM.

Controleer de VM-lijst correct (exclusief de Control Domain):

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 de lijst

Controleer of de ISO is geladen:

xe cd-list

Als de ISO niet in de lijst staat, zoek dan de SR voor de ISO:

xe sr-list content-type=iso

Navigeer naar de ISO-map:

cd /opt/xensource/packages/iso

Controleer de aanwezigheid van het bestand:

ls -lh

Als het bestand ontbreekt, download het van het internet:

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

Of vanaf uw lokale computer (uitvoeren op uw PC):

scp /pad/naar/bestand.iso root@<IP-host>:/opt/xensource/packages/iso/

Scan de SR opnieuw:

xe sr-scan uuid=<UUID_SR>

Controleer opnieuw:

xe cd-list

Probleem: VM wordt niet correct uitgeschakeld¶

Symptomen:

• xe vm-shutdown werkt niet of blijft hangen
• VM kan alleen worden uitgeschakeld via --force
• Timeout-fouten in de logs

Oorzaken:

• Guest Tools niet geïnstalleerd of werken niet
• OS reageert niet op ACPI-events
• Vastgelopen processen in het gast-OS

Oplossing:

1. Installeer/controleer Guest Tools (hoofdoorzaak)

2. Controleer de status van Guest Tools

   Controleer de versie van de PV-drivers op de XCP-ng host:

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

   Controleer de actualiteit van de drivers:

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

3. Gebruik de juiste shutdown-commando's

   Zachte shutdown (vereist Guest Tools):

   xe vm-shutdown uuid=<UUID_VM>
   

   Geforceerde shutdown (gelijk aan het indrukken van de aan/uit-knop):

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

Harde shutdown (gelijk aan het lostrekken 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 bestellen met XCP-ng via de API¶

Om een server met RouterOS te installeren met de API, volgt u deze instructies.