`ap`

Creates or updates access point (AP) configurations.

Syntax

ap { pre-prov | swap } { export | import } ftp-url

no ap mac-address [ lock ]

After the acct-profile command is entered to enable the Account Profile configuration mode, the following configuration syntax is available:

[ description text | name name | realm realm ]

After the realm command is entered in Account Profile Realm configuration mode, the following additional configuration syntax is available:

[ acct-service name | name name ]

Command Default

AP configurations are not created.

Parameters

mac-address: Specifies the AP MAC address.
approve: Approves the AP to proceed with the registration process.
lock: Locks the AP.
move zone: Moves the AP to a target AP zone. Valid values for the name variable are 5.1.2_Zone, 5.1.1_GA, "Default Zone", Dual, ER-7581, IPv6_ZOne, "SZ Dis-Shreyas", zone-discovery, and ap-zone-name.
pre-prov: Specifies pre-provision APs.
swap: Specifies swaping APs.
trigger-prefer-node: Specifies the trigger prefer node action.
trigger-swap: Specifies the trigger swap action.
export: Export to a CSV file using FTP.
import: Import from a CSV file using FTP.
ftp-url: Specifies the FTP directory URL.

Modes

Global configuration mode

Usage Guidelines

This command is supported on all SmartZone platforms except SmartZone Data Plane controller.

The trigger-prefer-node keyword is only available on the SmartZone 300.

Examples

The following example creates an AP and specifies an AP MAC address. It also imports pre-provision APs from a CSV file using FTP and exports swapping APs using FTP.

device# config
device(config)# ap A1:87:45:34:56:FE
device(config)# ap pre-prov import ftp://device:device1!@172.19.7.100/backup/AP_ad8745345 
device(config)# ap swap export ftp://device:device1!@172.19.7.100

Related Commands

Commands related to device(config-ap) lists the related ap profile configuration commands.

Commands related to device(config-ap-model) lists the related ap model configuration commands.

Commands related to device(config-ap-model-lan1) lists the related ap model lan1 configuration commands.

Commands related to device(config-ap-model-lan1) lists the related ap pre-prov configuration commands for the SmartZone 300.

Commands related to device(config-ap)

