> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexxible.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Wake on LAN

Wake on LAN (WoL) é um padrão de rede que permite ligar dispositivos remotamente através de Ethernet, desde que o hardware e a configuração do sistema o suportem.

O WoL permite ligar dispositivos físicos de forma automática, programada ou sob demanda, utilizando como ponte outro dispositivo com FlexxAgent instalado disponível na rede. Este será o encarregado de enviar o pacote mágico (Magic Packet) necessário para ativar o dispositivo de destino dentro da rede local.

## Requisitos

* Placa de rede compatível.
* Ativar WoL na BIOS/UEFI.
* Configurar WoL no sistema operacional.
* Um dispositivo ponte —com FlexxAgent instalado e reportando— na mesma rede que o dispositivo que se deseja ligar.

<Info>
  O WoL normalmente opera dentro de uma rede local e pode funcionar entre sub-redes, desde que não existam restrições impostas por firewalls ou dispositivos de rede que bloqueiem a transmissão do pacote mágico. Em ambientes com segmentação por sub-redes, é necessário configurar exceções em nível de rede que permitam o roteamento do pacote mágico entre essas sub-redes.
</Info>

## Configurar WoL no Windows

Para configurar o WoL em um dispositivo com sistema operacional Windows, siga as seguintes etapas:

1. **Verificar se o WoL está ativo.**

Na janela do CMD, executar o seguinte comando:

`powercfg /devicequery wake_programmable`

2. **Ativar WoL.**

Executar o comando:

`powercfg /deviceenablewake "Realtek PCIe GbE Family Controller"`

> Substituir "Realtek PCIe GbE Family Controller" pelo nome do controlador correspondente.

## Ações disponíveis

Quando a funcionalidade for corretamente habilitada e configurada, as seguintes ações estarão disponíveis:

* Programar o ligamento em Grupos de workspaces
* Programar o ligamento após a aplicação de atualizações
* Configurar dispositivos para Wake on LAN (WoL) em Grupos de relatório

### Programar o ligamento em Grupos de workspaces

1. Acessar **Workspaces** → **Grupos de workspaces**.
2. Selecionar o grupo de workspaces sobre o qual se deseja programar o ligamento.
3. Clicar na aba **Programação**.
4. Clicar no botão **Novo** e preencher o formulário.
   * **Ação.** Permite escolher entre *Wake on LAN* ou *Desligar*. Se a primeira opção for selecionada, na parte inferior do formulário será possível ativar **Usar Workspace específico para WoL**, para programar o ligamento em um dispositivo determinado.
   * **Dia da semana.** Dia da semana em que a ação será realizada.
   * **Hora UTC.** Hora exata para iniciar a ação.
5. Clicar em **Novo**.

<img src="https://mintcdn.com/flexxible/OlbpoHQcny_-uUZx/images/features/sched.png?fit=max&auto=format&n=OlbpoHQcny_-uUZx&q=85&s=75f573bdb156e6685231c8813f56389b" alt="sched" width="403" height="600" data-path="images/features/sched.png" />

Os dados inseridos serão refletidos na tabela, além do e-mail do usuário que criou e atualizou a programação. A partir de **Ver detalhe** é possível editar e excluir a ação programada.

### Programar o ligamento após a aplicação de atualizações

1. Acessar **Workspaces** → **Atualizações** → **Destinatários**.
2. Na tabela, escolher o destinatário.
3. Na aba **Detalhes**, clicar no botão **Editar**.
4. Ativar a opção **Wake on LAN (WoL)** no formulário.
5. Clicar em **Salvar**.

<img src="https://mintcdn.com/flexxible/OlbpoHQcny_-uUZx/images/features/edit-patch-policy.png?fit=max&auto=format&n=OlbpoHQcny_-uUZx&q=85&s=f612cca190f9eed6dbbd9d45a0af0897" alt="edit-patch-policy" width="597" height="504" data-path="images/features/edit-patch-policy.png" />

### Configurar dispositivos para Wake on LAN (WoL) em Grupos de relatório

Essa funcionalidade permite definir os dispositivos específicos que executarão o ligamento automático via Wake on LAN (WoL) nos grupos de relatório selecionados.

#### Configuração

É possível configurar até três dispositivos para a execução do WoL, caso o processo falhe em algum deles.

1. Acessar **Configuração** → **Grupos de relatório**.
2. Na tabela, selecionar um (ou vários) grupos de relatório.
3. Clicar em **Configurar workspaces para WoL**.
4. No formulário, selecionar os dispositivos preferenciais que se encarregarão de ligar os equipamentos via WoL.
5. Clicar em **Salvar** para aplicar as alterações.

<img src="https://mintcdn.com/flexxible/BrDSW2F1WXuPf1cA/images/features/rg-wol.png?fit=max&auto=format&n=BrDSW2F1WXuPf1cA&q=85&s=d6f5118cd7570cdefa3304ec60e4d54d" alt="rg-wol" width="999" height="451" data-path="images/features/rg-wol.png" />

<Warning>
  Quando são selecionados vários grupos de relatório e um ou mais dos três campos do formulário são deixados vazios, estes serão salvos como vazios também nos grupos que tinham valores previamente configurados.
</Warning>

#### Remover a configuração de dispositivos WoL

Para remover os dispositivos associados à configuração de WoL:

1. Selecionar novamente o grupo de relatório correspondente.
2. Clicar em **Configura workspaces para WoL**.
3. Deixar os três campos sem valores.
4. Clicar em **Salvar** para confirmar a remoção.
