You are here: Home > CLI Commands > Just_CLI_Topics > provision-ap

provision-ap

provision-ap

a-ant-bearing <bearing>

a-ant-gain <gain>

a-ant-pol <a-ant-pol>

a-ant-tilt-angle <angle>

a-antenna {1|2|both}

altitude <altitude>

ap-group <group>

ap-lldp-pse-detect {disabled|enabled}

ap-name <name>

ap-poe-power-optimization

ap2xx-prestandard-poe-detection

apdot1x-factory-cert

apdot1x-passwd <string>

apdot1x-tls

apdot1x-tls-suffix

apdot1x-tls-suffix-domain <apdot1x-tls-suffix-domain>

apdot1x-username <name>

cellular_nw_preference 3g-only|4g-only|advanced|auto

cert-DN

dns-server-ip <ipaddr>

dns-server-ip6 <ipv6 address>

domain-name <name>

external-antenna

fqln <name>

g-ant-bearing <bearing>

g-ant-gain <gain>

g-ant-pol <g-ant-pol>

g-ant-tilt-angle <angle>

g-antenna {1|2|both}

gateway <ipaddr>

gateway6 <ipv6-address>

ikepsk <key>

installation default|indoor|outdoor

ip6addr <ipv6-address>

ip6prefix <ipv6-prefix>

ipaddr <ipaddr>

latitude <location>

link-priority-cellular <link-priority-cellular>

link-priority-ethernet <link-priority-ethernet>

link-priority-wifi <link-priority-wifi>

longitude <location>

master {<name>|<ipaddr>}

mesh-role {mesh-auto|mesh-point|mesh-portal|none|remote-mesh-portal}

mesh-sae {sae-disable|sae-enable}

netmask <netmask>

no ...

ocsp_default

pap-passwd <string>

pap-user <name>

pkcs12-passphrase <string>

pppoe-chap-secret<key>

pppoe-passwd <string>

pppoe-service-name <name>

pppoe-user <name>

preferred_uplink

radio-0-5ghz-ant-gain <radio-0-5ghz-ant-gain>

radio-0-5ghz-ant-pol <radio-0-5ghz-ant-pol>

radio-1-5ghz-ant-gain <radio-1-5ghz-ant-gain>

radio-1-5ghz-ant-pol <radio-1-5ghz-ant-pol>

read-bootinfo {ap-name <name>|ip-addr <ipaddr>|wired-mac <macaddr>}

reprovision {all|ap-name <name>|ip-addr <ipaddr>|ip6-addr <ip6-addr>|serial-num <string>|wired-mac <macaddr>}

reset-bootinfo {ap-name <name>|ip-addr <ipaddr>|wired-mac <macaddr>}

server-ip <ipaddr>

sch-mode-radio-0

sch-mode-radio-1

server-ip <server-ip>

server-name <name>

set-ikepsk-by-addr <ip-addr>

syslocation <string>

uplink-vlan <uplink-vlan>

usb-dev <usb-dev>

usb-dial <usb-dial>

usb-init <usb-init>

usb-passwd <usb-passwd>

usb-power-mode {auto|enable|disable}

usb-tty <usb-tty>

usb-tty-control <usb-tty-control>

usb-type <usb-type>

usb-user <usb-user>

wifi-uplink

Description

This command provisions or reprovisions an AP.

Syntax

Parameter

Description

Range

a-ant-bearing

Determines the horizontal coverage distance of the 802.11a802.11a provides specifications for wireless systems. Networks using 802.11a operate at radio frequencies in the 5 GHz band. The specification uses a modulation scheme known as orthogonal frequency-division multiplexing (OFDM) that is especially well suited to use in office settings. The maximum data transfer rate is 54 Mbps. (5 GHzGigahertz.) antenna from True North.

From a planning perspective, the horizontal coverage pattern does not consider the elevation or vertical antenna pattern.

NOTE: This parameter is supported on outdoor APs only.
If you use this parameter to configure an indoor AP, an error message is displayed.

0-360 Decimal Degrees

a-ant-gain

Antenna gain for 802.11a802.11a provides specifications for wireless systems. Networks using 802.11a operate at radio frequencies in the 5 GHz band. The specification uses a modulation scheme known as orthogonal frequency-division multiplexing (OFDM) that is especially well suited to use in office settings. The maximum data transfer rate is 54 Mbps. (5GHz) antenna.

a-ant-pol

Antenna polarization value for 5GHz radio. Use one of the following parameters:

0: CO-Polarized

1: Cross-Polarized

a-ant-tilt-angle

Directs the angle of the 802.11a802.11a provides specifications for wireless systems. Networks using 802.11a operate at radio frequencies in the 5 GHz band. The specification uses a modulation scheme known as orthogonal frequency-division multiplexing (OFDM) that is especially well suited to use in office settings. The maximum data transfer rate is 54 Mbps. (5GHz) antenna for optimum coverage.

