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

Общие сведения о системе
Начало работы с системой
Уникальные объекты, именованные и нумерованные списки

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

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

Именованный объект имеет в системе алфавитно-цифровое имя, причём начинаться оно должно, как правило, с буквы. В конфигурации элементы именованного списка выглядят так же, как и уникальные объекты, предопределённые в структуре меню.

ВНИМАНИЕ! Категорически не рекомендуется использовать имена, содержащие только заглавные буквы и знаки препинания. Имена такого вида зарезервированы для служебных целей.

Некоторые именованные списки допускают имена объектов только в строго определённом формате, например, br1. Такие имена могут вводиться как полностью, так и только в виде номера — в этом случае они автоматически приводятся к требуему формату. При этом номер создаваемого объекта не должен быть уже занят. Такие случаи оговариваются в документации особо.

Особым случаем являются именованные списки, в которых имена являются целыми числами. Внешне они могут быть похожи на нумерованные, но отличаются тем, что не упорядочиваются автоматически. Такие случаи также оговариваются в документации особо.

Элементы нумерованного списка идентифицируются номерами, начиная, как правило, с 1, например:

nsg:port.eth0.ifAddress> _print

1
: prefix = "1.2.3.4/24"
: _keep = true
2
: prefix = "5.6.7.8/24"
: _keep = true 

Иногда нумерация начинается с 0, чтобы подчеркнуть, что 0-й элемент является особенным в каком-то отношении.

Параметры, начинающиеся со знака подчёркивания (_), являются служебными. Они могут создаваться и удаляться системой автоматически и не предназначены для настройки пользователем; в последующих примерах они опускаются. В вышеприведённом примере таковым является параметр _keep, сигнализирующий о том, что данный узел создан пользователем.

Ключевое различие между двумя типами списков состоит в том, что нумерованные списки всегда являются плотными, т.е. система может перенумеровывать элементы подряд согласно определённым правилам. Предположим, что нумерованный список содержит N элементов, тогда:

Порядковый номер элемента в списке может рассматриваться как некоторый приоритет, а может и не рассматриваться — это зависит от природы конкретного списка и указано во встроенной справке. В частности, он не является приоритетом, если элементы списка имеют некий приоритизирующий параметр внутри себя: вес, метрику и т.п.

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

Для добавления элемента списка используются команды +, _new или _insert в меню узла списка. Они являются синонимами, нужный тип списка выбирается автоматически. Для удаления элемента, вместе со всеми его дочерними узлами, используются команды - или _remove в меню этого узла. В Web-интерфейсе используются кнопки Редактировать конфигурацию в текстовом режиме (Плюс) и Редактировать конфигурацию в текстовом режиме (Минус), соответственно.

Если параметр не содержится в конфигурации, то он имеет специальное значение nil.


© Network Systems Group 2015–2024 Отдел документации