Unifi — getting started

Introduction

There are a few things to take into consideration when managing large UniFi installs with hundreds of devices and several sites connected to a single UniFi Network Controller. A Controller running under such a high load might encounter some issues if configured the same way as a Controller managing a much lighter load. There are some symptoms that can be recognized, diagnosed and worked on to improve the controller’s performance. 

The sections below show how to modify the UniFi Controller system settings by altering or adding values to the system.properties file. See the UniFi — Explaining the system.properties File article for more information on this file.

WARNING: Before proceeding with the configurations outlined below, make sure to create a backup of your machine and Controller configurations. A typo error could break the system. See the UniFi — How to Create and Restore a Backup article for more information.

Монтаж контроллера

Чтобы установить UniFI AP с нуля на компьютере с Windows XP, следуйте инструкции:

  • скачайте и инсталлируйте Java Runtime Environment версии 1.6 или выше, которую можно взять на официальном сайте Java;
  • установите в используемом браузере флеш-плеер последней версии, который скачайте на его официальном сайте;
  • создайте или войдите в ОС под именем, написанным латиницей. Вся последующая инсталляция выполняется под этим логином во избежание сбоев в работе контрольного устройства;
  • контроллер желательно устанавливать не с диска, а с официального сайта производителя в разделе «Загрузки» (Downloads).

На сайте программы выберите:

  • в разделе Platform — UniFi;
  • в «Моделях» — свою модель устройства;
  • в «Версиях» — последнюю модель контролирующего устройства;

Настройка устройств Ubiquiti UniFi AP LR

  • нажмите на кнопку «Скачать» и согласитесь с условиями применения, затем сохраните файл;
  • запустите результат скачивания и инсталлируйте контроллер.

В окне при запуске программы откроется окно, где нажатие кнопки Launch a Browser перенаправит вас в браузер для дальнейших настроек. Там вы должны будете принять условия эксплуатации сертификата контроллера. Дальнейшая настройка через браузер предусматривает:

  • выбор языка. Программное обеспечение поддерживает исключительно англоязычную версию;
  • настройку характеристик Wi-Fi сети. Там вам потребуется указать логин и пароль будущих точек доступа, разрешить или запретить гостевое посещение и в случае разрешения аналогичным образом настроить параметры для гостевых хотспотов.

После того как вами будет произведена настройка UniFI АР, задайте логин администратора, его пароль и подтвердите данные в окне, нажав клавишу Next. Вы увидите название вашей сети беспроводного доступа, а также ваше имя как администратора в ней. Нажмите Finish и заново введите свои логин и пароль. Перед вами появится интерфейс, где будет выполнена настройка комплекса UniFi. Для некоторых браузеров возможно использование Java.

Описание UniFi

Программно-аппаратный комплекс Ubiquiti UniFi позволяет построить бесшовную Wi-Fi сеть, состоящую из большого количества беспроводных точек.

Комплекс включает в себя Wi-Fi точки доступа UniFi и программный контроллер, который устанавливается на любой компьютер с операционной системой Windows, Mac OS или Linux.

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

Системные требования контроллера:

  • Microsoft Windows XP, Windows Vista, Windows 7, Windows 8, Mac OS X или Linux;
  • Java Runtime Environment 1.6 или выше;
  • Web браузер Mozilla Firefox, Google Chrome или Microsoft Internet Explorer 8 или выше.

Особых требований к аппаратной части компьютера нет. Подойдет любой компьютер или ноутбук. Если контроллер будет обслуживать большую сеть, то желательно использовать современный компьютер с 2ГБ оперативной памяти или больше.

Основные возможности UniFi контроллера:

  • Централизованное управление и мониторинг беспроводной сетью;
  • Создание до 4-х виртуальных Wi-Fi сетей с независимыми настройками;
  • Поддержка современных видов шифрования;
  • Поддержка VLAN;
  • Возможность подключить к одой мастер точке, подключенной по кабелю, до 4-х точек по Wi-Fi. Благодаря этой возможности вам не придется к каждой Wi-Fi точке подключать сетевой кабель.
  • Встроенный HotSpot позволяет печатать талоны с паролями доступа и работает с аккаунтами PayPal. Пользователей хотспота можно ограничивать по времени.
  • Ограничение скорости скачивания для пользователей;
  • Подключение к контроллеру удаленных Wi-Fi сетей филиалов и управление ими.
  • Загрузка в контроллер изображений планов помещений и размещение на них точек доступа UniFi.
  • Интеграция с Google Мaps для отображения размещения точек доступа на картах.

