1.4. Интерфейс командной строки (CLI)

Основной пользовательский интерфейс коммутатора реализован в виде интерфейса командной строки (Command Line Interface). CLI разделен на различные режимы. От используемого режима зависят доступные пользователю команды.

Пользователь может запустить сеанс CLI, подключившись к коммутатору через VTY или консольный порт.

Доступ к CLI

Доступ к CLI через консольный порт или через VTY

Перед получением доступа к CLI необходимо подключиться к консольному порту или mgmt-порту коммутатора, как описано в Инструкции по установке и запуску.

Для получения доступа к CLI можно использовать один из следующих методов:

  • Прямое подключение консольного порта к ПК.

  • Подключение консольного порта к консольному серверу для удаленного доступа.

  • Удаленное подключение по выделенной mgmt-сети (OOB) или по рабочей сети (IB) через VTY (Telnet или SSH).

Поддерживаемое количество одновременных сессий VTY (независимо от типа подключения):

Версия AqNOS

Количество сессий

7.0 - 7.4.0

8

7.4.1 и выше

16

Доступ к CLI при стекировании

Пользователь может получить доступ к CLI коммутаторов, объединенных в стек. Выполняется управление всем стеком через мастер-коммутатор.

Для управления необходимо подключиться к мастер-коммутатору через консольный порт.

Важно!

Рекомендуется использовать один сеанс CLI при управлении стеком коммутаторов.

При стекировании все команды рекомендуется выполнять на Master-коммутаторе. Однако, могут возникать ситуации, когда необходимо выполнить некоторые действия на Slave-коммутаторе.

Вывод команд, доступных на Slave-коммутаторе:

SW1(Slave:2)# ?
Exec commands:
  boot       Specify boot parameter
  clear      Reset functions
  configure  Enter configuration mode
  debug      Debugging functions
  disable    Disable
  enable     Enable
  exit       Exit from the EXEC
  generate   Generate
  help       Description of the interactive help system
  logout     Exit from the EXEC
  no         Negate a command or set its defaults
  quit       Exit from the EXEC
  reboot     Halt and perform a warm restart
  reload     Halt and perform a warm restart
  set        Set device attribute
  show       Show running system information
  stack      Switch box Stacking
  terminal   Set terminal line parameters
  write      Write running configuration to memory, network, or terminal

В случае, если доступ к порту управления Master-коммутатора затруднен, возможен доступ к Master-коммутатору с порта управления Slave-коммутатора.

Режимы ввода команд

Режим Default EXEC или User EXEC (пользовательский режим) доступен после запуска сеанса CLI. В данном режиме доступен ограниченный набор команд мониторинга, например: ping, traceroute, или подключение к другим сетевым устройствам по telnet, ssh.

Режим Privileged EXEC (привилегированный режим) используется для выполнения команд мониторинга, диагностики и эксплуатации коммутатора. Например: команды show … - отображают текущую конфигурацию, команды clear … - очищают счетчики…

Режимы Global Config (режим глобальной конфигурации) и Specific Config (специальный режим конфигурации) используются для внесения изменений в текущую конфигурацию коммутатора. После сохранения конфигурации результаты ввода команд сохранятся и будут использованы немедленно или после перезагрузки коммутатора.

Описание режимов командной строки:

Название

Назначение

Способы входа

Системная подсказка по умолчанию

Способы выхода

Default EXEC (User EXEC)

Изменение настроек терминала, выполнение базовых проверок, вывод информации о системе.

Подключение через сетевой, управляющий или консольный порт

Switch>

Ввод команды logout, enable или quit

Privileged EXEC

Доступ ко всем командам, проверка введенных команд

Ввод команды enable в режиме Default EXEC

Switch#

Ввод команды disable, exit или quit

Global Сonfig

Глобальная (общая) настройка коммутатора

Ввод команды configure terminal в режиме Privileged EXEC

Switch(config)#

Ввод команды end, exit или quit. Нажатие комбинации клавиш <Ctrl>+<Z> соответствует команде end

Specific Сonfig

Общее название режимов настройки интерфейсов, параметров или служб. Конкретные названия режимов указаны в Справочнике по командам.

Ввод соответствующей команды после системной подсказки Switch(config)#

