Hypervisor-spezifische Bereitstellungen von Zoom Node

Bereitstellung von Zoom Node auf verschiedenen Hypervisor-Plattformen mit diesem Abschnitt

Beim Bereitstellen von Zoom Node in virtualisierten Umgebungen müssen Sie die Installations- und Konfigurationsschritte an die jeweils verwendete Hypervisor-Plattform anpassen. Jeder Hypervisor – etwa VMware vSphere, Microsoft Hyper-V oder andere – kann spezielle Anforderungen in Bezug auf Ressourcenzuweisung, Speicherzugriff und Netzwerkschnittstellenkonfiguration mit sich bringen.

Dieser Abschnitt bietet detaillierte Anleitungen für unterstützte Hypervisoren und stellt sicher, dass Zoom Node in Ihrer virtuellen Infrastruktur zuverlässig und effizient arbeitet.

VMware vSphere-Bereitstellungen

Der folgende Abschnitt beschreibt die Installationsmethode für VMWare vSphere, für die das Herunterladen und Bereitstellen einer OVA-(Open Virtual Appliance)-Dateiversion von Zoom Node erforderlich ist.

Das OVA-Image herunterladen

So laden Sie die Image-Datei herunter:

1. Melden Sie sich beim Zoom-Admin-Webportal an.

2. Laden Sie die OVA-Image-Datei von Zoom Node herunter, indem Sie zu Node Management > Modules > Node > Add Node.\

   
3. Klicken Sie auf die Registerkarte Download Schaltfläche.

Das OVA-Image bereitstellen

So stellen Sie die Image-Datei bereit:

1. Melden Sie sich bei der VMware-Weboberfläche an.

2. Klicken Sie auf Create/Register VM.

3. Klicken Sie im Menü Sect creation type auf Deploy a virtual machine from an OVF or OVA file.\

   
4. Klicken Sie auf Next.

5. Geben Sie einen Namen für die Zoom Node-VM ein.

6. Klicken Sie auf das blaue Dialogfeld, um einen Dateibrowser zu öffnen, und wählen Sie die heruntergeladene Zoom Node OVA-Image-Datei aus.

   1. (Optional) Ziehen Sie die Image-Datei per Drag-and-drop in das Feld.

1. Klicken Sie auf Next.

2. Wählen Sie das Speichervolumen aus, auf dem Sie Zoom Node speichern möchten, und klicken Sie auf Next.

3. Wählen Sie das Netzwerk aus, in dem sich der Server befinden wird.

   1. (Optional) Sie können die VM bei Bedarf als Thin Provision bereitstellen.

„Thin Provisioning“ ermöglicht es, dass die Festplatte einer virtuellen Maschine physischen Speicher nur dann verwendet, wenn Daten geschrieben werden, anstatt die gesamte Festplattengröße im Voraus zu reservieren. Diese Methode spart Speicherplatz, kann jedoch dazu führen, dass Ihnen der Speicherplatz ausgeht, wenn der Gesamtverbrauch schneller wächst als die verfügbare Kapazität.

1. Klicken Sie auf Next.

2. Überprüfen Sie Ihre Auswahl und klicken Sie auf Finish um die VM bereitzustellen.

Es kann einige Minuten dauern, bis die Bereitstellung der VM abgeschlossen ist.

Nach dem Start verfügt die VM über ähnliche Einstellungen und Details wie im folgenden Bild dargestellt:

Die Bereitstellung der VM ist abgeschlossen.

Microsoft Hyper-V-Bereitstellung

Der folgende Abschnitt beschreibt die Installationsmethode für Microsoft Hyper-V, für die das Herunterladen und Bereitstellen einer VHDX-Dateiversion von Zoom Node erforderlich ist.

Das Zoom Node VHDX-Archiv herunterladen

Das Zoom-Archiv enthält sowohl das Zoom Node VHDX-Festplattenimage als auch die Konfigurationsmetadaten der VM.

So laden Sie das Archiv herunter:

1. Melden Sie sich beim Zoom-Admin-Webportal an.

2. Laden Sie das Zoom Node VHDX Image aus dem Zoom-Admin-Portal herunter, indem Sie zu Node Management > Modules > Node > Add Node.\

3. Laden Sie die Zoom Node VHDX-Datei herunter.

4. Entpacken Sie die Datei in einen lokalen Ordner zur vorübergehenden Verwendung.

(Optional) Erstellen eines VHDX-Images aus einem QCOW2-(KVM)-Festplattenimage mit qemu-img unter Windows

Um ein QCOW2-(KVM)-Festplattenimage in einer Hyper-V-Umgebung zu verwenden, können Sie es mit qemu-img in PowerShell in das VHDX-Format konvertieren.

Schritt 1: Herunterladen und installieren qemu-img für Windows

1. Rufen Sie das offizielle Cloudbase-Repository auf: https://cloudbase.it/qemu-img-windows/

2. Laden Sie die Windows-Version von qemu-img.

3. Entpacken Sie den Inhalt in ein bekanntes Verzeichnis, z. B.: C:\Users\Administrator\Downloads\qemu-img.

Schritt 2: QCOW2 mit PowerShell in das VHDX-Format konvertieren

Öffnen Sie PowerShell und führen Sie den folgenden Befehl aus, um Ihr Image zu konvertieren:

.\qemu-img.exe convert `
  -f qcow2 `
  -O vhdx `
  -p `
  .\ubuntu22-zoomcommon-build-dev-20250312012853-2.qcow2 `
  .\ubuntu22-zoomcommon-build-dev-20250312012853.vhdx

Sie sollten eine Fortschrittsausgabe ähnlich der folgenden sehen:

(100.00/100%)

• -f qcow2 gibt das Eingabeformat an

• -O vhdx gibt das mit Hyper-V kompatible Ausgabeformat an

• -p aktiviert während der Konvertierung die Anzeige eines Fortschrittsbalkens

• Passen Sie die Dateipfade bei Bedarf an Ihre Umgebung an

Implementierungskontext und praktisches Ergebnis

Die Konvertierung in VHDX ermöglicht es Ihnen, benutzerdefinierte Linux-Images (wie Ubuntu mit vorinstallierten Zoom-Agenten oder -Diensten) in eine Hyper-V-VM zu importieren. Dies unterstützt benutzerdefinierte Laborumgebungen, CI/CD-Tests oder lokalisierte Entwicklung mit konsistenten Systemkonfigurationen.

Bereitstellen einer Zoom Node Hyper-V-VM

Hyper-V unterstützt die VM-Bereitstellung über zwei Hauptmethoden: die erste über die GUI im Hyper-V-Manager und die zweite über PowerShell-Skripte. PowerShell ist die einfachste Methode, um mehrere Node-Bereitstellungen zu automatisieren.

Es gibt zwei Methoden, mit denen die virtuelle Maschine bereitgestellt werden kann. Die einfache Methode, Option 1, verwendet PowerShell-Befehle, um eine neue Zoom Node-VM mit der VMDK und den korrekten Attributen zu erstellen. Option 2 verwendet die Hyper-V-Manager-GUI, um die VM bereitzustellen.

Siehe die Voraussetzungen für die Zoom-Node-Infrastruktur Voraussetzungsseite für weitere Informationen.

Für bestimmte Modulfamilien (ZPLS, ZRH, CRC Hybrid) muss die Größe der Zoom Node-VM möglicherweise angepasst werden. Weitere Informationen zu den korrekten Attributen finden Sie in der modulspezifischen Dokumentation.

Option 1 (empfohlen): Bereitstellen der Zoom Node-VM über PowerShell

Ab 2025 ist Microsoft PowerShell v5.1 die unterstützte Version für das Hyper-V-Verwaltungs-Plug-in. PowerShell 7 kann funktionieren, aber einige Hyper-V-spezifische Befehle funktionieren möglicherweise nicht ordnungsgemäß.

Suchen Sie den Speicherort für Ihre Hyper-V-virtuellen Maschinen. In diesem Beispiel werden die VMs auf dem Hyper-V-Server gespeichert unter D:\!-HyperVMs.

Die folgenden PowerShell-Befehle werden verwendet, um die VM zu erstellen, das VHDX-Image anzubinden und die VM mit den richtigen Attributen anzupassen.

# ===========================
# Zoom Node VM: Hyper-V-Einrichtung
# ===========================

# Bearbeiten Sie diese vier Werte
$VMName      = "ZN-PROD-01"
$RootPath    = "D:\!-HyperVMs"  # Ordner, der den VM-Ordner enthalten wird
$SourceVhdx  = "D:\Downloads\ubuntu22-zoomcommon-build-20250502110711.vhdx"
$SwitchName  = "vSwitch-Production"

# Abgeleitete Pfade
$VMFolder    = Join-Path $RootPath $VMName
$TargetVhdx  = Join-Path $VMFolder "$VMName.vhdx"

# --- Ordner für die VM erstellen und das VHDX kopieren (vollständiger, unabhängiger Klon) ---
New-Item -ItemType Directory -Path $VMFolder -Force | Out-Null

Copy-Item -LiteralPath $SourceVhdx -Destination $TargetVhdx -Force

# --- Gen-2-VM erstellen (noch ohne Festplatte) ---
New-VM `
  -Name $VMName `
  -Generation 2 `
  -MemoryStartupBytes 16GB `
  -Path $VMFolder `
  -NoVHD | Out-Null

# --- CPU: 8 vCPU ---
Set-VMProcessor -VMName $VMName -Count 8

# --- Speicher: statische 16 GB (dynamischen Speicher deaktivieren) ---
Set-VMMemory -VMName $VMName -DynamicMemoryEnabled:$false -StartupBytes 16GB

# --- Geklonte Festplatte anhängen ---
Add-VMHardDiskDrive -VMName $VMName -Path $TargetVhdx

# --- Secure Boot + Microsoft UEFI CA + von der Festplatte booten ---
# Secure Boot für Linux (Ubuntu) mit Microsoft UEFI CA aktivieren
Set-VMFirmware -VMName $VMName -EnableSecureBoot On -SecureBootTemplate "MicrosoftUEFICertificateAuthority"

# Das Systemfestplattenobjekt abrufen und als erstes Bootgerät festlegen
$sysDisk = Get-VMHardDiskDrive -VMName $VMName | Where-Object { $_.Path -eq $TargetVhdx }
Set-VMFirmware -VMName $VMName -BootOrder $sysDisk

# --- Netzwerke: mit vSwitch verbinden (optionale VLAN-Zeile auskommentiert) ---
Connect-VMNetworkAdapter -VMName $VMName -SwitchName $SwitchName
# Set-VMNetworkAdapterVlan -VMName $VMName -Access -VlanId 123

# --- Verwaltungsverhalten und Prüfpunkte ---
Set-VM -Name $VMName -AutomaticStartAction StartIfRunning -AutomaticStopAction ShutDown
Set-VM -Name $VMName -CheckpointType Production -AutomaticCheckpointsEnabled:$false

# --- Integrationsdienste: Gastdienstschnittstelle aktivieren ---
$gsi = Get-VMIntegrationService -VMName $VMName -Name 'Guest Service Interface' -ErrorAction SilentlyContinue
if ($gsi -and -not $gsi.Enabled) {
  Enable-VMIntegrationService -VMName $VMName -Name 'Guest Service Interface'
}

# --- VM starten (optional) ---
Start-VM -Name $VMName

Option 2: Das VHDX bereitstellen und die virtuelle Maschine manuell erstellen

