> 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/pt/servicos-empresariais-avancados/zoom-node/zoom-node-deployment-field-guide/zoom-node-hypervisor-specific-deployments.md).

# Implementações do Zoom Node específicas para hipervisor

Implemente o Zoom Node em várias plataformas de hipervisor usando esta seção

Ao implementar o Zoom Node em ambientes virtualizados, tem de alinhar os passos de instalação e configuração com a plataforma de hipervisor específica em utilização. Cada hipervisor — como o VMware vSphere, o Microsoft Hyper-V ou outros — pode introduzir requisitos específicos relacionados com a alocação de recursos, o acesso ao armazenamento e a configuração das interfaces de rede.

Esta secção fornece orientações detalhadas para os hipervisores suportados, garantindo que o Zoom Node funciona de forma fiável e eficiente na sua infraestrutura virtual.

### <mark style="color:azul;">Implementações do VMware vSphere</mark>

A secção seguinte descreve o método de instalação do VMware vSphere, que requer o descarregamento e a implementação de uma versão do Zoom Node em ficheiro OVA (Open Virtual Appliance).

#### Descarregar a imagem OVA

Para descarregar o ficheiro de imagem:

1. Inicie sessão no portal Web do administrador do Zoom.
2. Descarregue o ficheiro de imagem OVA do Zoom Node acedendo a **Gestão de nós > Módulos > Nó > Adicionar nó**.\\

   <figure><img src="https://1821044411-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. Clique no botão **Descarregar** .

#### Implementar a imagem OVA

Para implementar o ficheiro de imagem:

1. Inicie sessão na interface Web do VMware.
2. Clique em **Criar/Registar VM**.
3. No menu do tipo de criação Sect, clique em **Implementar uma máquina virtual a partir de um ficheiro OVF ou OVA**.\\

   <figure><img src="https://1821044411-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. Clique em **Próximo(a)**.
5. Insira um nome para a VM do Zoom Node.
6. Clique na caixa de diálogo azul para abrir um navegador de ficheiros e selecionar o ficheiro de imagem OVA do Zoom Node que descarregou.
   1. (Opcional) Arraste e largue o ficheiro de imagem na caixa.

<figure><img src="https://1821044411-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. Clique em **Próximo(a)**.
8. Escolha o volume de armazenamento onde pretende guardar o Zoom Node e clique em **Próximo(a)**.
9. Escolha a rede à qual o servidor ficará ligado.
   1. (Opcional) Se pretender, pode aprovisionar a VM de forma dinâmica.

{% hint style="info" %}
O «aprovisionamento dinâmico» permite que o disco de uma máquina virtual utilize armazenamento físico apenas à medida que os dados são escritos, em vez de reservar antecipadamente o espaço total do disco. Este método poupa espaço, mas pode correr o risco de ficar sem armazenamento se a utilização total crescer mais rapidamente do que a capacidade disponível.
{% endhint %}

<figure><img src="https://1821044411-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. Clique em **Próximo(a)**.
11. Reveja as seleções e clique em **Concluir** para implementar a VM.

A implementação da VM poderá demorar alguns minutos.

Depois de arrancar, a VM terá configurações e detalhes semelhantes aos apresentados na imagem seguinte:

<figure><img src="https://1821044411-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>

A implementação da VM está concluída.

### <mark style="color:azul;">Implementação do Microsoft Hyper-V</mark>

A secção seguinte descreve o método de instalação do Microsoft Hyper-V, que requer o descarregamento e a implementação de uma versão do Zoom Node em ficheiro VHDX.

#### Descarregar o arquivo VHDX do Zoom Node

O arquivo do Zoom inclui a imagem de disco VHDX do Zoom Node e os metadados de configuração da VM.

Para descarregar o arquivo:

1. Inicie sessão no portal Web do administrador do Zoom.
2. Descarregue a imagem **Zoom Node VHDX** a partir do portal de administração do Zoom, acedendo a **Gestão de nós > Módulos > Nó > Adicionar nó**.\\
3. Descarregue o ficheiro VHDX do Zoom Node.
4. Extraia o ficheiro para uma pasta local para utilização temporária.

### <mark style="color:azul;">(Opcional) Criar uma imagem VHDX a partir de uma imagem de disco QCOW2 (KVM) utilizando</mark> <mark style="color:azul;">`qemu-img`</mark> <mark style="color:azul;">no Windows</mark>

Para utilizar uma imagem de disco QCOW2 (KVM) num ambiente Hyper-V, pode convertê-la para o formato VHDX utilizando `qemu-img` no PowerShell.

**Passo 1: Transferir e instalar `qemu-img` para Windows**

1. Aceda ao repositório oficial da Cloudbase:\
   <https://cloudbase.it/qemu-img-windows/>
2. Transfira a versão para Windows do `qemu-img`.
3. Extraia o conteúdo para um diretório conhecido, como: `C:\Users\administrador\Downloads\qemu-img`.

**Passo 2: Converter QCOW2 para o formato VHDX utilizando o PowerShell**

Abra o PowerShell e execute o seguinte comando para converter a imagem:

{% 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 %}

Deverá ver uma indicação de progresso semelhante a:

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

{% hint style="info" %}

* `-f qcow2` especifica o formato de entrada
* `-O vhdx` especifica o formato de saída compatível com o Hyper-V
* `-p` ativa a exibição de uma barra de progresso durante a conversão
* Ajuste os caminhos dos ficheiros conforme necessário para o seu ambiente
  {% endhint %}

**Contexto da implementação e resultado prático**

