Skip to main content
Cisco SD-WAN
Support
Product Documentation
Viptela Documentation

Troubleshoot WiFi Connnections

This article describes how to check for connection problems between a WiFi client and a WiFi network that is provided by a vEdge 100wm router. This article also describes how to resolve these problems.

Check for WiFi Connection Problems

If a WiFi client is unable to connect to a WiFi network when a vEdge 100wm router is providing the WiFi network, follow these steps to determine the source of the problem. To perform each step, use a method appropriate for the WiFi client.

  1. Verify that the WiFi client can locate the service identifier (SSID) advertised by the vEdge router. If the client cannot find the SSID, see SSID Not Located, below.
  2. Verify that the WiFi client can connect to the SSID advertised by the vEdge router. If the client cannot connect to the SSID, see SSID Connection Fails, below.
  3. Verify that the WiFi client has been assigned an IP address. If the client cannot obtain an IP address, see Missing IP Address, below.
  4. Verify that the WiFi client can access the Internet. If the client cannot connect to the Internet, see Internet Connection Failure, below.
  5. If the WiFi client connection is slow or if you notice frequent disconnects, see WiFi Speed Is Slow, below.

Resolve Problems with WiFi Connections

This section describes the most common issues that occur with WiFi connections between a WiFi client and a vEdge router, and it describes steps to resolve the issues.

SSID Not Located

Problem Statement

The WiFi client cannot locate the SSID advertised by the vEdge 100wm router.

Resolve the Problem

  1. Ensure that the basic service set identifier (BSSID) address for the SSID is valid:
    1. In vManage NMS, select the Monitor ► Network screen.
    2. Locate the vEdge 100wm router using the Sort options drop-down and the Search box. Or scroll through the list of devices in the device table.
    3. Select the vEdge 100wm router by clicking its hostname.
    4. From the left pane, select WiFi. The right pane displays information about WiFI configuration on the vEdge router.
    5. In the right pane, locate the SSID. Check that the BSSID for this SSID does not have a value of 00:00:00:00:00:00.
    6. If the BSSID is 00:00:00:00:00:00, the WLAN (VAP) interface for this SSID may be misconfigured. Ensure that the WLAN interface has been added to a bridge during the configuration process.
      — To view the device's running configuration in vManage NMS, from the Configuration ► Devices screen, select the vEdge 100wm router. Then click the More Actions icon to the right of the row, and click Running Configuration. To view the device's running configuration from the CLI, use the show running-config command.
      — To add the WLAN interface to a bridge, in vManage NMS, from the Configuration ► Templates screen, use the Bridge feature template. To do this from the CLI, see Configuring WLAN Interfaces.
  2. Eliminate static channels. A static channel is one where you explicitly configure the radio channel rather than allowing the router to automatically select the best radio channel. A slow static channel may appear to be an unreachable SSID.
    1. View the current SSID channel setting for the vEdge router. To do this in vManage NMS, from the Monitor ► Network screen, select the vEdge 100wm router. Then click Real Time, and in the command drop-down, select WLAN Clients or WLAN Radios. From the CLI, use the show wlan clients or show wlan radios command.
    2. If the channel is set to a specific number, change the value to "auto". To do this in vManage NMS, from the Configuration ► Templates screen, use the WiFi Radio feature template. From the CLI, use the wlan channel auto command.
  3. Ensure that the WiFi client is using the same radio band as the vEdge 100wm router, either 2.4 GHz (for IEEE 802.11b/g/n) or 5 GHz(for IEEE802.11a/n/ac):
    1. Check which radio band the WiFi client supports.
    2. Check the vEdge 100wm router’s Select Radio setting. To do this in vManage NMS, from the Monitor ► Network screen, select the vEdge 100wm router. Then click Real Time, and in the command drop-down, select WLAN Radios. From the CLI, use the show wlan radios command.
    3. If the vEdge 100wm router and WiFi client radio band settings do not match, either change the WiFi client's radio band or change the settings on the vEdge 100wm router so that they match. To do this in vManage NMS, from the Configuration ► Templates screen, use the WiFi Radio feature template. From the CLI, use the wlan command.

SSID Connection Fails

Problem Statement

The WiFi client can locate the SSID advertised by the vEdge 100wm router but cannot connect to it.