Bei Option 2 wird die virtuelle Maschine manuell erstellt, indem die VHDX-Datei bereitgestellt wird. Bei dieser Methode muss das Festplattenimage aus dem entpackten Zoom Node-Archiv in den vorgesehenen Speicherort für Hyper-V-virtuelle Maschinen übertragen und die VM-Einstellungen manuell konfiguriert werden.

Die VMDK in den Hyper-V-VM-Speicher kopieren

1. Suchen Sie den Speicherort für Ihre Hyper-V-virtuellen Maschinen. (In diesem Beispiel werden die VMs auf dem Hyper-V-Server gespeichert unter D:\HyperVMs.)

   
2. Erstellen Sie einen eindeutigen Ordner für den Zoom Node, den Sie bereitstellen, und erstellen Sie in diesem Verzeichnis ein neues Unterverzeichnis mit dem Namen Virtual Hard Disks.

   
3. Kopieren Sie die VHDX-Image-Datei, die Sie von Zoom heruntergeladen haben, in das Verzeichnis Virtual Hard Disks.

4. Melden Sie sich an der Microsoft Hyper-V Manager-Konsole an, um die VMs zu verwalten.

Die VM definieren

Klicken Sie im Hyper-V-Manager auf New und wählen Sie Virtual Machine im rechten Bereich aus. Dadurch wird der New Virtual Machine Wizard.

1. Abschließen des Schritts Specify a Name and Location :

   1. Geben Sie einen Namen für Ihre virtuelle Maschine ein.

   2. (Optional) Wählen Sie einen Speicherort. Es ist üblich, die VM-Konfigurationsdateien im selben Ordner wie die virtuelle Festplatte der VM zu speichern.

   3. Aktivieren Sie das Kontrollkästchen „Store the virtual machine in a different location" und klicken Sie auf Browse.

1. Navigieren Sie zu dem zuvor erstellten Speicherordner der VM.

1. Wählen Sie den Ordner aus.

2. Klicken Sie auf Next.

3. Abschließen des Schritts Generation angeben :

   1. Wählen Sie die Generation 2 Optionsfeld

   2. Klicken Sie auf Next

1. Abschließen des Schritts Arbeitsspeicher zuweisen :

   1. Im Startup memory: Textfeld geben Sie ein 16384 (MB)

   2. (Optional) Aktivieren Sie "Use Dynamic Memory for this virtual machine", um den zugewiesenen RAM zu reduzieren

   3. Klicken Sie auf Next

1. Abschließen des Schritts Netzwerk konfigurieren :

   1. Klicken Sie auf die Registerkarte Connection: Dropdown-Menü und wählen Sie einen virtuellen Switch aus, um die VM mit Ihrem Netzwerk zu verbinden. Dies ist abhängig von Ihrer Hyper-V-Netzwerkumgebung.

1. Klicken Sie auf Next.

Die VHDX-Festplattenimage verbinden

Als Nächstes im Assistenten für neue virtuelle Maschinen schließen Sie den Schritt Connect Virtual Hard Disk ab. So verbinden Sie das Image:

1. Wählen Sie die Use an existing virtual hard disk Optionsfeld.

1. Klicken Sie auf Browse und suchen Sie den zuvor erstellten VM-Ordner.\

   
2. Klicken Sie im Dateiauswahlfenster auf Open.

3. Klicken Sie auf Next.

4. Überprüfen Sie Ihre Einstellungen und klicken Sie auf Finish um die VM mit der angehängten VHDX-Festplatte zu erstellen.\

   

Starten Sie die VM noch nicht.

Zusätzliche VM-Einstellungen konfigurieren

So konfigurieren Sie zusätzliche Einstellungen:

1. Klicken Sie mit der rechten Maustaste auf die bereitgestellte VM und wählen Sie Settings....\

   
2. Unter der Hardware Kategorie auf der linken Seite des Bildschirms klicken Sie auf Sicherheit.

3. Auf der rechten Seite des Bildschirms und unter der Sicherheit Überschrift klicken Sie auf die Template: Dropdown-Liste.

4. Wählen Sie die Microsoft UEFI Certificate Authority Option.\

   
5. Klicken Sie auf Apply.

6. Unter der Hardware Kategorie auf der linken Seite des Bildschirms klicken Sie auf Processor.

7. Auf der rechten Seite des Bildschirms und unter der Processor Überschrift setzen Sie das Number of virtual processors: Feld auf 8 (virtuelle Prozessoren).\

   

Dies ist der Standardwert, den Zoom Node benötigt, um vier (4) Module auszuführen. Weitere Informationen zum Verkleinern der VM bei Ausführung weniger Module finden Sie auf der Voraussetzungen für die Zoom-Node-Infrastruktur Seite.

1. Klicken Sie auf OK um die Änderungen zu übernehmen.

Die virtuelle Maschine starten

So starten Sie die VM:

1. Wählen Sie die neu erstellte VM im Hyper-V-Manager aus.

2. Klicken Sie im rechten Bereich des Bildschirms im Actions Bereich auf Start.

3. Klicken Sie auf Connect um das Konsolenfenster der VM zu öffnen.\

   

Eine funktionierende Startsequenz der VM zeigt den Linux-Startbildschirm. Anschließend wird die textbasierte Zoom Node-Oberfläche geladen.

Wenn beim Starten eine UEFI-Fehlermeldung angezeigt wird, ist die Secure-Boot-Methode möglicherweise nicht auf "UEFI Certificate Authority" gesetzt.

KVM-Bereitstellungen

Der folgende Abschnitt beschreibt die Installationsmethode für Kernel-based Virtual Machine (KVM), die Zoom Node-Installationen entweder über Proxmox VE oder KVM Virtual Machine Manager (Virt-Manager) ermöglicht.

KVM Proxmox Virtual Environment (VE)

