Cisco Aironet Wave 2 Cli Command Reference Manual

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

First Published: 2018-04-10

Americas Headquarters

Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000

800 553-NETS (6387)

Fax: 408 527-0883

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version of the UNIX operating system. All rights reserved. Copyright©1981, Regents of the University of California.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL:

https://www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship

between Cisco and any other company. (1721R)

PREFACE

CHAPTER 1

CHAPTER 2

Preface ix

Audience ix

Document Conventions ix

Audience

Note

Preface

This preface describes the audience, organization, and conventions of the Cisco Aironet Wave 2 Access Point Command Reference. It also provides information about how to obtain other documentation.

• Audience, on page ix

• Document Conventions, on page ix

• Related Documentation, on page xii

• Obtaining Documentation and Submitting a Service Request, on page xii

This publication is for experienced network administrators who configure and maintain Cisco Aironet Wave 2 Access Points.

Usage of test commands may cause system disruption such as unexpected reboot of the Cisco AP. Therefore, we recommend that you use the test commands on Cisco APs for debugging purposes with the help of Cisco Technical Assistance Center (TAC) personnel.

Document Conventions

This document uses the following conventions:

italic font

{x | y | z }

[ x | y | z ]

IndicationConvention

Commands and keywords and user-entered text appear in bold font.bold font

Document titles, new or emphasized terms, and arguments for which you supply values are in italic font.

Elements in square brackets are optional.[ ]

Required alternative keywords are grouped in braces and separated by vertical bars.

Optional alternative keywords are grouped in brackets and separated by vertical bars.

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

Preface

IndicationConvention

Note

Tip

Caution

string

A nonquoted set of characters. Do not use quotation marks around the string or the string will include the quotation marks.

Terminal sessions and information the system displays appear in courier font.courier font

Nonprinting characters such as passwords are in angle brackets.<>

Default responses to system prompts are in square brackets.[]

!, #