A conversão para VHDX permite importar imagens Linux personalizadas (como o Ubuntu com agentes ou serviços Zoom pré-instalados) para uma VM Hyper-V. Isto permite criar ambientes de laboratório personalizados, efetuar testes de CI/CD ou desenvolver num ambiente localizado com configurações de sistema consistentes.

#### Implementar uma VM Zoom Node Hyper-V

O Hyper-V suporta a implantação de VMs usando dois métodos principais: o primeiro pela interface gráfica do Gerenciador do Hyper-V e o segundo por meio de scripts do PowerShell. O PowerShell é a maneira mais fácil de automatizar a implantação de vários nós.

Há dois métodos que podem ser usados para implantar a máquina virtual. O método simples, a Opção 1, usa comandos do PowerShell para criar uma nova VM do Zoom Node usando o VMDK com os atributos corretos. A Opção 2 usa a interface gráfica do Gerenciador do Hyper-V para implantar a VM.

Consulte o [Pré-requisitos de infraestrutura do Zoom Node](https://library.zoom.com/technical-library/pt/servicos-empresariais-avancados/zoom-node/zoom-node-deployment-field-guide/zoom-node-infrastructure-prerequisites.md#supported-hypervisors) página de pré-requisitos para mais informações.

{% hint style="info" %}
Para determinadas famílias de módulos (ZPLS, ZRH, Conector de sala na nuvem (CRC) Híbrido), talvez seja necessário ajustar o dimensionamento da VM do Zoom Node. Consulte a documentação específica do módulo para obter os atributos corretos.
{% endhint %}

#### Opção 1 (recomendada): implemente a VM do Zoom Node através do PowerShell

{% hint style="info" %}
Em 2025, o Microsoft PowerShell v5.1 é a versão compatível com o Plugin de gerenciamento do Hyper-V. O PowerShell 7 pode funcionar, mas alguns comandos específicos do Hyper-V não funcionam corretamente.
{% endhint %}

Localize a localização de armazenamento das suas máquinas virtuais Hyper-V. Neste exemplo, o servidor Hyper-V tem máquinas virtuais armazenadas em `D:\!-HyperVMs`.

Os seguintes comandos do PowerShell são usados para criar a VM, anexar a imagem VHDX e personalizar a VM com os atributos corretos.

{% code overflow="wrap" %}

```powershell
# ===========================
# Configuração do Zoom Node VM: Hyper-V
# ===========================

# Edite estes quatro valores
$VMName      = "ZN-PROD-01"
$RootPath    = "D:\!-HyperVMs"  # pasta que irá conter a pasta da VM
$SourceVhdx  = "D:\Downloads\ubuntu22-zoomcommon-build-20250502110711.vhdx"
$SwitchName  = "vSwitch-Production"

# Caminhos derivados
$VMFolder    = Join-Path $RootPath $VMName
$TargetVhdx  = Join-Path $VMFolder "$VMName.vhdx"

# --- Crie uma pasta para a VM e copie o VHDX (clone completo e independente) ---
New-Item -ItemType Directory -Path $VMFolder -Force | Out-Null

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

# --- Criar VM de Geração 2 (ainda sem disco) ---
New-VM `
  -Name $VMName `
  -Generation 2 `
  -MemoryStartupBytes 16GB `
  -Path $VMFolder `
  -NoVHD | Out-Null

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

# --- Memória: 16 GB estáticos (Desabilitar a memória dinâmica) ---
Set-VMMemory -VMName $VMName -DynamicMemoryEnabled:$false -StartupBytes 16GB

# --- Anexar o disco clonado ---
Adicionar-VMHardDiskDrive -VMName $VMName -Path $TargetVhdx

# --- Arranque Seguro + Microsoft UEFI CA + arranque a partir do disco ---
# Habilitar o Arranque Seguro para Linux (Ubuntu) com a Microsoft UEFI CA
Set-VMFirmware -VMName $VMName -EnableSecureBoot On -SecureBootTemplate "MicrosoftUEFICertificateAuthority"

# Obtenha o objeto do disco do sistema e defina-o como o primeiro dispositivo de arranque
$sysDisk = Get-VMHardDiskDrive -VMName $VMName | Where-Object { $_.Path -eq $TargetVhdx }
Set-VMFirmware -VMName $VMName -BootOrder $sysDisk

# --- Rede: ligar ao vSwitch (linha de VLAN opcional comentada) ---
Connect-VMNetworkAdapter -VMName $VMName -SwitchName $SwitchName
# Set-VMNetworkAdapterVlan -VMName $VMName -Acessar -VlanId 123

# --- Comportamento de gestão e pontos de controlo ---
Set-VM -Name $VMName -AutomaticStartAction StartIfRunning -AutomaticStopAction ShutDown
Set-VM -Name $VMName -CheckpointType Production -AutomaticCheckpointsEnabled:$false

# --- Serviços de Integração: Habilitar Interface de Serviço de Convidado ---
$gsi = Get-VMIntegrationService -VMName $VMName -Name 'Convidado Service Interface' -ErrorAction SilentlyContinue
if ($gsi -and -not $gsi.Enabled) {
  Habilitar-VMIntegrationService -VMName $VMName -Name 'Convidado Service Interface'
}

# --- Iniciar a VM (Opcional) ---
Start-VM -Name $VMName

```

{% endcode %}

#### Opção 2: Implemente o VHDX e crie manualmente a máquina virtual

A Opção 2 consiste em criar manualmente a máquina virtual através da implementação do ficheiro VHDX. Este método requer a transferência da imagem do disco do arquivo Zoom Node extraído para a localização de armazenamento designada para máquinas virtuais Hyper-V e a configuração manual das definições da VM.

**Copiar o VMDK para o armazenamento de VMs do Hyper-V**

1. Localize a Localização de armazenamento das suas máquinas virtuais Hyper-V. (Neste exemplo, o servidor Hyper-V tem máquinas virtuais armazenadas em `D:\HyperVMs`.)

   <figure><img src="https://1821044411-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. Crie uma pasta exclusiva para o Zoom Node que está a implementar e, nesse diretório, crie um novo subdiretório chamado **Discos rígidos virtuais**.

   <figure><img src="https://1821044411-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. Copie o ficheiro de imagem VHDX que descarregou do Zoom para o diretório Virtual Hard Disks.
4. Inicie sessão na consola do Microsoft Hyper-V Manager para gerir as VMs.

**Definir a VM**

No Hyper-V Manager, clique em **Novo** e selecione **Máquina virtual** no painel à direita. Isto iniciará o **Assistente de Nova Máquina Virtual**.

1. Conclua o **Especificar um nome e uma Localização** passo:
   1. Inserir um nome para a máquina virtual.
   2. (Opcional) Escolher uma Localização de armazenamento. É comum guardar os ficheiros de configuração da VM na mesma pasta que o disco virtual da VM.
   3. Marque a caixa «Armazenar a máquina virtual numa Localização diferente» e clique em **Procurar**.

<figure><img src="https://1821044411-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. Aceda à pasta de armazenamento da VM que criou anteriormente.

<figure><img src="https://1821044411-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. Selecionar a pasta.
4. Clique em **Próximo(a)**.
5. Conclua o **passo Especificar geração** :
   1. Selecionar a opção **Geração 2** através do botão de opção
   2. Clique em **Próximo(a)**

<figure><img src="https://1821044411-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. Conclua o **passo Atribuir memória** :
   1. No campo **Memória de arranque:** Inserir `16384` (MB)
   2. (Opcional) Marque a opção «Utilizar memória dinâmica para esta máquina virtual» para reduzir a RAM atribuída
   3. Clique em **Próximo(a)**

<figure><img src="https://1821044411-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. Conclua o **passo Configurar rede** :
   1. Clique no menu pendente **Ligação:** e, em seguida, deve Selecionar um comutador virtual para ligar a VM à rede. A escolha depende do seu ambiente de rede Hyper-V.

<figure><img src="https://1821044411-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. Clique em **Próximo(a)**.

**Ligar a imagem de disco VHDX**

Em seguida, no Assistente de Nova Máquina Virtual, conclua o **passo Ligar disco rígido virtual** . Para ligar a imagem:

1. Selecionar a opção **Utilizar um disco rígido virtual existente** através do botão de opção.

<figure><img src="https://1821044411-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. Clique em **Procurar** e localize a pasta da VM que criou anteriormente.\\

   <figure><img src="https://1821044411-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. Na janela de seleção de ficheiros, clique em **Abrir**.
4. Clique em **Próximo(a)**.
5. Reveja as Configurações e clique em **Concluir** para criar a VM com o disco VHDX anexado.\\

   <figure><img src="https://1821044411-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" %}
Não inicie a VM ainda.
{% endhint %}

**Configurar Configurações adicionais da VM**

Para Configurar Configurações adicionais:

1. Clique com o botão direito do rato na VM implementada e, no menu, deve Selecionar **Configurações...**.\\

   <figure><img src="https://1821044411-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. Na categoria de **hardware** à esquerda da tela, clique em **Segurança**.
3. No lado direito da tela, sob o título **Segurança** , clique na lista suspensa **Modelo:** .
4. Selecionar a opção **Autoridade de certificado UEFI da Microsoft** .\\

   <figure><img src="https://1821044411-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. Clique em **Aplicar**.
6. Na categoria de **hardware** à esquerda da tela, clique em **Processador**.
7. No lado direito da tela, sob o título **Processador** , defina o valor da caixa **Número de processadores virtuais:** como `8` (processadores virtuais).\\

   <figure><img src="https://1821044411-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" %}
Esse é o valor padrão necessário para que o Zoom Node execute quatro (4) módulos. Consulte a [Pré-requisitos de infraestrutura do Zoom Node](https://library.zoom.com/technical-library/pt/servicos-empresariais-avancados/zoom-node/zoom-node-deployment-field-guide/zoom-node-infrastructure-prerequisites.md#deployment-sizing-and-capacity-planning-matrix) para obter mais informações sobre como redimensionar a VM ao executar menos módulos.
{% endhint %}

8. Clique em **OK** para aceitar as alterações.

**Iniciar a máquina virtual**

Para iniciar a VM:

1. Selecionar a VM recém-criada no Gerenciador do Hyper-V.
2. No painel **Ações** à direita da tela, clique em **Iniciar**.
3. Clique em **Conectar** para abrir a janela do console da VM.\\

   <figure><img src="https://1821044411-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>

Uma sequência de inicialização bem-sucedida da VM irá Mostrar a tela de inicialização do Linux. Na etapa Próximo(a), a interface de texto do Zoom Node será carregada.

{% hint style="info" %}
Se uma mensagem de erro UEFI aparecer ao tentar inicializar, talvez você não tenha definido o método de inicialização segura como "Autoridade de certificado UEFI".

<img src="https://1821044411-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:azul;">Implantações com KVM</mark>

A seção a seguir descreve o método de instalação Kernel-based Virtual Machine (KVM), que permite instalar o Zoom Node por meio do Proxmox VE ou do KVM Virtual Machine Manager (Virt-manager).

#### KVM Proxmox Virtual Environment (VE)

A implantação do Zoom Node no Proxmox VE usando a imagem qcow2 exige etapas adicionais em comparação com a implantação de uma imagem ISO. As etapas a seguir criarão uma nova VM configurada para que a imagem qcow2 do Zoom Node possa ser anexada a ela.

{% hint style="info" %}
Uma implantação padrão do QEMU/KVM usa o NAT do hipervisor e um conjunto de endereços IP privados para implantar VMs gerenciadas pelo KVM. Essa arquitetura não é compatível com o Zoom Node. Embora seja possível implantar e executar um Zoom Node por trás do NAT do hipervisor, os clientes na rede não poderão se comunicar com ele corretamente. O Zoom Node deve ser implantado em uma interface em ponte para que tenha um endereço IP na faixa com a qual os clientes possam se comunicar.
{% endhint %}

**Definir a máquina virtual do Zoom Node**

Para definir a VM:

1. Faça login na interface do aplicativo de gerenciamento do Proxmox.
2. Clique no botão **Criar VM** . Esta será a VM de modelo do Zoom Node.
3. Dê um nome à VM e **guarde o ID da VM**.
   1. Estas informações serão utilizadas numa etapa posterior.
4. Clique em **Próximo(a)** para continuar.
5. Selecione **Não utilize qualquer suporte multimédia** na página de configurações do SO.
6. Clique em **Próximo(a)**.
7. Escolha a `q35` opção em **Configurações da máquina** .
   1. Para o tipo de **BIOS** , selecione **OVMF (UEFI)** e escolha o volume onde pretende armazenar as configurações EFI. Este é definido como o mesmo volume da VM utilizado para armazenar a própria VM.

{% hint style="info" %}
É fundamental definir as configurações de máquina e BIOS conforme descrito. Caso contrário, a VM não iniciará corretamente.
{% endhint %}

8. Clique em **Próximo(a)**.
9. Na página **Discos** , selecione o volume de armazenamento a partir do qual a VM será executada.
10. Defina **Tamanho do disco (GiB)** como `200`.
11. Escolha **Write-Through** para a Cache.
12. Clique em **Próximo(a)**.
13. Altere a configuração **Núcleos** para `8`.
14. Clique em **Próximo(a)**.
15. Ajuste a configuração **Memória (GiB)** para `16384`.
16. Clique em **Próximo(a)**.
17. Escolha as configurações de rede adequadas para a sua implementação, normalmente uma interface de bridge com uma etiqueta VLAN.
18. Clique em **Próximo(a)**.
19. Na página **Confirmar** , certifique-se de que a caixa de seleção **Iniciar após a criação** não está selecionada.
20. Verifique novamente as configurações, prestando atenção a `q35` como tipo de máquina e `omvf` como tipo de BIOS.
21. Clique em **Concluir** após verificar se as Configurações estão corretas.
22. Faça login no [portal de administração do Zoom na web](https://zoom.us/) como administrador em <https://zoom.us>.

**Preparar a imagem QCOW2 do Zoom Node**

Para preparar a imagem:

1. No portal de administração do Zoom, acesse **Zoom Node > Módulos > Nós > Adicionar nó**.
2. Baixe a versão atual do **arquivo de imagem qcow2 do Zoom Node**.
3. Copie o arquivo para um diretório acessível pelo Proxmox, como um volume NFS.
   1. (Opcional) Copie-o para o volume do servidor Proxmox onde as VMs estão armazenadas.
4. Observe a criação do diretório `111` e da imagem de disco vazia.
5. Anote o nome da imagem de disco nesta pasta
   1. Exemplo: `vm-111-disk-0.qcow2`.
6. Exclua o arquivo de imagem de disco.
7. Copie o arquivo **qcow2 do Zoom Node** para este diretório.
8. Renomeie esse arquivo com o nome original da imagem de disco anotado anteriormente (ou seja, `vm-111-disk-0.qcow2`).
9. Retorne à interface web principal do Proxmox e use Selecionar na VM que acabou de ser implantada.
10. Clicar com o botão direito na VM selecionada e Escolher **clonar** a VM.
11. Transforme o clone em um modelo, dando-lhe um nome e clicando em **Clonar**.
12. Após a conclusão da clonagem, Clicar com o botão direito no clone e usar Selecionar em **Converter em modelo**.
    1. Agora você tem um modelo pronto para implantação.
13. Use Selecionar na VM original e clique para abrir o **Console**.
14. Inicie a VM clicando no botão **Iniciar agora** .

Confirme que a VM inicializa e exibe a interface textual local de usuário do Zoom Node, verificando assim se o modelo pode ser usado em implantações futuras.

#### Gerenciador de máquinas virtuais KVM (Virt-manager)

O Virtual Machine Manager (também conhecido como virt-manager) é um gerenciador de máquinas virtuais QEMU/KVM baseado em aplicativo bastante popular.

Este exemplo de implantação usa o Virtual Machine Manager no Ubuntu 22.04 LTS. No entanto, ele pode ser executado em várias distribuições Linux.

Uma implantação padrão do QEMU/KVM usa o NAT do hipervisor e um conjunto de endereços IP privados para implantar VMs, gerenciados pelo KVM. Esta **não** é uma arquitetura compatível com o Zoom Node.

{% hint style="info" %}
Embora seja possível implantar e executar um Zoom Node atrás do NAT do hipervisor, os clientes na rede não conseguirão se comunicar corretamente. Para garantir a comunicação adequada dos clientes, implante o Zoom Node em uma interface em ponte que corresponda ao intervalo de endereços IP dos clientes.
{% endhint %}

Para instalar usando o método virt-manager:

1. Faça login no [portal de administração do Zoom na web](https://zoom.us/) como administrador.
2. Transfira a versão atual do **ficheiro de imagem qcow2 do Zoom Node** a partir do portal de administração do Zoom Node, selecionando **Zoom Node > Módulos > Nós > Adicionar nó**.
3. Mude o nome do ficheiro para o nome pretendido para a máquina virtual ou o disco.
   1. Exemplo: `ZN-SJC01-NODE01.qcow2`.
4. Mova o ficheiro para um volume a que o Virtual Manager tenha acesso.
5. Crie uma nova máquina virtual no Virtual Manager.
6. Clique em **Importar imagem de disco existente**.
7. Selecione o volume onde guardou a imagem qcow2 cujo nome alterou.
8. Clique no botão **Escolher volume** .
   1. (Opcional) Se ainda não tiver adicionado o diretório correto ao virt-manager, pode clicar em **Procurar localmente** para o adicionar.
9. (Opcional) Se o SO não for detetado automaticamente, defina-o como **Ubuntu 22.04 LTS**.
10. Altere a configuração da RAM para `16384 MB` (16 GB) e a configuração da CPU para `8 CPUs`.
    1. Estas configurações permitem que o Zoom Node execute quatro (4) módulos.

{% hint style="info" %}
Pode ajustar estes valores, mas os ajustes podem afetar a capacidade e o desempenho do Zoom Node. Se estiver a executar apenas um módulo no Zoom Node, pode definir a RAM como 6 GB e o número de CPUs como 3, os valores mínimos absolutos.
{% endhint %}

11. Insira um nome para o Node.
12. **Clique em Personalizar configuração antes da instalação**.

{% hint style="danger" %}
Se não efetuar esta configuração, o Node não arrancará. É necessário modificar definições adicionais.
{% endhint %}

13. Certifique-se de que o dispositivo de rede esteja definido como **Ethernet em ponte** e não como NAT.

{% hint style="info" %}
A implantação de um Zoom Node atrás de um NAT no KVM impedirá que os clientes se comuniquem com ele.
{% endhint %}

14. Quando o **Detalhes da VM** painel for aberto, altere o **Chipset** para **Q35**.
15. Altere o **Firmware** para **UEFI**.

{% hint style="warning" %}
O Zoom Node não arranca sem a definição UEFI.
{% endhint %}

16. Clique em **Aplicar**.
17. Clique em **Iniciar instalação** na parte superior do menu da faixa de opções para implementar a VM.

A VM será iniciada e começará a arrancar. Quando a VM original tiver arrancado, saberemos que o modelo que criámos está oficialmente pronto a ser utilizado.

### <mark style="color:azul;">Implementações do Nutanix AHV</mark>

O Zoom Node pode ser executado como uma máquina virtual (VM) no Nutanix AHV. O Zoom Node é implantado em um datacenter para operar os serviços híbridos do Zoom, também chamados de módulos de serviço, como Meetings Hybrid, Recording Hybrid, Chat Hybrid e Phone Local Survivability.

Esta secção aborda a instalação da VM do SO Zoom Node nas versões 6.8.1 a 7.0.1 do Nutanix AHV.

#### Requisitos gerais do hipervisor e da máquina virtual

O [Pré-requisitos de infraestrutura do Zoom Node](https://library.zoom.com/technical-library/pt/servicos-empresariais-avancados/zoom-node/zoom-node-deployment-field-guide/zoom-node-infrastructure-prerequisites.md)A página apresenta os pré-requisitos de hardware e software necessários para a implementação.

#### Implementação do Zoom Node

A implementação do Zoom Node requer o descarregamento de uma imagem, a importação da imagem para o AHV e a criação de uma VM.

**Baixe o arquivo de imagem do Zoom Node**

Para descarregar o ficheiro de imagem:

1. Inicie sessão no [Portal Web de administração do Zoom](https://zoom.us/).
2. Transfira a **imagem QCOW2 do Zoom Node** a partir do portal de administração do Zoom, selecionando **Gestão de nós > Módulos > Nó > Adicionar nó**.\\

   <figure><img src="https://1821044411-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. Transfira a **imagem QCOW2** clicando no botão **Transferir** .

{% hint style="info" %}
O AHV pode importar imagens QCOW2 ou .ova/VMDK. Pode utilizar qualquer uma delas, mas a Zoom recomenda a imagem QCOW2. Este formato pode ser carregado diretamente, sem necessidade de descompactar um ficheiro .ova para extrair o VMDK.
{% endhint %}

**Importar a imagem Zoom Node para o AHV**

1. Inicie sessão na consola Nutanix AHV acedendo a `https://<cluster hostname>:9440`.
2. Clique em **Início** Menu suspenso e selecione **Configurações** na lista.

<figure><img src="https://1821044411-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. Reveja o **Configurações** página.

<figure><img src="https://1821044411-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. No lado esquerdo da tela, clique em **Configuração da imagem**. A caixa de diálogo de carregamento de imagem de disco é apresentada.

<figure><img src="https://1821044411-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. Clique no botão + Carregar imagem.

<figure><img src="https://1821044411-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. Insira as informações pretendidas nos campos de texto da caixa de diálogo Criar imagem.
   1. A anotação é um campo Opcional.
   2. Clique em **Tipo de imagem** menu pendente e selecione **DISK**.
   3. Clique no **Contentor de armazenamento** menu pendente e selecione a opção adequada ao seu ambiente.
7. Clique no **Carregar um ficheiro** botão de opção e, em seguida, clique em **Procurar...**.
8. Selecione a imagem QCOW2 que transferiu anteriormente.
9. Clique em **Guardar** para começar a carregar a imagem.

<figure><img src="https://1821044411-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>

O progresso do carregamento será apresentado na faixa azul.

{% hint style="danger" %}
Mantenha a janela ou o separador atual do navegador aberto para garantir que o carregamento é concluído. Não tente navegar para outra área da interface AHV enquanto o carregamento estiver ativo.
{% endhint %}

Quando o carregamento estiver concluído, o processo de atualização da imagem será iniciado. Clique no ícone intermitente do estado da tarefa no menu da faixa para acompanhar o progresso.

<figure><img src="https://1821044411-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>

A conclusão do processo de importação pode demorar vários minutos. Quando terminar, a imagem aparece na lista com o estado **ATIVO** :

<figure><img src="https://1821044411-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" %}
A imagem de disco do Zoom Node ocupa aproximadamente 200 GB após a importação.
{% endhint %}