Syntax and Type	Parameters (if any)	Description
device(config-ap)# admin	logonpassword	Sets the administrative logon credentials.
device(config-ap)# admin-mode	lockedunlocked	Sets the administrative mode to either locked or unlocked.
device(config-ap)# ap-logon	logon-id	Sets the access point administration login credentials.
device(config-ap)# ap-model	ap-model	Sets the model specification (overrides the zone configuration).
device(config-ap)# ap-password	password	Sets the access point administrative password.
device(config-ap)# area-code	areacode	Sets the user location information of LAC or TAC.
device(config-ap)# bonjour-gateway		Enables the bonjour gateway.
device(config-ap)# bonjour-policy		Enables the bonjour policy.
device(config-ap)# channel-evaluation-interval	seconds: The interval value (60~3600 secs)	Sets the channel evaluation interval.
device(config-ap)# channel-select-mode	2.4g${value}: 2.4GHz radio 5g${value}: 5GHz radio	Automatically adjusts the AP channels.
device(config-ap)# channelfly-mtbc	2.4gnumber: 2.4GHz radio number: MTBC value range:100-1440 5gnumber: 5GHz radio number: MTBC value range:100-1440	Set MTBC value of Channelfly.
device(config-ap)# client-admission-control	2.4g 5g 2.4gminClientCountminClientCount Min Client Count (Default: 10) 2.4gmaxRadioLoadmaxRadioLoad Max Radio Load (Default: 75%) 2.4g minClientThroughput minClientThroughput: Min Client Throughput (Default: 0.0Mbps) 5gminClientCountminClientCount Min Client Count (Default: 20) 5gmaxRadioLoadmaxRadioLoad Max Radio Load (Default: 75%) 5g minClientThroughputminClientThroughput Min Client Throughput (Default: 0.0Mbps)	Enables the client admission control.
device(config-ap)# description	description	Sets the model specification (overrides the zone configuration).
device(config-ap)# device-ip-mode	[ipv6\|ipv4\|dual]	Sets the device IP mode.
device(config-ap)# gps	latitudelongitude	Sets the GPS coordinates to latitude and longitude values.
device(config-ap)# gps-latitude	gps-latitude	Sets the GPS coordination latitude.
device(config-ap)# gps-longitude	gps-longitude	Sets the GPS coordination longitude.
device(config-ap)# hotspot20	name[swe\|cze\|spa\|eng\|chi\|ger\|fre\|jpn\|dan\|tur] name : Name swe: Swedish cze: Czech spa: Spanish eng: English chi: Chinese ger: German fre: French jpn: Japanese dan: Danish tur: Turkish	Sets the hotspot 2.0 settings.
device(config-ap)# ip	addressipnetwork-maskgateway name-serverdns-serversecondary	Sets the IP address and primary and secondary DNS servers.
device(config-ap)# ip6	addressipgateway: address: Set IPv6 address ip: Static IPv6 address gateway: Gateway name-serverdns-serversecondary name-server: Set primary and secondary DNS server dns-server: DNS server secondary: Secondary DNS server	Sets the AP IPv6 network settings.
device(config-ap)# location	location	Sets the location.
device(config-ap)# location-additional-info	text	Sets the additional information for location.
device(config-ap)# mesh	[disable\|mesh\|root\|auto]	Sets the mesh mode to either: disable: Disable mesh: Mesh AP root: Root AP auto: Auto
device(config-ap)# model		Sets the model specifications. It overrides the zone configuration.
device(config-ap)# name	name	Sets the AP name.
device(config-ap)# no	admin bonjour-gateway channel-evaluation-interval channel-select-mode client-admission-control description gps hotspot20 ipaddressname-server secondary ip6addressname-server secondary location location-additional-info model override-client-admission-control override-smart-mon override-mgmt-ap-vlan override-channel-select-mode override-client-admission-control override-syslog-opt override-zone-location no protection-mode override-zone-location-additional-info radio recovery-ssid smart-mon swap-in-ap syslog uplink-ap venue-profile	Disables the configuration.
device(config-ap)# override-ap-mgmt-vlan	vlanTag: VLAN tag (1-4094) enter ‘keep’ to retain the APs setting.	Overrides AP Management VLAN
device(config-ap)# override-channel-select-mode	2.4g: 2.4GHz radio 5g: 5 GHZ radio	Overrides Auto Channel Selection Mode and Channelfly MTBC.
device(config-ap)# override-client-admission-control	2.4g5g	Overrides the client admission control.
device(config-ap)# override-smart-mon		Overrides the smart monitor.
device(config-ap)# override-syslog-opt		Overrides the Syslog option.
device(config-ap)# override-zone-location		Overrides the zone location settings.
device(config-ap)# override-zone-location-additional-info		Overrides the zone’s additional information setting on location.
device(config-ap)# protection-mode	2.4g ${value}	Overrides the protection mode on 2.4 GHz radio
device(config-ap)# radio	2.4g channelchannel 5gchannelchannel 2.4g channelizationchannelization 5g channelizationchannelization 2.4gtx-powertx-power 5gtx-powertx-power 2.4gwlan-service 5gwlan-service 2.4gwlan-groupname 5gwlan-groupname 2.4groam[enable\|disable] 5groam [enable\|disable] 2.4groam-macfilt-time seconds (0-600) Smart roam MAC filter time in seconds 5groam-macfilt-time seconds (0-600) Smart roam MAC filter time in seconds	Sets the radio channels.
device(config-ap)# recovery-ssid-enabled	disable	Overrides the enable recovery SSID broad case.
device(config-ap)# smart-mon	intervalbetween 5-60 thresholdbetween 1-10	Enables the smart monitor.
device(config-ap)# swap-in-ap	mac	Sets the AP Mac IP address for swap-in.
device(config-ap)# syslog	enableipport: Enable the syslog server enableipport [Local2\| Keep Original\| Local1\| Local5\| Local6\| Local0\|Local7 \| Local3\|Local4] [Error\|Critical\|Warning\|All\|Alert\|Notice\|Info\|Emergency] disable: Disables the syslog server	Sets the syslog server.
device(config-ap)# uplink	[smart\|manual]	Sets the uplink selection to either smart or manual.
device(config-ap)# uplink-ap		Sets the uplink to manual access point.
device(config-ap)# venue-profile	name	Sets the venue profile
device(config-ap)# zone	name	Move the access point to another zone.

