# Deployment specifici dell’hypervisor di Zoom Node

Quando si distribuisce Zoom Node in ambienti virtualizzati, è necessario allineare i passaggi di installazione e configurazione con la specifica piattaforma di hypervisor in uso. Ogni hypervisor, ad esempio VMware vSphere, Microsoft Hyper-V o altri, può introdurre requisiti unici relativi all'allocazione delle risorse, all'accesso allo storage e alla configurazione dell'interfaccia di rete.

Questa sezione fornisce indicazioni dettagliate per gli hypervisor supportati, garantendo che Zoom Node funzioni in modo affidabile ed efficiente nella tua infrastruttura virtuale.

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

La sezione seguente descrive il metodo di installazione VMware vSphere, che richiede il download e la distribuzione di un file OVA (Open Virtual Appliance) della versione Zoom Node.

#### Scarica l'immagine OVA

Per scaricare il file immagine:

1. Accedi al portale web amministratore 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%20(118).png?alt=media" alt=""><figcaption></figcaption></figure>
3. Fai clic sulla scheda **Download** pulsante.

#### Distribuisci 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 tipo di creazione Sect, 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. Fai clic su **Avanti**.
5. Inserisci un nome per la VM Zoom Node.
6. Fai clic sulla finestra di dialogo blu per aprire un browser dei file e selezionare il file immagine OVA di Zoom Node che hai scaricato.
   1. (Facoltativo) Trascina e rilascia il file immagine nella casella.

<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. Fai clic su **Avanti**.
8. Scegli il volume di storage in cui memorizzerai Zoom Node e fai clic su **Avanti**.
9. Scegli la rete su cui risiederà il server.
   1. (Facoltativo) Se desideri, puoi eseguire il provisioning sottile della VM.

{% hint style="info" %}
Il «provisioning sottile» consente al disco di una macchina virtuale di utilizzare storage fisico solo quando vengono scritti i dati, invece di riservare in anticipo l'intera dimensione del disco. Questo metodo fa 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. Fai clic su **Avanti**.
11. Rivedi 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 Microsoft Hyper-V</mark>

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

#### Scarica 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 web amministratore di Zoom.
2. Scarica l'immagine **Zoom Node VHDX** dal portale amministratore di 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 uso temporaneo.

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

Per usare un'immagine disco QCOW2 (KVM) in un ambiente Hyper-V, puoi convertirla nel formato VHDX usando `qemu-img` all'interno di PowerShell.

**Passaggio 1: scarica e installa `qemu-img` per Windows**

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

**Passaggio 2: converti 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 output di avanzamento simile a:

```
(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` abilita la visualizzazione di una barra di avanzamento durante la conversione
* Modifica i percorsi dei file secondo le esigenze del tuo ambiente
  {% endhint %}

**Contesto di implementazione e risultato pratico**

La conversione in VHDX consente di importare immagini Linux personalizzate (come Ubuntu con agent o servizi Zoom preinstallati) in una VM Hyper-V. Questo supporta ambienti di laboratorio personalizzati, test CI/CD o sviluppo localizzato con configurazioni di sistema coerenti.

#### Distribuzione di una VM Zoom Node su Hyper-V

Hyper-V supporta la distribuzione di VM usando due metodi principali: il primo tramite la GUI in Hyper-V Manager e il secondo tramite script PowerShell. PowerShell è il metodo più semplice per automatizzare più distribuzioni di Node.

Esistono due metodi che possono essere usati per distribuire la macchina virtuale. Il metodo semplice, Opzione 1, usa comandi PowerShell per creare una nuova VM Zoom Node usando il VMDK con gli attributi corretti. L'Opzione 2 usa la GUI di Hyper-V Manager per distribuire la VM.

