> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/it/servizi-enterprise-avanzati/zoom-node/zoom-node-deployment-field-guide/zoom-node-hypervisor-specific-deployments.md).

# Distribuzioni specifiche per hypervisor di Zoom Node

Distribuisci Zoom Node su varie piattaforme hypervisor utilizzando questa sezione

Quando si distribuisce Zoom Node in ambienti virtualizzati, è necessario adattare le procedure di installazione e configurazione alla specifica piattaforma hypervisor in uso. Ogni hypervisor, come VMware vSphere, Microsoft Hyper-V o altri, può comportare requisiti specifici relativi all'allocazione delle risorse, all'accesso allo storage e alla configurazione delle interfacce di rete.

Questa sezione fornisce indicazioni dettagliate per gli hypervisor supportati, per garantire che Zoom Node funzioni in modo affidabile ed efficiente nell'infrastruttura virtuale.

### <mark style="color:blu;">Distribuzioni su VMware vSphere</mark>

La sezione seguente descrive il metodo di installazione su VMware vSphere, che richiede il download e la distribuzione di una versione di Zoom Node in formato OVA (Open Virtual Appliance).

#### Scaricare l'immagine OVA

Per scaricare il file immagine:

1. Accedi al portale amministratori Web di Zoom.
2. Scarica il file immagine OVA di Zoom Node accedendo a **Gestione nodi > Moduli > Nodo > Aggiungi nodo**.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-904a6441a8b23f2c4870f0730dbd8068abed1636%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
3. Fai clic sul pulsante **Scarica** .

#### Distribuire l'immagine OVA

Per distribuire il file immagine:

1. Accedi all'interfaccia web di VMware.
2. Fai clic su **Crea/Registra VM**.
3. Nel menu Seleziona il tipo di creazione, fai clic su **Distribuisci una macchina virtuale da un file OVF o OVA**.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-f950f3774cdb44e52af8e6ea1a9192d0b36ed439%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
4. Fare clic su **Avanti**.
5. Inserisci un nome per la VM Zoom Node.
6. Fai clic sul riquadro blu per aprire un browser di file e seleziona il file immagine OVA di Zoom Node scaricato.
   1. (Facoltativo) Trascina il file immagine nel riquadro.

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-8c01dba69c53e657d909fa87ba2733a6d4c11e75%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

7. Fare clic su **Avanti**.
8. Scegli il volume di storage in cui archiviare Zoom Node e fai clic su **Avanti**.
9. Scegli la rete su cui risiederà il server.
   1. (Facoltativo) Se lo desideri, puoi utilizzare il thin provisioning per la VM.

{% hint style="info" %}
Il «thin provisioning» consente al disco di una macchina virtuale di utilizzare lo storage fisico solo quando vengono scritti i dati, anziché riservare in anticipo l'intera dimensione del disco. Questo metodo consente di risparmiare spazio, ma comporta il rischio di esaurire lo storage se l'utilizzo complessivo cresce più rapidamente della capacità disponibile.
{% endhint %}

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-290f8dc92612b93d0b03cee035ef6567c27f45f3%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

10. Fare clic su **Avanti**.
11. Verifica le selezioni e fai clic su **Fine** per distribuire la VM.

Il completamento della distribuzione della VM potrebbe richiedere alcuni minuti.

Una volta avviata, la VM avrà Impostazioni e dettagli simili a quelli mostrati nell'immagine seguente:

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-5323e44d982cdf4a86d20cfc4200cbbbd54c5a31%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

La distribuzione della VM è completata.

### <mark style="color:blu;">Distribuzione su Microsoft Hyper-V</mark>

La sezione seguente descrive il metodo di installazione su Microsoft Hyper-V, che richiede il download e la distribuzione di una versione di Zoom Node in formato VHDX.

#### Scaricare l'archivio VHDX di Zoom Node

L'archivio Zoom include sia l'immagine disco VHDX di Zoom Node sia i metadati di configurazione della VM.

Per scaricare l'archivio:

1. Accedi al portale amministratori Web di Zoom.
2. Scarica l'immagine **VHDX di Zoom Node** dal portale amministratori Zoom accedendo a **Gestione nodi > Moduli > Nodo > Aggiungi nodo**.\\
3. Scarica il file VHDX di Zoom Node.
4. Estrai il file in una cartella locale per un uso temporaneo.

### <mark style="color:blu;">(Facoltativo) Creazione di un'immagine VHDX da un'immagine disco QCOW2 (KVM) utilizzando</mark> <mark style="color:blu;">`qemu-img`</mark> <mark style="color:blu;">su Windows</mark>

Per utilizzare un'immagine disco QCOW2 (KVM) in un ambiente Hyper-V, puoi convertirla nel formato VHDX utilizzando `qemu-img` in PowerShell.

**Passaggio 1: download e installazione `qemu-img` per Windows**

1. Visita il repository ufficiale di Cloudbase:\
   <https://cloudbase.it/qemu-img-windows/>
2. Scarica la versione per Windows di `qemu-img`.
3. Estrai i contenuti in una directory nota, ad esempio: `C:\Users\amministratore\Downloads\qemu-img`.

**Passaggio 2: convertire QCOW2 in formato VHDX usando PowerShell**

Apri PowerShell ed esegui il seguente comando per convertire l'immagine:

{% code overflow="wrap" %}

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

{% endcode %}

Dovresti vedere un'indicazione di avanzamento simile alla seguente:

```
(100.00/100%)
```

{% hint style="info" %}

* `-f qcow2` specifica il formato di input
* `-O vhdx` specifica il formato di output compatibile con Hyper-V
* `-p` mostra una barra di avanzamento durante la conversione
* Adatta i percorsi dei file in base al tuo ambiente
  {% endhint %}

**Contesto di implementazione e risultato pratico**

La conversione in VHDX consente di importare immagini Linux personalizzate (ad esempio Ubuntu con agenti o servizi Zoom preinstallati) in una macchina virtuale Hyper-V. Questo è utile per ambienti di laboratorio personalizzati, test CI/CD o sviluppo localizzato con configurazioni di sistema coerenti.