Use a - (negative) value for downtilt and a + (positive) value for uptilt.

NOTE: This parameter is supported on outdoor APs only.
If you use this parameter to configure an indoor AP, an error message is displayed.

-90 to +90 Decimal Degrees

 

a-antenna

Antenna use for 5 GHzGigahertz. (802.11a802.11a provides specifications for wireless systems. Networks using 802.11a operate at radio frequencies in the 5 GHz band. The specification uses a modulation scheme known as orthogonal frequency-division multiplexing (OFDM) that is especially well suited to use in office settings. The maximum data transfer rate is 54 Mbps.) frequency bandBand refers to a specified range of frequencies of electromagnetic radiation.. Use one of the following parameters:

1: Use antenna 1

2: Use antenna 2

both: Use both antennas (default)

1, 2, both(default)

altitude

Altitude, in meters, of the AP.

NOTE: This parameter is supported on outdoor APs only.
If you use this parameter to configure an indoor AP, an error message is displayed.

ap-group

Name of the AP group to which the AP belongs.

ap-lldp-pse-detect

Enabling causes the AP to detect the POE type via LLDPLink Layer Discovery Protocol. LLDP is a vendor-neutral link layer protocol in the Internet Protocol suite used by network devices for advertising their identity, capabilities, and neighbors on an IEEE 802 local area network, which is principally a wired Ethernet. POE TLVType-length-value or Tag-Length-Value. TLV is an encoding format. It refers to the type of data being processed, the length of the value, and the value for the type of data being processed.. Use one of the following parameters:

enabled: The AP uses PSE TYPE in the POE TLVType-length-value or Tag-Length-Value. TLV is an encoding format. It refers to the type of data being processed, the length of the value, and the value for the type of data being processed. to detect the PSE type.

disabled: The AP detects the POE using the HW classification.

ap-name

Name of the AP to be provisioned.

ap-poe-power-optimization

Enables optimization to minimize the POE draw of the AP. Enabling optimization may disable some parts of the AP. Disabling optimization ensures all features are enabled.

ap2xx-prestandard-poe-detection

Configures the pre-standard PoEPower over Ethernet. PoE is a technology for wired Ethernet LANs to carry electric power required for the device in the data cables. The IEEE 802.3af PoE standard provides up to 15.4 W of power on each port. detection on 200 Series APs.

The POE+ pre-standard detection is only available on 200 Series APs.

It consists of a basic voltage comparator. If the line voltage is equal to or greater than 51 V, the PSE is assumed to be 802.3at802.3at is an IEEE standard for PoE version that supplies up to 25.5W of DC power. See PoE+. compatible.

apdot1x-factory-cert

Enables AP to use factory certificates when doing 802.1x EAP-TLSEAP–Transport Layer Security. EAP-TLS is a certificate-based authentication method supporting mutual authentication, integrity-protected ciphersuite negotiation and key exchange between two endpoints. See RFC 5216..

 

apdot1x-passwd

Password of the AP to authenticate to 802.1X802.1X is an IEEE standard for port-based network access control designed to enhance 802.11 WLAN security. 802.1X provides an authentication framework that allows a user to be authenticated by a central authority. using PEAPProtected Extensible Authentication Protocol. PEAP is a type of EAP communication that addresses security issues associated with clear text EAP transmissions by creating a secure channel encrypted and protected by TLS..

apdot1x-tls

Enables AP to 802.1x using EAP-TLSEAP–Transport Layer Security. EAP-TLS is a certificate-based authentication method supporting mutual authentication, integrity-protected ciphersuite negotiation and key exchange between two endpoints. See RFC 5216..

 

apdot1x-tls-suffix

Enables AP to use EAP-TLSEAP–Transport Layer Security. EAP-TLS is a certificate-based authentication method supporting mutual authentication, integrity-protected ciphersuite negotiation and key exchange between two endpoints. See RFC 5216. username suffix.

apdot1x-tls-suffix-domain <apdot1x-tls-suffix-domain>

Set the suffix domain for AP dot1x EAP-TLSEAP–Transport Layer Security. EAP-TLS is a certificate-based authentication method supporting mutual authentication, integrity-protected ciphersuite negotiation and key exchange between two endpoints. See RFC 5216. username. If defined, use EAP-TLSEAP–Transport Layer Security. EAP-TLS is a certificate-based authentication method supporting mutual authentication, integrity-protected ciphersuite negotiation and key exchange between two endpoints. See RFC 5216. username as suffix, else use aruba.ap.

1- 63 string length

apdot1x-username

