#rev 2022-12-02 stroth

= Wake on LAN (WOL) =
Powered-off managed Windows and Linux workstations can be ''woken'' (switched on) by remote with the Linux command line tool `reveil`.
 * '''staff''' or '''guest''' members of a D-ITET institute or D-BAUG VAW may wake their institute's workstations
 * '''students''' may wake workstations in [[Workstations/ComputerRooms|student computer rooms]]
 * The tool can only be invoked on the Linux host `login.ee.ethz.ch`
 * `login.ee.ethz.ch` is accessible from outside the ETH network with an ''ssh client''.<<BR>>
 An ''ssh client'' is typically pre-installed on Linux, macOS or Windows with the [[https://learn.microsoft.com/en-us/windows/wsl/install|Windows Subsystem for Linux (WSL) installed]].<<BR>>
 As an alternative to WSL, the standalone client [[https://computing.ee.ethz.ch/WindowsDirectSSHAccess|putty]] can be used.

== Usage ==
 1. Log in to `login.ee.ethz.ch` with your ETH credentials: {{{
ssh <ETH username>@login.ee.ethz.ch }}}
 1. List all hosts you are allowed to wake from sleep: {{{
reveil -l }}}
 1. Wake the host(s) you want to access: {{{
reveil <host1> }}}
⚠ Be responsible and don't wake workstations you don't need to access. The workstations are switched off to save power.

== About reveil ==
Usage information of `reveil` can be shown by issuing the following command: {{{
ssh <ETH username>@login.ee.ethz.ch reveil -h }}}
The manual of `reveil` can be shown with: {{{
ssh <ETH username>@login.ee.ethz.ch man reveil }}}

== Before you switch off your managed workstation ==
⚠ Not every workstation supports WOL. If you intend to switch off your workstation and want to wake it later, test first if waking works!
 * Linux workstations can be switched off by pressing the power button on the chassis once
 * Windows workstations have to do a so-called ''full'' shutdown by pressing ''Shift'' while selecting ''Shut down'' in the start menu

If your workstation cannot be woken, send a [[mailto:support@ee.ethz.ch|support request]] stating the name of your workstation so we can investigate the issue.