An exclamation point (!) or a pound sign (#) at the beginning of a line of code indicates a comment line.

Means reader take note. Notes contain helpful suggestions or references to material not covered in the manual.

Means the following information will help you solve a problem.

Means reader be careful. In this situation, you might perform an action that could result in equipment damage or loss of data.

Warning

This warning symbol means danger. You are in a situation that could cause bodily injury. Before you work on any equipment, be aware of the hazards involved with electrical circuitry and be familiar with standard practices for preventing accidents. (To see translations of the warnings that appear in this publication, refer to the appendix "Translated Safety Warnings.")

DescriptionWarning Title

Waarschuwing

Dit waarschuwingssymbool betekent gevaar. U verkeert in een situatie die lichamelijk letsel kan veroorzaken. Voordat u aan enige apparatuur gaat werken, dient u zich bewust te zijn van de bij elektrische schakelingen betrokken risico's en dient u op de hoogte te zijn van standaard maatregelen om ongelukken te voorkomen. (Voor vertalingen van de waarschuwingen die in deze publicatie verschijnen, kunt u het aanhangsel "Translated Safety Warnings" (Vertalingen van veiligheidsvoorschriften) raadplegen.)

Varoitus

Tämä varoitusmerkki merkitsee vaaraa. Olet tilanteessa, joka voi johtaa ruumiinvammaan. Ennen kuin työskentelet minkään laitteiston parissa, ota selvää sähkökytkentöihin liittyvistä vaaroista ja tavanomaisista onnettomuuksien ehkäisykeinoista. (Tässä julkaisussa esiintyvien varoitusten käännökset löydät liitteestä "Translated Safety Warnings" (käännetyt turvallisuutta koskevat varoitukset).)

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

Preface

DescriptionWarning Title

Attention

Warnung

Avvertenza

Advarsel

Ce symbole d'avertissement indique un danger. Vous vous trouvez dans une situation pouvant entraîner des blessures. Avant d'accéder à cet équipement, soyez conscient des dangers posés par les circuits électriques et familiarisez-vous avec les procédures courantes de prévention des accidents. Pour obtenir les traductions des mises en garde figurant dans cette publication, veuillez consulter l'annexe intitulée « Translated Safety Warnings » (Traduction des avis de sécurité).

Dieses Warnsymbol bedeutet Gefahr. Sie befinden sich in einer Situation, die zu einer Körperverletzung führen könnte. Bevor Sie mit der Arbeit an irgendeinem Gerät beginnen, seien Sie sich der mit elektrischen Stromkreisen verbundenen Gefahren und der Standardpraktiken zur Vermeidung von Unfällen bewußt. (Übersetzungen der in dieser Veröffentlichung enthaltenen Warnhinweise finden Sie im Anhang mit dem Titel "Translated Safety Warnings" (Übersetzung der Warnhinweise).)

Questo simbolo di avvertenza indica un pericolo. Si è in una situazione che può causare infortuni. Prima di lavorare su qualsiasi apparecchiatura, occorre conoscere i pericoli relativi ai circuiti elettrici ed essere al corrente delle pratiche standard per la prevenzione di incidenti. La traduzione delle avvertenze riportate in questa pubblicazione si trova nell'appendice, "Translated Safety Warnings" (Traduzione delle avvertenze di sicurezza).

Dette varselsymbolet betyr fare. Du befinner deg i en situasjon som kan føre til personskade. Før du utfører arbeid på utstyr, må du være oppmerksom på de faremomentene som elektriske kretser innebærer, samt gjøre deg kjent med vanlig praksis når det gjelder å unngå ulykker. (Hvis du vil se oversettelser av de advarslene som finnes i denne publikasjonen, kan du se i vedlegget "Translated Safety Warnings" [Oversatte sikkerhetsadvarsler].)

Aviso

¡Advertencia!

Varning

Este símbolo de aviso indica perigo. Encontra-se numa situação que lhe poderá causar danos fisicos. Antes de começar a trabalhar com qualquer equipamento, familiarize-se com os perigos relacionados com circuitos eléctricos, e com quaisquer práticas comuns que possam prevenir possíveis acidentes. (Para ver as traduções dos avisos que constam desta publicação, consulte o apêndice "Translated Safety Warnings" - "Traduções dos Avisos de Segurança").

Este símbolo de aviso significa peligro. Existe riesgo para su integridad física. Antes de manipular cualquier equipo, considerar los riesgos que entraña la corriente eléctrica y familiarizarse con los procedimientos estándar de prevención de accidentes. (Para ver traducciones de las advertencias que aparecen en esta publicación, consultar el apéndice titulado "Translated Safety Warnings.")

Denna varningssymbol signalerar fara. Du befinner dig i en situation som kan leda till personskada. Innan du utför arbete på någon utrustning måste du vara medveten om farorna med elkretsar och känna till vanligt förfarande för att förebygga skador. (Se förklaringar av de varningar som förekommer i denna publikation i appendix "Translated Safety Warnings" [Översatta säkerhetsvarningar].)

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

Preface

Obtaining Documentation and Submitting a Service Request

For information about obtaining documentation, submitting a service request, and gathering additional information, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:

http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html

Subscribe to the What's New in Cisco Product Documentation as an RSS feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service. Cisco currently supports RSS Version 2.0.

xii

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

Using the Command Line Interface

This chapter describes the Cisco Aironet Wave 2 AP command-line interface (CLI) and how to use it to configure your AP.

• Understanding Command Modes, on page 2

• Understanding Abbreviated Commands, on page 3

• Understanding no Forms of Commands, on page 4

• Understanding CLI Error Messages, on page 5

• Configuring the Terminal, on page 6

• Recalling Commands, on page 7

• Accessing the CLI, on page 8

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

Understanding Command Modes

The Cisco Aironet Wave 2 AP command line interface is divided into the following two different modes:

• User EXEC mode—When you start a session on the AP, you begin in the User EXEC mode. Only a limited subset of the commands are available in this mode. Also, the show commands that are available in the User EXEC mode are a subset of the show commands that are available in the Privileged EXEC mode.

The user EXEC commands are not saved when the AP is rebooted.

• Privileged EXEC mode—In this mode, you will have access to all commands. You are required to enter a password to enter the Privileged EXEC mode.

The commands available to you depend on which mode you are currently in. Enter a question mark (?) at the system prompt to obtain a list of commands available for the command mode you are in. For example, here are the list of User EXEC mode commands available:

cisco-wave2-ap>? Exec mode commands

enable Turn on privileged commands logout Logout out from CLI ping Send echo messages show Show running system information

Using the Command Line Interface

Table 1: Command Mode Summary

User EXEC

Begin a session with your switch.

Privileged EXEC

While in user EXEC mode, enter the enable command and enter the password when prompted.

cisco-wave2-ap>

cisco-wave2-ap#

Enter logout or quit.

Enter disable to exit.

About This ModeExit MethodPromptAccess MethodMode

Use this mode to

• Change terminal settings.

• Perform basic tests.

• Display system information.

Use this mode to verify commands that you have entered. Use a password to protect access to this mode.

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

Using the Command Line Interface

Understanding Abbreviated Commands

You need to enter only enough characters for the AP to recognize the command as unique.

This exampleshows how to enter the show configuration privileged EXEC command in an abbreviated form:

cisco-wave2-ap# show conf

Understanding Abbreviated Commands

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

Understanding no Forms of Commands

While you need to use the debug command to enable debugs on many features, the prefix no disables debugs on those respective features. For example:

Command to enable debug:

cisco-wave2-ap# debug client ...

Command to disable debug:

cisco-wave2-ap# no debug client ...

Using the Command Line Interface

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

Using the Command Line Interface

Understanding CLI Error Messages

This table lists some error messages that you might encounter while using the CLI to configure your AP.

Table 2: Common CLI Error Messages

Understanding CLI Error Messages

How to Get HelpMeaningError Message

% Ambiguous command: "show con"

% Incomplete command.

% Invalid input detected at ‘^’ marker.

You did not enter enough characters for your AP to recognize the command.

You did not enter all the keywords or values required by this command.

You entered the command incorrectly. The caret (^) marks the point of the error.

Enter the command again followed by a question mark (?) with a space between the command and the question mark.

The possible keywords that you can enter with the command appear.

Enter the command again followed by a question mark (?) with a space between the command and the question mark.

The possible keywords that you can enter with the command appear.

Enter a question mark (?) to display all the commands that are available in this command mode.

The possible keywords that you can enter with the command appear.

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

Configuring the Terminal

Before you begin

Enter the Privileged EXEC mode.

Procedure

• Configure the number of lines on the screen by entering this command:

terminal length number-of-lines

Valid range is 0 to 512. If you enter 0, there will be no pausing.

Example:

cisco-wave2-ap# terminal length 20

• Copy debug output to the current terminal line by entering this command:

terminal monitor

• Disable logging to the current terminal line by entering this command:

terminal monitor disable

• Specify the terminal type by entering this command:

terminal type type-name

• Configure the number of characters that should be displayed on a screen line by entering this command:

terminal width number-of-characters

Using the Command Line Interface

Valid range is 0 to 132.

Example:

cisco-wave2-ap# terminal width 30

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

Using the Command Line Interface

Recalling Commands

To recall commands from the history buffer, perform one of the actions listed in this table. These actions are optional.

Note

The arrow keys function only on ANSI-compatible terminals such as VT100s.

Table 3: Recalling Commands

Recalling Commands

ResultAction

Press the up arrow key

Press the down arrow key

Recalls commands in the history buffer, beginning with the most recent command. Repeat the key sequence to recall successively older commands.

Returns to more recent commands in the history buffer after recalling commands with the up arrow key. Repeat the key sequence to recall successively more recent commands.

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

Accessing the CLI

You can access the CLI through a console connection, through Telnet, or by using the browser. Commands you enter in one session are not displayed in the other sessions. Therefore, it is possible to lose track of the session from which you entered commands.

Using the Command Line Interface

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

capwap Commands

• capwap ap, on page 10

• capwap ap auth-token, on page 11

• capwap ap erase, on page 12

• capwap ap ethernet, on page 13

• capwap ap hostname, on page 14

• capwap ap ip, on page 15

• capwap ap lag, on page 16

• capwap ap mode, on page 17

• capwap ap restart, on page 18

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

capwap ap

capwap Commands

To configure the primary, secondary and tertiary controllers for the AP, use the capwap ap command.

capwap ap {primary-base | secondary-base | tertiary-base}

controller-name controller-ip-address

Syntax Description

Command Modes

Command History

Configure AP's primary controllerprimary-base

Configure AP's secondary controllersecondary-base

Configure AP's tertiary controllertertiary-base

controller-name

controller-ip-address

Privileged EXEC (#)

ModificationRelease

8.1.111.0

Examples

The following example shows how to configure the primary controller for the AP:

cisco-wave2-ap# capwap ap primary-base wlc-5520 209.165.200.224

This command was introduced.

Name of the controller

IP address of the controller.

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

capwap Commands

capwap ap auth-token

To configure authentication token, use the capwap ap auth-token command.

capwap ap auth-token ssc-token

capwap ap auth-token

Syntax Description

Command Modes

Command History

ssc-token

Privileged EXEC (#)

8.1.111.0

Examples

The following example shows how to configure authentication token,:

cisco-wave2-ap# capwap ap auth-token myauthtoken

SSC token; valid range is 8 to 32 characters

ModificationRelease

This command was introduced.

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

capwap ap erase

To erase CAPWAP configuration, use the capwap ap erase command.

capwap ap erase {all | static-ip}

capwap Commands

Syntax Description

Command Modes

Command History

all

Privileged EXEC (#)

8.1.111.0

Examples

The following example shows how to erase all the CAPWAP configuration on the AP:

cisco-wave2-ap# capwap ap erase all

Erases all CAPWAP configuration

Note

Erase static IP or DNS configurationstatic-ip

ModificationRelease

This command was introduced.

If the AP is in Bridge mode, then the same Bridge mode is retained after the factory reset of the AP; if the AP is in FlexConnect, Local, Sniffer, or any other mode, then the AP mode is set to Local mode after the factory reset of the AP. If you press the Reset button on the AP and perform a true factory reset, then the AP moves to a cookie configured mode.

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

capwap Commands

capwap ap ethernet

To configure AP Ethernet parameters, use the capwap ap ethernet command.

capwap ap ethernet tag ethernet-vlan-id

capwap ap ethernet

Syntax Description

Command Modes

Command History

ethernet-vlan-id

Privileged EXEC (#)

ModificationRelease

8.1.111.0

Examples

The following example shows how to configure Ethernet VLAN tagging on the AP:

cisco-wave2-ap# capwap ap ethernet tag 2

This command was introduced.

Ethernet VLAN ID; valid range is 0 to 4094. If you enter the VLAN ID value as 0, the VLAN tagging is disabled.

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

capwap ap hostname

To configure AP hostname, use the capwap ap hostname command.

capwap ap hostname ap-name

capwap Commands

Syntax Description

Command Modes

Usage Guidelines

Command History

ap-name

Privileged EXEC (#)

If the AP is already associated with a Cisco WLC, the new hostname is reflected on the Cisco WLC only after the AP dissociates and reassociates with the Cisco WLC.

8.1.111.0

Examples

The following example shows how to configure a hostname for the AP:

cisco-wave2-ap# capwap ap hostname cisco-wave2-ap-2802

AP name

ModificationRelease

This command was introduced.

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

capwap Commands

capwap ap ip

To configure static IP address and DNS for the CAPWAP AP, use the capwap ap ip command.

capwap ap ip static-ip-addr static-netmask ip-addr-default-gateway [ip-addr-dns1 | ip-addr-dns2]

[domain-name]

capwap ap ip

Syntax Description

Command Modes

Command History

static-ip-addr

static-netmask

ip-addr-default-gateway

[ip-addr-dns1 | ip-addr-dns2]

[domain-name]

Static IP address of the AP

Static netmask

IP address of the default gateway

(Optional parameters) IP address(es) of the DNS

(Optional parameter) Domain name

Privileged EXEC (#)

ModificationRelease

8.1.111.0

This command was introduced.

Examples

The following example shows how to configure static IP address and DNS for the CAPWAP AP:

cisco-wave2-ap# capwap ap ip 209.165.200.225 255.255.255.224 209.165.200.227 209.165.200.226

example.org

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

capwap ap lag

To configure CAPWAP lag, use the capwap ap lag command.

capwap ap lag {enable | disable}

capwap Commands

Syntax Description

Command Modes

Command History

enable

disable

Privileged EXEC (#)

8.1.111.0

Examples

The following example shows how to enable LAG on the AP:

cisco-wave2-ap# capwap ap lag enable

Enables LAG

Disables LAG

ModificationRelease

This command was introduced.

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

capwap Commands

capwap ap mode

To configure AP mode, use the capwap ap mode command.

capwap ap mode {bridge | local}

capwap ap mode

Syntax Description

Command Modes

Command History

bridge

Privileged EXEC (#)

8.1.111.0

Examples

The following example shows how to configure the AP to operate in local mode:

cisco-wave2-ap# capwap ap mode local

Enables bridge mode

Enables local modelocal

ModificationRelease

This command was introduced.

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

capwap ap restart

To restart the CAPWAP protocol, use the capwap ap restart command.

capwap ap restart

capwap Commands

Syntax Description

Command Modes

Command History

restart

Privileged EXEC (#)

8.1.111.0

Examples

The following example shows how to restart CAPWAP protocol:

cisco-wave2-ap# capwap ap restart

Restart the CAPWAP protocol

ModificationRelease

This command was introduced.

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

+ 134 hidden pages

Cisco Aironet Wave 2 Cli Command Reference Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Cisco Aironet Wave 2 Access Point Command Reference, Release 8.7

CONTENTS

Audience

Preface

Document Conventions

Related Documentation

Obtaining Documentation and Submitting a Service Request

Using the Command Line Interface

Understanding Command Modes

Understanding Abbreviated Commands

Understanding no Forms of Commands

Understanding CLI Error Messages

Configuring the Terminal

Recalling Commands

Accessing the CLI

capwap Commands

capwap ap

capwap ap auth-token

capwap ap erase

capwap ap ethernet

capwap ap hostname

capwap ap ip

capwap ap lag

capwap ap mode

capwap ap restart