Username of the AP to authenticate to 802.1X802.1X is an IEEE standard for port-based network access control designed to enhance 802.11 WLAN security. 802.1X provides an authentication framework that allows a user to be authenticated by a central authority. using PEAPProtected Extensible Authentication Protocol. PEAP is a type of EAP communication that addresses security issues associated with clear text EAP transmissions by creating a secure channel encrypted and protected by TLS..

cellular_nw_preference
3g-only|4g-only|
advanced|auto

This setting allows you to select how the modem should operate.

auto (default): In this mode, the modem firmware will control the cellular network service selection; so the cellular network service failover and fallback is not interrupted by the Remote APRemote APs extend corporate network to the users working from home or at temporary work sites. Remote APs are deplyed at branch office sites and are connected to the central network on a WAN link..

3g_only: Locks the modem to operate only in 3GThird Generation of Wireless Mobile Telecommunications Technology. See W-CDMA..

4g_only: Locks the modem to operate only in 4GFourth Generation of Wireless Mobile Telecommunications Technology. See LTE..

advanced: The Remote APRemote APs extend corporate network to the users working from home or at temporary work sites. Remote APs are deplyed at branch office sites and are connected to the central network on a WAN link. controls the cellular network service selection based on the Received Signal Strength Indication (RSSIReceived Signal Strength Indicator. RSSI is a mechanism by which RF energy is measured by the circuitry on a wireless NIC (0-255). The RSSI is not standard across vendors. Each vendor determines its own RSSI scale/values.) threshold-based approach. Initially the modem is set to the default auto mode. This allows the modem firmware to select the available network. The Remote APRemote APs extend corporate network to the users working from home or at temporary work sites. Remote APs are deplyed at branch office sites and are connected to the central network on a WAN link. determines the RSSIReceived Signal Strength Indicator. RSSI is a mechanism by which RF energy is measured by the circuitry on a wireless NIC (0-255). The RSSI is not standard across vendors. Each vendor determines its own RSSI scale/values. value for the available network type (for example 4GFourth Generation of Wireless Mobile Telecommunications Technology. See LTE.), checks whether the RSSIReceived Signal Strength Indicator. RSSI is a mechanism by which RF energy is measured by the circuitry on a wireless NIC (0-255). The RSSI is not standard across vendors. Each vendor determines its own RSSI scale/values. is within required range, and if so, connects to that network. If the RSSIReceived Signal Strength Indicator. RSSI is a mechanism by which RF energy is measured by the circuitry on a wireless NIC (0-255). The RSSI is not standard across vendors. Each vendor determines its own RSSI scale/values. for the modem’s selected network is not within the required range, the Remote APRemote APs extend corporate network to the users working from home or at temporary work sites. Remote APs are deplyed at branch office sites and are connected to the central network on a WAN link. will then check the RSSIReceived Signal Strength Indicator. RSSI is a mechanism by which RF energy is measured by the circuitry on a wireless NIC (0-255). The RSSI is not standard across vendors. Each vendor determines its own RSSI scale/values. limit of an alternate network (for example, 3GThird Generation of Wireless Mobile Telecommunications Technology. See W-CDMA.), and reconnect to that alternate network. The Remote APRemote APs extend corporate network to the users working from home or at temporary work sites. Remote APs are deplyed at branch office sites and are connected to the central network on a WAN link. will repeat the above steps each time it tries to connect using a 4GFourth Generation of Wireless Mobile Telecommunications Technology. See LTE. multimode modem in this mode.

cert-DN

The Server Certificate CNCommon Name. CN is the primary name used to identify a certificate. for Identity

dns-server-ip

IP address of the DNSDomain Name System. A DNS server functions as a phone book for the intranet and Internet users. It converts human-readable computer host names into IP addresses and IP addresses into host names. It stores several records for a domain name such as an address 'A' record, name server (NS), and mail exchanger (MX) records. The Address 'A' record is the most important record that is stored in a DNS server, because it provides the required IP address for a network peripheral or element. server for the AP.

dns-server-ip6

IPv6 address of the DNSDomain Name System. A DNS server functions as a phone book for the intranet and Internet users. It converts human-readable computer host names into IP addresses and IP addresses into host names. It stores several records for a domain name such as an address 'A' record, name server (NS), and mail exchanger (MX) records. The Address 'A' record is the most important record that is stored in a DNS server, because it provides the required IP address for a network peripheral or element. server for the AP.

domain-name

Domain name for the AP.

external-anten
na

Use an external antenna with the AP.

fqln

FQLNFully Qualified Location Name. FQLN is a device location identifier in the format: APname.Floor.Building.Campus. for the AP, in the format <APname.floor.building.campus>.

g-ant-bearing