#### Distribuzione di una macchina virtuale Zoom Node su Hyper-V

Hyper-V supporta la distribuzione di VM con due metodi principali: il primo tramite l’interfaccia grafica di Hyper-V Manager e il secondo tramite script PowerShell. PowerShell è il metodo più semplice per automatizzare la distribuzione di più nodi.

Esistono due metodi per distribuire la macchina virtuale. Il metodo semplice, Opzione 1, usa comandi PowerShell per creare una nuova VM Zoom Node utilizzando il VMDK con gli attributi corretti. L’Opzione 2 usa l’interfaccia grafica di Hyper-V Manager per distribuire la VM.

Consulta la [Prerequisiti dell'infrastruttura di Zoom Node](https://library.zoom.com/technical-library/it/servizi-enterprise-avanzati/zoom-node/zoom-node-deployment-field-guide/zoom-node-infrastructure-prerequisites.md#supported-hypervisors) pagina dei prerequisiti per ulteriori informazioni.

{% hint style="info" %}
Per alcune famiglie di moduli (ZPLS, ZRH, CRC Hybrid), potrebbe essere necessario modificare il dimensionamento della VM Zoom Node. Consulta la documentazione specifica del modulo per conoscere gli attributi corretti.
{% endhint %}

#### Opzione 1 (consigliata): distribuisci la VM Zoom Node tramite PowerShell

{% hint style="info" %}
A partire dal 2025, Microsoft PowerShell v5.1 è la versione supportata per il Plugin di gestione di Hyper-V. PowerShell 7 potrebbe funzionare, ma alcuni comandi specifici di Hyper-V non funzionano correttamente.
{% endhint %}

Individua la Posizione di archiviazione delle macchine virtuali Hyper-V. In questo esempio, il server Hyper-V archivia le VM in `D:\!-HyperVMs`.

I seguenti comandi PowerShell vengono usati per creare la VM, collegare l’immagine VHDX e personalizzare la VM con gli attributi corretti.

{% code overflow="wrap" %}

```powershell
# ===========================
# Configurazione di Zoom Node VM: Hyper-V
# ===========================

# Modifica questi quattro valori
$VMName      = "ZN-PROD-01"
$RootPath    = "D:\!-HyperVMs"  # cartella che conterrà la cartella della VM
$SourceVhdx  = "D:\Downloads\ubuntu22-zoomcommon-build-20250502110711.vhdx"
$SwitchName  = "vSwitch-Production"

# Percorsi derivati
$VMFolder    = Join-Path $RootPath $VMName
$TargetVhdx  = Join-Path $VMFolder "$VMName.vhdx"

# --- Crea una cartella per la VM e copia il VHDX (clone completo e indipendente) ---
New-Item -ItemType Directory -Path $VMFolder -Force | Out-Null

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

# --- Crea una VM di generazione 2 (senza disco) ---
New-VM `
  -Name $VMName `
  -Generation 2 `
  -MemoryStartupBytes 16GB `
  -Path $VMFolder `
  -NoVHD | Out-Null

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

# --- Memoria: 16 GB statici (Disabilita la memoria dinamica) ---
Set-VMMemory -VMName $VMName -DynamicMemoryEnabled:$false -StartupBytes 16GB

# --- Collega il disco clonato ---
Add-VMHardDiskDrive -VMName $VMName -Path $TargetVhdx

# --- Avvio protetto + Microsoft UEFI CA + avvio dal disco ---
# Abilita Secure Boot per Linux (Ubuntu) con Microsoft UEFI CA
Set-VMFirmware -VMName $VMName -EnableSecureBoot On -SecureBootTemplate "MicrosoftUEFICertificateAuthority"

# Ottieni l’oggetto del disco di sistema e impostalo come primo dispositivo di avvio
$sysDisk = Get-VMHardDiskDrive -VMName $VMName | Where-Object { $_.Path -eq $TargetVhdx }
Set-VMFirmware -VMName $VMName -BootOrder $sysDisk

# --- Rete: connessione al vSwitch (riga VLAN facoltativa commentata) ---
Connect-VMNetworkAdapter -VMName $VMName -SwitchName $SwitchName
# Set-VMNetworkAdapterVlan -VMName $VMName -Access -VlanId 123

# --- Comportamento di gestione e checkpoint ---
Set-VM -Name $VMName -AutomaticStartAction StartIfRunning -AutomaticStopAction ShutDown
Set-VM -Name $VMName -CheckpointType Production -AutomaticCheckpointsEnabled:$false

# --- Servizi di Integrazioni: Abilita l'interfaccia del servizio Ospite ---
$gsi = Get-VMIntegrationService -VMName $VMName -Name 'Ospite Service Interface' -ErrorAction SilentlyContinue
if ($gsi -and -not $gsi.Enabled) {
  Abilita-VMIntegrationService -VMName $VMName -Name 'Ospite Service Interface'
}

# --- Avvia la VM (Facoltativo) ---
Start-VM -Name $VMName

```

{% endcode %}

#### Opzione 2: distribuire il VHDX e creare manualmente la macchina virtuale

L'opzione 2 prevede la creazione manuale della macchina virtuale distribuendo il file VHDX. Questo metodo richiede di trasferire l'immagine del disco dall'archivio Zoom Node estratto nella posizione di archiviazione designata per le macchine virtuali Hyper-V e di configurare manualmente le impostazioni della VM.

**Copia il VMDK nell'archivio delle macchine virtuali Hyper-V**

1. Individua la posizione di archiviazione delle macchine virtuali Hyper-V. (In questo esempio, il server Hyper-V archivia le VM in `D:\HyperVMs`.)

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-f985a064f1e189b6ee41ff68a908fab368d1e018%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>
2. Crea una cartella univoca per lo Zoom Node che stai distribuendo e, in quella directory, crea una nuova sottodirectory chiamata **Dischi rigidi virtuali**.

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-c7ba7bbd77bb5fd0f6c36b88514178dd2a11d3d8%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>
3. Copia il file immagine VHDX scaricato da Zoom nella directory dei dischi rigidi virtuali.
4. Accedi alla console di Microsoft Hyper-V Manager per gestire le VM.

**Definire la VM**

In Hyper-V Manager, fai clic su **Nuovo** e seleziona **Macchina virtuale** nel riquadro a destra. Verrà avviata la **Procedura guidata per la creazione di una nuova macchina virtuale**.

1. Completa la **Specifica un nome e una Posizione** :
   1. inserire un nome per la macchina virtuale.
   2. (Facoltativo) Scegli una Posizione di archiviazione. È comune archiviare i file di configurazione della VM nella stessa cartella del disco virtuale della VM.
   3. Seleziona la casella «Archivia il computer virtuale in una posizione diversa» e fai clic su **Sfoglia**.

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-e2da648950db55e12e7652da1b8fcf208d0aa68c%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>

2. Individua la cartella di archiviazione della VM creata in precedenza.

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-2f33b703f1adf5b4cd3e50927dbfdced04cb30cf%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>

3. Seleziona la cartella.
4. Fare clic su **Avanti**.
5. Completa il passaggio **Specifica generazione** :
   1. Seleziona **Generazione 2** come pulsante di opzione
   2. Fai clic su **Avanti**

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-0e8f445aa803cfaaa8ee2760304d646868ab8a65%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>

7. Completa il passaggio **Assegna memoria** :
   1. Nella casella di testo **Memoria di avvio:** inserire `16384` (MB)
   2. (Facoltativo) Seleziona «Usa memoria dinamica per il computer virtuale» per ridurre la RAM allocata
   3. Fai clic su **Avanti**

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-a9b854dfdd94190288130e4c7bfe182bf6787b7b%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>

8. Completa il passaggio **Configura rete** :
   1. Fai clic sul menu a discesa **Connessione:** e Seleziona un commutatore virtuale per connettere la VM alla rete. La scelta dipenderà dall'ambiente di rete Hyper-V.

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-8a82acfa91de1ef007f2091507a99da7ba85372f%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>

9. Fare clic su **Avanti**.

**Collega l'immagine disco VHDX**

Nella Creazione guidata nuovo computer virtuale, completa quindi il passaggio **Connetti disco rigido virtuale** . Per collegare l'immagine:

1. Seleziona **Usa un disco rigido virtuale esistente** come pulsante di opzione.

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-2710d15507ef48173d8e02255f31d1eceab0eefc%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>

2. Fai clic su **Sfoglia** e individua la cartella della VM creata in precedenza.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-925dffe7be359c06c2b1318af88152d4b3f5a30e%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>
3. Nella finestra di selezione dei file, fai clic su **Apri**.
4. Fare clic su **Avanti**.
5. Verifica le Impostazioni e fai clic su **Fine** per creare la VM con il disco VHDX collegato.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-39754679d1152d8c66f2c20b82399d30837c7d08%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Non avviare ancora la VM.
{% endhint %}

**Configura ulteriori Impostazioni della VM**

Configura ulteriori Impostazioni come segue:

1. Fai clic con il pulsante destro del mouse sulla VM distribuita e Seleziona **Impostazioni...**.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-4327767f591fcbc02ab6f4ee599112ce96f7ed85%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>
2. Nella categoria **hardware** sul lato sinistro dello schermo, fai clic su **Sicurezza**.
3. Sul lato destro dello schermo, sotto l'intestazione **Sicurezza** , fai clic sull'elenco a discesa **Modello:** .
4. Seleziona l'opzione **Autorità di certificazione UEFI Microsoft** .\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-24bac2604171e6578a11403dcf9bfa7a86f802ab%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>
5. Fai clic su **Applica**.
6. Nella categoria **hardware** sul lato sinistro dello schermo, fai clic su **Processore**.
7. Sul lato destro dello schermo, sotto l'intestazione **Processore** , imposta il valore della casella **Numero di processori virtuali:** su `8` (processori virtuali).\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-1364c2938421760484435e0e17a1813800d25c71%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Questo è il valore predefinito richiesto da Zoom Node per eseguire quattro (4) moduli. Consulta la [Prerequisiti dell'infrastruttura di Zoom Node](https://library.zoom.com/technical-library/it/servizi-enterprise-avanzati/zoom-node/zoom-node-deployment-field-guide/zoom-node-infrastructure-prerequisites.md#deployment-sizing-and-capacity-planning-matrix) per ulteriori informazioni sul ridimensionamento della VM quando si esegue un numero inferiore di moduli.
{% endhint %}

8. Fai clic su **OK** per accettare le modifiche.

**Avviare la macchina virtuale**

Per avviare la VM:

1. Seleziona la VM appena creata in Gestione Hyper-V.
2. Nel riquadro **Azioni** sul lato destro dello schermo, fai clic su **Avvia**.
3. Fai clic su **Connetti** per aprire la finestra della console della VM.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-2cf51b9a938b92f92ca3983741ee5e45bfbe8387%2Funknown?alt=media" alt=""><figcaption></figcaption></figure>

Se la sequenza di avvio della VM funziona correttamente, verrà visualizzata la schermata di avvio di Linux. In seguito verrà caricata l'interfaccia testuale di Zoom Node.

{% hint style="info" %}
Se durante l'avvio viene visualizzato un messaggio di errore UEFI, è possibile che il metodo di avvio protetto non sia stato impostato su "Autorità di certificazione UEFI".

<img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-0b290fa647f6639fedd39a37d3f2fe277ce9a13b%2Funknown?alt=media" alt="unknown" data-size="original">
{% endhint %}

### <mark style="color:blu;">Distribuzioni KVM</mark>

La sezione seguente descrive il metodo di installazione Kernel-based Virtual Machine (KVM), che consente di installare Zoom Node tramite Proxmox VE o KVM Virtual Machine Manager (Virt-manager).

#### KVM Proxmox Virtual Environment (VE)

La distribuzione di Zoom Node su Proxmox VE tramite l'immagine qcow2 richiede passaggi aggiuntivi rispetto alla distribuzione di un'immagine ISO. I passaggi seguenti consentono di creare una nuova VM configurata a cui collegare l'immagine qcow2 di Zoom Node.

{% hint style="info" %}
Una distribuzione predefinita di QEMU/KVM usa il NAT dell'hypervisor e un pool privato di Indirizzo IP per distribuire VM gestite da KVM. Questa architettura non è supportata da Zoom Node. Sebbene sia possibile distribuire ed eseguire Zoom Node dietro il NAT dell'hypervisor, i client sulla rete non saranno in grado di comunicare correttamente con esso. Zoom Node deve essere distribuito su un'interfaccia con bridge, in modo che il suo Indirizzo IP rientri nell'intervallo IP con cui i client possono comunicare.
{% endhint %}

**Definire la macchina virtuale Zoom Node**

Per definire la VM:

1. Accedi all'interfaccia dell'applicazione di gestione Proxmox.
2. Fai clic sul **Crea VM** pulsante. Questa diventerà la VM modello di Zoom Node.
3. Assegna un nome alla VM e **salva l'ID della VM**.
   1. Queste informazioni verranno utilizzate in un passaggio successivo.
4. Fai clic su **Avanti** per continuare.
5. Seleziona **Non utilizzare alcun supporto** nella pagina delle impostazioni del sistema operativo.
6. Fare clic su **Avanti**.
7. Scegli l'opzione `q35` in **Impostazioni** della macchina.
   1. Per il **BIOS** seleziona il tipo **OVMF (UEFI)** e scegli il volume in cui archiviare le impostazioni EFI. In genere, si tratta dello stesso volume della VM utilizzato per archiviare la VM.

{% hint style="info" %}
È fondamentale impostare le impostazioni di macchina e BIOS come descritto. In caso contrario, la VM non si avvierà correttamente.
{% endhint %}

8. Fare clic su **Avanti**.
9. Nella pagina **Dischi** seleziona il volume di archiviazione da cui verrà eseguita la VM.
10. Imposta **Dimensione del disco (GiB)** su `200`.
11. Scegli **Write-Through** per la cache.
12. Fare clic su **Avanti**.
13. Modifica l'impostazione **Core** su `8`.
14. Fare clic su **Avanti**.
15. Imposta **Memoria (GiB)** su `16384`.
16. Fare clic su **Avanti**.
17. Scegli le impostazioni di rete appropriate per la tua distribuzione, in genere un'interfaccia bridge con un tag VLAN.
18. Fare clic su **Avanti**.
19. Nella pagina **Conferma** assicurati che la casella di controllo **Avvia dopo la creazione** non sia selezionata.
20. Ricontrolla le impostazioni, prestando particolare attenzione a `q35` come tipo di macchina e a `omvf` come tipo di BIOS.
21. Fai clic su **Completa** dopo aver verificato che le impostazioni siano corrette.
22. Accedi al [portale web amministratori Zoom](https://zoom.us/) come amministratore all'indirizzo <https://zoom.us>.

**Preparare l'immagine QCOW2 di Zoom Node**

Per preparare l'immagine:

1. Nel portale amministratori Zoom, vai a **Zoom Node > Moduli > Nodi > Aggiungi nodo**.
2. Scarica la versione corrente del **file immagine qcow2 di Zoom Node**.
3. Copia il file in una directory accessibile da Proxmox (ad esempio, un volume NFS).
   1. (Facoltativo) Copialo nel volume del server Proxmox in cui sono archiviate le VM.
4. Prendi nota della creazione della `111` directory e dell'immagine disco vuota.
5. Annota il nome dell'immagine disco in questa cartella
   1. Esempio: `vm-111-disk-0.qcow2`.
6. Elimina il file dell'immagine disco.
7. Copia il file **Zoom Node qcow2** in questa directory.
8. Rinomina questo file con il nome originale dell'immagine disco annotato in precedenza (ovvero `vm-111-disk-0.qcow2`).
9. Torna all'interfaccia web principale di Proxmox e seleziona la VM appena distribuita.
10. Clicca con il tasto destro sulla VM selezionata e scegli di **clonarla** .
11. Trasforma il clone in un modello assegnandogli un nome e facendo clic su **Clona**.
12. Al termine della clonazione, clicca con il tasto destro sul clone e seleziona **Converti in modello**.
    1. Ora hai un modello pronto per la distribuzione.
13. Seleziona la VM originale e fai clic per aprire la **Console**.
14. Avvia la VM facendo clic sul pulsante **Avvia ora** .

Verifica che la VM si avvii e mostri l'interfaccia testuale locale di Zoom Node, che conferma l'idoneità del modello per le future distribuzioni.

#### KVM Virtual Machine Manager (Virt-manager)

Virtual Machine Manager (noto anche come virt-manager) è un popolare gestore basato su applicazione per le macchine virtuali QEMU/KVM.

Questo esempio di distribuzione utilizza Virtual Machine Manager su Ubuntu 22.04 LTS. Tuttavia, può essere eseguito su molte distribuzioni Linux.

Una distribuzione predefinita di QEMU/KVM utilizza la NAT dell'hypervisor e un pool di Indirizzi IP privati per distribuire le VM, gestito da KVM. Questa è un'architettura **non** supportata per Zoom Node.

{% hint style="info" %}
Sebbene sia possibile distribuire ed eseguire Zoom Node dietro la NAT dell'hypervisor, i client della rete non saranno in grado di comunicare correttamente. Per garantire una comunicazione corretta con i client, distribuisci Zoom Node su un'interfaccia bridge che corrisponda all'intervallo di Indirizzi IP dei client.
{% endhint %}

Per installare usando il metodo virt-manager:

1. Accedi al [portale web amministratori Zoom](https://zoom.us/) come amministratore.
2. Scarica la versione corrente del **file immagine qcow2 di Zoom Node** dal portale amministratori di Zoom Node, selezionando **Zoom Node > Moduli > Nodi > Aggiungi nodo**.
3. Rinomina il file con il nome desiderato per la VM o il disco.
   1. Esempio: `ZN-SJC01-NODE01.qcow2`.
4. Sposta il file in un volume accessibile a Virtual Manager.
5. Crea una nuova VM in Virtual Manager.
6. Fai clic su **Importa immagine disco esistente**.
7. Seleziona il volume in cui hai salvato l'immagine qcow2 rinominata.
8. Fai clic sul pulsante **Scegli volume** .
   1. (Facoltativo) Se non hai ancora aggiunto la directory corretta a virt-manager, puoi fare clic su **Sfoglia in locale** per aggiungerla.
9. (Facoltativo) Se il sistema operativo non viene rilevato automaticamente, impostalo su **Ubuntu 22.04 LTS**.
10. Modifica la configurazione della RAM impostandola su `16384 MB` (16 GB) e la configurazione della CPU su `8 CPUs`.
    1. Queste Impostazioni servono a consentire a Zoom Node di eseguire quattro (4) moduli.

{% hint style="info" %}
Puoi modificare questi valori, ma le modifiche potrebbero influire sulla capacità e sulle prestazioni di Zoom Node. Se esegui un solo modulo su Zoom Node, puoi impostare la RAM su 6 GB e le CPU su 3 come valori minimi assoluti.
{% endhint %}

11. Per il nodo, inserire un nome.
12. **Fai clic su Personalizza configurazione prima dell'installazione**.

{% hint style="danger" %}
Se non esegui questa configurazione, il nodo non si avvierà. È necessario modificare altre Impostazioni.
{% endhint %}

13. Assicurati che il Dispositivo di rete sia impostato su **Ethernet con bridge** e non su NAT.

{% hint style="info" %}
La distribuzione di Zoom Node dietro un NAT su KVM può bloccare la comunicazione dei client con il nodo.
{% endhint %}

14. Quando il pannello **Dettagli VM** si apre, Modifica il **Chipset** impostandolo su **Q35**.
15. Modifica il **Firmware** impostandolo su **UEFI**.

{% hint style="warning" %}
Zoom Node non si avvia senza l'impostazione UEFI.
{% endhint %}

16. Fai clic su **Applica**.
17. Fai clic su **Avvia installazione** nella parte superiore della barra multifunzione per distribuire la VM.

La VM si accenderà e inizierà la procedura di avvio. Una volta avviata la VM originale, sapremo che il modello creato è utilizzabile.

### <mark style="color:blu;">Distribuzioni Nutanix AHV</mark>

Zoom Node può essere eseguito come macchina virtuale (VM) su Nutanix AHV. Zoom Node viene distribuito in un data center per eseguire i servizi ibridi Zoom, chiamati anche moduli di servizio, come Meetings Hybrid, Recording Hybrid, Chat Hybrid e Phone Local Survivability.

Questa sezione descrive l'installazione della VM del sistema operativo Zoom Node sulle versioni di Nutanix AHV dalla 6.8.1 alla 7.0.1.

#### Requisiti generali per hypervisor e macchine virtuali

La pagina [Prerequisiti dell'infrastruttura di Zoom Node](https://library.zoom.com/technical-library/it/servizi-enterprise-avanzati/zoom-node/zoom-node-deployment-field-guide/zoom-node-infrastructure-prerequisites.md)indica i prerequisiti hardware e software necessari per la distribuzione.

#### Distribuzione di Zoom Node

Per distribuire Zoom Node è necessario scaricare un'immagine, importarla in AHV e creare una VM.

**Scaricare il file immagine di Zoom Node**

Per scaricare il file immagine:

1. Accedi al [portale amministratori Zoom](https://zoom.us/).
2. Scarica l'immagine **QCOW2 di Zoom Node** dal portale amministratori Zoom selezionando **Gestione nodi > Moduli > Nodo > Aggiungi nodo**.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-b16ce1aa1e16b7838854e789a00d1331169b99c0%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
3. Scarica l' **immagine QCOW2** facendo clic sul pulsante **Scarica** .

{% hint style="info" %}
AHV può importare sia l'immagine QCOW2 sia l'immagine .ova/VMDK. Puoi utilizzare entrambe, ma Zoom consiglia di usare l'immagine QCOW2. Questo formato può essere caricato in modo nativo senza dover decomprimere un file .ova per estrarre il VMDK.
{% endhint %}

**Importare l'immagine di Zoom Node in AHV**

1. Accedi alla console Nutanix AHV visitando `https://<cluster hostname>:9440`.
2. Fai clic sul **menu a tendina Home** e Seleziona **Impostazioni** dall'elenco.

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-60d20e5cc62dcec3c6cf90c3fc0fe4b69182ed2d%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

3. Esamina la pagina **Impostazioni** .

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-6519b8ce1e2870b301d70f461943558f97954a56%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

4. Sul lato sinistro dello schermo, fai clic su **Configurazione immagine**. Viene visualizzata la finestra di dialogo per il caricamento dell'immagine disco.

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-ded1a16c1aadc4864393e52b269df8463eea03d0%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

5. Fai clic sul pulsante + Carica immagine.

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-af1444caa47a2318eb5d1a7a2cba9d001b0c3703%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

6. Inserisci le informazioni desiderate nei campi di testo della finestra di dialogo Crea immagine.
   1. Il campo Annotazione è Facoltativo.
   2. Fai clic sul menu a tendina **Tipo di immagine** e Seleziona **DISCO**.
   3. Fai clic sul menu a tendina **Contenitore di archiviazione** e Seleziona l'opzione appropriata per il tuo ambiente.
7. Fai clic sul pulsante di opzione **Carica un file** e poi su **Sfoglia...**.
8. Seleziona l'immagine QCOW2 scaricata in precedenza.
9. Fai clic su **Salva** per iniziare a caricare l'immagine.

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-53b770f1c8aacc343ed894a9b41408085b45ca2a%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

L'avanzamento del caricamento viene visualizzato nella barra blu.

{% hint style="danger" %}
Tieni aperta la finestra o la scheda corrente del browser per assicurarti che il caricamento venga completato. Non provare a navigare altrove nell'interfaccia AHV mentre il caricamento è in corso.
{% endhint %}

Al termine del caricamento, verrà eseguito il processo di aggiornamento dell'immagine. Fai clic sull'icona lampeggiante dello stato del processo nel menu della barra per seguirne l'avanzamento.

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-7e6de74df5f314185ef393de99627f84f5180246%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

Il completamento del processo di importazione può richiedere diversi minuti. Al termine, l'immagine viene visualizzata nell'elenco in stato **ATTIVA** :

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-859d94c55a31e99c0c77b6ef016ea7ee5470c081%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Una volta importata, l'immagine del disco di Zoom Node occupa circa 200 GB.
{% endhint %}

**Creare la macchina virtuale Zoom Node**

Successivamente, creerai la macchina virtuale. Per creare la VM:

1. Fai clic sul menu a discesa **Impostazioni** e seleziona **VM**.

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-474951338298637cc45c8a4ffaab1e8e452b5abd%2Funknown.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>
2. Nella schermata VM, fai clic su **+ Create VM** sul lato destro dello schermo.

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-b01cec67254e40cc465e27007d52faa3435cd613%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
3. Inserire un **Nome**, **e una Descrizione** (facoltativo), quindi selezionare il **Fuso orario**.
4. In **Dettagli di elaborazione**, inserisci le specifiche di elaborazione.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-815de752de241325f60ffecd7c350a721bf0ce2f%2Funknown.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
Come mostrato sopra, Zoom Node richiede 8 core vCPU per una distribuzione in produzione. Zoom consiglia di impostare il numero di socket delle vCPU in modo che corrisponda al numero di socket del server fisico. Le seguenti descrizioni delle impostazioni soddisfano i requisiti di una distribuzione standard:

* Imposta il campo **vCPU(s)** in modo che corrisponda al numero di socket del server su cui è in esecuzione Nutanix AHV. Per un server tipico con due socket, imposta questo valore su **2**.
* Imposta **Number Of Cores Per vCPU** su **4**, per ottenere **8 vCPU**.
* Imposta la **Memoria** (RAM) su **16** GB.
* In **Configurazione di avvio**, seleziona **UEFI**.
  {% endhint %}

{% hint style="danger" %}
Zoom Node NON si avvierà se non è selezionata l'opzione UEFI.
{% endhint %}

5. Viene visualizzata una finestra di avviso. Fai clic su **OK** per confermare.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-8650c6bcb97e8e59e698dbb2279e91dda03446d7%2Funknown.png?alt=media" alt="" width="525"><figcaption></figcaption></figure>
6. Scorri verso il basso fino alla sezione **Dischi** sezione.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-754c969e06ac2d54827d1c9b9c61dd659efb4dff%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>
7. Clicca su **+ Aggiungi nuovo disco** per creare un disco su cui eseguire Zoom Node.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-7ce64b4af20709c24fde059fbb4a906eef92849c%2Funknown.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>
8. Nel menu a discesa **Tipo** , Seleziona **DISCO**.
9. Nel menu a discesa **Operazione** , Seleziona **Clona dal servizio immagini**.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-a52a02d5c64aed117aa2b9da1a0c2b47f62b53fd%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>
10. Nel menu a discesa **Immagine** , Seleziona il nome dell'immagine creata in precedenza durante l'importazione del disco di Zoom Node.
11. Fai clic su **Aggiungi**.
12. Scorri verso il basso fino alla sezione **Schede di rete (NIC)** .\\

    <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-27cf7978d38bd953e64108d19ecf97bafe2075d1%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>
13. Clicca su + Aggiungi nuova NIC.\\

    <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-93faedc48201020bdd3546579a26dfa6fcaa5c04%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>
14. Nel menu a discesa **Nome subnet** , Seleziona l'opzione con accesso IP diretto.

{% hint style="info" %}
Come promemoria, il NAT dell'hypervisor non è supportato.
{% endhint %}

15. In **Stato della connessione di rete**, Seleziona **Connesso**.
16. Clicca su **Aggiungi**.\\

    <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-088ab7e3569d1e244786d3be266617903047da7b%2Funknown.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>
17. Clicca su **Salva** per creare la VM.

**Accendi la nuova VM di Zoom Node**

Il nuovo nodo verrà visualizzato nell'elenco delle VM. Scegli la vista Tabella per visualizzare più facilmente l'elenco delle VM.

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-9d41bee9bd5784fafc6d387da902fac351a5624b%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

Clicca con il tasto destro sulla nuova VM che hai creato e Seleziona **Accendi**.

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-58323e423085b1790e0891004ef300f862ca0099%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

La VM inizierà ad avviarsi dopo alcuni secondi.

Clicca con il tasto destro sulla VM e Seleziona **Avvia console** per interagire con la VM.

{% hint style="info" %}
Si aprirà una finestra pop-up. Se non la vedi, potrebbe essere necessario consentire i pop-up per AHV nelle Impostazioni del browser.
{% endhint %}

Una volta avviata la VM, la distribuzione di Zoom Node su Nutanix AHV è completata.

#### Gestione di Zoom Node

Per ulteriori informazioni sulla gestione dei Zoom Node attivati, consulta l'articolo dell'Assistenza Zoom [Gestione di server e moduli Zoom Node](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063730).

### <mark style="color:blu;">Distribuzioni AWS EC2</mark>

{% hint style="info" %}
L'AMI di Zoom Node non è ancora Disponibile nello Zoom App Marketplace. Attualmente è necessario creare un'AMI manualmente. Questa procedura deve essere eseguita una sola volta per l'account AWS.

Puoi saltare questa sezione se l'AMI di Zoom Node è già stata creata nel tuo account e desideri soltanto distribuire una nuova istanza di Zoom Node.
{% endhint %}

#### Prerequisiti

La pagina [Prerequisiti dell'infrastruttura di Zoom Node](https://library.zoom.com/technical-library/it/servizi-enterprise-avanzati/zoom-node/zoom-node-deployment-field-guide/zoom-node-infrastructure-prerequisites.md)indica i prerequisiti hardware e software necessari per la distribuzione.

#### Download dell’immagine OVA

1. Scarica l’immagine OVA più recente di Zoom Node dal portale web amministratori di Zoom, andando a **Portale amministratori > Zoom Node > Moduli > Nodi > Aggiungi nodi**.

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-1c3ae8bd61b6e5d88e39cfc6f638b1af2c517bd8%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

2. Scarica l’immagine OVA VMWare e annotane il nome. Il file è di circa 5 GB e il download potrebbe richiedere del tempo.
3. Estrai il file OVA in una directory di lavoro. (Su Windows, usa PowerShell per accedere al comando tar.)
   1. Digita: `tar xvf <Zoom Node>.ova`
   2. L'output sarà simile al seguente:\\

      <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-4626811be8f9ea5d7761020fa34d32a232135a6a%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
   3. Annota il nome del file .vmdk. In questo esempio è: `ubuntu22-zoomcommon-build-go-20240418014859-disk-0.vmdk`.
4. Carica il file .vmdk in un bucket S3. Usa l'interfaccia web AWS o, preferibilmente, la CLI AWS per garantire la coerenza dei nomi dei file .vmdk.
   1. Inserisci il comando seguente per copiare il file in AWS S3: `aws s3 cp ubuntu22-zoomcommon-build-go-20240418014859-disk-0.vmdk s3:///node3.4.vmdk`.
   2. A seconda della velocità della connessione Internet, il caricamento può richiedere da pochi minuti a diverse ore. Il file è di circa 5 GB.\\

      <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-6621bf2c934afafa36779b8049bf49d786193d0b%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Il comando precedente rinomina il file in S3 con un nome più intuitivo, `node3.4.vmdk` per facilitarne l'uso durante l'importazione.

Ad esempio, se il bucket S3 si chiama `vhd-import-bucket` il comando sarà: `aws s3 cp ubuntu22-zoomcommon-build-go-20240418014859-disk-0.vmdk s3://vhd-import-bucket/node3.4.vmdk`.
{% endhint %}

5. Prepara un file JSON con i seguenti dettagli che descrivono l'immagine disco che stai importando:

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

{% hint style="info" %}
Questo codice identifica l'importazione dell'immagine `node3.4.vmdk` attualmente archiviata in un bucket S3, come Zoom Node versione 3.4.
{% endhint %}

6. Importa l'immagine .vmdk di Zoom Node come **snapshot**.

{% hint style="warning" %}
Devi importare il disco come snapshot e **non** come immagine.
{% endhint %}

7. Inserisci il comando seguente: `aws ec2 import-snapshot --disk-container file://.json`.
8. (Facoltativo) Se il file JSON si chiama `node.json`, inserisci il comando seguente: `aws ec2 import-snapshot --disk-container file://node.json`.
9. Controlla il campo `StatusMessage:` per verificare la presenza dello stato “pending” all'avvio dell'importazione.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-41eb385ae7229d8ddb24651f1794082953012eab%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Il completamento dell'importazione può richiedere 20 minuti o più.
{% endhint %}

10. Controlla nell'output della CLI il valore `ImportTaskId` .
    1. Nell'esempio precedente, `ImportTaskId` è `import-snap-f8d845596565b0c3t`. Questo valore controlla periodicamente lo stato del processo.
    2. Inserire il comando seguente: `aws ec2 describe-import-snapshot-tasks --import-task-ids <ImportTaskId>` dove `ImportTaskId` è il valore univoco determinato nel passaggio precedente.
    3. Dovrebbe apparire il seguente output, con il valore `ImportTaskId` compilato:\\

       <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-ddbb134ad032b38f0148e0efd07463573d9738e7%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
    4. Nota che lo stato attuale del processo è «downloading/converting», il che significa che il processo sta ancora elaborando il file. Il campo `Progress: <##>,` mostra la percentuale di completamento. L'esempio precedente mostra il valore `19` per un completamento del 19%.
    5. Esaminare il campo `Status:` per verificare il completamento del processo:\\

       <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-d5e95a0013f54e293cd0e836243ee9fe6510e0de%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Convertire lo snapshot in un'Amazon Machine Image (AMI)

1. Accedi alla dashboard EC2 della Console AWS.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-495ff50c27be4f5880910750271cba41bc1d4e01%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
2. Sul lato sinistro dello schermo, sotto il menu a discesa **Elastic Block Store** fai clic su **Snapshot**.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-10efb7067c30bf4667e4a42764232ab1a24611d6%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
3. Fai clic sul collegamento **ID snapshot** per visualizzarne i dettagli.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-1cd5fc7510c2faed257ac0faee99c2f10211926c%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
4. Fai clic sul pulsante a discesa **Azioni** nell'angolo in alto a destra dello schermo e seleziona **Crea immagine da snapshot**.
5. Viene visualizzata la finestra **Impostazioni immagine** .
6. Inserire un **Nome immagine** per l'AMI.
   1. Esempio: **Zoom Node 3.4 AMI**.
7. (Facoltativo) Inserire una descrizione.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-0d4e5efcbe70b6e80866211fc130458d8da572ba%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
8. Scorri la finestra verso il basso per visualizzare altre impostazioni.
9. Verifica che in **Dimensione (GiB)**&#x73;ia assegnato il volume del disco da 189 GB.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-f1ec30743a66afc398b20d0036d7dfde8e3f555e%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
10. Nel menu a discesa **Modalità di avvio** Seleziona **UEFI**.

#### Distribuzione delle istanze Zoom Node su AWS EC2

1. Accedi alla dashboard EC2 della Console AWS.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-495ff50c27be4f5880910750271cba41bc1d4e01%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
2. Sul lato sinistro dello schermo, nel menu a discesa **Istanze** , fai clic su **Istanze**.
3. Crea una nuova istanza utilizzando l'AMI di Zoom Node.
4. inserire un nome per l'istanza.

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-1f6ae0259884d8f846423e001edb3ffcd4e83d8b%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

5. Nella sezione **Immagini dell'applicazione e del sistema operativo (Amazon Machine Image)** , fai clic sulla scheda **Le mie AMI** .
6. Cerca l'AMI di Zoom Node che hai appena creato e denominato.\\

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-e77a5de3de0e83b321d92c53d296cca1ced58d72%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>
7. Fai clic sull'AMI che hai creato per impostare i vari parametri.
8. Nella sezione **Tipo di istanza** , fai clic sul **Tipo di istanza** menu a discesa e Seleziona **t3.medium**.

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-729f12d883c854eba7892ea9520ea410af2c8c9c%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Per le distribuzioni di produzione, Zoom Node richiede 8 vCPU e 16 GB di RAM. Gli ambienti di laboratorio, invece, possono funzionare con 2 vCPU e 4 GB di RAM; si consiglia un'istanza t3.medium. Se Zoom Meetings Hybrid è in esecuzione sul sistema, sarà probabilmente necessaria un'istanza t3.large per supportare più di pochi utenti in una riunione.
{% endhint %}

9. Nella sezione **Coppia di chiavi (accesso)** , fai clic sul **Nome della coppia di chiavi** menu a discesa e Seleziona **Procedi senza una coppia di chiavi (non consigliato)**.

   1. È necessario omettere la coppia di chiavi perché SSH non è abilitato su Zoom Node per l'accesso alla console.

   <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-d9d734bbd4466ab52f9d6bbdbdbf7b4ce00ee3c7%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>
10. In Impostazioni di rete, Configura le seguenti opzioni:
    1. In **VPC - obbligatorio**, Scegli un VPC che consenta alle app Zoom Workplace l'accesso diretto instradato a livello L3.
    2. In **Sottorete**, Scegli la sottorete in cui opererà questa VM.\\

       <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-728f03485275d3561c751fc29f3fc2cb10c8957e%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>
    3. **Zoom Node richiede comunicazioni In uscita verso il cloud Zoom**. È necessario fornire un Indirizzo IP pubblico.
    4. Seleziona **Abilita** dal campo **Assegna automaticamente IP pubblico** .
    5. Crea un **gruppo di sicurezza** che consenta l'accesso In entrata dall'app Zoom Workplace sulla Portabilità richiesta.
    6. Utilizza le regole del firewall documentate nell'articolo dell'Assistenza Zoom [Regole del firewall del server di gestione Zoom Node](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0066766).\\

       <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-ddf67e307bfefd85af13d78c20eb19dea8fc2404%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
L'accesso a Internet In entrata non è richiesto per Zoom Node, tranne quando è abilitato l'accesso diretto ai contenuti multimediali da fonti esterne (una distribuzione Facoltativo per il Connettore delle riunioni o per consentire l'accesso agli utenti esterni a Zoom Meetings Hybrid - Private Meetings).
{% endhint %}

11. Fai clic su **Dettagli avanzati**.
12. Fai clic su **Versione dei metadati** el menu a discesa e seleziona **Solo V2 (token obbligatorio)**.\\

    <figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-3c12526cdf11ff191120e67a81fc3de8e228b283%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Devi impostare la versione dei metadati su V2, altrimenti la distribuzione non riuscirà.
{% endhint %}

#### (Facoltativo) Preconfigurare Zoom Node

Le impostazioni del sistema operativo di Zoom Node, come quelle di rete, il nome host, le password locali e i codici di iscrizione di 16 cifre, possono essere configurate automaticamente tramite la **Dati utente -&#x20;*****facoltativo*** sezione in AWS EC2.

All'avvio di Zoom Node, verranno recuperate queste informazioni preconfigurate da AWS EC2 (server IDMSv2) e il nodo verrà configurato automaticamente, come mostrato nell'immagine seguente:

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-dd88be2e2972858f488b0e2439fce2221fd6b920%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

Usa il codice seguente per creare un nuovo file di dati utente:

```yaml
#custom-config
hostname: zn-ec2
password: ZoomNodepassword1234
codice_iscrizione: ABCD1234DEFG5678
rete:
  interfacce Ethernet:
    ens:
      indirizzi:
        - 10.15.1.150/24
        - 10.15.1.151/24
        - 10.15.1.152/24
      gateway: 10.15.1.1
      server dei nomi:
        indirizzi:
          - 1.1.1.1
```

Dopo aver caricato il file dei dati utente su AWS EC2, distribuisci l'istanza facendo clic su **Avvia istanza**.

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-f005bdc6849b51089c2f4d9c852a8f17422acf88%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Verifica di un'istanza distribuita

<div align="center"><figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-81efccb2aef64fd6ddbd71c74d717468f4fd4059%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

Fai clic sul **link dell'ID dell'istanza** (i-06e4592fd2d91ef3f, come mostrato nell'immagine sopra) per trovare l' **Indirizzo IP interno** assegnato al Node.

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-ee0d8b76974b80de46560b8415771b3297b5ccd8%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

Il Node impiega alcuni minuti per avviarsi e rendere disponibile un'interfaccia web grafica locale.

Entro i primi 10 minuti dall'avvio dell'istanza, apri un browser e inserisci gli indirizzi **IPv4 privati** elencati (`10.10.130.223` nell'immagine sopra).

Ad esempio: `https://<10.10.130.223>:8443`.

Accetta l'avviso relativo al certificato non valido che viene visualizzato. Viene visualizzato il portale amministratori locale di Zoom Node, che ti chiede una password.

<figure><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-055d15acc93f4e797065fe134ebf7d535f156851%2Funknown.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Fai clic sul link **Imposta password** per configurare una password amministratore.

Il nome utente è sempre `zoom-setup`.

{% hint style="info" %}
Il link «Imposta password» è visibile solo nei primi 10 minuti dopo l’avvio della VM. Se non è visibile, riavvia la VM per rendere nuovamente disponibile l’opzione.
{% endhint %}

Ora che la distribuzione è completa, puoi continuare la configurazione seguendo le istruzioni a partire dalla [Configurazione e gestione post-distribuzione di Zoom Node](https://library.zoom.com/technical-library/it/servizi-enterprise-avanzati/zoom-node/zoom-node-deployment-field-guide/zoom-node-post-deployment-configuration-and-management.md#network-configuration)procedura della [Configurazione e gestione post-distribuzione di Zoom Node](https://library.zoom.com/technical-library/it/servizi-enterprise-avanzati/zoom-node/zoom-node-deployment-field-guide/zoom-node-post-deployment-configuration-and-management.md) pagina.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://library.zoom.com/technical-library/it/servizi-enterprise-avanzati/zoom-node/zoom-node-deployment-field-guide/zoom-node-hypervisor-specific-deployments.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
