Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
indent20

Tip

Для получения программного обеспечения для установки обратитесь в нашу службу технической поддержки с указанием Вашего лицензионного ключа и варианта предоставления ПО (ISO образ или DEB-пакеты).

Программное обеспечение контроллера беспроводных точек доступа Wi-Fi "WiCo" состоит из двух компонентов:

  1. Управляющий агент для точки доступа (firmware точки).
  2. Управляющий контроллер (ядро контроллера, коммуникационный агент, веб-интерфейс, СУБД и т.д).

...

  1. .

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

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

3.1 Системные требования 

Контроллер работает под управлением операционной системы Linux. Поддерживается работа в виртуальном окружении и на физическом сервере.

...

  • 2 vCPU или больше;
  • 4Gb RAM или больше;
  • 20Gb свободного места на диске или больше;
  • (опционально) дополнительный сетевой интерфейс для терминирования туннельного трафика VXLAN или GRE. Также терминацию туннелей можно выполнять и на отдельном Linux-сервере.

Контроллер использует следующие каталоги на сервере:

...

Путь

...

Содержимое

...

Контроллер (ядро и бэк-энд)

...

Файлы бэкапов базы данных контроллера

...

Лог-файлы точек доступа, собираемые с помощью rsyslog, а также лог-файлы контроллера и агента контроллера

  • VXLAN over WG от беспроводных клиентов через контроллер.

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

  • TCP:
    • 22 - SSH доступ к контроллеру;
    • 53 - DNS;
    • 80 - HTTP интерфейс контроллера;
    • 514 - Syslog;
    • 1883, 8883 - MQTT для связи с точками доступа;
    • 8080 - Websocket для работы кластерной конфигурации;
    • 5912 - SSH для подключения к точкам доступа напрямую или через NAT;
    • 18120, 18130 - RADIUS-Proxy
  • UDP:
    • 53 - DNS;
    • 123 - NTP;
    • 514 - Syslog;
    • 3799 - RADUIS CoA;
    • 4789 - VXLAN для работы клиентских туннелей;
    • 51820 - WireGuard для работы клиентских туннелей;

3

Все компоненты контроллера запускаются из-под непривилегированного пользователя с логином controller (интерактивный вход запрещён).

...

.2 Установка программного обеспечения

Программное обеспечение контроллера можно установить:

  • из образа виртуальной машины в форматах:OVF/VMDK (VMware, Hyper-VISO на виртуальную или физическую машину (рекомендуемый вариант);
  • QCOW2 (KVM);
  • на пустую виртуальную машину с OC Debian Linux или другой ОС на ее основе с использованием Debian при помощи менеджера пакетов.

...

...

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

В качестве эталонной системы для сборки пакетов и создания образов мы используем OC Debian Linux x64, версии 12.1российскую ОС Основа версии 3 (Onyx). Также по запросу возможна сборка пакетов или образов с адаптацией под другие дистрибутивы и форматы распространения.

Для установки из образа ISO:

  • Получите ISO образ для установки у нашей службы технической поддержки;
  • Запишите образ на внешний накопитель ( USB накопитель, DVD или CD-диск), либо примонтируйте его к виртуальной машине, и загрузитесь из него, выбрав накопитель или образ в BIOS машины или в системе виртуализации;
  • После запуска образа выберите раздел, в который необходимо установить систему контроллеру и подтвердите операцию установки. Внимание: при установке все данные в данном разделе будут удалены;
  • После окончания установки извлеките накопитель или отмонтируйте образ;
  • В конце установки машина будет перезапущена, после этого система и ПО контроллера загрузятся и будут готовы к работе.

Для установки с использованием менеджера пакетов:

  • Создайте "пустую" виртуальную машину с ОС на основе Debian x64, в которой имеется доступ в интернет;

  • Запросите у нашей службы поддержки ссылку на репозиторий DEB-пакетов;
  • После получения ссылки войдите в консоль созданной виртуальный машины и выполните следующие команды:, подставив полученную ссылку вместо https://example.com:

echo "deb [trusted=yes] https://example.com ./" | sudo tee /etc/apt/sources.list.d/00-controller.list

sudo apt update

sudo apt -y install fplus-controller

При настройке кластерной конфигурации контроллер необходимо установить на 2 машины соответственно (желательно идентичных по железной конфигурации).

После получения установочных файлов установите их путем развертывания образа виртуальной машины или с помощью менеджера пакетов apt-get. ПО контроллера имеет минимальные стандартные настройки и готово к использованию сразу после установки. 

После установки вы можете произвести дополнительные настройки контроллера (настроить параметры TCP/IP, DNS, кластерной конфигурации) при помощи терминального интерфейса, описанного в разделе в разделе 8.7 Графический терминальный интерфейс контроллера.

Warning

Если контроллер не будет иметь доступа к интернету, либо у вас в сети нет NTP серверов, то во избежание различных проблем с неработоспособностью контроллера или веб-интерфейса, настройте время вручную при помощи терминального графического интерфейса (см. раздел 8.7 Графический терминальный интерфейс контроллера). Даже если у машины контроллера есть доступ в интернет, при возникновении проблем (невозможно войти в веб-интерфейс, не подходит пароль при входе в веб-интерфейс и т.д.) проверьте настроенное системное время машины контроллера.