Determines the horizontal coverage distance of the 802.11g802.11g offers transmission over relatively short distances at up to 54 Mbps, compared with the 11 Mbps theoretical maximum of 802.11b standard. 802.11g employs Orthogonal Frequency Division Multiplexing (OFDM), the modulation scheme used in 802.11a, to obtain higher data speed. Computers or terminals set up for 802.11g can fall back to speed of 11 Mbps, so that 802.11b and 802.11g devices can be compatible within a single network. (2.4GHz) antenna from True North.

From a planning perspective, the horizontal coverage pattern does not consider the elevation or vertical antenna pattern.

NOTE: This parameter is supported on outdoor APs only. If you use this parameter to configure an indoor AP, an error message is displayed.

0-360 decimal degrees

g-ant-gain

Antenna gain for 802.11g802.11g offers transmission over relatively short distances at up to 54 Mbps, compared with the 11 Mbps theoretical maximum of 802.11b standard. 802.11g employs Orthogonal Frequency Division Multiplexing (OFDM), the modulation scheme used in 802.11a, to obtain higher data speed. Computers or terminals set up for 802.11g can fall back to speed of 11 Mbps, so that 802.11b and 802.11g devices can be compatible within a single network. (2.4GHz) antenna.

g-ant-pol

Antenna polarization value for 2.4GHz radio. Use one of the following parameters:

0: CO-Polarized

1: Cross-Polarized

g-ant-tilt-angle

Directs the angle of the 802.11g802.11g offers transmission over relatively short distances at up to 54 Mbps, compared with the 11 Mbps theoretical maximum of 802.11b standard. 802.11g employs Orthogonal Frequency Division Multiplexing (OFDM), the modulation scheme used in 802.11a, to obtain higher data speed. Computers or terminals set up for 802.11g can fall back to speed of 11 Mbps, so that 802.11b and 802.11g devices can be compatible within a single network. (2.4GHz) antenna for optimum coverage.

Use a - (negative) value for downtilt and a + (positive) value for uptilt.

NOTE: This parameter is supported on outdoor APs only. If you use this parameter to configure an indoor AP, an error message is displayed.

-90 to +90 Decimal Degrees

g-antenna

Antenna use for 2.4 GHzGigahertz. (802.11g802.11g offers transmission over relatively short distances at up to 54 Mbps, compared with the 11 Mbps theoretical maximum of 802.11b standard. 802.11g employs Orthogonal Frequency Division Multiplexing (OFDM), the modulation scheme used in 802.11a, to obtain higher data speed. Computers or terminals set up for 802.11g can fall back to speed of 11 Mbps, so that 802.11b and 802.11g devices can be compatible within a single network.) frequency bandBand refers to a specified range of frequencies of electromagnetic radiation.. Use one of the following parameters:

1: Use antenna 1

2: Use antenna 2

both: Use both antennas

1, 2, both

gateway

IP address of the default gatewayGateway is a network node that allows traffic to flow in and out of the network. for the AP.

gateway6

IPv6 address of the default gatewayGateway is a network node that allows traffic to flow in and out of the network. for the AP.

ikepsk

IKEInternet Key Exchange. IKE is a key management protocol used with IPsec protocol to establish a secure communication channel. IKE provides additional feature, flexibility, and ease of configuration for IPsec standard. preshared key for the AP.

installation

Specifies the type of installation (indoor or outdoor). The default parameter automatically selects an installation mode based upon the AP model type.

default

indoor

outdoor

ip6addr

Static IPv6 address of the AP.

ip6prefix

The prefix of static IPv6 address of the AP.

ipaddr

Static IP address for the AP.

latitude

Latitude coordinates of the AP. Use the format: Degrees, Minutes, Seconds (DMS). For example: 37 22 00 N

link-priority-cellular <link-priority-cellular>

 

Sets the priority of the cellular uplink. By default, the cellular uplink is a lower priority than the wired uplink; making the wired link the primary link and the cellular link the secondary or backup link.

Configuring the cellular link with a higher priority than your wired link priority will set your cellular link as the primary link.

link-priority-ethernet <link-priority-ethernet>

 

Sets the priority of the wired uplink. Each uplink type has an associated priority; wired ports having the highest priority by default.

link-priority-wifi <link-priority-wifi>

Sets the priority of the Wi-FiWi-Fi is a technology that allows electronic devices to connect to a WLAN network, mainly using the 2.4 GHz and 5 GHz radio bands. Wi-Fi can apply to products that use any 802.11 standard. uplink. Both Wi-FiWi-Fi is a technology that allows electronic devices to connect to a WLAN network, mainly using the 2.4 GHz and 5 GHz radio bands. Wi-Fi can apply to products that use any 802.11 standard. and wired uplink types have equal priority, depending on their availablility. If one of the uplink types is not available, the other uplink type is set as the primary link by default. However if both the uplink types are available, one of them is chosen randomly as the primary link.

 