**Criar a máquina virtual do Zoom Node**

Em seguida, vai criar a máquina virtual. Para criar a VM:

1. Clique no menu **Configurações** pendente e selecione **VM**.

   <figure><img src="https://1821044411-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. No ecrã da VM, clique em **+ Create VM** no lado direito do ecrã.

   <figure><img src="https://1821044411-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. Insira um **Nome**, **Descrição** (opcional) e selecione o **Fuso horário**.
4. Em **Detalhes de computação**, insira as especificações de computação.\\

   <figure><img src="https://1821044411-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" %}
Conforme apresentado acima, o Zoom Node requer 8 núcleos vCPU para uma implementação de produção. A Zoom recomenda que a contagem de sockets das definições de vCPU corresponda à do servidor físico. As definições seguintes cumprem os requisitos de uma implementação padrão:

* Defina o campo **vCPU(s)** com o mesmo número de sockets do servidor em que o Nutanix AHV está a ser executado. Num servidor típico com dois sockets, defina este valor como **2**.
* Defina **Número de núcleos por vCPU** como **4**, o que corresponde a **8 vCPUs**.
* Defina a **Memória** (RAM) como **16** GB.
* Em **Configuração de arranque**, selecione **UEFI**.
  {% endhint %}

{% hint style="danger" %}
O Zoom Node NÃO será iniciado se a opção UEFI não estiver selecionada.
{% endhint %}