Die Bereitstellung von Zoom Node auf Proxmox VE mithilfe des qcow2-Images erfordert im Vergleich zur Bereitstellung eines ISO-Images zusätzliche Schritte. Die folgenden Schritte erstellen eine neue, konfigurierte VM, damit das Zoom Node qcow2-Image dieser VM zugewiesen werden kann.

Eine Standardbereitstellung von QEMU/KVM verwendet Hypervisor-NAT und einen privaten IP-Adresspool für die Bereitstellung von VMs, die von KVM verwaltet werden. Dies ist keine unterstützte Architektur für Zoom Node. Obwohl es möglich ist, einen Zoom Node hinter Hypervisor-NAT bereitzustellen und zu betreiben, können die Clients im Netzwerk nicht ordnungsgemäß mit ihm kommunizieren. Zoom Node muss auf einer Bridged-Schnittstelle bereitgestellt werden, damit er IP-Adressen aus dem IP-Bereich erhält, mit dem die Clients kommunizieren können.

Die Zoom Node virtuelle Maschine definieren

So definieren Sie die VM:

1. Melden Sie sich bei der Proxmox-Verwaltungsoberfläche an.

2. Klicken Sie auf die Registerkarte VM erstellen Schaltfläche. Daraus wird die Zoom Node-Vorlagen-VM.

3. Benennen Sie die VM und speichern Sie die VM-ID.

   1. Diese Informationen werden in einem späteren Schritt verwendet.

4. Klicken Sie auf Next um fortzufahren.

5. Wählen Sie Do not use any media auf der OS-Einstellungsseite aus.

6. Klicken Sie auf Next.

7. Wählen Sie die q35 Option unter den Machine Einstellungen aus.

   1. Für den BIOS Typ wählen Sie OVMF (UEFI) und wählen Sie das Volume aus, auf dem die EFI-Einstellungen gespeichert werden sollen. Dies ist auf dasselbe VM-Volume festgelegt, das Sie zum Speichern der VM selbst verwenden.

Die Einstellungen für Machine und BIOS sind wie beschrieben entscheidend. Andernfalls wird die VM nicht erfolgreich starten.

1. Klicken Sie auf Next.

2. Auf der Disks Seite wählen Sie das Speichervolumen aus, von dem aus die VM ausgeführt wird.

3. Setzen Sie die Einstellung Disk size (GiB) auf 200.

4. Wählen Sie Write-Through für den Cache.

5. Klicken Sie auf Next.

6. Ändern Sie die Einstellung Cores auf 8.

7. Klicken Sie auf Next.

8. Passen Sie die Memory (GiB) auf 16384.

9. Klicken Sie auf Next.

10. Wählen Sie die richtigen Netzwerkeinstellungen für Ihre Bereitstellung, in der Regel eine Bridge-Schnittstelle mit einem VLAN-Tag.

11. Klicken Sie auf Next.

12. Auf der Bestätigen Seite stellen Sie sicher, dass das Kontrollkästchen Start after created nicht ausgewählt ist.

13. Überprüfen Sie die Einstellungen noch einmal und achten Sie dabei besonders auf q35 als Maschinentyp und omvf als BIOS-Typ.

14. Klicken Sie auf Finish nachdem Sie überprüft haben, dass die Einstellungen korrekt sind.

15. Melden Sie sich beim Zoom-Admin-Webportal als Administrator unter https://zoom.us.

Das Zoom Node QCOW2-Image vorbereiten

So bereiten Sie das Image vor:

1. Rufen Sie das Zoom-Admin-Portal auf unter Zoom Node > Modules > Nodes > Add Node.

2. Laden Sie die aktuelle Version der Zoom Node qcow2-Image-Datei.

3. Kopieren Sie die Datei in ein für Proxmox zugängliches Verzeichnis (z. B. ein NFS-Volume).

   1. (Optional) Kopieren Sie sie auf das Proxmox-Server-Volume, auf dem die VMs gespeichert werden.

4. Beachten Sie das Erstellen des 111 Verzeichnisses und des leeren Festplattenimages.

5. Notieren Sie sich den Namen des Festplattenimages in diesem Ordner

   1. Beispiel: vm-111-disk-0.qcow2.

6. Löschen Sie die Festplattenimagedatei.

7. Kopieren Sie die Zoom Node qcow2 Datei in dieses Verzeichnis.

8. Benenne Sie diese Datei in den zuvor notierten ursprünglichen Namen des Festplattenimages um (d. h. vm-111-disk-0.qcow2).

9. Kehren Sie zur Haupt-Weboberfläche von Proxmox zurück und wählen Sie die gerade bereitgestellte VM aus.

10. Klicken Sie mit der rechten Maustaste auf die ausgewählte VM und wählen Sie clone aus.

11. Verwandeln Sie den Klon in eine Vorlage, indem Sie ihm einen Namen geben und auf Clone.

12. Sobald der Klonvorgang abgeschlossen ist, klicken Sie mit der rechten Maustaste auf den Klon und wählen Sie Convert to template.

    1. Sie haben jetzt eine bereitstellbare Vorlage.

13. Wählen Sie die ursprüngliche VM aus und klicken Sie, um die Console.

14. Starten Sie die VM, indem Sie auf Start Now Schaltfläche.

Klicken Sie auf

KVM Virtual Machine Manager (Virt-manager)

Virtual Machine Manager (auch bekannt als virt-manager) ist ein beliebter anwendungsbasierter Manager für QEMU/KVM-virtuelle Maschinen.

Dieses Bereitstellungsbeispiel verwendet Virtual Machine Manager unter Ubuntu 22.04 LTS. Es kann jedoch auf vielen Linux-Distributionen ausgeführt werden.

Eine Standardbereitstellung von QEMU/KVM verwendet Hypervisor-NAT und einen privaten IP-Adresspool für die Bereitstellung von VMs, die von KVM verwaltet werden. Dies ist nicht eine unterstützte Architektur für Zoom Node.