Introduction

In order to update the UniFi Network Controller via APT, it is necessary to create source files or edit lines in an existing sources.list file with Linux text editors: vi or nano. That is the most common method for package updates and installs for these operating systems. The repo structure should be permanent, but if there are any changes they will be pointed out in the UniFi Network Controller software version release posts, found in the Community.

Follow the instructions below to stay with the current stable release, regardless of changes in versions. When there is a new stable release, there will be a post on the Community announcing it.

Разновидности и описание

UniFI AP Pro с хотспотами Wi-Fi в зависимости от места использования бывает:

  • внутренним. Монтируется на потолок или стенку;
  • наружным, адаптированным к изменениям погодных условий. Устанавливается на стену.

Каждое место, где имеется доступ к интернету, удалено кабелем посредством инжектора POE, который включен в комплект системы. Кроме него, комплектация устройства включает:

  • место, где имеется доступ к Wi-Fi;
  • крепежи;
  • диск установки и контролирующее устройство.

В зависимости от мощности, системы для внутренней установки делятся на:

  1. Недорогие с базовой мощностью 2,4 ГГц. К ним относят UniFI
  2. Более мощные. Предназначаются для большой территории или комнат с толстыми стенами (UniFI AP LR).
  3. 2-диапазонные модели PRO с мощностью 2,4 ГГц и 5 ГГц.
  4. Высокоскоростные комплексы с двумя диапазонами (AP-AC). Они поддерживают новые настройки беспроводной связи 802.11ас. Скорость передачи информации такими устройствами составляет до 450 Мбит/с и до 1300 Мбит/с на мощностях 2,4 и 5 ГГц соответственно.

Настройка UniFi AP без контроллера

Системы для установки на улице делятся на:

  1. Маломощные на 2,4 ГГц (UniFI AP Outdoor).
  2. Мощные на 5 ГГц (UniFI AP Outdoor 5G).

Подключение точек доступа UniFi к контроллеру из другой подсети

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

При такой конфигурации трафик Wi-Fi сетей филиалов выходит напрямую в интернет, а на контроллер в центральный офис перенаправляется лишь служебный трафик небольшого объема.

Для подключения удаленных точек к контроллеру, им нужно указать IP адрес контроллера. Это можно сделать тремя способами:

  • Определение адреса контроллера через DNS;
  • Определение адреса контроллера через DHCP option 43;
  • Задание адреса контроллера через специальную утилиту.

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

Определение адреса через DHCP option 43
Если DHCP сервер, установленный в удаленном офисе, поддерживает задание опций, можно передать адрес удаленного сервера в DHCP пакете.

Пример конфигурации для ISC DHCP server:

# …
Option space ubnt;
option ubnt.UniFi-address code 1 = IP-address;
class «ubnt» {
        match if substring (option vendor-class-identifier, 0, 4) = «ubnt»;
        option vendor-class-identifier «ubnt»;
        vendor-option-space ubnt;
}
subnet 10.10.10.0 netmask 255.255.255.0 {
        range 10.10.10.100 10.10.10.160;
        option ubnt.UniFi-address 201.10.7.31; ### UniFi Controller IP ###
        option routers 10.10.10.2;
        option broadcast-address 10.10.10.255;
        option domain-name-servers 168.95.1.1, 8.8.8.8;
        # …
}
# …

Задание адреса контроллера через утилиту

Самым простым и быстрым способом подключения точек доступа филиалов является задание адреса контроллера вручную.

Подключите компьютер в одну подсеть с точками доступа UniFi и запустите утилиту Unifi-Discover, которая устанавливается вместе с контроллером. Контроллер на компьютере при этом не должен быть запущен. Выберите точку, нажмите manage и введите IP адрес контроллера. Контроллер увидит точку и сможет ее подключить.

После подключения точки UniFi к контроллеру и перезагрузки, нужно заново прописать адрес контроллера.