5. É apresentada uma caixa de diálogo de aviso. Clique em **OK** para confirmar.\\

   <figure><img src="https://1821044411-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. Desloque-se para baixo até à secção **Discos** secção.\\

   <figure><img src="https://1821044411-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. Clique em **+ Adicionar novo disco** para criar um disco para o Zoom Node executar.\\

   <figure><img src="https://1821044411-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. Em **Tipo** na lista pendente, selecione **DISK**.
9. Em **Operação** lista pendente, Selecionar **Clonar a partir do Image Service**.\\

   <figure><img src="https://1821044411-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. Em **Imagem** na lista pendente, selecione o nome da imagem que criou quando importou anteriormente o disco do Zoom Node.
11. Clique em **Adicionar**.
12. Desloque-se para baixo até à **secção Adaptadores de rede (NIC)** secção.\\

    <figure><img src="https://1821044411-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. Clique em + Adicionar Nova NIC.\\<br>

    <figure><img src="https://1821044411-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. Em **Nome da sub-rede** menu pendente, selecione a opção com acesso IP direto.

{% hint style="info" %}
Como lembrete, o NAT do hipervisor não é suportado.
{% endhint %}

15. Em **Estado da ligação de rede**, selecione **Ligado**.
16. Clique em **Adicionar**.\\

    <figure><img src="https://1821044411-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. Clicar **Guardar** para criar a VM.