Commands related to device(config-ap-model)

Syntax and Type	Parameters (if any)	Description
device(config-ap-model)# ext-ant	2.4gnumber: 2.4 with DBI number 2.4ggnumber[3\|2] : 3/2 antennas numbers: DBI number 5gnumber: 5g with DBI number 5gg number [2\| 3]: 5gg with 2/3 antennas	Enables the external antenna.
device(config-ap-model)# internal-heater		Enables the internal heater.
device(config-ap-model)# lan1 device(config-ap-model)# lan2 device(config-ap-model)# lan3 device(config-ap-model)# lan4 device(config-ap-model)# lan5		Sets the LAN configurations from 1 to 5.
device(config-ap-model)# led		Enables the status of LEDs.
device(config-ap-model)# led-mode		Sets the LED mode.
device(config-ap-model)# lldp		Enables link layer discovery protocol.
device(config-ap-model)# lldp-ad-interval	seconds	Sets the LLDP advertise interval.
device(config-ap-model)# lldp-hold-time	seconds	Sets the LLDP hold time.
device(config-ap-model)# lldp-mgmt		Enables LLDP management IP TLV.
device(config-ap-model)# no	ext-ant internal-heater lan1 lan2 lan3 lan4 lan5 led lldp lldp-mgmt poe-operating-mode poe-out-port radio-band usb usb-software	Disables or deletes the settings that have been configured.
device(config-ap-model)# poe-operating-mode	$value	Switches the PoE mode.
device(config-ap-model)# poe-out-port		Enables the PoE out port.
device(config-ap-model)# radio-band	$value	Switches the radio band.
device(config-ap-model)# usb		Enables the USB port.
device(config-ap-model)# usb-software	$value	Sets the AP USB software package.

Commands related to device(config-ap-model-lan1)

Syntax and Type	Parameters (if any)	Description
device(config-ap-model-lan1)# 8021x	802.1x-type	Sets 802.1x.
device(config-ap-model-lan1)# acct-service	acct-service	Sets the authentication service configurations.
device(config-ap-model-lan1)# auth-service	auth-service	Sets the authentication service configurations.
device(config-ap-model-lan1)# mac-bypass		Sets the MAC bypass.
device(config-ap-model-lan1)# members	members	Sets the AP model configurations.
device(config-ap-model-lan1)# no	acct-service mac-bypass overwrite	Disables or deletes the settings that have been configured.
device(config-ap-model-lan1)# overwrite		Enable overwriting of VLAN
device(config-ap-model-lan1)# profile	profile: Ethernet port profile	Sets Ethernet port profile
device(config-ap-model-lan1)# supplicant	mac customusernamepassword	Sets the supplicant.
device(config-ap-model-lan1)# type	[trunk-port\|access-port\|general-port]	Sets the port type.
device(config-ap-model-lan1)# vlan-untag-id	untag-id:VLAN untag ID	Sets the VLAN untag ID.
device(config-ap-model-lan1)# vlan-members	members: VLAN members	Sets the VLAN members.

Commands related to device(config-ap-pre-prov)

Syntax and Type	Parameters (if any)	Description
device(config-ap-pre-prov)# ip6		Sets IPV6 network settings.
device(config-ap-pre-prov)# ip6 address	ip: IP address gateway: Gateway	Sets the IPV6 address and gateway.
device(config-ap-pre-prov)# ip6 name-server	primary-dns: Primary DNS. secondary-dns: Secondary DNS	Sets the primary or secondary DNS.

Syntax and Type

Parameters (if any)

Description

device(config-ap-pre-prov)# ip6

Sets IPV6 network settings.

device(config-ap-pre-prov)# ip6 address

ip: IP address

gateway: Gateway

Sets the IPV6 address and gateway.

device(config-ap-pre-prov)# ip6 name-server

primary-dns: Primary DNS.

secondary-dns: Secondary DNS

Sets the primary or secondary DNS.

RUCKUS SmartZone (ST-GA) Command Reference Guide, 7.0.0 800-73385-001 Rev B

ap