This is how the job definition looks like now:
----------------------8<-
plugin: user-interact-verify
name: wireless/wireless_connection_wpa_bg_manual
requires:
device.category == 'WIRELESS'
environment.ROUTERS == 'single'
user: root
environ: ROUTER_SSID ROUTER_PSK
command: trap "nmcli con delete id $ROUTER_SSID" EXIT; create_connection wifi $ROUTER_SSID --security=wpa --key=$ROUTER_PSK && gateway_ping_test --interface=`nmcli dev status | awk '/802-11-wireless/ {prin
estimated_duration: 120.0
_description:
PURPOSE:
Tests that the systems wireless hardware can connect to a router using WPA
security and the 802.11b/g protocols.
STEPS:
1. Open your routers configuration tool
2. Change the settings to only accept connections on the B and G wireless bands
3. Make sure the SSID is set to ROUTER_SSID
4. Change the security settings to use WPA2 and ensure the PSK matches that set in ROUTER_PSK
5. Click the 'Test' button to create a connection to the router and test the connection
VERIFICATION:
Verification is automated, do not change the automatically selected result.
---------------------->8-
The description mentions ROUTER_SSID and ROUTER_PSK but the command clearly treats those as environment variables.
I agree the job descriptions could be a bit clearer. Any suggestions about phrasing are welcome. They need to convey the fact that the router_ssid option in the config file is the same as the router used to test.
In fact step 3 might not even be necessary - the user should already have configured the correct SSID.