**Ligar a nova VM do Zoom Node**

O novo Node aparecerá na lista de VMs. Pode escolher a vista Tabela para ver mais facilmente uma lista de VMs.

<figure><img src="https://1821044411-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>

Clique com o botão direito do rato na nova VM que criou e selecione **Ligar**.

<figure><img src="https://1821044411-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>

A VM começará a arrancar após alguns segundos.

Clique novamente com o botão direito do rato na VM e selecione **Iniciar consola** para interagir com a VM.

{% hint style="info" %}
Será aberta uma janela pop-up. Se não a vir, poderá ter de permitir pop-ups para o AHV nas Configurações do navegador.
{% endhint %}

Depois de iniciado, o processo de implementação do Zoom Node no Nutanix AHV estará concluído.

#### Gerir o Zoom Node

Para obter mais informações sobre como gerir os seus Zoom Nodes ativados, consulte o artigo do Suporte do Zoom. [Gerir servidores e módulos do Zoom Node](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063730).

### <mark style="color:azul;">Implementações do AWS EC2</mark>

{% hint style="info" %}
A AMI do Zoom Node ainda não está Disponível no Zoom App Marketplace. Atualmente, é necessário criar uma AMI manualmente. Esse processo precisa ser realizado uma vez para a conta da AWS.

