Skip to content

Latest commit

 

History

History
71 lines (49 loc) · 4.79 KB

WoL-test-plan.md

File metadata and controls

71 lines (49 loc) · 4.79 KB
Raw

Wake-on-LAN Test Plan

1 Overview

The purpose is to test the functionality of WoL (Wake-on-LAN) feature on SONiC switch.

For details of WoL feature design, please refer to HLD: Wake-on-LAN in SONiC.

1.1 Scope

The test is targeting a running SONiC system will fully functioning configuration. The purpose of this test is to verify the function of WoL CLI utility.

1.2 Testbed

The test can run on both physical and virtual testbeds with any topology.

1.3 Limitation

The functional test of WoL depends on NIC capability of target device. In real scenarios, the device waiting for wake up is in low-power mode. In this situation, the network interface is UP but wol packet is not delivered to CPU of device. Instead, the wol packet is handled by NIC and NIC will turn on the device.

In this testplan, the interfaces in PTF are not in low-power mode. We only verify the SONiC switch can send out wol packet as expected. Will not verify the target device can be woken up.

2 Setup Configuration

No setup pre-configuration is required, test will setup and clean-up all the configuration.

3 Test

Test for WoL CLI Utility

The test will issue wol commands with various parameter combinations on DUT, then check if target devices (PTF) can capture the expected packet(s).

Test case #1 - Verrify send a wol packet to a specific interface

  1. Start tcpdump process in PTF to capture WoL packet on spacific interface. Save the captured packets to .pcap file.
  2. Issue command on DUT host: wol <sonic_interface_name> <target_mac> (e.g., wol Ethernet10 00:11:22:33:44:55)
  3. Stop tcpdump process in PTF.
  4. Check if only one wol packet exists in .pcap file and the content is expected.

Test case #2 - Verify send a wol packekt to each member of a vlan

  1. Start multiple tcpdump processes in PTF to capture WoL packet on each interfaces. Save the captured packets to different .pcap files.
  2. Issue command on DUT host: wol <vlan_name> <target_mac>. (e.g., wol Vlan1000 00:11:22:33:44:55)
  3. Stop all tcpdump processes in PTF.
  4. For each interface in vlan, check if one wol packet exists in corresponding .pcap file and the content is expected.
  5. For each interface not in vlan, check no wol packet exists in corresponding .pcap file.

Test case #3 - Verify send a broadcast wol packet

  1. Start tcpdump process in PTF to capture WoL packet on spacific interface. Save the captured packets to .pcap file.
  2. Issue command on DUT host: wol <sonic_interface_name> <target_mac> -b (e.g., wol Ethernet10 00:11:22:33:44:55 -b)
  3. Stop tcpdump process in PTF.
  4. Check if only one wol packet exists in .pcap file and the content is expected. Especially, verify the destination MAC in Ethernet frame header is broadcast MAC address (FF:FF:FF:FF:FF:FF).

Test case #4 - Verify send a wol packet with password

  1. Start tcpdump process in PTF to capture WoL packet on spacific interface. Save the captured packets to .pcap file.
  2. Issue command on DUT host: wol <sonic_interface_name> <target_mac> -p <password> (e.g., wol Ethernet10 00:11:22:33:44:55 -p 192.168.1.1)
  3. Stop tcpdump process in PTF.
  4. Check if only one wol packet exists in .pcap file and the content is expected. Especially, verify the password in wol packet is same as command.

Test case #5 - Verify send multiple wol packets with specific interval to a specific interface

  1. Start tcpdump process in PTF to capture WoL packet on spacific interface. Save the captured packets to .pcap file.
  2. Issue command on DUT host: wol <sonic_interface_name> <target_mac> -c <count> -i <interval> (e.g., wol Ethernet10 00:11:22:33:44:55 -c 3 -i 2000)
  3. Stop tcpdump process in PTF.
  4. Check if exact <count> wol packets exist in .pcap file and the content is expected. Moreover, check the time interval between each wol packet in .pcap file is ALMOST SAME1 as input <interval>.

Test case #6 - Verify send multiple wol packets with specific interval to each membor of a vlan

  1. Start multiple tcpdump processes in PTF to capture WoL packet on each interfaces. Save the captured packets to different .pcap files.
  2. Issue command on DUT host: wol <sonic_interface_name> <target_mac> -c <count> -i <interval> (e.g., wol Vlan1000 00:11:22:33:44:55 -c 3 -i 2000)
  3. Stop tcpdump process in PTF.
  4. For each interface in vlan, check if exact <count> wol packets exist in .pcap file and the content is expected. Moreover, check the time interval between each wol packet in .pcap file is ALMOST SAME1 as input <interval>.
  5. For each interface not in vlan, check no wol packet exists in corresponding .pcap file.

Footnotes

  1. ALMOST SAME means we should tolerate small errors caused by electrical characteristics. ↩ ↩2