Switch(config-...)#

Ввод команды exit,end или quit. Нажатие комбинации клавиш <Ctrl>+<Z> соответствует команде endend

Контекстная справка

Для вывода описания контекстной справки необходимо ввести команду help.

Для вызова контекстной справки необходимо ввести символ ? после системной подсказки или введенного фрагмента команды в любом из режимов.

При вводе символа ? через пробел будет выведен список доступных далее команд, ключевых слов и переменных.

При вводе символа ? после фрагмента команды или ключевого слова без пробела будет выведен список доступных для ввода команд с учетом незавершенного фрагмента.

При вводе символа ? после полностью введенного ключевого слова будет выведено описание данного ключевого слова.

Примечание

Выводятся команды, доступные для текущего режима, из которого была вызвана контекстная справка.

Примеры применения

Вывод описания контекстной справки:

Switch# help                          
AQUARIUS CLI provides advanced help feature.  When you need help, anytime at the command line please press '?'.

If nothing matches, the help list will be empty and you must backup until entering a '?' shows the available options.
Two styles of help are provided:
1. Full help is available when you are ready to enter a
   command argument (e.g. 'show ?') and describes each possible
   argument.
2. Partial help is provided when an abbreviated argument is entered
   and you want to know what arguments match the input
   (e.g. 'show ve?').

Вывод доступных команд по <фрагмент команды>+<?>:

Switch# di?
dir
disable

Вывод доступной команды по <фрагмент команды>+<Tab>:

Switch# sh<Tab>
Switch# show 

Вывод команд, доступных в текущем режиме:

Switch> ?
Exec commands:
  cd          System command cd
  dir         System command ls
  disable     Disable
  enable      Enable
  ethernet    Ethernet Configuration Commands
  exit        Exit from the EXEC
  help        Description of the interactive help system
  logout      Exit from the EXEC
  ls          System command ls
  md5sum      System command md5sum
  no          Negate a command or set its defaults
  ping        Send echo messages
  pwd         System command pwd
  quit        Exit from the EXEC
  ssh         Open a secure shell client connection
  telnet      Open a telnet connection
  terminal    Set terminal line parameters
  traceroute  Trace route to destination

Вывод описания ключевого слова:

Switch# show users?
  users  Display information about terminal lines

Ввод команд

Ввод сокращенных команд

При вводе команды достаточно ввести минимальное количество символов, необходимое для распознания команды.

Ниже показано, как можно ввести команду show running-config в сокращенной форме:

Switch# sh run 

“No” - форма и значения по умолчанию

Большинство команд имеют форму no. Форма no используется для отключения функции или отмены действия команды.

Например, команда no shutdown отменяет отключение порта.

Использование команды без ключевого слова no повторно включает отключенную функцию или включает функцию, отключенную по умолчанию.

Команды также могут иметь форму c ключевыми словами enable или disable.

Редактирование команд

Функция редактирования команд всегда включена.

Для редактирования команд могут применяться следующие клавиши:

Клавиши

Действие

<Ctrl>+<B> / <Стрелка влево>

Перемещение курсора на один символ назад

<Ctrl>+<F> / <Стрелка вправо>

Перемещение курсора на один символ вперед

<Ctrl>+<А>

Перемещение курсора в начало командной строки

<Ctrl>+<E>

Перемещение курсора в конец командной строки

<Esc>+<B>

Перемещение курсора на одно слово назад

<Esc>+<F>

Перемещение курсора на одно слово вперед

<Ctrl>+<T>

Замена местами символа, находящегося слева от курсора, с символом, выделенным курсором.

<Delete> / <Backspace>

Удаление символа, находящегося слева от курсора.

<Ctrl>+<D>

Удаление символа, выделенного курсором

<Ctrl>+<K>

Удаление всех символов от курсора до конца строки

<Ctrl>+<U>

Удаление всех символов

<Ctrl>+<W>

Удаление слова слева от курсора

<Esc>+<D>

Удаление всех символов от курсора до конца слова

<Esc>+<C>

Преобразование символа, выделенного курсором, в заглавный (ВЕРХНИЙ РЕГИСТР) и перевод курсора в конец строки

<Esc>+<L>