Obwohl es möglich ist, einen Zoom Node hinter Hypervisor-NAT bereitzustellen und auszuführen, können die Clients im Netzwerk nicht ordnungsgemäß kommunizieren. Um die korrekte Kommunikation der Clients sicherzustellen, stellen Sie Zoom Node auf einer gebridgten Schnittstelle bereit, die mit dem IP-Adressbereich des Clients übereinstimmt.

Um die Installation mit der virt-manager-Methode durchzuführen:

1. Melden Sie sich beim Zoom-Admin-Webportal als Administrator.

2. Laden Sie die aktuelle Version der Zoom Node qcow2-Image-Datei aus dem Zoom Node-Admin-Portal durch Auswahl von Zoom Node > Modules > Nodes > Add Node.

3. Benennen Sie die Datei in den gewünschten VM- oder Festplattennamen um.

   1. Beispiel: ZN-SJC01-NODE01.qcow2.

4. Verschieben Sie die Datei in ein Volume, auf das Virtual Manager Zugriff hat.

5. Erstellen Sie eine neue VM in Virtual Manager.

6. Klicken Sie auf Import existing disk image.

7. Wählen Sie das Volume aus, auf dem Sie das umbenannte qcow2-Image gespeichert haben.

8. Klicken Sie auf die Registerkarte Choose Volume Schaltfläche.

   1. (Optional) Wenn Sie noch nicht den richtigen Ordner zu virt-manager hinzugefügt haben, können Sie auf Browse Local klicken, um ihn hinzuzufügen.

9. (Optional) Wenn das Betriebssystem nicht automatisch erkannt wird, setzen Sie es auf Ubuntu 22.04 LTS.

10. Ändern Sie die RAM-Konfiguration auf 16384 MB (16 GB) und die CPU-Konfiguration auf 8 CPUs.

    1. Diese Einstellungen ermöglichen es Zoom Node, vier (4) Module auszuführen.

Sie können diese Werte anpassen, aber Anpassungen können die Kapazität und Leistung von Zoom Node beeinträchtigen. Wenn Sie auf Zoom Node nur ein einzelnes Modul ausführen, können Sie die RAM-Einstellung auf 6 GB und die CPUs auf 3 als absolute Mindestwerte setzen.

1. Geben Sie einen Namen für den Node ein.

2. Klicken Sie vor der Installation auf Customize configuration.

Wenn Sie diese Konfiguration nicht durchführen, wird der Node nicht booten. Zusätzliche Einstellungen müssen geändert werden.

1. Stellen Sie sicher, dass das Netzwerkgerät auf Bridged Ethernet und nicht auf NAT eingestellt ist.

Die Bereitstellung eines Zoom Node hinter einem NAT auf KVM verhindert, dass Clients mit ihm kommunizieren können.

1. Wenn sich der Bereich VM details öffnet, ändern Sie den Chipset auf Q35.

2. Ändern Sie die Firmware auf UEFI.

Zoom Node wird ohne die UEFI-Einstellung nicht booten.

1. Klicken Sie auf Apply.

2. Klicken Sie auf Begin Installation oben im Ribbon-Menü, um die VM bereitzustellen.

Die VM wird gestartet und beginnt mit dem Hochfahren. Sobald die ursprüngliche VM gebootet hat, wissen wir, dass die von uns erstellte Vorlage offiziell verwendbar ist.

Nutanix AHV-Bereitstellungen

Zoom Node kann als virtuelle Maschine (VM) auf Nutanix AHV ausgeführt werden. Zoom Node wird in einem Rechenzentrum bereitgestellt, um Zoom Hybrid Services zu betreiben, auch Service Modules genannt, wie Meetings Hybrid, Recording Hybrid, Chat Hybrid und Phone Local Survivability.

Dieser Abschnitt behandelt die Installation des Zoom Node-OS-VM auf Nutanix-AHV-Versionen 6.8.1 bis 7.0.1.

Allgemeine Anforderungen an Hypervisor und virtuelle Maschine

Die Voraussetzungen für die Zoom-Node-InfrastrukturSeite bietet die für die Bereitstellung erforderlichen Hardware- und Softwarevoraussetzungen.

Zoom Node-Bereitstellung

Für die Bereitstellung von Zoom Node müssen ein Image heruntergeladen, das Image in AHV importiert und eine VM erstellt werden.

Die Zoom Node-Image-Datei herunterladen

So laden Sie die Image-Datei herunter:

1. Melden Sie sich beim Zoom-Admin-Webportal.

2. Laden Sie das Zoom Node QCOW2 Image aus dem Zoom-Admin-Portal durch Auswahl von Node Management > Modules > Node > Add Node.\

   
3. Laden Sie das QCOW2 image durch Klicken auf die Download Schaltfläche.

AHV kann entweder das QCOW2- oder das .ova/VMDK-Image importieren. Sie können beide verwenden, Zoom empfiehlt jedoch die Verwendung des QCOW2-Images. Dieses Format kann nativ hochgeladen werden, ohne eine .ova-Datei entpacken zu müssen, um die VMDK zu extrahieren.

Das Zoom Node-Image in AHV importieren

1. Melden Sie sich bei der Nutanix-AHV-Konsole an, indem Sie zu https://<cluster hostname>:9440.

2. Klicken Sie auf die Registerkarte Home Dropdown-Menü und wählen Sie Settings aus der Liste aus.

1. Überprüfen Sie die Settings Seite.

1. Klicken Sie auf der linken Seite des Bildschirms auf Image Configuration. Das Dialogfeld zum Hochladen des Festplattenimages wird angezeigt.

1. Klicken Sie auf die Schaltfläche + Upload Image.

1. Geben Sie Ihre bevorzugten Informationen in die Textfelder des Dialogfelds Create Image ein.

   1. Annotation ist ein optionales Feld.

   2. Klicken Sie auf die Registerkarte Image Type Dropdown-Menü und wählen Sie DISK.

   3. Klicken Sie auf die Registerkarte Storage Container Dropdown-Menü und wählen Sie die für Ihre Umgebung geeignete Option aus.