Pode ignorar esta secção se a sua conta já tiver a AMI do Zoom Node criada e pretender apenas implementar uma nova instância do Zoom Node.
{% endhint %}

#### Pré-requisitos

O [Pré-requisitos de infraestrutura do Zoom Node](https://library.zoom.com/technical-library/pt/servicos-empresariais-avancados/zoom-node/zoom-node-deployment-field-guide/zoom-node-infrastructure-prerequisites.md)A página apresenta os pré-requisitos de hardware e software necessários para a implementação.

#### Transferir a imagem OVA

1. Transfira a imagem OVA mais recente do Zoom Node a partir do portal Web de administração do Zoom, acedendo a **Portal de administração > Zoom Node > Módulos > Nós > Adicionar nós**.

<figure><img src="https://1821044411-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. Transfira a imagem OVA do VMWare e anote o nome. O ficheiro tem cerca de 5 GB e a transferência pode demorar algum tempo.
3. Extraia o ficheiro OVA para um diretório de trabalho. (No Windows, utilize o PowerShell para aceder ao comando tar.)
   1. Escreva: `tar xvf <Zoom Node>.ova`
   2. O resultado será semelhante a este:\\

      <figure><img src="https://1821044411-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. Anote o nome do ficheiro .vmdk. Neste exemplo, é: `ubuntu22-zoomcommon-build-go-20240418014859-disk-0.vmdk`.
4. Carregue o ficheiro .vmdk para um bucket do S3. Utilize a interface Web da AWS ou, de preferência, a CLI da AWS para garantir a consistência dos nomes dos ficheiros .vmdk.
   1. Insira o seguinte comando para copiar o ficheiro para o AWS S3: `aws s3 cp ubuntu22-zoomcommon-build-go-20240418014859-disk-0.vmdk s3:///node3.4.vmdk`.
   2. Consoante a velocidade da ligação à Internet, o carregamento pode demorar desde alguns minutos até várias horas. O ficheiro tem aproximadamente 5 GB.\\

      <figure><img src="https://1821044411-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" %}