longitude

Longitude coordinates of the AP. Use the DMS format.

For example: 122 02 00 W

master

Name or IP address of the Mobility Master.

mesh-role

Configures the AP to operate as a mesh node. You assign one of four roles: mesh auto, mesh portal, mesh point or remote mesh point. If you select none, the AP operates as a thin AP.

mesh-sae

Enables or disables Simultaneous Authentication of Equals (SAE) on a mesh network. This option offers enhanced security over the default wpa2-psk-aes mesh security setting, and provides secure, attack-resistant authentication using a PSKPre-shared key. A unique shared secret that was previously shared between two parties by using a secure channel. This is used with WPA security, which requires the owner of a network to provide a passphrase to users for network access. . SAE supports simultaneous initiation of a key exchange, allowing either party to initiate an exchange or both parties to initiate a key exchange simultaneously

To use the SAE feature, you must enable this parameter on all mesh nodes (points and portals) in the network, to prevent mesh link connectivity issues.

NOTE: This is a Beta feature only. This parameter should be kept “disabled” for this release.

netmask

NetmaskNetmask is a 32-bit mask used for segregating IP address into subnets. Netmask defines the class and range of IP addresses. for the IP address.

ocsp_default

If this parameter is set to 0 (default accept) and the certificate status is unknown, the server certificate is considered valid and the Remote APRemote APs extend corporate network to the users working from home or at temporary work sites. Remote APs are deplyed at branch office sites and are connected to the central network on a WAN link. comes up. If this parameter is set to 1 (default deny) and the certificate status is unknown, the server certificate is considered revoked and the Remote APRemote APs extend corporate network to the users working from home or at temporary work sites. Remote APs are deplyed at branch office sites and are connected to the central network on a WAN link. does not come up.

By default, OCSPOnline Certificate Status Protocol. OCSP is used for determining the current status of a digital certificate without requiring a CRL. default is set to 0 (default accept).

no

Negates any configured parameter.

pap-passwd

PAPPassword Authentication Protocol. PAP validates users by password. PAP does not encrypt passwords for transmission and is thus considered insecure. password for the AP.

You can use special characters in the PAPPassword Authentication Protocol. PAP validates users by password. PAP does not encrypt passwords for transmission and is thus considered insecure. password. Following are the restrictions:

You cannot use double-byte characters

You cannot use a tilde (~)

You cannot use a tick (‘)

If you use quotes (single or double), you must use the backslash (\) before and after the password

pap-user

PAPPassword Authentication Protocol. PAP validates users by password. PAP does not encrypt passwords for transmission and is thus considered insecure. username for the AP.

pkcs12-passphrase

Passphrase in PKCS12 format.

pppoe-chap-secret

PPPoEPoint-to-Point Protocol over Ethernet. PPPoE is a method of connecting to the Internet, typically used with DSL services, where the client connects to the DSL modem. CHAPChallenge Handshake Authentication Protocol. CHAP is an authentication scheme used by PPP servers to validate the identity of remote clients. secret key for the AP.

pppoe-passwd

PPPoEPoint-to-Point Protocol over Ethernet. PPPoE is a method of connecting to the Internet, typically used with DSL services, where the client connects to the DSL modem. password for the AP.

pppoe-service-
name

PPPoEPoint-to-Point Protocol over Ethernet. PPPoE is a method of connecting to the Internet, typically used with DSL services, where the client connects to the DSL modem. service name for the AP.

pppoe-user

PPPoEPoint-to-Point Protocol over Ethernet. PPPoE is a method of connecting to the Internet, typically used with DSL services, where the client connects to the DSL modem. username for the AP.

preferred_uplink

Choose AP preferred uplink interface (eth0-eth1). This is only applicable to AP-318, AP-374, AP-375, and AP-377 access points.

radio-0-5ghz-ant-gain <radio-0-5ghz-ant-gain>

Antenna gain for Radio 0 (5 GHzGigahertz.) antenna.

NOTE: This parameter is only needed for APs that support dual 5 GHzGigahertz. mode.

radio-0-5ghz-ant-pol <radio-0-5ghz-ant-pol>

Antenna polarization value for Radio 0 (5 GHzGigahertz.) antenna. Use one of the following parameters:

0: CO-Polarized

1: Cross-Polarized

NOTE: This parameter is only needed for APs that support dual 5 GHzGigahertz. mode.

radio-1-5ghz-ant-gain <radio-1-5ghz-ant-gain>

Antenna gain for Radio 1 (5 GHzGigahertz.) antenna.

NOTE: This parameter is only needed for APs that support dual 5 GHzGigahertz. mode.