2. Klicken Sie auf die Registerkarte Upload a file Optionsfeld und klicken Sie dann auf Browse....

3. Wählen Sie das zuvor heruntergeladene QCOW2-Image aus.

4. Klicken Sie auf Speichern um mit dem Hochladen des Images zu beginnen.

Der Upload-Fortschritt wird im blauen Banner angezeigt.

Lassen Sie das aktuelle Browserfenster oder den aktuellen Tab geöffnet, damit der Upload abgeschlossen werden kann. Versuchen Sie nicht, in der AHV-Oberfläche zu navigieren, solange der Upload aktiv ist.

Sobald der Upload abgeschlossen ist, wird der Aktualisierungsvorgang des Images ausgeführt. Klicken Sie auf das blinkende Symbol für den Auftragsstatus im Ribbon-Menü, um den Fortschritt zu verfolgen.

Der Importvorgang kann einige Minuten dauern. Sobald er abgeschlossen ist, erscheint das Image in der Liste in einem ACTIVE Status:

Das Zoom Node-Festplattenimage hat nach dem Import eine Größe von etwa 200 GB.

Die Zoom Node-virtuelle Maschine erstellen

Anschließend erstellen Sie die virtuelle Maschine. So erstellen Sie die VM:

1. Klicken Sie auf die Registerkarte Settings Dropdown-Menü und wählen Sie VM.

   
2. Klicken Sie auf dem VM-Bildschirm auf + Create VM auf der rechten Seite des Bildschirms.

   
3. Geben Sie einen Name, Beschreibung (optional), und wählen Sie die passende Timezone.

4. Unter Computerdetails, geben Sie Ihre Rechenwerkspezifikationen ein.\

   

Wie oben gezeigt, benötigt Zoom Node für eine Produktionsbereitstellung 8 vCPU-Kerne. Zoom empfiehlt, beim Festlegen der vCPU-Einstellungen die Socket-Anzahl des physischen Servers zu übernehmen. Die folgenden Einstellungsbeschreibungen erfüllen die Standardbereitstellungsanforderungen:

• Setzen Sie die Einstellung vCPU(s) Feld, um die Anzahl der Sockets auf dem Server, auf dem Nutanix AHV ausgeführt wird, abzugleichen. Bei einem typischen Server mit zwei Sockets würden Sie diesen Wert auf 2.

• Setzen Sie die Einstellung Anzahl der Kerne pro vCPU auf 4 festlegen, was sich auf 8 vCPUs.

• Setzen Sie die Einstellung Speicher (RAM) auf 16 GB.

• Unter Startkonfiguration, wählen Sie UEFI.

Zoom Node wird NICHT starten, sofern UEFI nicht ausgewählt ist.

1. Es erscheint ein Warnhinweis. Klicken Sie auf OK um ihn zu bestätigen.\

   
2. Scrollen Sie nach unten zum Disks Abschnitt.\

   
3. Klicken Sie auf + Neues Laufwerk hinzufügen um ein Laufwerk zu erstellen, auf dem Zoom Node ausgeführt werden kann.\

   
4. Unter der Typ Dropdown-Menü, wählen Sie DISK.

5. Unter der Aktion Dropdown-Menü, wählen Sie Aus Image Service klonen.\

   
6. Unter der Image Dropdown-Menü, wählen Sie den Namen des Images aus, das Sie zuvor beim Importieren des Zoom-Node-Laufwerks erstellt haben.

7. Klicken Sie auf Hinzufügen.

8. Scrollen Sie nach unten zum Netzwerkadapter (NIC) Abschnitt.\

   
9. Klicken Sie auf + Neuen NIC hinzufügen.\

   
10. Unter der Subnetzname Dropdown-Menü, wählen Sie die Option mit direktem IP-Zugriff aus.

Zur Erinnerung: Hypervisor-NAT wird nicht unterstützt.

1. Unter Netzwerkverbindungsstatus, wählen Sie Verbunden.

2. Klicken Sie auf Hinzufügen.\

   
3. Klicken Sie auf Speichern um die VM zu erstellen.

Schalten Sie die neue Zoom-Node-VM ein

Der neue Node wird in der Liste der VMs angezeigt. Sie können die Tabellenansicht wählen, um die Liste der VMs besser sehen zu können.

Klicken Sie mit der rechten Maustaste auf die neu erstellte VM und wählen Sie Einschalten.

Die VM beginnt nach einigen Sekunden zu starten.

Klicken Sie erneut mit der rechten Maustaste auf die VM und wählen Sie Konsole starten um mit der VM zu interagieren.

Es wird ein Pop-up-Fenster geöffnet. Wenn Sie das Fenster nicht sehen, müssen Sie in Ihren Browsereinstellungen Pop-ups für AHV zulassen.

Sobald die Bereitstellung gestartet wurde, ist die Bereitstellung von Zoom Node auf Nutanix AHV abgeschlossen.

Zoom Node verwalten

Weitere Informationen zur Verwaltung Ihrer aktivierten Zoom Nodes finden Sie im Zoom-Support-Artikel Zoom-Node-Server und -Module verwalten.

AWS EC2-Bereitstellungen

Das Zoom Node AMI ist im Zoom App Marketplace noch nicht verfügbar. Derzeit muss ein AMI manuell erstellt werden. Dieser Vorgang muss einmalig für das AWS-Konto durchgeführt werden.

Sie können diesen Abschnitt überspringen, wenn Ihr Konto bereits über das erstellte Zoom Node AMI verfügt und Sie lediglich eine neue Zoom-Node-Instanz bereitstellen möchten.

Voraussetzungen

Die Voraussetzungen für die Zoom-Node-InfrastrukturSeite bietet die für die Bereitstellung erforderlichen Hardware- und Softwarevoraussetzungen.