Resolve the Problem

  1. If you configure passwords locally on the vEdge 100wm router, ensure that the WiFi client's password matches the SSID's password.
  2. If you are using a RADIUS server, ensure that the RADIUS server is reachable and that the WiFi client's username and password match the RADIUS configuration:
    1. To verify that the RADIUS server is reachable from the router, ping the server. To do this in vManage NMS, see Ping a Device. From the CLI, use the ping command.
    2. Check for matching passwords on the RADIUS server and WiFi client.
  3. Ensure that you do not exceed the maximum number of clients for this SSID:
    1. Verify the number of used clients and the maximum number of clients:
      • In vManage NMS, from the Monitor ► Network screen, select the vEdge 100wm router. From the left pane, select WiFi. In the right pane, locate the SSID. Check the No. of Clients field. If the used/maximum values are equal, no more clients can connect to this SSID.
      • From the CLI, use the show wlan interfaces detail command.
    2. If needed, increase the Max Clients setting for your SSID. To do this in vManage NMS, from the Configuration ► Templates screen, use the WiFi SSID feature template. From the CLI, use the max-clients command.
  4. Ensure that the WiFi client supports WPA2 management security:
    1. Check your Management Security setting. To do this in vManage NMS, from the Monitor ► Network screen, select the vEdge 100wm router. Then click Real Time, and in the command drop-down, select WLAN Interfaces. From the CLI, use the show wlan interfaces command. If the management security value is set to "required," the WiFi client must support WPA2 security.
    2. If necessary, change the Management Security setting for your SSID to "optional" or "none." To do this in vManage NMS, from the Configuration ► Templates screen, use the WiFi SSID feature template. From the CLI, use the mgmt-security command.

Missing IP Address

Problem Statement

The WiFi client can connect to the SSID, but cannot obtain an IP address.

Resolve the Problem

Ensure that a DHCP server is reachable and has an available IP address in its address pool:

  1. If the vEdge 100wm router is acting as a DHCP helper (DHCP relay agent), ping the DHCP server to ensure that it is reachable from the router. To do this in vManage NMS, see Ping a Viptela Device. From the CLI, use the ping command.
  2. If you are using a remote DHCP server, check that the remote DHCP server has an available IP address in its address pool.
  3. If the vEdge 100wm router is acting as the local DHCP server:
    1. View the number of addresses being used. In vManage NMS, from the Monitor ► Network screen, select the vEdge 100wm router. Then click Real Time, and in the command drop-down, select DHCP Servers. From the CLI, use the show dhcp server command.
    2. Compute the number of IP addresses in the pool based on the configured DHCP address pool size and the number of addresses excluded from the DHCP address pool. To view these values in vManage NMS, from the Configuration ► Devices screen, select the vEdge router. Then click the More Actions icon to the right of the row, and click Running Configuration. To view them from the CLI, use the show running-config command.
    3. If necessary, increase the range of addresses in the router's DHCP address pool. To do this in vManage NMS, from the Configuration ► Templates screen, use the DHCP-Server feature template. From the CLI, use the address-pool command.

Internet Connection Failure

Problem Statement

The WiFi client is connected to the SSID and has an IP address, but it cannot connect to the Internet.

Resolve the Problem

Ensure that the WiFi client has received the correct default gateway and DNS settings from the DHCP server:

  1. If the DHCP server is remote, check the settings on the server.
  2. If the vEdge 100wm router is the DHCP server, ensure that the default gateway and DNS server settings are the same as those on the WiFi client. To view the settings in vManage NMS, from the Monitor ► Network screen, select the vEdge 100wm router. Then click Real Time, and in the command drop-down, select DHCP Interfaces. From the CLI, use the show dhcp interface command.

WiFi Speed Is Slow

Problem Statement

The WiFi client can connect to the Internet, but the connection speed is slow.

Resolve the Problem

Allow the vEdge 100wm router to choose the best WiFi channel:

  1. View the current SSID channel setting for the vEdge 100wm router. To do this in vManage NMS, from the Monitor ► Network screen, select the vEdge 100wm router. Then click Real Time, and in the command drop-down, select WLAN Clients or WLAN Radios. From the CLI, use the show wlan clients or show wlan radios command.
  2. If the channel is set to a specific number, change the value to "auto". To do this in vManage NMS, from the Configuration ► Templates screen, use the WiFi Radio feature template. From the CLI, use the wlan channel auto command.

Operational Commands

show dhcp interface
show dhcp server
show running-config
show wlan clients
show wlan interfaces
show wlan radios

Release Information

Introduced in vManage NMS in Release 16.3

Additional Information

Configuring WLAN Interfaces

  • Was this article helpful?