VASE-CLI — Command Line Interface для управления платформой СКАТ [Документация VAS Experts]

VASE-CLI — Command Line Interface для управления платформой СКАТ

Назначение

VASE-CLI — командная оболочка для управления продуктами VAS Experts и сопутствующими сторонними продуктами.
Оболочка состоит из модулей main, fdpi, bird, kea, frad. Подробнее в разделе Модули.

Установка и обновление

Способ 1. Выполнить скрипт:

source <(curl https://vasexperts.ru/install/vase-cli-rpm_install.sh)

Способ 2. Добавить репозитории VASE и выполнить:

yum install vase-cli

Обновление производится теми же способами, что и установка.

Настройки

Управление пользователями и группами

Для создания и управления пользователями, VASE-CLI нужно запустить под пользователем root с помощью команды vase-cli.

По умолчанию созданы следующие группы пользователей:

  • vase-cli-w — группа с правами на запись (пользователи могут редактировать файлы).
  • vase-cli-r — группа с правами только на чтение (пользователи могут только просматривать файлы в системе).
  • tacacs0..tacacs15 — группы с правами на запись для подключения авторизации и аккаунтинга в TACACS+. Эти группы используются если включен TACACS+ — подробнее.

Создание пользователя с правами на запись

adduser <username>
usermod -aG vase-cli-w <username>
usermod -s /usr/bin/vase-cli-shell <username>

Создание пользователя с правами на чтение

adduser <username>
usermod -aG vase-cli-r <username>
usermod -s /usr/bin/vase-cli-shell <username>

Конфигурация VASE-CLI

Все настройки доступны в файле /etc/vase-cli/.env
Возможные опции доступны в файле /etc/vase-cli/sample.env

Также есть пользовательские настройки, которые доступные внутри VASE-CLI в модуле main. Управляются через команду config. Для подсказки наберите help.

Настройка TACACS+

В VASE-CLI настроена интеграция с сервером авторизации TACACS+. При желании можно подключить авторизацию и аккаунтинг через TACACS+ в /etc/vase-cli/.env.
Пример можно увидеть в /etc/vase-cli/sample.env.
Пример конфигурации TACACS сервера находится в /etc/vase-cli/tacacs_server.sample.conf.

Для полной поддержки TACACS+ (авторизация нелокальных пользователей) рекомендуется установить пакет bngtacplus:
dnf install bngtacplus

Модули

main

Главный модуль VASE-CLI, включается по умолчанию. В этом модуле доступно управление основными возможностями VASE-CLI (просмотр конфигурационных и лог-файлов, версии оболочки).

Перейти в модуль — use main
Открыть подсказку по модулю — help

fdpi

Настройка конфигурации fastdpi и fastpcrf. В этом модуле можно прозрачно выполнять действия с fdpi_ctrl и fdpi_cli, работать с файлами, управлять услугами, абонентами и полисингом, продуктами VAS Experts: BRAS, DPI, NAT, DHCP.

Перейти в модуль — use fdpi
Открыть подсказку по модулю — help

Подмодули:

  • модуль файловой системы
  • fdpi модуль
  • управление fastdpi
  • управление абонентами
  • управление полисингами
  • управление услугами
  • BRAS - управление абонентами
  • BRAS - управление DHCP/DHCP6
  • BRAS - управление PCRF
  • BRAS - управление PPPoE
  • управление VLAN трансляция
  • Утилиты DPI
  • DPI nat
  • Приоритезация DSCP

bird

Настройка конфигурации и запрос действий в bird и bird netns.

Перейти в модуль — use bird
Открыть подсказку по модулю — help

Подмодули:

  • конфигурация модуля
  • обновление конфигурации модуля и перезапуск
  • команды настройки bird
  • команды bird
  • команды bird netns
  • логи модуля

kea

Настройка конфигурации и запрос действий в kea4 и kea6.

Перейти в модуль — use kea
Открыть подсказку по модулю — help

Подмодули:

  • управление dhcp-арендой IPv4
  • управление dhcp-арендой IPv6
  • конфигурация модуля
  • обновление конфигурации модуля и перезапуск
  • логи модуля

frad

Управление Radius proxy на базе freeRadius — просмотр и редактирование конфигурации freeradius.

Перейти в модуль — use frad
Открыть подсказку по модулю — help