radio-1-5ghz-ant-pol <radio-1-5ghz-ant-pol>

Antenna polarization value for Radio 1 (5 GHzGigahertz.) antenna. Use one of the following parameters:

0: CO-Polarized

1: Cross-Polarized

NOTE: This parameter is only needed for APs that support dual 5 GHzGigahertz. mode.

read-bootinfo

Retrieves current provisioning parameters of the specified AP.

NOTE: This parameter can only be used on the Mobility Master.

reprovision

Provisions one or more APs with the values in the provisioning-params workspace. To use reprovision, you must use read-bootinfo to retrieve the current values of the APs into the provisioning-ap-list.

NOTE: This parameter can only be used on the Mobility Master.

reset-bootinfo

Restores factory default provisioning parameters to the specified AP.

NOTE: This parameter can only be used on the Mobility Master.

sch-mode-radio-0

If you are provisioning an 802.11n802.11n is a wireless networking standard to improve network throughput over the two previous standards, 802.11a and 802.11g. With 802.11n, there will be a significant increase in the maximum raw data rate from 54 Mbps to 600 Mbps with the use of four spatial streams at a channel width of 40 MHz.-capable AP, you can issue the sch-mode-radio-0 command to enable single-chain mode for the selected radio. AP radios in single-chain mode will transmit and receive data using only legacy rates and single-stream HTHigh Throughput. IEEE 802.11n is an HT WLAN standard that aims to achieve physical data rates of close to 600 Mbps on the 2.4 GHz and 5 GHz bands. rates up to MCSModulation and Coding Scheme. MCS is used as a parameter to determine the data rate of a wireless connection for high throughput. 7. This setting is disabled by default.

sch-mode-radio-1

If you are provisioning an 802.11n802.11n is a wireless networking standard to improve network throughput over the two previous standards, 802.11a and 802.11g. With 802.11n, there will be a significant increase in the maximum raw data rate from 54 Mbps to 600 Mbps with the use of four spatial streams at a channel width of 40 MHz.-capable AP, you can issue the sch-mode-radio-1 command to enable single-chain mode for the selected radio. AP radios in single-chain mode will transmit and receive data using only legacy rates and single-stream HTHigh Throughput. IEEE 802.11n is an HT WLAN standard that aims to achieve physical data rates of close to 600 Mbps on the 2.4 GHz and 5 GHz bands. rates up to MCSModulation and Coding Scheme. MCS is used as a parameter to determine the data rate of a wireless connection for high throughput. 7. This setting is disabled by default.

server-ip

IPv4 or IPv6 address of the managed device from which the AP boots.

server-name

DNSDomain Name System. A DNS server functions as a phone book for the intranet and Internet users. It converts human-readable computer host names into IP addresses and IP addresses into host names. It stores several records for a domain name such as an address 'A' record, name server (NS), and mail exchanger (MX) records. The Address 'A' record is the most important record that is stored in a DNS server, because it provides the required IP address for a network peripheral or element. name of the managed device from which the AP boots.

set-ikepsk-by-addr

Sets a IKEInternet Key Exchange. IKE is a key management protocol used with IPsec protocol to establish a secure communication channel. IKE provides additional feature, flexibility, and ease of configuration for IPsec standard. preshared key to correspond to a specific IP address.

syslocation

User-defined description of the location of the AP.

uplink-vlan <uplink-vlan>

If you configure an uplink VLANVirtual Local Area Network. In computer networking, a single Layer 2 network may be partitioned to create multiple distinct broadcast domains, which are mutually isolated so that packets can only pass between them through one or more routers; such a domain is referred to as a Virtual Local Area Network, Virtual LAN, or VLAN. on an AP connected to a port in trunk mode, the AP sends and receives frames tagged with this VLANVirtual Local Area Network. In computer networking, a single Layer 2 network may be partitioned to create multiple distinct broadcast domains, which are mutually isolated so that packets can only pass between them through one or more routers; such a domain is referred to as a Virtual Local Area Network, Virtual LAN, or VLAN. on its EthernetEthernet is a network protocol for data transmission over LAN. uplink.

By default, an AP has an uplink vlanVirtual Local Area Network. In computer networking, a single Layer 2 network may be partitioned to create multiple distinct broadcast domains, which are mutually isolated so that packets can only pass between them through one or more routers; such a domain is referred to as a Virtual Local Area Network, Virtual LAN, or VLAN. of 0, which disables this feature.

NOTE: If an AP is provisioned with an uplink VLANVirtual Local Area Network. In computer networking, a single Layer 2 network may be partitioned to create multiple distinct broadcast domains, which are mutually isolated so that packets can only pass between them through one or more routers; such a domain is referred to as a Virtual Local Area Network, Virtual LAN, or VLAN., it must be connected to a trunk mode port or the AP’s frames will be dropped.