O comando anterior muda o nome do ficheiro no S3 para um nome mais fácil de utilizar, `node3.4.vmdk` para facilitar a utilização durante a importação.

Por exemplo, se o bucket do S3 se chamar `vhd-import-bucket` o comando seria: `aws s3 cp ubuntu22-zoomcommon-build-go-20240418014859-disk-0.vmdk s3://vhd-import-bucket/node3.4.vmdk`.
{% endhint %}

5. Prepare um ficheiro JSON com os seguintes detalhes, que descrevem a imagem de disco que está a importar:

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

{% hint style="info" %}
Este código identifica a importação da imagem `node3.4.vmdk` atualmente armazenada num bucket do S3 como a versão 3.4 do Zoom Node.
{% endhint %}

6. Importe a imagem .vmdk do Zoom Node como um **Snapshot**.

{% hint style="warning" %}
Tem de importar o disco como um Snapshot e **não** como uma imagem.
{% endhint %}

7. Insira o seguinte comando: `aws ec2 import-snapshot --disk-container file://.json`.
8. (Opcional) Se o ficheiro JSON se chamar `node.json`, insira o seguinte comando: `aws ec2 import-snapshot --disk-container file://node.json`.
9. Verifique o campo `StatusMessage:` para confirmar o estado “pending” quando a importação começar.\\

   <figure><img src="https://1821044411-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" %}
A conclusão da importação pode demorar 20 minutos ou mais.
{% endhint %}

10. Verifique o resultado da CLI para consultar o valor de `ImportTaskId` .
    1. No exemplo acima, o valor de `ImportTaskId` é `import-snap-f8d845596565b0c3t`. Este valor verifica periodicamente o estado da tarefa.
    2. Insira o seguinte comando: `aws ec2 describe-import-snapshot-tasks --import-task-ids <ImportTaskId>` em que `ImportTaskId` é o valor exclusivo determinado no passo acima.
    3. Deverá aparecer o seguinte resultado, com o seu valor de `ImportTaskId` preenchido:\\

       <figure><img src="https://1821044411-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. Tenha em atenção que o estado atual da tarefa é “downloading/converting”, o que significa que a tarefa ainda está a processar o ficheiro. O campo `Progress: <##>,` indica a percentagem de conclusão. No exemplo acima, o valor `19` corresponde a 19% de conclusão.
    5. Verifique o campo `Status:` para confirmar que a tarefa foi concluída:\\

       <figure><img src="https://1821044411-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>

#### Converter o snapshot numa imagem de máquina da Amazon (AMI)

1. Inicie sessão no painel do EC2 da Consola da AWS.\\

   <figure><img src="https://1821044411-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. No lado esquerdo da tela, no menu pendente **Elastic Block Store** clique em **Snapshots**.\\

   <figure><img src="https://1821044411-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. Clique na **ligação do ID do snapshot** para ver os respetivos detalhes.\\

   <figure><img src="https://1821044411-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. Clique no botão do menu pendente **Ações** no canto superior direito da tela e selecione **Criar imagem a partir do snapshot**.
5. É apresentada a janela **Configurações da imagem** .
6. Insira um **Nome da imagem** para a AMI.
   1. Exemplo: **Zoom Node 3.4 AMI**.
7. (Opcional) Insira uma descrição.\\

   <figure><img src="https://1821044411-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. Desloque a janela para baixo para ver definições adicionais.
9. Confirme que o volume de disco atribuído de 189 GB é apresentado em **Tamanho (GiB)**.\\

   <figure><img src="https://1821044411-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. No menu pendente **Modo de arranque** selecione **UEFI**.

#### Implementar instâncias do Zoom Node no AWS EC2

1. Inicie sessão no painel do EC2 da Consola da AWS.\\

   <figure><img src="https://1821044411-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. No lado esquerdo da tela, abaixo de **Instâncias** no menu pendente, clique em **Instâncias**.
3. Crie uma nova instância usando a AMI do Zoom Node.
4. Insira um nome para a instância.