OVA-Image herunterladen

1. Laden Sie das neueste Zoom Node OVA-Image vom Zoom-Admin-Webportal herunter, indem Sie zu Admin-Portal > Zoom Node > Module > Nodes > Nodes hinzufügen.

1. Navigieren Sie zum Download des VMware OVA-Images und notieren Sie sich den Namen. Die Datei ist etwa 5 GB groß und der Download kann einige Zeit dauern.

2. Entpacken Sie die OVA-Datei in ein Arbeitsverzeichnis. (Unter Windows verwenden Sie PowerShell für den Zugriff auf den tar-Befehl.)

   1. Geben Sie ein: tar xvf <Zoom Node>.ova

   2. Die Ausgabe sieht ähnlich aus wie folgt:\

      
   3. Notieren Sie sich den Namen der .vmdk-Datei. In diesem Beispiel lautet er: ubuntu22-zoomcommon-build-go-20240418014859-disk-0.vmdk.

3. Laden Sie die .vmdk-Datei in einen S3-Bucket hoch. Verwenden Sie die AWS-Weboberfläche oder vorzugsweise die AWS CLI, um die Konsistenz der .vmdk-Benennung sicherzustellen.

   1. Geben Sie den folgenden Befehl ein, um die Datei nach AWS S3 zu kopieren: aws s3 cp ubuntu22-zoomcommon-build-go-20240418014859-disk-0.vmdk s3:///node3.4.vmdk.

   2. Abhängig von der Geschwindigkeit Ihrer Internetverbindung kann der Upload einige Minuten bis mehrere Stunden dauern. Die Dateigröße beträgt ungefähr 5 GB.\

      

Der vorangehende Befehl benennt die Datei in S3 in eine benutzerfreundlichere node3.4.vmdk um, damit sie nach dem Import leichter verwendet werden kann.

Wenn der S3-Bucket beispielsweise heißt vhd-import-bucket wäre der Befehl: aws s3 cp ubuntu22-zoomcommon-build-go-20240418014859-disk-0.vmdk s3://vhd-import-bucket/node3.4.vmdk.

1. Erstellen Sie eine JSON-Datei mit den folgenden Details, die das zu importierende Laufwerksimage beschreiben:

 {
    "Description": "Zoom Node 3.4 VMDK",
    "Format": "vmdk",
    "UserBucket": {
        "S3Bucket": "vhd-import-bucket",
        "S3Key": "node3.4.vmdk"
    }
  }

Dieser Code kennzeichnet Ihren Import des node3.4.vmdk Images, das derzeit in einem S3-Bucket gespeichert ist, als Zoom Node Version 3.4.

1. Importieren Sie das Zoom Node .vmdk-Image als Snapshot.

Sie müssen das Laufwerk als Snapshot importieren und nicht ein Image.

1. Geben Sie den folgenden Befehl ein: aws ec2 import-snapshot --disk-container file://.json.

2. (Optional) Wenn die JSON-Datei heißt node.json, geben Sie den folgenden Befehl ein: aws ec2 import-snapshot --disk-container file://node.json.

3. Überprüfen Sie die StatusMessage: Feld für den Status „pending“, wenn der Import beginnt.\

   

Der Import kann 20 Minuten oder länger dauern.

1. Prüfen Sie die CLI-Ausgabe auf den ImportTaskId Wert.

   1. Im obigen Beispiel lautet die ImportTaskId ist import-snap-f8d845596565b0c3t. Dieser Wert prüft regelmäßig den Status des Auftrags.

   2. Geben Sie den folgenden Befehl ein: aws ec2 describe-import-snapshot-tasks --import-task-ids <ImportTaskId> wobei ImportTaskId der im obigen Schritt ermittelte eindeutige Wert ist.

   3. Die folgende Ausgabe sollte erscheinen, wobei Ihr ImportTaskId Wert eingetragen ist:\

      
   4. Beachten Sie, dass der aktuelle Status des Auftrags „downloading/converting“ ist, was bedeutet, dass der Auftrag die Datei noch verarbeitet. Das Feld Fortschritt: <##>, zeigt den Prozentsatz des Fortschritts an. Das obige Beispiel zeigt den Wert 19 für 19 % abgeschlossen.

   5. Überprüfen Sie die Status: Feld zur Überprüfung des Abschlusses des Auftrags:\

      

Snapshot in ein Amazon Machine Image (AMI) konvertieren

1. Melden Sie sich beim AWS-Console-EC2-Dashboard an.\

   
2. Auf der linken Seite des Bildschirms unter dem Elastic Block Store Dropdown-Menü klicken Sie auf Snapshots.\

   
3. Klicken Sie auf die Registerkarte Snapshot-ID-Link um die Details anzuzeigen.\

   
4. Klicken Sie auf die Registerkarte Actions Drop-down-Schaltfläche in der oberen rechten Ecke des Bildschirms und wählen Sie Image aus Snapshot erstellen.

5. Die Imageeinstellungen Fenster wird angezeigt.

6. Geben Sie einen Image-Namen für das AMI ein.

   1. Beispiel: Zoom Node 3.4 AMI.

7. (Optional) Geben Sie eine Beschreibung ein.\

   
8. Scrollen Sie im Fenster nach unten, um zusätzliche Einstellungen zu sehen.

9. Bestätigen Sie, dass Sie das zugewiesene 189-GB-Festplattenvolumen unter Größe (GiB).\

   
10. Unter der Startmodus Dropdown-Menü, wählen Sie UEFI.

Zoom Node-Instanzen auf AWS EC2 bereitstellen

1. Melden Sie sich beim AWS-Console-EC2-Dashboard an.\

   
2. Auf der linken Seite des Bildschirms unter Instanzen Dropdown-Menü klicken Sie auf Instanzen.

