FlexConnect AP Configuration
In a traditional centralised wireless deployment, every packet a wireless client sends — even to a device on the same local network — travels across the WAN inside a CAPWAP tunnel to the WLC at headquarters, gets processed, and is tunnelled back. For branch offices connected over low-bandwidth or high-latency WAN links, this hairpinning is inefficient and means that if the WAN or WLC becomes unavailable, all wireless clients lose connectivity completely.
FlexConnect (formerly called H-REAP — Hybrid Remote Edge Access Point) solves both problems. A FlexConnect AP registers with and is managed by the central WLC over the WAN, but it can switch client traffic locally at the branch — directly between the wireless client and the local LAN — without sending every packet across the WAN. Crucially, when the WAN link or WLC becomes unreachable, FlexConnect APs enter standalone mode and continue to service wireless clients using locally cached policies, pre-downloaded SSID configurations, and locally stored credentials. Connectivity is maintained even during WLC outages. For wireless fundamentals see Wi-Fi Overview and Wi-Fi Security.
Before starting this lab, ensure you are familiar with WLC fundamentals at WLC Getting Started and SSID-to-VLAN mapping at WLC SSID & VLAN Mapping. For a comparison of Lightweight (CAPWAP) vs Autonomous AP modes, see Lightweight vs Autonomous APs. For the guest WLAN WebAuth scenario that FlexConnect must handle at the branch, see Guest WLAN with WebAuth. For trunk port configuration on the branch switch connecting to the FlexConnect AP, see Trunk Port Configuration.
1. FlexConnect — Core Concepts
Central Switching vs Local Switching
The key distinction in FlexConnect is how traffic is forwarded once a wireless client sends a frame. Each SSID on a FlexConnect AP can independently be set to central or local switching:
══ Central Switching (traditional CAPWAP) ══════════════════════
[Branch Client] ──802.11──► [FlexConnect AP]
│
CAPWAP tunnel (all data encapsulated)
│
──WAN link──►
│
[WLC at HQ]
│
Forwarded to destination
(even if destination is on same branch LAN)
Pros: Full WLC visibility, centralised policy, simpler config
Cons: WAN bandwidth consumed for local traffic, all access lost
if WAN/WLC fails
══ Local Switching ════════════════════════════════════════════
[Branch Client] ──802.11──► [FlexConnect AP]
│
802.3 frame exits AP
directly to local switch
│
[Branch Access Switch]
│
Forwarded locally on branch LAN
WAN not involved at all
Pros: Local traffic stays local, WAN bandwidth conserved,
clients survive WLC/WAN outage (standalone mode)
Cons: WLC has less real-time visibility; some features
(WebAuth, central DHCP) need extra consideration
FlexConnect Operating Modes
| Mode | WLC Reachable? | Data Forwarding | Authentication | Configuration Source |
|---|---|---|---|---|
| Connected Mode | Yes — CAPWAP control channel is up | Local switching (data) or central switching per SSID setting | Central (WLC authenticates against RADIUS) or local | WLC pushes config to AP in real time |
| Standalone Mode | No — WLC is unreachable (WAN down, WLC failure) | Local switching only — locally switched SSIDs remain up; centrally switched SSIDs go down | Local authentication (cached credentials or local RADIUS) — central RADIUS is unreachable | Cached config downloaded from WLC before outage |
FlexConnect SSID Switching Modes
Each WLAN (SSID) mapped to a FlexConnect AP can be independently configured for local or central switching. The choice determines both normal operation and standalone mode behaviour:
| SSID Switching Mode | Normal (Connected) Operation | Standalone Mode Behaviour | Typical Use Case |
|---|---|---|---|
| Local Switching | Client data exits AP directly onto the local VLAN — WAN not used for data | SSID remains up — clients can still access the local LAN | Corporate SSID for branch employees — local LAN access is critical |
| Central Switching | All client data is encapsulated in CAPWAP and sent to the WLC | SSID goes down — no local forwarding without WLC | Guest SSID where traffic must be hairpinned to headquarters for filtering and control |
FlexConnect Groups
A FlexConnect Group is a WLC container that groups multiple FlexConnect APs at the same branch location. The group provides three key capabilities:
| Capability | Description | Benefit |
|---|---|---|
| Local Authentication | Credentials (usernames and passwords) are pre-downloaded to all APs in the group and cached locally | APs can authenticate WPA2-Enterprise clients during standalone mode without reaching the RADIUS server at HQ |
| CCKM / Fast Roaming | APs in the group share PMK (Pairwise Master Key) caches — clients roaming between APs in the group do not need to re-authenticate with the RADIUS server | Seamless roaming within the branch without RADIUS round-trips for every AP association |
| Central DHCP Override | Overrides the DHCP server used by clients on locally switched SSIDs — can point to a local DHCP server at the branch | Clients get IPs from a local DHCP server at the branch, not a central DHCP server across the WAN |
Traffic Flow Summary — FlexConnect Branch
┌─────────────────────────────────────────────────────────────────┐
│ BRANCH OFFICE │
│ │
│ [Corporate Client] ──802.11──► [FlexConnect AP] │
│ │ │
│ Local Switch (VLAN 10) │
│ │ │
│ [Branch Switch] │
│ │ │
│ Local LAN resources │
│ (file server, printer, etc.) │
│ │ │
│ ─ ─ ─ ─ ─ ─ ─ WAN Link ─ ─ ─ ─ ─ ─ ┤ │
│ │ (CAPWAP control only) │
└────────────────────────────────────────┼────────────────────────┘
│
┌────────────▼─────────────┐
│ WLC at HQ │
│ (management + config │
│ only — no data plane) │
└───────────────────────────┘
CAPWAP Control channel: Always to WLC (AP management, config, stats)
CAPWAP Data channel: LOCAL SWITCHING → bypasses WLC entirely
CENTRAL SWITCHING → tunnelled to WLC
Standalone mode (WAN down):
► Locally switched SSIDs: REMAIN UP ✅
► Centrally switched SSIDs: GO DOWN ✗
► Authentication: local cache from FlexConnect Group ✅
2. Lab Topology & Scenario
NetsTuts has two branch offices — Branch-A and Branch-B — each with two FlexConnect APs. Both branches connect to the central WLC at HQ over a WAN. The corporate SSID (NetsTuts-Corp) must use local switching so branch employees maintain LAN access during WAN outages. The guest SSID (NetsTuts-Guest) uses central switching so all guest traffic is hairpinned through HQ for filtering. A FlexConnect group will be created for each branch to enable local authentication and fast roaming between the two APs at each site.
┌──────────────────────────────────────────────────────────────────┐
│ HQ — WLC │
│ Management: 10.0.0.50/24 │
│ WLANs: │
│ WLAN 1: NetsTuts-Corp (WPA2-Enterprise, VLAN 10) │
│ WLAN 2: NetsTuts-Guest (Open + WebAuth, VLAN 100) │
│ FlexConnect Groups: │
│ FC-GROUP-BRANCH-A (Branch-A-AP1, Branch-A-AP2) │
│ FC-GROUP-BRANCH-B (Branch-B-AP1, Branch-B-AP2) │
└───────────────────────────┬──────────────────────────────────────┘
│ WAN (CAPWAP control + central data)
┌──────────────┴──────────────┐
│ │
┌────────────▼────────────┐ ┌────────────▼────────────┐
│ Branch-A │ │ Branch-B │
│ Branch-A-AP1 (Gi0/1) │ │ Branch-B-AP1 (Gi0/1) │
│ Branch-A-AP2 (Gi0/2) │ │ Branch-B-AP2 (Gi0/2) │
│ Branch Switch │ │ Branch Switch │
│ VLAN 10: 10.10.0.0/24 │ │ VLAN 10: 10.20.0.0/24 │
│ VLAN 100: 192.168.10.0 │ │ VLAN 100: 192.168.20.0 │
│ DHCP: local router │ │ DHCP: local router │
└─────────────────────────┘ └─────────────────────────┘
SSID Switching Mode per Branch AP:
┌──────────────────┬──────────────────────┬───────────────────────┐
│ SSID │ Switching Mode │ Standalone Behaviour │
├──────────────────┼──────────────────────┼───────────────────────┤
│ NetsTuts-Corp │ Local Switching │ Remains UP ✅ │
│ NetsTuts-Guest │ Central Switching │ Goes DOWN ✗ │
└──────────────────┴──────────────────────┴───────────────────────┘
3. Step 1 — Convert APs to FlexConnect Mode
By default, Cisco lightweight APs join the WLC in Local mode — all data is centrally switched through the WLC. Each AP must be individually converted to FlexConnect mode via the WLC GUI or CLI. This is done per-AP, not globally. Navigate to Wireless → Access Points → All APs → [AP Name] → General:
WLC GUI — Wireless → Access Points → All APs → Branch-A-AP1 → General
┌───────────────────────────────────────────────────────┐
│ AP Name: Branch-A-AP1 │
│ AP Model: Cisco Aironet 2802i │
│ AP MAC: 00:1a:2b:3c:4d:01 │
│ AP IP: 10.10.0.11 (DHCP from branch) │
│ │
│ AP Mode: Local ← CHANGE THIS │
│ [Dropdown] ● FlexConnect ← select FlexConnect │
│ │
│ FlexConnect ─────────────────────────────────── │
│ Local Switching: ✅ Enabled │
│ Local Auth: ✅ Enabled │
│ Learn Client IP: ✅ Enabled │
└───────────────────────────────────────────────────────┘
[Apply] — AP will reboot and rejoin in FlexConnect mode
(30–90 seconds downtime during mode change)
Repeat for: Branch-A-AP2, Branch-B-AP1, Branch-B-AP2
WLC CLI — Convert AP to FlexConnect Mode
! ── Alternatively, use the WLC CLI ─────────────────────── (Cisco Controller) >config ap mode flexconnect Branch-A-AP1 Changing the AP's mode will cause the AP to reboot. Are you sure you want to continue? (y/n) y (Cisco Controller) >config ap mode flexconnect Branch-A-AP2 Are you sure you want to continue? (y/n) y (Cisco Controller) >config ap mode flexconnect Branch-B-AP1 Are you sure you want to continue? (y/n) y (Cisco Controller) >config ap mode flexconnect Branch-B-AP2 Are you sure you want to continue? (y/n) y
4. Step 2 — Configure Local Switching on the Corporate WLAN
Local switching is enabled per WLAN (SSID), not per AP. When local switching is enabled on a WLAN, all FlexConnect APs broadcasting that SSID will switch that WLAN's client traffic locally. Navigate to WLANs → [WLAN ID] → Advanced:
WLC GUI — WLANs → WLAN 1 (NetsTuts-Corp) → Advanced ┌───────────────────────────────────────────────────────┐ │ FlexConnect │ │ ─────────────────────────────────────────────────── │ │ FlexConnect Local Switching: ✅ Enabled │ │ FlexConnect Local Auth: ✅ Enabled │ │ FlexConnect Learn Client IP: ✅ Enabled │ └───────────────────────────────────────────────────────┘ [Apply] → [Save Configuration]
WLC GUI — WLANs → WLAN 2 (NetsTuts-Guest) → Advanced ┌───────────────────────────────────────────────────────┐ │ FlexConnect │ │ ─────────────────────────────────────────────────── │ │ FlexConnect Local Switching: ☐ Disabled │ │ (Central switching — all guest traffic to WLC) │ └───────────────────────────────────────────────────────┘ [Apply] → [Save Configuration]
WLC CLI — Enable Local Switching on WLAN 1
! ── Enable FlexConnect local switching on WLAN 1 ───────── (Cisco Controller) >config wlan flexconnect local-switching 1 enable ! ── Enable local auth on WLAN 1 ────────────────────────── (Cisco Controller) >config wlan flexconnect local-auth 1 enable ! ── Enable learn client IP on WLAN 1 ───────────────────── (Cisco Controller) >config wlan flexconnect learn-ipaddr 1 enable ! ── Confirm local switching is disabled on guest WLAN 2 ── (Cisco Controller) >config wlan flexconnect local-switching 2 disable
5. Step 3 — Configure FlexConnect VLAN Mapping on the AP
When an AP switches traffic locally, it must know which local VLAN to place each SSID's traffic on. This is done through FlexConnect VLAN Mapping — mapping a WLAN ID to a local VLAN on the branch switch. Navigate to Wireless → Access Points → [AP Name] → FlexConnect:
WLC GUI — Wireless → All APs → Branch-A-AP1 → FlexConnect ── Native VLAN ────────────────────────────────────────── ┌───────────────────────────────────────────────────────┐ │ Native VLAN ID: 10 │ │ (Management traffic from the AP uses VLAN 10) │ └───────────────────────────────────────────────────────┘ ── VLAN Mappings ───────────────────────────────────────── ┌──────────┬────────────────────┬───────────────────────┐ │ WLAN ID │ WLAN Profile Name │ VLAN ID (local) │ ├──────────┼────────────────────┼───────────────────────┤ │ 1 │ NetsTuts-Corp │ 10 (corporate VLAN) │ │ 2 │ NetsTuts-Guest │ 100 (guest VLAN) │ └──────────┴────────────────────┴───────────────────────┘ [Apply] Repeat identical VLAN mapping for Branch-A-AP2 (same branch = same local VLANs 10 and 100) For Branch-B APs: same WLAN IDs but same or different local VLAN IDs depending on branch L3 design
Branch Switch — Trunk Port to FlexConnect AP
Branch_SW>en Branch_SW#conf t ! ── Trunk port connecting to Branch-A-AP1 ───────────────── Branch_SW(config)#interface GigabitEthernet0/1 Branch_SW(config-if)#description Trunk to Branch-A-AP1 (FlexConnect) Branch_SW(config-if)#switchport mode trunk Branch_SW(config-if)#switchport trunk native vlan 10 Branch_SW(config-if)#switchport trunk allowed vlan 10,100 Branch_SW(config-if)#spanning-tree portfast trunk Branch_SW(config-if)#exit ! ── Trunk port connecting to Branch-A-AP2 ───────────────── Branch_SW(config)#interface GigabitEthernet0/2 Branch_SW(config-if)#description Trunk to Branch-A-AP2 (FlexConnect) Branch_SW(config-if)#switchport mode trunk Branch_SW(config-if)#switchport trunk native vlan 10 Branch_SW(config-if)#switchport trunk allowed vlan 10,100 Branch_SW(config-if)#spanning-tree portfast trunk Branch_SW(config-if)#exit Branch_SW(config)#end Branch_SW#wr
spanning-tree portfast trunk on the AP uplink port
eliminates the 30-second STP listening/learning delay when the AP
reboots or reconnects — the port transitions directly to forwarding,
reducing AP join time. This is safe on AP uplink ports because APs
do not generate BPDUs. The native VLAN on the switch trunk must
match the Native VLAN ID configured on the AP in the WLC GUI.
A mismatch causes management traffic to be tagged incorrectly and
the AP will fail to communicate with the WLC. For PortFast details,
see PortFast & BPDU Guard.
6. Step 4 — Create and Configure FlexConnect Groups
FlexConnect Groups enable local authentication (so APs can authenticate clients during WLC outage), fast roaming between APs at the same branch, and central DHCP override. A separate group is created for each branch. Navigate to Wireless → FlexConnect Groups → New:
WLC GUI — Wireless → FlexConnect Groups → [New] ── Create Group for Branch-A ───────────────────────────── ┌───────────────────────────────────────────────────────┐ │ FlexConnect Group Name: FC-GROUP-BRANCH-A │ └───────────────────────────────────────────────────────┘ [Apply] ── Tab: General ───────────────────────────────────────── ┌───────────────────────────────────────────────────────┐ │ Multicast Mode: Multicast-Multicast ← for video │ │ Central DHCP: Disabled (use local branch DHCP) │ └───────────────────────────────────────────────────────┘ ── Tab: APs ────────────────────────────────────────────── ┌───────────────────────────────────────────────────────┐ │ Add AP: Branch-A-AP1 [Add] │ │ Add AP: Branch-A-AP2 [Add] │ │ │ │ AP List: │ │ Branch-A-AP1 00:1a:2b:3c:4d:01 FlexConnect │ │ Branch-A-AP2 00:1a:2b:3c:4d:02 FlexConnect │ └───────────────────────────────────────────────────────┘ ── Tab: Local Authentication ───────────────────────────── ┌───────────────────────────────────────────────────────┐ │ Local Radius Server: ✅ Enabled │ │ EAP Type: EAP-FAST (recommended) │ │ or PEAP-MSCHAPv2 │ │ │ │ Local Net Users (cached credentials): │ │ Username: branch-user1 Password: BranchP@ss1 │ │ Username: branch-user2 Password: BranchP@ss2 │ │ (These are downloaded to the AP and used during │ │ WLC outage for standalone-mode authentication) │ └───────────────────────────────────────────────────────┘ [Apply] → [Save Configuration]
── Repeat: Create FC-GROUP-BRANCH-B ──────────────────── WLC GUI — Wireless → FlexConnect Groups → [New] ┌───────────────────────────────────────────────────────┐ │ FlexConnect Group Name: FC-GROUP-BRANCH-B │ └───────────────────────────────────────────────────────┘ [Apply] ── Tab: APs ────────────────────────────────────────────── ┌───────────────────────────────────────────────────────┐ │ Add AP: Branch-B-AP1 [Add] │ │ Add AP: Branch-B-AP2 [Add] │ └───────────────────────────────────────────────────────┘ ── Tab: Local Authentication ───────────────────────────── ┌───────────────────────────────────────────────────────┐ │ Local Radius Server: ✅ Enabled │ │ EAP Type: EAP-FAST │ │ Local Net Users: branch-b-user1 / BranchP@ss1 │ └───────────────────────────────────────────────────────┘ [Apply] → [Save Configuration]
WLC CLI — Create FlexConnect Group and Add APs
! ── Create FlexConnect Group for Branch-A ──────────────── (Cisco Controller) >config flexconnect group FC-GROUP-BRANCH-A add ! ── Add APs to the group (by AP name) ──────────────────── (Cisco Controller) >config flexconnect group FC-GROUP-BRANCH-A ap add Branch-A-AP1 (Cisco Controller) >config flexconnect group FC-GROUP-BRANCH-A ap add Branch-A-AP2 ! ── Enable local authentication on the group ───────────── (Cisco Controller) >config flexconnect group FC-GROUP-BRANCH-A radius ap enable ! ── Add local credentials cached on the AP ─────────────── (Cisco Controller) >config flexconnect group FC-GROUP-BRANCH-A radius ap user add branch-user1 password BranchP@ss1 ! ── Repeat for Branch-B ─────────────────────────────────── (Cisco Controller) >config flexconnect group FC-GROUP-BRANCH-B add (Cisco Controller) >config flexconnect group FC-GROUP-BRANCH-B ap add Branch-B-AP1 (Cisco Controller) >config flexconnect group FC-GROUP-BRANCH-B ap add Branch-B-AP2 (Cisco Controller) >config flexconnect group FC-GROUP-BRANCH-B radius ap enable
7. Step 5 — Verify and Understand Standalone Mode Behaviour
Before testing standalone mode, it is important to understand precisely what FlexConnect can and cannot do when the WLC is unreachable, so expectations are set correctly:
| Feature | Connected Mode | Standalone Mode | Requirement |
|---|---|---|---|
| Locally switched SSIDs (WPA2-PSK) | Up | Up ✅ | PSK is cached on AP — no WLC needed |
| Locally switched SSIDs (WPA2-Enterprise) | Up | Up ✅ (if local auth enabled) | Local credentials pre-cached via FlexConnect Group |
| Centrally switched SSIDs | Up | Down ✗ | CAPWAP data tunnel to WLC required — not available without WLC |
| New client associations (locally switched) | Yes | Yes ✅ | AP handles association autonomously with cached config |
| New client associations (centrally switched) | Yes | No ✗ | WLC required for CAPWAP data channel |
| DHCP for locally switched clients | From local DHCP server (branch router) | From local DHCP server ✅ | DHCP must be a local branch server — central DHCP over WAN is unavailable |
| Configuration changes | WLC pushes to AP immediately | Not possible ✗ | AP uses last cached config from WLC — changes applied only when WLC reconnects |
| WebAuth (Guest captive portal) | Yes (central or local WebAuth) | Limited — depends on WebAuth type | Internal WebAuth can work locally; External WebAuth (ISE) requires WLC |
8. Verification
show ap config general [AP-Name] — Primary Verification Command
(Cisco Controller) >show ap config general Branch-A-AP1 Cisco AP Identifier.............................. 1 Cisco AP Name.................................... Branch-A-AP1 Country code..................................... US AP Mode.......................................... FlexConnect AP SubMode....................................... Not Configured Rogue Detection.................................. Enabled FlexConnect Information: FlexConnect Mode................................. Local VLAN Support..................................... Yes VLAN name for Central Switching.................. management VLAN ID for Native VLAN.......................... 10 Local Switching for Locally Mapped WLANs......... Enabled Flexconnect ACL Applied.......................... No FlexConnect Group................................ FC-GROUP-BRANCH-A Local Authentication: Local Auth....................................... Enabled EAP Type......................................... EAP-FAST Number of local users............................ 2 CAPWAP Path MTU.................................. 1485 Primary Cisco Switch Name........................ WLC-HQ Primary Cisco Switch IP Address.................. 10.0.0.50
show ap flexconnect [AP-Name] — FlexConnect WLAN Detail
(Cisco Controller) >show ap flexconnect Branch-A-AP1 FlexConnect AP: Branch-A-AP1 WLAN SSID Mode VLAN Status ---- ---------------- ---------------- ---- ------- 1 NetsTuts-Corp Local Switching 10 Enabled 2 NetsTuts-Guest Central Switching 100 Enabled
show flexconnect group detail [Group-Name]
(Cisco Controller) >show flexconnect group detail FC-GROUP-BRANCH-A FlexConnect Group: FC-GROUP-BRANCH-A Group Members: AP Name AP Mac Status ------------------ ------------------ ---------- Branch-A-AP1 00:1a:2b:3c:4d:01 Connected Branch-A-AP2 00:1a:2b:3c:4d:02 Connected Local Authentication: Local Radius: Enabled EAP Type: EAP-FAST Local Users: 2 configured VLAN-ACL Mapping: None Multicast Mode: Multicast-Multicast
show ap summary — Confirm All APs in FlexConnect Mode
(Cisco Controller) >show ap summary Number of APs.................................... 4 AP Name Slots AP Model Ethernet MAC Radio MAC IP Address State --------------- ----- ---------------- ----------------- ---------------- ------------ --------- Branch-A-AP1 2 AIR-AP2802I-UXK9 00:1a:2b:3c:4d:01 00:1a:2b:3c:4d:00 10.10.0.11 FlexConnect Branch-A-AP2 2 AIR-AP2802I-UXK9 00:1a:2b:3c:4d:02 00:1a:2b:3c:4d:10 10.10.0.12 FlexConnect Branch-B-AP1 2 AIR-AP2802I-UXK9 00:2c:3d:4e:5f:01 00:2c:3d:4e:5f:00 10.20.0.11 FlexConnect Branch-B-AP2 2 AIR-AP2802I-UXK9 00:2c:3d:4e:5f:02 00:2c:3d:4e:5f:10 10.20.0.12 FlexConnect
show client detail [MAC] — Confirm Local Switching is Active
(Cisco Controller) >show client detail a4:c3:f0:11:22:33 Client MAC Address............................... a4:c3:f0:11:22:33 Client Username.................................. branch-user1 AP Name.......................................... Branch-A-AP1 Client State..................................... Associated Wireless LAN Id.................................. 1 WLAN Profile Name................................ NetsTuts-Corp IP Address....................................... 10.10.0.55 VLAN............................................. 10 Data Switching................................... Local Authentication................................... Local FlexConnect Data Switching....................... Local FlexConnect Dhcp Status.......................... Local
Simulate Standalone Mode — Disconnect WLC and Verify
! ── On WLC — disable the management interface temporarily ─ ! ── (lab simulation — do not do on production WLC) ──────── (Cisco Controller) >config interface disable management ! ── On the AP console (during standalone mode) ──────────── ! ── APs log the transition to standalone ───────────────── AP-Console: %CAPWAP-3-GOING_TO_STANDALONE: CAPWAP SM is moving to standalone mode. AP-Console: %CAPWAP-5-STANDALONE: The AP has gone to standalone mode. ! ── Verify on AP CLI (connect via SSH or console) ───────── Branch-A-AP1>show capwap ip config CAPWAP State: STANDALONE ! ── Clients on locally switched WLAN remain connected ───── ! ── Test: ping from branch client to local LAN resource ─── Branch-Client$ ping 10.10.0.1 PING 10.10.0.1: 64 bytes from 10.10.0.1, icmp_seq=1, ttl=64, time=1.2ms PING 10.10.0.1: 64 bytes from 10.10.0.1, icmp_seq=2, ttl=64, time=1.1ms ! ── Clients on centrally switched WLAN disconnect ───────── ! ── (NetsTuts-Guest goes down in standalone) ──────────────
Verification Command Summary
| Command | What It Shows | Primary Use |
|---|---|---|
show ap config general [AP] |
Full AP configuration — AP mode (FlexConnect/Local), FlexConnect mode, VLAN support, native VLAN, FlexConnect group membership, local auth status | Primary verification — confirm AP is in FlexConnect mode with correct group and local auth |
show ap flexconnect [AP] |
Per-WLAN FlexConnect configuration — SSID, switching mode (local/central), VLAN mapping, enabled/disabled status | Confirm each SSID is correctly set to local or central switching with the right VLAN |
show flexconnect group detail [group] |
FlexConnect group members — AP names, MAC addresses, connection status, local auth settings, user count | Confirm all branch APs are in the correct group and local auth is configured |
show ap summary |
All APs — name, model, MAC, IP, and current state (FlexConnect / Local / Standalone) | Quick overview — confirm all target APs show FlexConnect state, not Local |
show client detail [MAC] |
Per-client detail — data switching (Local/Central), DHCP status (Local/Central), authentication type | Confirm an associated client is being locally switched and using local DHCP and auth |
show capwap ip config (AP CLI) |
CAPWAP state on the AP — Connected or Standalone, WLC IP, CAPWAP tunnel status | On the AP CLI via SSH or console — confirm whether the AP is in connected or standalone mode |
9. Troubleshooting FlexConnect Issues
| Problem | Symptom | Cause | Fix |
|---|---|---|---|
| AP still shows "Local" mode after FlexConnect conversion | show ap summary shows State: Local — AP did not successfully reboot into FlexConnect mode |
The AP rebooted but failed to rejoin the WLC in FlexConnect mode, or the mode change was applied but not saved — AP reverted to Local mode on reboot | Re-apply the mode change: config ap mode flexconnect [AP-Name]. Verify the WLC configuration is saved: save config. Check that the AP can reach the WLC after rebooting — CAPWAP discovery failure causes the AP to fall back to its default mode. See WLC Getting Started |
| Locally switched clients cannot get DHCP addresses | Corporate SSID clients get APIPA (169.254.x.x) or no IP in FlexConnect local switching mode | The branch has no local DHCP server — clients are relying on a DHCP server at HQ that is unreachable without WAN, or the FlexConnect group has Central DHCP enabled pointing to a WLC-internal scope that does not apply to local switching | Deploy a DHCP server locally at the branch (branch router or local server) with a scope covering the corporate VLAN. Disable Central DHCP in the FlexConnect Group settings. Verify show client detail shows FlexConnect DHCP Status: Local. See DHCP Server Configuration |
| Clients cannot connect during standalone mode (WPA2-Enterprise) | When the WAN is down, WPA2-Enterprise clients fail to associate to the locally switched corporate SSID — authentication fails | FlexConnect Local Authentication is not enabled on the FlexConnect Group, or the local user credentials are not configured, or the EAP type used by clients does not match the EAP type configured in the group (must be EAP-FAST or PEAP) | Verify the FlexConnect Group has Local Radius Server: Enabled and that local users are populated. Confirm the AP in show ap config general [AP] shows Local Auth: Enabled and user count is non-zero. Ensure the client supplicant is configured for EAP-FAST or PEAP matching the group setting |
| VLAN mapping not working — traffic goes to wrong VLAN | Locally switched corporate clients end up on VLAN 1 (native/untagged) instead of VLAN 10, or get no connectivity | The VLAN mapping in Wireless → All APs → [AP] → FlexConnect was not configured, or the native VLAN on the AP does not match the native VLAN on the switch trunk port facing the AP | Verify the VLAN mapping table: each WLAN ID must have an explicit local VLAN ID assigned. Confirm the Native VLAN ID on the AP (in WLC GUI) matches the switchport trunk native vlan on the branch switch port. A mismatch causes management and data traffic to be placed on the wrong VLAN |
| AP enters standalone mode unexpectedly during normal operation | AP transitions to standalone despite the WAN link appearing to be up — show ap summary briefly shows State: Standalone |
CAPWAP keepalive timers are expiring — the WAN link is degraded (high latency or packet loss) but not fully down. The WLC considers the AP unreachable when keepalive packets are not returned within the CAPWAP heartbeat timeout | Increase the CAPWAP echo interval on the WLC: config advanced timers ap-heartbeat-timeout [seconds] (default is 30 seconds). Investigate the WAN link quality with ping [WLC-IP] repeat 100 from the branch router. For WAN resilience, consider a backup WAN path or a secondary WLC. Check show logging for CAPWAP disconnection events |
| Guest SSID (central switching) stays up during WLC outage | After WLC becomes unreachable, the guest SSID still appears in the AP's beacon — but clients cannot associate or pass traffic | The SSID is still being broadcast (beacon still transmitted) but the AP cannot forward client data without the WLC. Clients may associate but will get no IP address and no traffic forwarding — the SSID appears up but is not functional | This is expected behaviour — centrally switched SSIDs continue broadcasting beacons in standalone mode but cannot pass traffic. Configure the WLAN to suppress the SSID broadcast during standalone mode if needed: in the FlexConnect Group WLAN settings, set the WLAN to be disabled in standalone mode. This prevents clients from attempting to connect to a non-functional SSID |
Key Points & Exam Tips
- FlexConnect (formerly H-REAP) allows a Cisco lightweight AP to switch client traffic locally at the branch while still being managed by a central WLC. The CAPWAP control channel always goes to the WLC; the CAPWAP data channel is bypassed for locally switched SSIDs.
- Each SSID on a FlexConnect AP can be independently set to Local Switching (traffic exits the AP directly onto the local VLAN) or Central Switching (traffic is tunnelled through CAPWAP to the WLC). Local switching survives WLC outages; central switching does not.
- FlexConnect APs operate in two modes: Connected (WLC reachable — full management, real-time config, statistics) and Standalone (WLC unreachable — AP uses last cached configuration, locally switched SSIDs remain up, centrally switched SSIDs go down).
- FlexConnect Groups serve three purposes: (1) local authentication — cached credentials allow WPA2-Enterprise authentication during standalone mode without a RADIUS server; (2) fast roaming — shared PMK cache between APs in the group enables CCKM/OKC roaming without full RADIUS re-authentication; (3) central DHCP override — controls whether clients use a local or central DHCP server.
- The native VLAN on the AP (set in WLC GUI under AP → FlexConnect) must exactly match the
switchport trunk native vlanon the branch switch port connected to the AP. A mismatch causes CAPWAP and management traffic to be incorrectly tagged, preventing AP registration. - FlexConnect VLAN mappings must be configured on each AP — each WLAN ID is mapped to a local branch VLAN. Without VLAN mapping, locally switched traffic is placed on VLAN 1 (the default untagged VLAN), which is typically incorrect and may cause security issues.
- For standalone mode survivability, three things must all be in place: (1) the SSID must have local switching enabled, (2) a local DHCP server must be available at the branch (central DHCP at HQ is unreachable when WAN is down), and (3) FlexConnect Group local authentication must be enabled with pre-cached credentials for WPA2-Enterprise SSIDs.
show ap config general [AP-Name]is the primary verification command — confirm AP Mode: FlexConnect, Local Switching: Enabled, FlexConnect Group is populated, and Local Auth: Enabled.show ap flexconnect [AP-Name]shows per-SSID switching mode and VLAN mapping.- On the exam: know the two FlexConnect operating modes (Connected vs Standalone), the two SSID switching modes (Local vs Central) and their standalone behaviour, the three purposes of FlexConnect Groups, and the required switch trunk configuration for the AP uplink (trunk mode, native VLAN match, allowed VLANs). Also review AAA Overview for the authentication framework underpinning local auth.