<figure><img src="https://1821044411-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. Em **Imagens de aplicativos e SO (Amazon Machine Image)** clique na seção **Minhas AMIs** aba.
6. Procure a AMI do Zoom Node que acabou de criar e à qual deu um nome.\\

   <figure><img src="https://1821044411-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. Clique na AMI que criou para definir vários parâmetros.
8. Na secção **Tipo de instância** clique na **Tipo de instância** lista pendente e selecione **t3.medium**.

<figure><img src="https://1821044411-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" %}
Para implementações de produção, o Zoom Node requer 8 vCPU e 16 GB de RAM. Em contrapartida, os ambientes de laboratório podem funcionar com 2 vCPU e 4 GB de RAM, sendo recomendada uma instância t3.medium. Se o Zoom Meetings Hybrid estiver a ser executado no sistema, provavelmente será necessária uma instância t3.large para suportar mais do que alguns utilizadores numa reunião.
{% endhint %}

9. Em **Par de chaves (início de sessão)** seção, clique em **Nome do par de chaves** na lista suspensa e, em seguida, Selecionar **Prosseguir sem um par de chaves (não recomendado)**.

   1. É necessário omitir o par de chaves porque o SSH não está habilitado no Zoom Node para acesso ao console.

   <figure><img src="https://1821044411-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. Em Configurações de rede, Configurar as seguintes opções:
    1. Em **VPC - obrigatório**, Escolher uma VPC que permita aos seus aplicativos Zoom Workplace acesso direto por roteamento L3.
    2. Em **Sub-rede**, Escolher a sub-rede onde esta VM irá operar.\\

       <figure><img src="https://1821044411-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. **O Zoom Node requer comunicações Realizadas com a nuvem Zoom**. Tem de fornecer um endereço IP público.
    4. Selecionar **Habilitar** a partir do **Atribuir automaticamente um IP público** campo.
    5. Crie um **Grupo de segurança** permitindo o acesso de entrada do aplicativo Zoom Workplace na porta necessária.
    6. Use as regras de firewall documentadas no artigo de suporte do Zoom [Regras de firewall do servidor de gerenciamento do Zoom Node](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0066766).\\

       <figure><img src="https://1821044411-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" %}
O acesso de entrada à Internet não é necessário para o Zoom Node, exceto quando o acesso direto à mídia de fontes externas está ativado (uma implementação Opcional do Conector de reunião ou para fornecer acesso externo de usuários ao Zoom Meetings Hybrid - Private Meetings).
{% endhint %}

11. Clique em **Detalhes avançados**.
12. Clique em **Versão dos metadados** lista suspensa e Selecionar **Apenas V2 (token obrigatório)**.\\

    <figure><img src="https://1821044411-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" %}
Você deve definir a versão dos metadados como V2; caso contrário, a implantação falhará.
{% endhint %}

#### (Opcional) Pré-Configurar o Zoom Node

As Configurações do SO do Zoom Node, como Configurações de rede, nome do host, senhas locais e códigos de inscrição de 16 dígitos, podem ser configuradas automaticamente usando a seção **Dados do usuário -&#x20;*****Opcional*** no AWS EC2.

Quando o Zoom Node iniciar, ele obterá essas informações pré-configuradas do AWS EC2 (servidor IDMSv2) e irá Configurar o Node automaticamente, conforme mostrado na imagem a seguir:

<figure><img src="https://1821044411-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>

Use o código abaixo para criar um novo arquivo de dados do usuário:

```yaml
#custom-config
hostname: zn-ec2
senha: ZoomNodepassword1234
inscrição_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
      servidores de nomes:
        addresses:
          - 1.1.1.1
```

Depois de carregar o ficheiro de dados do usuário para o AWS EC2, implemente a instância clicando em **Iniciar instância**.

<figure><img src="https://1821044411-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>

#### Rever uma instância implementada

<div align="center"><figure><img src="https://1821044411-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>

Clique na **ligação do ID da instância** (i-06e4592fd2d91ef3f, conforme mostrado na imagem acima) para encontrar o **endereço IP interno** atribuído ao Node.

<figure><img src="https://1821044411-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>

O Node demora alguns minutos a arrancar e a iniciar uma interface gráfica local na Web.

Nos primeiros 10 minutos após iniciar a instância, abra um navegador e insira o **Endereços IPv4 privados** indicado (`10.10.130.223` na imagem acima).

Por exemplo: `https://<10.10.130.223>:8443`.

Aceite o aviso de certificado inválido que aparece. O portal de administração local do Zoom Node é apresentado e pede-lhe uma senha.

<figure><img src="https://1821044411-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>

Clique na ligação **Definir senha** para configurar uma senha de administrador.

O nome de usuário é sempre `zoom-setup`.

{% hint style="info" %}
A ligação «Definir senha» só fica visível durante os primeiros 10 minutos após a VM arrancar. Se não estiver visível, reinicie a VM para voltar a disponibilizar esta opção.
{% endhint %}

Agora que a implementação está concluída, pode continuar a configuração seguindo as instruções que começam na [Configuração e gerenciamento pós-implementação do Zoom Node](https://library.zoom.com/technical-library/pt/servicos-empresariais-avancados/zoom-node/zoom-node-deployment-field-guide/zoom-node-post-deployment-configuration-and-management.md#network-configuration)etapas da [Configuração e gerenciamento pós-implementação do Zoom Node](https://library.zoom.com/technical-library/pt/servicos-empresariais-avancados/zoom-node/zoom-node-deployment-field-guide/zoom-node-post-deployment-configuration-and-management.md) página.


---

# 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/pt/servicos-empresariais-avancados/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.