Преобразование символа, выделенного курсором, в строчный (нижний регистр) и перевод курсора в конец строки

<Esc>+<U>

Преобразование букв от курсора до конца слова в заглавные (ВЕРХНИЙ РЕГИСТР)

<Enter>

Выполнение команды [1]

<Пробел>

Прокрутка вниз на один экран

Для команд, выходящих за пределы одной строки, будет выполнен перенос. Когда курсор достигает правого края, командная строка смещается на десять символов влево. Чтобы вернуться к началу ввода команды, необходимо несколько раз нажать <Ctrl>+<B> / <Стрелку влево>, или <Ctrl>+<A> для перехода к началу строки.

Возможные ошибки и способы их устранения

В таблице ниже приведены некоторые сообщения об ошибках, с которыми пользователь может столкнуться при использовании CLI.

Сообщение об ошибке

Причина

Способы устранения

% Ambiguous command: "..."

Неуникальная команда: Введено недостаточно символов для распознания команды.

Повторный ввод команды, с символом ? в конце, без пробелов. Будут выведены доступные варианты ввода команды.

% Incomplete command

Неполная команда: Не введены все ключевые слова или значения, необходимые для выполнения команды.

Повторный ввод команды, с символом ? в конце через пробел. Будут выведены доступные варианты ключевых слов.

% Invalid input detected at ‘^’ marker

Обнаружен неверный ввод: Каретка ^ отмечает место ошибки.

Ввод символа ? после системной подсказки. Будут выведены все команды, доступные в текущем режиме.

Использование файловой системы

Для просмотра файловой системы коммутатора служат команды dir и ls. По данным командам выводится информация о файлах и папках, находящихся на коммутаторе. Команды dir и ls аналогичны по получаемому результату. Команды доступны в режимах Default EXEC и Privileged EXEC.

Пример использования команды dir:

Switch# dir
...
-rw-r--r-- 1 37592467 Apr 15 12:35 aqnos-cg1-7.6.0.bin
drwxr-xr-x 3     4096 Feb 28 19:31 boot
drwsrwsrwt 2     4096 Jan 12 11:10 cfg
drwsrwsrwt 3     4096 Jan 12 11:10 conf
-rw-r--r-- 1     1278 Mar  4 14:11 demostand-default-config
-rw-r----- 1      147 Apr 19 15:07 dhcpsnooping
-rw-r----- 1      151 Apr 19 15:07 dhcpv6snooping
drwsrwsrwt 2     4096 Jan  5 08:11 reboot-info
-rw-r--r-- 1     1278 Apr 17 08:22 startup-config.conf
-rw-r--r-- 1  1419851 Apr 10 09:23 syslog
-rw-r--r-- 1   786431 Apr  9 18:01 uboot-cg1-2.6.1.bin

Пример использования команды ls:

Switch# ls flash:/boot
Directory of flash:/boot
...
-rw-r--r-- 1  37592467 Apr 21 15:05 aqnos-cg1-7.6.0.bin
-rw-r--r-- 1  37621967 Apr 21 15:06 aqnos-cg1-7.6.1.bin

Дополнительные функции CLI

Отладка (режим Debug)

В процессе диагностики может возникать необходимость использования отладки. Функциональность отладки обеспечивает вывод служебной информации, связанной с работой различных служб коммутатора.

Доступна отладка следующих служб:

Служба

Описание

aaa

Authentication, authorization and accounting

alarm

Alarm

arp

IP Arp features

bfd

Bidirectional Forwarding Detection (BFD)

bgp

Border Gateway Protocol (BGP)

dhcp

DHCP

dhcpv6

DHCPv6

dot1x

IEEE 802.1X Port-Based Access Control

erps

ERPS

ethernet

Configure layer-2

gmrp

gmrp - GMRP commands

gvrp

gvrp - GVRP commands

igmp

Internet Group Management Protocol (IGMP)

ip

Internet Protocol (IP)

ipfix

IP Information Export(IPFIX)

ipsla

IP Service Level Agreement

ipsourceguard

IP

ipv6

IPv6

isis

Intermediate System - Intermediate System (IS-IS)

l2ping

L2 ping

lacp

LACP commands

lldp

Link Layer Discovery Protocol

loopback-detect

