Справочное руководство по интерфейсу командной строки
(CLI Reference Guide)
NWS v 1.0.0
Содержание
- Глава 1. Обзор интерфейса командной строки
- Гл ава 2. Базовые команды CLI и навигация
- Глава 3. Команды show (Show commands)
- Глава 4. System-команды и немедленные действия (Immediate actions)
- Глава 5. Настройка Site (Site configuration)
- Глава 6. Настройка Profile (Profile configuration)
- Глава 7. Настройка Device (Device configuration)
- Глава 8. Настройка Radio interface
- Глава 9. Настройка WLAN policy
- Глава 10. Настройка Management policy
- Глава 11. Настройка DHCP policy
- Глава 12. Настройка NAT policy
- Глава 13. Настройка Firewall policy
- Глава 14. Настройка Route policy
- Глава 15. Принятие AP (AP adoption)
- Глава 16. Настройка Auto provision policy
- Глава 17. Firmware, boot, upgrade и reload
- Глава 18. ACS (Auto Channel Select)
- Глава 19. Диагностика, мониторинг и сессии
- Глава 20. Краткая карта CLI-команд
Глава 1. Обзор интерфейса командной строки
1. Назначение главы
В этой главе приведён обзор CLI контроллера и управляемых Wi-Fi AP: как читать синтаксис команд, какие режимы используются, как применяется конфигурация и чем отличаются команды только для чтения, команды конфигурации и команды немедленного действия.
Глава не является полным перечнем команд. Подробное описание синтаксиса, параметров и особенностей использования приводится в следующих главах справочника.
2. Область действия
Справочник описывает пользовательские команды текущего релиза контроллера и управляемых AP.
3. Соглашения по синтаксису
Фиксированные слова CLI записываются как есть. Пользователь вводит их буквально.
show running-config
Переменные значения записываются в угловых скобках.
device <AP ID>
Необязательные параметры записываются в квадратных скобках.
commit [write]
Взаимоисключающие варианты записываются через вертикальную черту. В такой позиции выбирается один из вариантов.
self|all|ap <AP ID>
Повторяемые элементы записываются с многоточием.
system adopt <AP ID> [<AP ID> ...]
4. Режимы CLI
CLI использует несколько уровней работы. Приглашение CLI показывает текущий режим.
| Режим | Общий вид приглашения | Назначение |
|---|---|---|
| Административный режим (EXEC) | <hostname># | Операционный режим верхнего уровня. Используется для просмотра состояния и выполнения команд, которые не требуют входа в режим конфигурации. |
| Режим глобальной конфигурации | <hostname>(config)# | Основной режим настройки. Из него выполняется переход в контексты конфигурации для настройки отдельных объектов, политик и интерфейсов. |
| Контекст конфигурации / вложенный контекст | <hostname>(config-...)# | Настройка конкретного объекта, политики или вложенного интерфейса. |
Вход в global configuration mode выполняется командами configure или configure terminal. Обе формы выполняют одно и то же действие.
Типовая схема перехода между режимами:
<hostname># configure terminal
<hostname>(config)# <context command>
<hostname>(config-...)# exit
<hostname>(config)# exit
<hostname>#
Подробные команды навигации, точные prompt examples и примеры переходов описаны в главе 2.
5. Типы команд
5.1 Команды только для чтения
Read-only commands показывают состояние системы, конфигурацию или runtime-информацию и не должны изменять конфигурацию или состояние устройства.
Три команды связаны с общей моделью конфигурации:
| Команда | Роль |
|---|---|
| show context | Показывает конфигурацию текущего context, включая ещё не применённые изменения. |
| show running-config | Показывает применённую running-config. |
| show startup-config | Показывает сохранённую startup-config. |
Остальные show commands описываются в главе 3 и тематических главах.
5.2 Команды конфигурации
Configuration commands изменяют конфигурацию текущего context. Такие изменения применяются к running-config только после commit. Если изменения должны сохраниться после reboot, используется commit write.
Configuration commands обычно выполняются внутри configuration contexts: WLAN, profile, device, site, management policy, DHCP policy, NAT policy, firewall policy, route policy, auto-provision policy и других тематических разделов CLI.
5.3 Команды system и команды немедленного действия
system commands и другие immediate actions выполняются немедленно. Они не требуют commit и не откатываются через revert.
К командам немедленного действия относятся такие категории действий, как принятие AP, операции с прошивкой, перезагрузка, управление пользователями, управление сессиями, мониторинг и диагностика сетевой связности. Подробный синтаксис и предупреждения для конкретных команд описываются в главе 2 и тематических главах.
6. Модель применения конфигурации
CLI использует staged configuration model.
context config -> commit -> running-config
context config -> commit write -> running-config + startup-config
revert -> discard uncommitted context changes
commit применяет изменения к running-config.
commit write применяет изменения и сохраняет их в startup-config.
revert отбрасывает изменения контекстной конфигурации, ещё не применённые командой commit.
7. Контекстная справка
CLI поддерживает контекстную справку через ?. Подробные правила использования ?, примеры и help-выводы описываются в главе 2 и тематических главах.
8. NO-формы
no-форма — это отрицательная форма команды, которая используется для отмены, удаления или отключения ранее заданной настройки. Для configuration commands изменения через no-формы применяются к running-config после commit. Подробное описание no <command> приведено в главе 2. Конкретные no-формы описываются в тематических главах рядом с соответствующими командами.
9. Конфиденциальные значения
Чувствительные данные в примерах маскируются, например:
encryption-settings security-psk-key ********
Подробности поведения конкретных команд и выводов, связанных с sensitive data, описываются в соответствующих разделах справочника.
10. Примеры в справочнике
В примерах могут использоваться условные значения, например <hostname>, <AP ID> и <NAME>. Реальные значения в выводах приводятся только там, где они
нужны для понимания поведения команды.