3. Erstellen Sie eine neue Instanz mit dem Zoom Node AMI.

4. Geben Sie einen Namen für die Instanz ein.

1. Unter der Anwendungs- und Betriebssystem-Images (Amazon Machine Image) Abschnitt klicken Sie auf Meine AMIs aus.

2. Suchen Sie nach dem Zoom Node AMI, das Sie gerade erstellt und benannt haben.\

   
3. Klicken Sie auf das von Ihnen erstellte AMI, um verschiedene Parameter festzulegen.

4. Unter der Instanztyp Abschnitt klicken Sie auf Instanztyp Dropdown-Liste und wählen Sie t3.medium.

Für Produktionsbereitstellungen benötigt Zoom Node 8 vCPU und 16 GB RAM. Im Gegensatz dazu können Laborumgebungen mit 2 vCPU und 4 GB RAM betrieben werden, wobei eine t3.medium-Instanz empfohlen wird. Wenn Zoom Meetings Hybrid auf dem System ausgeführt wird, ist wahrscheinlich eine t3.large-Instanz erforderlich, um mehr als nur wenige Benutzer in einem Meeting zu unterstützen.

1. Unter der Schlüsselpaar (Anmeldung) Abschnitt klicken Sie auf Name des Schlüsselpaares Dropdown-Liste und wählen Sie Ohne Schlüsselpaar fortfahren (nicht empfohlen).

   1. Das Weglassen eines Schlüsselpaares ist erforderlich, da SSH auf Zoom Node für den Konsolenzugriff nicht aktiviert ist.

   
2. Konfigurieren Sie unter Netzwerkeinstellungen die folgenden Optionen:

   1. Unter VPC - erforderlich, wählen Sie eine VPC, die Ihren Zoom Workplace-Apps direkten gerouteten L3-Zugriff ermöglicht.

   2. Unter Subnetz, wählen Sie das Subnetz, in dem diese VM betrieben werden soll.\

      
   3. Zoom Node benötigt ausgehende Verbindungen zur Zoom-Cloud. Sie müssen eine öffentliche IP-Adresse bereitstellen.

   4. Wählen Sie Aktivieren Sie aus dem Öffentliche IP automatisch zuweisen Feld.

   5. Erstellen Sie eine Sicherheitsgruppe die eingehenden Zugriff von der Zoom Workplace-App auf dem erforderlichen Port zulässt.

   6. Verwenden Sie die dokumentierten Firewall-Regeln im Zoom-Supportartikel Firewall-Regeln für Zoom Node Management-Server.\

      

Eingehender Internetzugang ist für Zoom Node nicht erforderlich, außer wenn direkter Medienzugriff von externen Quellen aktiviert ist (eine optionale Bereitstellung für Meeting Connector oder zur Bereitstellung externer Benutzerzugriffe für Zoom Meetings Hybrid - Private Meetings).

1. Klicken Sie auf Erweiterte Details.

2. Klicken Sie auf die Registerkarte Metadatenversion Dropdown-Liste und wählen Sie Nur V2 (Token erforderlich).\

   

Sie müssen die Metadatenversion auf V2 setzen, andernfalls schlägt die Bereitstellung fehl.

(Optional) Zoom Node vorkonfigurieren

Zoom Node-Betriebssystemeinstellungen wie Netzwerkeinstellungen, der Hostname, lokale Passwörter und 16-stellige Registrierungscodes können automatisch mit dem Benutzerdaten - optional Abschnitt innerhalb von AWS EC2 konfiguriert werden.

Wenn Zoom Node startet, ruft es diese vorkonfigurierten Informationen von AWS EC2 (IDMSv2-Server) ab und konfiguriert den Node automatisch wie im folgenden Bild gezeigt:

Verwenden Sie den folgenden Code, um eine neue Benutzerdatendatei zu erstellen:

#custom-config
hostname: zn-ec2
password: ZoomNodepassword1234
registration_code: ABCD1234DEFG5678
network:
  ethernets:
    ens:
      addresses:
        - 10.15.1.150/24
        - 10.15.1.151/24
        - 10.15.1.152/24
      gateway: 10.15.1.1
      nameservers:
        addresses:
          - 1.1.1.1

Sobald Sie die Benutzerdatendatei in AWS EC2 hochgeladen haben, stellen Sie die Instanz bereit, indem Sie auf Instanz starten.

Bereitgestellte Instanz überprüfen

Klicken Sie auf die Registerkarte Instanz-ID-Link (i-06e4592fd2d91ef3f wie im obigen Bild gezeigt), um die interne IP-Adresse zu finden, die dem Node zugewiesen wurde.

Es dauert einige Minuten, bis der Node startet und eine lokale Web-GUI öffnet.

Öffnen Sie innerhalb der ersten 10 Minuten nach dem Start der Instanz einen Webbrowser und geben Sie die Private IPv4-Adressen aufgelistet (10.10.130.223 im obigen Bild).

Zum Beispiel: https://<10.10.130.223>:8443.

Akzeptieren Sie die angezeigte Warnung bezüglich des ungültigen Zertifikats. Das Zoom Node Local Admin Portal erscheint und fordert Sie zur Eingabe eines Passworts auf.

Klicken Sie auf die Registerkarte Passwort festlegen Link, um ein Administratorkennwort zu konfigurieren.

Der Benutzername lautet immer zoom-setup.

Der Link „Passwort festlegen“ ist nur in den ersten 10 Minuten nach dem Start der VM sichtbar. Wenn er nicht sichtbar ist, starten Sie die VM neu, damit die Option wieder verfügbar wird.

Nun, da die Bereitstellung abgeschlossen ist, können Sie mit der Konfiguration fortfahren, indem Sie den Anweisungen folgen, die in den Konfiguration und Verwaltung von Zoom Node nach der BereitstellungSchritten von Konfiguration und Verwaltung von Zoom Node nach der Bereitstellung Seite.