Frequently Asked Questions

My password isn’t working. What is the default username and password for UniFi devices?

The UniFi devices can have two possible factory-default credential sets:

  • root/ubnt
  • ubnt/ubnt

Note that you may require multiple sets of credentials when using UniFi:

  • device credentials
  • controller credentials
  • Cloud Access Portal credentials
  • UniFi Cloud Key and SSH credentials

For more information, see UniFi — Accounts and Passwords for Controller, Cloud Key, and Other Devices.

What generation is my UniFi device?

The table below shows the generation and wave of devices.

UniFi Access Points

UniFi Security Gateways (Firewall)

UniFi Controller Hardware (UCK, UDM and UAS)

Generation 1 Devices

Generation 2 Devices (AC Wave 1)

Generation 3 Devices (AC Wave 2)

  • UAP (Datasheet)(Quick Start Guide)
  • UAP-LR (Datasheet)(Quick Start Guide)
  • UAP-Pro (Datasheet)(Quick Start Guide)
  • UAP-IW (Datasheet)(Quick Start Guide)
  • UAP-Outdoor (Datasheet)(Quick Start Guide)
  • UAP-Outdoor5 (Datasheet)(Quick Start Guide)
  • UAP-Outdoor+ (Datasheet)(Quick Start Guide)
  • UAPv2 (Datasheet)(Quick Start Guide)
  • UAP-LRv2 (Datasheet)(Quick Start Guide)
  • UAP-AC* (Quick Start Guide)
  • UAP-AC v2* (Quick Start Guide)
  • UAP-AC-Outdoor* (Quick Start Guide)
  • UAP-AC-LITE
  • UAP-AC-LR
  • UAP-AC-PRO
  • UAP-AC-EDU
  • UAP-AC-M
  • UAP-AC-M-PRO
  • UAP-AC-IW
  • UAP-AC-IW-PRO
  • UAP-AC-HD
  • UAP-AC-SHD
  • UAP-nanoHD
  • UAP-HD-IW
  • UAP-FlexHD
  • UAP-XG
  • UWB-XG
  • UAP-BeaconHD

* End of Life (EoL) and unsupported as of UniFi Network Controller version 5.7. Download here most current Controller version compatible (v5.6.40 LTS).

UniFi Switch (US models)

UniFi Switch (USW models)

  • UniFi Switch 16 XG
  • UniFi Switch 16-150W
  • UniFi Switch 24/48 PoE Models
  • UniFi Switch 24/48 non-PoE Models
  • UniFi Switch 8
  • UniFi Switch 8-60W
  • UniFi Switch 8-150W
  • UniFi Switch XG 6 PoE
  • UniFi Switch Industrial
  • UniFi Switch Flex
  • UniFi Switch 16 PoE
  • UniFi Switch 24 PoE
  • UniFi Switch 24 Pro PoE
  • UniFi Switch 48 Pro PoE

UniFi Routing & Firewall

  • UniFi Security Gateway
  • UniFi Security Gateway Pro 4

UniFi Controller Hardware

  • UniFi Dream Machine and UniFi Dream Machine Pro.
  • UniFi XG Server
  • UniFi Cloud Key Gen. 2 and Gen. 2 Plus
  • UniFi Cloud Key

Возможности

UniFI Controller может:

  • совершать централизованный контроль над сетью беспроводного типа;
  • создавать от 1 до 4 сетей, каждая из которых имеет разные настройки;
  • поддерживать VLAN;
  • поддерживать ультрасовременные типы шифровки данных;
  • подключать к мастер-точке до 4 стандартных точек Wi-Fi. Это избавляет вас от необходимости подключения проводов;
  • взаимодействовать с PayPal и выдавать талоны, содержащие пароль доступа;
  • благодаря хотспоту ставить лимит времени пользования интернетом или ограничивать скорость;
  • подключать к контрольному устройству филиалы беспроводных сетей и контролировать их;
  • загружать картинки плана здания с местами доступа к UniFI AP Pro;
  • соединяться с картами Google, чтобы отображать там места доступа к соединению беспроводного типа.

Ubiquiti UniFi AP настройка

Мнение специалиста