usb-dev

The USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices. device identifier, if the device is not already supported.

usb-dial

The dial string for the USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices. modem. This parameter only needs to be specified if the default string is not correct.

usb-modeswitch "-v <default_vendor>

-p <default_product>

-V <target_vendor> -P <target_product> -M <message_content>"

USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices. cellular devices on Remote APsRemote APs extend corporate network to the users working from home or at temporary work sites. Remote APs are deplyed at branch office sites and are connected to the central network on a WAN link. typically register as modems, but may occasionally register as a mass-storage device. If a Remote APRemote APs extend corporate network to the users working from home or at temporary work sites. Remote APs are deplyed at branch office sites and are connected to the central network on a WAN link. cannot recognize its USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices. cellular modem, use the usb-modeswitch command to specify the parameters for the hardware model of the USB cellular data-card.

NOTE: You must enclose the entire modeswitch parameter string in quotation marks.

usb-init

The initialization string for the USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices. modem. This string configures the AP Name setting of the USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices. modem. For the USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices. modem to understand this string, the value entered should adhere to one of the following formats:

Use double-quotes and prefix them with a backslash character. See example below:

"AT+CGDCONT=1,\"IP\",\"APN\""

Use single-quote instead of double-quotes. AP translates single-quote into double-quotes. See example below:

"AT+CGDCONT=1,’IP’,’APN’"

Use the string begin-end pair without double quotes. See example below:

AT+CGDCONT=1,’IP’,’APN’

In some cases, the 4GFourth Generation of Wireless Mobile Telecommunications Technology. See LTE./LTELong Term Evolution. LTE is a 4G wireless communication standard that provides high-speed wireless communication for mobile phones and data terminals. See 4G. modem requires the configuration of two AP Names during USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices. initialization. The first AP Name initiates the connection to obtain an IP address, and the second AP Name sends and receives data. Use the ; delimiter character to create two separate strings for the AP Names in the command. See example below:

"AT+CGDCONT=1,\"IP\",\"APN1\";1,1,\"APN2\""

NOTE: You must obtain the AP Name from your ISPInternet Service Provider. An ISP is an organization that provides services for accessing and using the Internet. and ensure that each AP Name entry follows the manufacturer's AT command reference.

usb-passwd

A PPPPoint-to-Point Protocol. PPP is a data link (layer 2) protocol used to establish a direct connection between two nodes. It can provide connection authentication, transmission encryption, and compression. password, if provided by the cellular service provider

usb-power-mode auto| enable|disable

Sets the USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices. power mode to control the power to the USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices. port.

usb-tty

The TTYTeleTypeWriter. TTY-enabled devices allow telephones to transmit text communications for people who are deaf or hard of hearing as well as transmit voice communication. device path for the USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices. modem. This parameter only needs to be specified if the default path is not correct.

usb-tty-control

The TTYTeleTypeWriter. TTY-enabled devices allow telephones to transmit text communications for people who are deaf or hard of hearing as well as transmit voice communication. device control path for the USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices. modem. This parameter only needs to be specified if the default path is not correct.

usb-type

Specify the USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices. driver type.

acm: Use ACM driver

airprime: Use Airprime driver

beceem-wimax: Use Beceem driver for 4GFourth Generation of Wireless Mobile Telecommunications Technology. See LTE.-WiMAXWorldwide Interoperability for Microwave Access. WiMAX refers to the implementation of IEEE 802.16 family of wireless networks standards set by the WiMAX forum.

ether: Use CDC Ether driver for direct IP 4GFourth Generation of Wireless Mobile Telecommunications Technology. See LTE. device

hso: Use HSO driver for newer Option

none: Disable 3GThird Generation of Wireless Mobile Telecommunications Technology. See W-CDMA. or 2G network on USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices.

option: Use Option driver

pantech-3g: Same as "pantech-uml290" - to support upgrade

pantech-uml290: Use Pantech USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices. driver for UML290 device

ptumlusbnet: Use Pantech USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices. driver for 4GFourth Generation of Wireless Mobile Telecommunications Technology. See LTE. device

rndis: Use a RNDIS driver for a 4GFourth Generation of Wireless Mobile Telecommunications Technology. See LTE. device

sierra-evdo: Use EVDO Sierra Wireless driver

sierra-gsm: Use GSM Sierra Wireless driver

sierrausbnet:Use SIERRA Direct IP driver for 4GFourth Generation of Wireless Mobile Telecommunications Technology. See LTE. device

storage: Use USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices.  flash as storage device for storing Remote APRemote APs extend corporate network to the users working from home or at temporary work sites. Remote APs are deplyed at branch office sites and are connected to the central network on a WAN link. certificates