Loopback Detect Function

mcast

IPv4 multicast

mcast6

IPv6 multicast

mirror

Debug mirror module

mlag

Multi-Chassis Link Aggregation

mld

Multicast Listener Discovery (MLD)

monitor-link

Monitor link function

multi-link

Multi-Link

ospf

Open Shortest Path First (OSPF)

overlay

Overlay

pim

Protocol Independent Multicast (PIM)

pm

Performance Monitor

port-security

Security related command

rip

Routing Information Protocol (RIP)

rmon

Rmon Debug On

sflow

Sampled flow

smart-link

Smart-Link

snmp-agentx

SNMP (AgentX or SMUX)

stp

Spanning Tree Protocols (STP/RSTP/MSTP)

time-range

Debug time-range module

track

Tracking

tunnel

Debug tunnel module

udld

Unidirectional Link Detection

vlan-mapping

VLAN mapping

vrrp

Virtual Router Redundancy Protocol (VRRP)

Команды отладки доступны в режиме Privileged EXEC.

Команды на включение отладки, связанные с конкретными протоколами и функциями, начинаются с ключевого слова debug. Для вывода всей отладочной информации, необходимо после названия службы ввести аргумент all. Для настройки подмодуля и типа отображаемой информации необходимо после названия службы ввести соответствующие аргументы. Перечень аргументов для отладки каждой из служб можно посмотреть в Справочнике по командам или использовать контекстную справку (команда ?).

Ниже показаны примеры настройки отладки.

Вывод всей отладочной информации о службе Smart-link:

Switch# debug smart-link all

Вывод отладочной информации о пакетах DHCP Snooping:

Switch# debug dhcp snooping packet

Вывод служб, для которых включена отладка, и типов отображаемой информации:

Switch# show debugging status 
Debugging status:
Module          Sub Module      Type                    Status
============================================================
dhcp            snooping        packet                  on
smart-link      all             all                     on

Отключение отладки Smart-link:

Switch# no debug smart-link 

Отключение отладки всех служб:

Switch# no debug all

Журнал изменений конфигурации

Доступны регистрация и просмотр изменений конфигурации коммутатора для каждого сеанса и для каждого пользователя.

Служба регистрации отслеживает каждую примененную команду конфигурации, пользователя, введшего команду, время ввода команды и код возврата синтаксического анализатора для команды. Доступна отправка уведомлений в системный журнал.

Примечание

Регистрируются только изменения через CLI или HTTP.

История введенных команд

Коммутатор поддерживает хранение введенных пользователем команд. Функция истории команд полезна для повторного вызова длинных или сложных команд или записей, например списки доступа. Данная функция может быть настроена в соответствии с потребностями пользователя.

Для вызова ранее введенной команды необходимо выполнить одно из следующих действий:

Действие

Ожидаемый результат

Нажатие комбинации клавиш <Ctrl>+<P> или клавиши <Стрелка вверх>

Вызов ранее введенных команд, начиная с самой последней команды. Повторение действия последовательно вызывает более старые команды.

Ввод команды show history

Список последних введенных в режиме Privileged EXEC команд.

Поиск и фильтрация сообщений

Доступны поиск и фильтрация выведенной информации. Данная функция полезна для сортировки больших объемов данных или для исключения ненужных на текущий момент данных.

Пример использования:

Switch# show interface description | include up
eth-0-2     up         switch2
eth-0-3     up         switch3
eth-0-4     up         switch4
eth-0-5     up                 
vlan1       up
loopback0   up
loopback1   up

Switch# show processes cpu sorted | exclude 0.00
CPU utilization for five seconds: 5.12%; one minute: 5.55%; five minutes: 5.50%
  PID     TIME    %CPU TTY      COMMAND
 4023 01:02:18    0.50 ?        hsrvd
 4463 00:15:42    0.10 ?        bgpd
 4529 00:14:13    0.10 ?        nsm
    7 00:06:51    0.05 ?        rcu_sched

Switch# show running-config | begin line

...skipping
line con 0
 no line-password
 no login
line vty 0 15
 exec-timeout 35791 0
 privilege level 4
 no line-password
 login local
!
!

Важно!

Выражения для поиска чувствительны к регистру.