Однозначные достоинства системы UbiquitiUniFI AP – это бесплатное распространение программного комплекса, простота его настройки, а также универсальность – с его помощью настроить беспроводную сеть можно практически где угодно, в помещении или на улице. Этот комплекс можно определенно рекомендовать всем, кто заинтересован в настройке собственной беспроводной сети.

Константин Котовский

Database Connection Tuning

When running a large UniFi installation, it may be desired to run an external Mongo cluster to be able to scale the database independently from the UniFi Network Controller application. Discussion on that can be found on our Community Beta forum (need access?). If high CPU usage is seen on the Mongo process, it can indicate the need of a bigger box or the need to separate the mongodb process as mentioned above. Once that is done, the following can be tuned to see if it results in better application performance: 

db.mongo.connections_per_host=100db.mongo.threads_multiplier=5

This results in 500 threads that can be waiting for a Mongo connection. So keep in mind that more threads can mean higher CPU usage because the CPU has to context-switch between threads. It may allow for higher DB throughput, but only if the Mongo process is able to consume more CPU to serve requests faster. 

How to Set Up the UniFi Network Controller as a Windows Service

1. Close any instances of the UniFi software on the computer. If the UniFi Network Controller was just installed, make sure to open the controller software manually at least once, or let it run at the end of the wizard. Once you see the message UniFi Controller (a.b.c) started, the controller may be closed.

2. Launch the Command Prompt as an Administrator. On Windows 10 this would entail right-clicking and selecting «Run as administrator». Please see Windows documentation to identify the appropriate method for your specific Windows version.

3. Change directory to the location of UniFi in the computer using the following command (exactly as it is here, no need to substitute anything):

cd "%UserProfile%\Ubiquiti UniFi\"

4. Once in the root of the UniFi folder, issue the following command to install the UniFi Network Controller service:

java -jar lib\ace.jar installsvc

5. Once you’re at a new command prompt line, after it says “Complete Installation…”, issue the following:

java -jar lib\ace.jar startsvc

6. Close the command prompt window either by entering the command, or clicking the X.

7. To access the UniFi Network Controller now open a browser and go to https://localhost:8443. Alternatively, the desired interface IP, or FQDN that is mapped to that host (in place of “localhost”) may be used.