usb-user

The PPPPoint-to-Point Protocol. PPP is a data link (layer 2) protocol used to establish a direct connection between two nodes. It can provide connection authentication, transmission encryption, and compression. username provided by the cellular service provider.

wifi-uplink

Enables the AP to use Wi-FiWi-Fi is a technology that allows electronic devices to connect to a WLAN network, mainly using the 2.4 GHz and 5 GHz radio bands. Wi-Fi can apply to products that use any 802.11 standard. uplink.

Usage Guidelines

You do not need to provision APs before installing and using them.

The exceptions are outdoor APs, which have antenna gains that you must provision before they can be used, and APs configured for mesh. You must provision the AP before you install it as a mesh node in a mesh deployment.

 

Users less familiar with this process may prefer to use the Provisioning page in the WebUI to provision an AP.

Provisioned or reprovisioned values do not take effect until the AP is rebooted. APs reboot automatically after they are successfully reprovisioned.

In order to enable cellular uplink for a Remote AP, the Remote AP must have the device driver for the USB data card and the correct configuration parameters. ArubaOS includes device drivers for the most common hardware types, but you can use the usb commands in this profile to configure a Remote AP to recognize and use an unknown USB modem type.

Provisioning a Single AP

To provision a single AP:

1. Use the read-bootinfo option to read the current information from the deployed AP you wish to reprovision.

2. Use the show provisioning-ap-list command to see the AP to be provisioned.

3. Use the copy-provisioning-params option to copy the AP’s parameter values to the provisioning-params workspace.

4. Use the provision-ap options to set new values. Use the show provisioning-params command to display parameters and values in the provisioning-params workspace. Use the clear provisioning-params command to reset the workspace to default values.

5. Use the reprovision option to provision the AP with the values in provisioning-params workspace. The AP automatically reboots.

Provisioning Multiple APs at a Time

You can change parameter values for multiple APs at a time, however, note the following:

You cannot provision the following AP-specific options on multiple APs:

ap-name

ipaddr

pap-user

pap-passwd

ikepsk

If any of these options are already provisioned on the AP, their values are retained when the AP is reprovisioned.

The values of the server-name, a-ant-gain, or g-ant-gain options are retained if they are not reprovisioned.

All other values in the provisioning-params workspace are copied to the APs.

To provision multiple APs at the same time:

1. Use the read-bootinfo to read the current information from each deployed AP that you wish to provision.

 

The AP parameter values are written to the provisioning-ap-list. To reprovision multiple APs, the APs must be present in the provisioning-ap-list. Use the show provisioning-ap-list command to see the APs that will be provisioned. Use the clear provisioning-ap-list command to clear the provisioning-ap-list.

2. Use the copy-provisioning-params option to copy an AP’s parameter values to the provisioning-params workspace.

3. Use the provision-ap options to set new values. Use the show provisioning-params command to display parameters and values in the provisioning-params workspace. Use the clear provisioning-params command to reset the workspace to default values.

4. Use the reprovisionall option to provision the APs in the provisioning-ap-list with the values in provisioning-params workspace. All APs in the provisioning-ap-list automatically reboot.

The following are useful commands when provisioning one or more APs:

show|clear provisioning-ap-list displays or clears the APs that will be provisioned.

show|clear provisioning-params displays or resets values in the provisioning-params workspace.

show ap provisioning shows the provisioning parameters an AP is currently using.

Example

The following commands change the IP address of the Mobility Master on the AP:

(host) [mynode] (config) #provision-ap

read-bootinfo ap-name lab103

show provisioning-ap-list

copy-provisioning-params ap-name lab103

master 10.100.102.210

reprovision ap-name lab103

Command History

Release

Modification

ArubaOS 8.5.0.0

The link-priority-wifi and wifi-uplink parameters were added.

ArubaOS 8.4.0.0

The following parameters were added:

apdot1x-tls-suffix

apdot1x-tls-suffix-domain

mesh-auto

preferred_uplink

ArubaOS 8.3.0.0

The following parameters were added:

radio-0-5ghz-ant-gain

radio-0-5ghz-ant-pol

radio-1-5ghz-ant-gain

radio-1-5ghz-ant-pol

ArubaOS 8.2.0.0

The following parameters were added:

apdot1x-factory-cert

apdot1x-tls

a-ant-pol

g-ant-pol

ap-lldp-pse-detect

ArubaOS 8.1.0.0

The server-ip parameter was modified to accept IPv6 address.

ArubaOS 8.0.0.0

Command introduced.

Command Information

Platforms

License

Command Mode

All platforms, except for the parameters noted in the syntax table.

Base operating system, except for the parameters noted in the syntax table.

Config mode on Mobility Master.

/*]]>*/