Vedi la [#supported-hypervisors](https://library.zoom.com/technical-library/it/servizi-enterprise-avanzati/zoom-node/zoom-node-infrastructure-prerequisites#supported-hypervisors "mention") 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. Fai riferimento alla documentazione specifica del modulo per 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 Hyper-V. PowerShell 7 potrebbe funzionare, ma alcuni comandi specifici di Hyper-V non funzionano correttamente.
{% endhint %}

Individua la posizione di archiviazione per le tue macchine virtuali Hyper-V. In questo esempio, il server Hyper-V ha le VM archiviate 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 della VM Zoom Node: 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 Gen 2 (ancora 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

# --- Secure Boot + 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: connetti a 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 integrazione: abilita Guest Service Interface ---
$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'
}

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

```

{% endcode %}

#### Opzione 2: distribuisci il VHDX e crea manualmente la macchina virtuale

L'Opzione 2 prevede la creazione manuale della macchina virtuale distribuendo il file VHDX. Questo metodo richiede il trasferimento dell'immagine disco dall'archivio Zoom Node estratto nella posizione di storage designata per le macchine virtuali Hyper-V e la configurazione manuale delle impostazioni della VM.

**Copia il VMDK nello storage VM di Hyper-V**

1. Individua la posizione di archiviazione per le tue macchine virtuali Hyper-V. (In questo esempio, il server Hyper-V ha le VM archiviate 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%20(1)?alt=media" alt=""><figcaption></figcaption></figure>
3. Copia il file immagine VHDX che hai scaricato da Zoom nella directory Dischi rigidi virtuali.
4. Accedi alla console Microsoft Hyper-V Manager per gestire le VM.

**Definisci la VM**

In Hyper-V Manager, fai clic su **Nuovo** e seleziona **Macchina virtuale** dal riquadro di destra. Verrà avviata la procedura guidata **Nuova macchina virtuale**.

1. Completa il passaggio **Specificare nome e percorso** :
   1. Inserisci un nome per la tua macchina virtuale.
   2. (Facoltativo) Scegli una posizione di storage. È comune memorizzare i file di configurazione della VM nella stessa cartella del disco virtuale della VM.
   3. Seleziona la casella «Memorizza la macchina 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. Vai alla cartella di storage della VM che hai creato 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. Fai clic su **Avanti**.
5. Completa il passaggio **Specifica generazione** :
   1. Seleziona l'opzione **Generazione 2** 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. Nel **Memoria di avvio:** casella di testo, inserisci `16384` (MB)
   2. (Facoltativo) Seleziona «Usa memoria dinamica per questa macchina 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 sulla scheda **Connessione:** menu a discesa e seleziona uno switch virtuale per connettere la VM alla tua rete. Questo dipenderà dal tuo 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. Fai clic su **Avanti**.

**Collega l'immagine disco VHDX**

Successivamente nella procedura guidata Nuova macchina virtuale, completerai il passaggio **Collega disco rigido virtuale** Per collegare l'immagine:

1. Seleziona l'opzione **Usa un disco rigido virtuale esistente** 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 che hai creato 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%20(10)?alt=media" alt=""><figcaption></figcaption></figure>
3. Nella finestra di selezione del file, fai clic su **Apri**.
4. Fai clic su **Avanti**.
5. Rivedi 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%20(11)?alt=media" alt=""><figcaption></figcaption></figure>

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

**Configura impostazioni aggiuntive della VM**

Per configurare ulteriori impostazioni:

1. Fai clic con il tasto destro 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. Sotto la categoria **Hardware** sul lato sinistro dello schermo, fai clic su **Sicurezza**.
3. Sul lato destro dello schermo e sotto l'intestazione **Sicurezza** fai clic sul **Modello:** elenco a discesa.
4. Seleziona l'opzione **Autorità di certificazione UEFI Microsoft** opzione.\\

   <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. Sotto la categoria **Hardware** sul lato sinistro dello schermo, fai clic su **Processore**.
7. Sul lato destro dello schermo e sotto l'intestazione **Processore** intestazione, imposta la **Numero di processori virtuali:** casella a `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" %}
Questa è l'impostazione predefinita richiesta da Zoom Node per eseguire quattro (4) moduli. Vedi la [#deployment-sizing-and-capacity-planning-matrix](https://library.zoom.com/technical-library/it/servizi-enterprise-avanzati/zoom-node/zoom-node-infrastructure-prerequisites#deployment-sizing-and-capacity-planning-matrix "mention") pagina per ulteriori informazioni sul ridimensionamento della VM quando vengono eseguiti meno moduli.
{% endhint %}

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

**Avvia la macchina virtuale**

Per avviare la VM:

1. Seleziona la VM appena creata in Hyper-V Manager.
2. Dal 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>

Una sequenza di avvio funzionante della VM mostrerà la schermata di avvio di Linux. Successivamente, verrà caricato l'interfaccia testuale di Zoom Node.

{% hint style="info" %}
Se vedi un messaggio di errore UEFI durante il tentativo di avvio, potresti non aver impostato il metodo Secure Boot su «UEFI Certificate Authority».

<img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-0b290fa647f6639fedd39a37d3f2fe277ce9a13b%2Funknown%20(18)?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 le installazioni di Zoom Node tramite Proxmox VE oppure KVM Virtual Machine Manager (Virt-manager).

#### Ambiente virtuale KVM Proxmox (VE)

La distribuzione di Zoom Node su Proxmox VE usando l'immagine qcow2 richiede passaggi aggiuntivi rispetto alla distribuzione di un'immagine ISO. I seguenti passaggi creeranno una nuova VM configurata in modo che l'immagine qcow2 di Zoom Node possa essere collegata a quella VM.

{% hint style="info" %}
Una distribuzione predefinita di QEMU/KVM utilizzerà NAT dell'hypervisor e un pool di indirizzi IP privati per distribuire le VM, gestite da KVM. Questa non è un'architettura supportata per Zoom Node. Anche se è possibile distribuire ed eseguire Zoom Node dietro NAT dell'hypervisor, i client sulla rete non potranno comunicare correttamente con esso. Zoom Node deve essere distribuito su un'interfaccia bridged in modo da avere un indirizzamento IP che rientri nell'intervallo IP con cui i client possono comunicare.
{% endhint %}

**Definisci la macchina virtuale Zoom Node**

Per definire la VM:

1. Accedi all'interfaccia dell'applicazione di gestione Proxmox.
2. Fai clic sulla scheda **Crea VM** pulsante. Questa diventerà la VM template di Zoom Node.
3. Assegna un nome alla VM e **salva l'ID della VM**.
   1. Queste informazioni verranno usate in un passaggio successivo.
4. Fai clic su **Avanti** per continuare.
5. Seleziona **Non usare alcun supporto** nella pagina delle impostazioni del sistema operativo.
6. Fai clic su **Avanti**.
7. Scegli l'opzione `q35` sotto le impostazioni **Macchina** .
   1. Per il tipo **BIOS** seleziona **OVMF (UEFI)** e scegli il volume in cui desideri che vengano archiviate le impostazioni EFI. Questo è impostato sullo stesso volume VM che stai usando per memorizzare la VM stessa.

{% hint style="info" %}
Le impostazioni di Macchina e BIOS sono fondamentali da configurare come descritto. In caso contrario, la VM non si avvierà correttamente.
{% endhint %}

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

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

Per preparare l'immagine:

1. Vai al portale amministratore di Zoom sotto **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 (come un volume NFS).
   1. (Facoltativo) Copialo sul volume del server Proxmox in cui sono archiviate le VM.
4. Nota la creazione della `111` directory e dell'immagine disco vuota.
5. Annota il nome del file immagine disco in questa cartella
   1. Esempio: `vm-111-disk-0.qcow2`.
6. Elimina il file 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 (ossia `vm-111-disk-0.qcow2`).
9. Torna all'interfaccia web principale di Proxmox e seleziona la VM appena distribuita.
10. Fai clic con il tasto destro sulla VM selezionata e scegli di **clonarla** .
11. Trasforma il clone in un template assegnandogli un nome e facendo clic su **Clona**.
12. Una volta completata la clonazione, fai clic con il tasto destro sul clone e seleziona **Converti in template**.
    1. Ora hai un template distribuibile.
13. Seleziona la VM originale e fai clic per aprire la **Console**.
14. Avvia la VM facendo clic su **Avvia ora** pulsante.

Conferma che la VM si avvii e visualizzi l'interfaccia utente testuale locale di Zoom Node, il che verifica l'usabilità del template per distribuzioni future.

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

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

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

Una distribuzione predefinita di QEMU/KVM utilizzerà NAT dell'hypervisor e un pool di indirizzi IP privati per distribuire le VM, gestite da KVM. Questo è **non** un'architettura supportata per Zoom Node.

{% hint style="info" %}
Anche se è possibile distribuire ed eseguire Zoom Node dietro NAT dell'hypervisor, i client sulla rete non potranno comunicare correttamente. Per garantire una comunicazione corretta dei client, distribuisci Zoom Node su un'interfaccia bridged che si allinei con l'intervallo di indirizzi IP del client.
{% endhint %}

Per installare usando il metodo virt-manager:

1. Accedi al [portale web amministratore di Zoom](https://zoom.us/) come amministratore.
2. Scarica la versione corrente del **file immagine qcow2 di Zoom Node** dal portale amministratore di Zoom selezionando **Zoom Node > Moduli > Nodi > Aggiungi nodo**.
3. Rinomina il file con il nome desiderato della VM o del disco.
   1. Esempio: `ZN-SJC01-NODE01.qcow2`.
4. Sposta il file in un volume a cui Virtual Manager ha accesso.
5. Crea una nuova VM in Virtual Manager.
6. Fai clic su **Importa immagine disco esistente**.
7. Seleziona il volume in cui hai memorizzato l'immagine qcow2 rinominata.
8. Fai clic sulla scheda **Scegli volume** pulsante.
   1. (Facoltativo) Se non hai già aggiunto la directory corretta a virt-manager, puoi fare clic su **Sfoglia 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 a `16384 MB` (16 GB) e la configurazione della CPU a `8 CPU`.
    1. Queste impostazioni consentono a Zoom Node di eseguire quattro (4) moduli.

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

11. Inserisci un nome per il Node.
12. **Fai clic su Personalizza configurazione prima dell'installazione**.

{% hint style="danger" %}
Se non esegui questa configurazione, il Node non si avvierà. È necessario modificare impostazioni aggiuntive.
{% endhint %}

13. Assicurati che il dispositivo di rete sia impostato su **Ethernet bridged** e non NAT.

{% hint style="info" %}
La distribuzione di Zoom Node dietro NAT su KVM impedirà ai client di comunicare con esso.
{% endhint %}

14. Quando il riquadro **dettagli VM** si apre, modifica il **Chipset** a **Q35**.
15. Modifica il **Firmware** a **UEFI**.

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

16. Fai clic su **Applica**.
17. Fai clic su **Avvia installazione** nella parte superiore del menu a nastro per distribuire la VM.

La VM si avvierà e inizierà il boot. Una volta che la VM originale si è avviata, sapremo che il template creato è ufficialmente utilizzabile.

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

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

Questa sezione riguarda l'installazione della VM OS di Zoom Node su versioni Nutanix AHV da 6.8.1 a 7.0.1.

#### Requisiti generali di hypervisor e macchina virtuale

La [zoom-node-infrastructure-prerequisites](https://library.zoom.com/technical-library/it/servizi-enterprise-avanzati/zoom-node/zoom-node-deployment-field-guide/zoom-node-infrastructure-prerequisites "mention")pagina fornisce i prerequisiti hardware e software necessari per la distribuzione.

#### Distribuzione di Zoom Node

La distribuzione di Zoom Node richiede il download di un'immagine, l'importazione dell'immagine in AHV e la creazione di una VM.

**Scarica il file immagine di Zoom Node**

Per scaricare il file immagine:

1. Accedi al [portale web amministratore di Zoom](https://zoom.us/).
2. Scarica l'immagine **Zoom Node QCOW2** immagine dal portale amministratore di 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%20(98).png?alt=media" alt=""><figcaption></figcaption></figure>
3. Scarica l'immagine **immagine QCOW2** facendo clic sul **Download** pulsante.

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

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

1. Accedi alla console Nutanix AHV andando su `https://<cluster hostname>:9440`.
2. Fai clic sulla scheda **Home** menu a discesa 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 **Impostazioni** pagina.

<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**. Verrà 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 preferite nei campi di testo della finestra di dialogo Crea immagine.
   1. Annotazione è un campo facoltativo.
   2. Fai clic sulla scheda **Tipo di immagine** menu a discesa e seleziona **DISK**.
   3. Fai clic sulla scheda **Contenitore di storage** menu a discesa e seleziona l'opzione appropriata per il tuo ambiente.
7. Fai clic sulla scheda **Carica un file** pulsante di opzione e poi fai clic su **Sfoglia...**.
8. Seleziona l'immagine QCOW2 che hai scaricato in precedenza.
9. Fai clic su **Salva** per iniziare il caricamento dell'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 apparirà nel nastro blu.

{% hint style="danger" %}
Mantieni aperta la finestra o la scheda del browser corrente per assicurarti che il caricamento venga completato. Non tentare di navigare altrove nell'interfaccia AHV mentre il caricamento è attivo.
{% endhint %}

Una volta completato il caricamento, verrà eseguito il processo di aggiornamento dell'immagine. Fai clic sull'icona lampeggiante dello stato del job nel menu a nastro per seguire 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>

L'importazione può richiedere diversi minuti per completarsi. Una volta terminata, l'immagine appare 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" %}
L'immagine disco di Zoom Node è di circa 200 GB una volta importata.
{% endhint %}

**Crea la macchina virtuale Zoom Node**

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

1. Fai clic sulla scheda **Impostazioni** menu a discesa 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. Dalla schermata VM, fai clic su **+ Crea 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. Inserisci un **Nome**, **Descrizione** (facoltativo), e seleziona il **Fuso orario appropriato**.
4. Sotto **Dettagli 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 di produzione. Zoom consiglia di far corrispondere il numero di socket del server fisico quando si impostano le vCPU. Le seguenti descrizioni delle impostazioni soddisfano i requisiti standard di distribuzione:

* Imposta la **vCPU** campo per far corrispondere il numero di socket nel server su cui è in esecuzione Nutanix AHV. Per un tipico server a due socket, imposteresti questo valore su **2**.
* Imposta la **Numero di core per vCPU** a **4**, che corrisponde a **8 vCPU**.
* Imposta la **Memoria** (RAM) a **16** GB.
* Sotto **Configurazione di avvio**, seleziona **UEFI**.
  {% endhint %}

{% hint style="danger" %}
Zoom Node NON si avvierà a meno che non sia selezionato UEFI.
{% endhint %}

5. Appare una finestra di avviso. Fai clic su **OK** per riconoscerla.\\

   <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 **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. Fai clic 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. Sotto la categoria **Tipo** menu a tendina, seleziona **DISK**.
9. Sotto la categoria **Operazione** menu a tendina, 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. Sotto la categoria **Immagine** menu a tendina, seleziona il nome dell'immagine creata quando hai importato in precedenza il disco di Zoom Node.
11. Fai clic su **Aggiungi**.
12. Scorri verso il basso fino alla **Schede di rete (NIC)** sezione.\\

    <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. Fai clic 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. Sotto la categoria **Nome subnet** menu a tendina, seleziona l'opzione con accesso IP diretto.

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

15. Sotto **Stato connessione di rete**, seleziona **Connesso**.
16. Fai clic 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. Fai clic su **Salva** per creare la VM.

**Accendi la nuova VM di Zoom Node**

Il nuovo Node apparirà nell'elenco delle VM. Puoi scegliere la vista Tabella per rendere più facile visualizzare 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>

Fai clic 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.

Fai di nuovo clic 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 distribuzione di Zoom Node su Nutanix AHV è completa.

#### Gestione di Zoom Node

Per ulteriori informazioni sulla gestione dei tuoi Zoom Node attivati, consulta l'articolo di Zoom Support [Gestione dei server e dei 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 in Zoom App Marketplace. Attualmente, è necessario creare manualmente un'AMI. Questo processo deve essere eseguito una sola volta per l'account AWS.

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

#### Prerequisiti

La [zoom-node-infrastructure-prerequisites](https://library.zoom.com/technical-library/it/servizi-enterprise-avanzati/zoom-node/zoom-node-deployment-field-guide/zoom-node-infrastructure-prerequisites "mention")pagina fornisce i prerequisiti hardware e software necessari per la distribuzione.

#### Download dell'immagine OVA

1. Scarica l'ultima immagine OVA di Zoom Node dal portale web di amministrazione Zoom andando su **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 annota 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 a questo:\\

      <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 AWS CLI per garantire la coerenza del nome .vmdk.
   1. Inserisci il seguente comando 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. La dimensione del 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 rinominerà il file in S3 con un nome più semplice `node3.4.vmdk` per renderne più facile l'uso durante l'importazione.

Ad esempio, se il bucket S3 si chiama `vhd-import-bucket` il comando sarebbe: `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 la tua importazione dell' `node3.4.vmdk` immagine, 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** un'immagine.
{% endhint %}

7. Inserisci il seguente comando: `aws ec2 import-snapshot --disk-container file://.json`.
8. (Facoltativo) Se il file JSON si chiama `node.json`, inserisci il seguente comando: `aws ec2 import-snapshot --disk-container file://node.json`.
9. Esamina la `StatusMessage:` campo per lo stato "pending" quando inizia l'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" %}
L'importazione potrebbe richiedere 20 minuti o più per completarsi.
{% endhint %}

10. Rivedi l'output della CLI per il `ImportTaskId` valore.
    1. Nell'esempio sopra, il `ImportTaskId` è `import-snap-f8d845596565b0c3t`. Questo valore verifica periodicamente lo stato del lavoro.
    2. Inserisci il seguente comando: `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 tuo `ImportTaskId` valore popolato:\\

       <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 lavoro è "downloading/converting", il che significa che il lavoro sta ancora elaborando il file. Il campo `Progresso: <##>,` mostra la percentuale di completamento. L'esempio sopra mostra il valore `19` per il 19% completato.
    5. Esamina la `Stato:` campo per verificare il completamento del lavoro:\\

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

#### Converti 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 della schermata, sotto il menu a tendina **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 sulla scheda **collegamento Snapshot ID** per vedere 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 sulla scheda **Azioni** pulsante a discesa nell'angolo in alto a destra della schermata e seleziona **Crea immagine dallo snapshot**.
5. La **Impostazioni immagine** finestra appare.
6. Inserisci un **Nome immagine** per l'AMI.
   1. Esempio: **Zoom Node 3.4 AMI**.
7. (Facoltativo) Inserisci 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 verso il basso nella finestra per visualizzare impostazioni aggiuntive.
9. Verifica di vedere il volume disco assegnato da 189 GB sotto **Dimensione (GiB)**.\\

   <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. Sotto la categoria **Modalità di avvio** menu a tendina, 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%20(45).png?alt=media" alt=""><figcaption></figcaption></figure>
2. Sul lato sinistro della schermata, sotto **Istanze** fai clic su **Istanze**.
3. Crea una nuova istanza utilizzando l'AMI di Zoom Node.
4. Inserisci 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. Sotto la categoria **Applicazioni e immagini del sistema operativo (Amazon Machine Image)** sezione, fai clic su **Le mie AMI** .
6. Cerca l'AMI di Zoom Node che hai appena creato e nominato.\\

   <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 vari parametri.
8. Sotto la categoria **Tipo istanza** sezione, fai clic su **Tipo istanza** elenco 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. Al contrario, gli ambienti di laboratorio possono funzionare con 2 vCPU e 4 GB di RAM, con un'istanza t3.medium consigliata. Se Zoom Meetings Hybrid è in esecuzione sul sistema, probabilmente sarà necessaria un'istanza t3.large per supportare più di pochi utenti in una riunione.
{% endhint %}

9. Sotto la categoria **Coppia di chiavi (login)** sezione, fai clic su **Nome coppia di chiavi** elenco a discesa e seleziona **Procedi senza una coppia di chiavi (Non consigliato)**.

   1. L'omissione di una coppia di chiavi è necessaria 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. Sotto **VPC - obbligatorio**, scegli un VPC che consenta alle tue app Zoom Workplace l'accesso diretto instradato L3.
    2. Sotto **Subnet**, scegli la subnet in cui questa VM opererà.\\

       <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**. Devi fornire un indirizzo IP pubblico.
    4. Seleziona **Abilita** dal campo **Auto-assegna IP pubblico** .
    5. Crea un **Gruppo di sicurezza** che consenta l'accesso in entrata dall'app Zoom Workplace sulla porta richiesta.
    6. Usa le regole firewall documentate nell'articolo di supporto Zoom [Regole 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 media da fonti esterne (una distribuzione opzionale per Meeting Connector o per fornire accesso utente esterno per Zoom Meetings Hybrid - Riunioni private).
{% endhint %}

11. Fai clic su **Dettagli avanzati**.
12. Fai clic sulla scheda **Versione dei metadati** elenco a discesa e seleziona **Solo V2 (token richiesto)**.\\

    <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 fallirà.
{% endhint %}

#### (Facoltativo) Preconfigura Zoom Node

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

Quando Zoom Node si avvia, recupererà queste informazioni preconfigurate da AWS EC2 (server IDMSv2) e configurerà automaticamente il Node come mostrato nella seguente immagine:

<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
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
```

Una volta caricato il file di dati utente in 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>

#### Revisione 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 sulla scheda **collegamento ID 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>

Ci vogliono alcuni minuti affinché il Node si avvii e avvii una GUI web locale.

Entro i primi 10 minuti di avvio dell'istanza, apri un browser web e inserisci le **Indirizzi IPv4 privati** elencati (`10.10.130.223` nell'immagine sopra).

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

Accetta l'avviso di certificato non valido che appare. Viene visualizzato il Portale amministratore locale di Zoom Node e ti viene richiesto di inserire 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 sulla scheda **Imposta password** collegamento per configurare una password amministratore.

Il nome utente è sempre `zoom-setup`.

{% hint style="info" %}
Il link "Imposta password" è visibile solo per i 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 che iniziano nelle [#network-configuration](https://library.zoom.com/technical-library/it/servizi-enterprise-avanzati/zoom-node/zoom-node-post-deployment-configuration-and-management#network-configuration "mention")passaggi della [zoom-node-post-deployment-configuration-and-management](https://library.zoom.com/technical-library/it/servizi-enterprise-avanzati/zoom-node/zoom-node-deployment-field-guide/zoom-node-post-deployment-configuration-and-management "mention") pagina.