NOTE:We recommend using Oracle Java JRE 8, which can be downloaded in Oracle’s website. For the UniFi Cloud Access portal (https://network.unifi.ui.com/) to work properly, only use x64 Java.

Set Up a New UniFi Device

When setting up a new UniFi device, follow its Quick Start Guide to connect the hardware and launch the Setup Wizard.

If you are setting up multiple UniFi devices, connect them together and launch the Setup Wizard. It will allow you to adopt all of the connected devices at once.

The image above displays a typical UniFi network topology with a UniFi Cloud Key, UniFi Security Gateway and a UniFi Switch.

If you are using a UniFi Dream Machine, which acts as a Cloud Key, switch and a gateway, your topology might look like this:

If you’re not sure how to connect several devices together, remember:

  • Gatekeeper devices like routers and gateways connect to the internet via the WAN port (sometimes identified with a globe icon).
  • Other devices like access points, switches and clients connect to gatekeepers and to each other via the LAN ports.

Поиск и устранение неисправностей

В функционировании системы UniFi могут возникать различные неисправности:

  • Потеря питания или кабельного подключения точками доступа.
  • Логическое нарушение соединения точек доступа и контроллера в режиме L3 подключения.
  • Не запускается контроллер UniFi.

Потеря питания или кабельного подключения отслеживаются по сообщению в Alerts и подсвечиванию точки доступа красным цветом на карте.

Состояния точек доступа UniFi:

Состояние точки доступа

Возможные причинысостояния

Рекомендуемые действия

Connected

Зеленыйиндикаторгоритпостоянно

Точка доступа успешно подключена к контроллеру

Штатный режимфункционирования, действия не требуются

ProvisioningUpgrade

Зеленыйиндикаторгоритпостоянно

Точка доступа успешно подключена на нейвыполняется обновление ПО или настроек соответственно

Штатный режимфункционирования, действия не требуются

Adopting

Оранжевыйиндикаторгоритпостоянно

Точка доступа подключается к контроллеру

Действия не требуются

Pending

Оранжевыйиндикаторгоритпостоянно

Точка доступа обнаруженаконтроллером

Можно подключить точкудоступа adoption

Managed byother

Любое

Точка доступа настроена для работы с другим контроллером

Сбросьте точку кнопкой Reset к заводским настройкам иливойдите в контроллер с логином и паролем контроллера, ккоторому точка была подключена до этого, и переключите точку на себя.

Isolated

Периодическимигаетзеленыйиндикатор

Невозможность пропинговать адрес Сonnectivity Monitor.Связь с контроллером при этом присутствует, но точка доступа не обслуживает Wi-Fi клиентов.

Проверить состояние узла, используемого в качествеСonnectivity Monitor. Eслипроблема возникла на одной части точек доступа, то проверить сетевые настройки коммутаторов — разрешен ли доступ из этой подсети к узлу Сonnectivity Monitor.

Disconnected

Оранжевыйиндикаторгоритпостоянно

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

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

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

  • Совпадает ли VLAN, в котором находится контроллер, с VLAN точек доступа, не тегирован ли он?
  • Корректно ли работает маршрутизация между подсетями точек доступа и контроллера?
  • Как точка доступа должна находить контроллер в другой подсети (DHCP option 43, DNS, с помощью утилиты)?
  • Не фильтруются ли необходимые для работы контроллера порты между подсетями?

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

Крайне нежелательно запускать контроллер UniFi из-под учетной записи, содержащей кириллические символы. Если ваше имя пользователя в ОС Windows на русском языке, создайте пользователя на английском языке, залогинтесь под ним и выполняйте установку от этого пользователя.

Для работы UniFi контроллера должны быть открыты следующие порты:

  • TCP 8080
  • TCP 8443
  • TCP 8880
  • TCP 8843
  • TCP 22
  • UDP 3478

При запуске контроллера UniFi проверяется доступность портов, и выводится сообщение, если какой-либо из портов занят. Также данную информацию можно посмотреть в логах в файле C:\Documents and Settings\user\Ubiquiti UniFi\logs\server.log

Если порт занят, остановите контроллер и в файле C:\Documents and Settings\user\Ubiquiti UniFi\data\system.properties измените данный порт на любой неиспользуемый.

В статье использованы материалы comptek.ru

Правила подключения

Места доступа к интернету требуется подсоединить к инжектору в его разъем РОЕ. Сделать это требуется через сетевой провод под названием «витая пара». Второй разъем должен быть подсоединен к ноутбуку, модему или коммутатору. Так как комплекс программ PRO  и AP-AC поддерживает 802.3af, он напрямую питается от коммутационного приспособления, и вам не потребуется соединять его с инжектором.

Точка соединения с интернетом внутри помещения устанавливается на стену при помощи пластины из пластмассы, которая входит в комплектацию. Сделать это требуется таким образом:

  • прикрутить пластинку к поверхности;
  • соединить ее с хотспотом  Wi-Fi. Вы увидите пазы, куда нужно будет закрутить крепежи;
  • провернуть хотспот для его фиксации на пластине.
Ubiquiti UniFi Controller обзор на русскомUbiquiti UniFi Controller обзор на русском

Чтобы вмонтировать хотспот на потолке (это возможно сделать на подвесной конструкции, известной как «фальшивый потолок»), воспользуйтесь входящей в комплект пластиной из металла. Ее установите на фальшпанель, а на нее присоедините пластину из пластика, предварительно сделав отверстие для сетевого кабеля. Дальнейшие действия заключаются в пропуске кабеля в полученное отверстие, соединении его с пластиной и проворачивании. Точка доступа к интернету снаружи здания может быть установлена на стену посредством обычного пластмассового крепежа, который заранее нужно закрепить на поверхности. Крепеж также устанавливается на мачту посредством хомута из металла.

Manage the UniFi Network

You can manage your UniFi network using the UniFi Network Controller, which is hosted on a UniFi device, local computer or a remote server.

The following UniFi devices come with the Network Controller pre-installed:

  • UniFi Dream Machines, such as UDM and UDM-Pro. The UDM-Pro can also host the UniFi Protect controller simultaneously.
  • UniFi Cloud Keys, such as UC-CK, UCK-G2 and UCK-G2-Plus. The UCK-G2-Plus can also host the UniFi Protect controller simultaneously.

Alternatively, you can install the UniFi Network Controller on a computer or server running macOS, Windows or Linux operating systems.

After you’ve set up the controller, you can also manage it on the go using the UniFi Network mobile app.

If you only have one or a few access points and don’t need advanced configuration, you can use the UniFi Network mobile app to set up a UniFi Access Point in Standalone Mode without needing the UniFi Network Controller.

User Notes & Tips

These notes have been added thanks to user collaboration. 

  • This Community post shares some scripts for UniFi Controller software installation on Ubuntu 18.04 and 16.04 and Debian 8/9.
  • If you are installing in a VM or a headless server, you may encounter entropy issues. This could be anything from slow service start/restart to complete service failure. The fix is to install . This is an external link for a tutorial on the subject.
  • Since UniFi Controller version 5.6.x the UniFi service does not run as root. This means that you cannot bind to privileged ports (<1024). The controller will fail to start if you try to use these ports. 
  • The following affects APT versions 1.5 onward (Ubuntu 17.10 and Debian Sid or newer). A recent version of the apt-secure man page stated: «Since version 1.5 changes in the information contained in the Release file about the repository need to be confirmed before APT continues to apply updates from this repository», meaning that when performing an update from a major version to the next (for example 5.5.x to 5.6.x) the will result in an error.
    • To fix this run the command the following way: 
    • If you receive an error stating the command is not understood in combination with the other options, users have reported that issuing the following two commands has fixed it: issue  and hit enter, followed by  and enter.
  • The UniFi Controller, when installed on Debian and Ubuntu, will not have a GUI since it’s being run as a Service. Please use the service command for starting, stopping and restarting the UniFi Controller.
  • If you see the following error on your DNS server, a user reports solving this by forcing the system to use 8.8.8.8 as DNS server, not his ISP.
  • At the moment Ubiquiti does not support arm64, hence it is not available via the repo. A download and manual installation will be necessary for this.
  • In the Add the GPG Keys, method B: Source: External Link. For users behind restrictive firewalls the following command will allow them to import the GPG key:

  • Because of the Java 8 dependency, when using UniFi controller 5.7.X some additional steps might be needed. See  for details.
  • The command  is  in Ubuntu older than 16.04.

Настройка гостевой Wi-Fi сети

Гостевую Wi-Fi сеть используют для предоставления доступа в интернет временным посетителям в гостиницах, кафе, кинотеатрах, конференц-залах и т.д. Гостевую сеть всегда изолируют от сети предприятия.

В UniFi есть несколько способов авторизации гостей для подключения к интернету:

  • Подключение без пароля;
  • Ввод пароля на web странице, на которую гость автоматически перенаправляется после подключения к wifi точке;
  • Авторизация по талонам, которые можно генерировать и распечатывать из контроллера;
  • Авторизация через PayPal;
  • Авторизация через внешний портал авторизации.

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

Алгоритм работы системы гостевого доступа.

Чтобы настроить гостевой доступ без пароля, откройте меню Settings — Wireless Networks, выберите необходимую wifi сеть, поставьте в настройках сети Security — Open и нажмите кнопку Apply.

После изменения настроек они применятся на всех точках доступа. Во время применения настроек в статусе точек доступа будет написано Provisioning.

На вкладке Users отображается список подключенных клиентов. Откройте любого клиента и просмотрите на вкладкеStatistics информацию по нему:

  • ESSID — это название точки доступа, к которой подключился клиент;
  • Connected AP — MAC адрес точки доступа, к которой подключился клиент;
  • Channel — номер wifi канала;
  • Signal — уровень wifi сигнала;
  • TX Rate — скорость передачи;
  • RX Rate — скорость приема;
  • Activity — сколько времени клиент подключен к wifi точке.

Вы можете открыть вверху вкладку Statistics и просмотреть общую информацию о системе UniFi: число подключенных клиентов, передаваемый объем данных, распределение клиентов по wifi сетям. Слева отображается статистика по наиболее нагруженным точкам доступа, наиболее активным клиентам, и наибольшему времени, которое клиенты были подключены к wifi точке.

Symptom: High CPU Usage

One of the most important metrics to monitor, is CPU usage on your UniFi Network Controller. High CPU usage is the first indication that there is an issue. Unfortunately, there is no silver bullet for this and just increasing the CPU is not necessarily the answer.

Allocating Additional Memory Before increasing the RAM allocation on your machine, first try increasing the `XMX` and `XMS` options. By default, the UniFi Network Controller has these set to 1GB.  The following lines set the xmx and xms to values to 2GB (2048MB):

unifi.xmx=2048
unifi.xms=2048

The changes above would increase the memory the UniFi Network Controller is allowed to consume from 1 to 2GB. The reason why not having enough memory could cause high CPU usage, is because the Java Virtual Machine would be spending too many CPU cycles collecting garbage to stay within the 1 GB of memory allocated to the Controller. So before moving to a machine with more CPU resources, it is recommended to max out the available memory on that machine with the above settings. Then observe if CPU usage decreases. If 2GB is not sufficient, administrators may want to raise the limit to 4-8GB depending on the scale. In this case it would simply be increasing the value above in increments of 1024, i.e. 4 GB= 4096. 

NOTE: The jstat -gcutil Java command can be used to check whether the memory allocation is sufficient on your machine. See the Oracle documentation for more information.

Enabling High Performance Java Garbage Collector If increasing memory does not solve the problem, administrators may consider also adding this line to the system.properties file (note this only applies to Controllers other than Cloud Key):

unifi.G1GC.enabled=true

This enables a new Java Garbage Collector that can help optimize performance. However, if after these changes high CPU usage does continue after memory increase, a larger machine with more CPU cores and more memory to handle the workload may be necessary.

Changing Mongo Version/Engine In persistent cases, administrators may consider updating MongoDB version to 3.2+ with WiredTiger as storage engine, as a means of better scaling the UniFi Network Controller. See the following links for instructions:

  • How to Upgrade to MongoDB 3.2

Настройка HotSpot

Контроллер UniFi имеет встроенное программное обеспечение для организации HotSpot. Хотспот позволяет организовать доступ клиентов к интернету по талонам. Клиенту выдается талон, на котором напечатан номер, он его вводит на странице авторизации и получает доступ к интернету на определенное время. HotSpot часто применяют в гостиницах, в обычных кафе и internet кафе.

Перед настройкой HotSpot, нужно одну wifi сеть настроить на гостевой доступ. Откройте меню Settings → Wireless Networks, выберите wifi сеть, которая будет хотспотом, в настройках сети поставьте галочку Guest Policy, Security выберите Open и нажмите кнопку Apply;

Далее включаем функцию HotSpot:

  • Откройте меню Settings → Guest Control;
  • Поставьте галочку Guest Portal;
  • В Authentification выберите Hotspot;
  • Поставьте галочку Voucher;
  • Нажмите кнопку Apply.

Теперь нужно сгенерировать талоны для клиентов:

  • Нажмите ссылку Go to Hotspot Manager.
  • Перейдите на вкладку Vouchers.
  • Слева внизу напротив Create выберите количество генерируемых талонов, одноразовые One-time они будут или многоразовые Multi-Use, длительность действия талонов 24 hours (24 часа). Чтобы выбрать длительность в минутах, выберите User-defined и укажите время. Также можно поставить галочку Add Notes и добавить к талонам какой-то комментарий, но на печать он выводится не будет.
  • Нажмите кнопку Create Vouchers для генерации талонов.

Кнопка Print All Unused Vouchers позволяет распечатать все неиспользованные талоны. Печатаем талоны, разрезаем и раздаем клиентам.

Когда клиент подключится к нашей wifi сети, то его автоматически перенаправит на страницу авторизации, где нужно ввести номер талона, поставить галочку I accept the Term of Use и нажать кнопку Use Vousher. После этого клиент получит доступ в интернет.

Контроллер автоматически отслеживает время активности клиента, и когда время действия талона истекло, контроллер отключает клиенту доступ к интернету.

Оцените статью
Рейтинг автора
5
Материал подготовил
Илья Коршунов
Наш эксперт
Написано статей
134
Добавить комментарий