Запускаем контроллер UniFi как службу в ОС Windows
В этой статье хочу продолжить цикл статей по настройке оборудования Ubiquiti. Сегодня поговорим о контроллере UniFi.
Всем известный факт: оборудование серии Ubiquiti UniFi настраивается и управляется с помощью специального контроллера.
Контроллер этот представляет собой ПО, написанный на Java и из коробки не работает в качестве службы Windows, и это главное неудобство. Стоит только выйти из системы или случайно закрыть окошко с запущенным сервером, как контроллер перестает работать и мониторить ваши точки, писать логи и считать трафик с устройств и так далее.
Сегодня я расскажу, как в четыре шага, за пару минут настроить и запустить контроллер UniFi в качестве службы Windows.
- Первое, что нужно сделать – закрыть всё запущенное на контроллере UniFi, в том числе и сам контроллер.
- Второе – открываем cmd от имени Администратора, и переходим в каталог установки Java:
Для 64-битных систем путь по умолчанию: «C:\Program Files\Java\jre7\bin»
Для 32-битных систем путь по умолчанию: «C:\Program Files (x86)\Java\jre7\bin»
Можно просто посмотреть путь до бинарных каталогов Java открыв стандартный Проводник Windows.
(в моем варианте установлена 7-я версия Java, например, для 6 версии Java каталог будет другим – будьте внимательны!)
Добавляем путь к переменным средам для Java.
- Третье – добавляем путь к директории указанной мной выше (в зависимости от версии вашей ОС), в строку PATH (Переменные среды) (во вкладке Компьютер (Computer)->Дополнительные параметры системы (Properties)->Дополнительно (Advanced)->Переменные среды (Environment Variables). Нажимаем ОК, закрываем окна.
- Финальный, четвертый шаг – вводим команду: java -jar libace.jar installsvc — тем самым устанавливаем запуск нашего контроллера как службу Windows:
Всё, установка завершена, запускаем службу UniFi:
Возможные проблемы:
При использовании 64-разрядной версии Windows, нужно установить обе версии Java, x86 и x64, в противном случае служба запустится не корректно.
Второй момент — при обновлении службы запускайте команду для остановки службы: «java -jar libace.jar stopsvc» (может меняться в зависимости от того, откуда Вы запускаете команду). После окончания обновления контроллера UniFI. Запустите, набрав команду: «java -jar libace.jar startsvc» для старта службы.
На этом всё, подписывайтесь на обновления блога!
Настраиваем запуск Ubiqiti UniFi контроллер как службу Windows
Установленный по-умолчанию контроллер Ubiquiti UniFi Controller запускается как приложение, что не совсем удобно: при перезагрузке машины с контроллером придется логиниться в систему и удостоверяться, что приложение запущено, и сети UniFi осуществляют вещание в штатном режиме. Однако, можно заставить стартовать контроллер как службу Windows. Из коробки этого сделать нельзя, но есть вариант, и сейчас я покажу, как это можно сделать. Приступим.
Откройте свойства системы (иконка Компьютер -> клик правой кнопкой мыши -> Свойства, или наберите команду sysdm.cpl в командной строке cmd) см. скриншоты:
Затем, перейдите во вкладку «Дополнительно», нажмите «Переменные среды», в списке системных переменных выберите «Path», нажмите «Изменить», в значении переменной добавьте через точку с запятой путь до директории «bin» в каталоге, где у вас установлена актуальная версия Java (в зависимости от установленной версии Java путь может быть различным.
Это может быть как системная папка Program Data, так и Program Files (в зависимости от установленной версии Java, а так же версии операционной системы).
На приведенном ниже скриншоте это директория C:\Program Data\Oracle\Java\javapath\) и затем нажмите «ОК»:
В виде небольшого отступления скажу, что по-умолчанию директория Program Data скрыта, для того чтобы ее увидеть нужно в Параметрах папок сделать видимыми системные и скрытие файлы, как показано на скриншоте:
Всё, Program Data доступна для просмотра:
Теперь идем по пути в каталог c Java и сверяем путь до исполняемых файлов:
Затем, нужно запустить командную строку с правами администратора, и с помощью команды cd перейдите в каталог, где у вас установлен Unifi Controller (обычно это \%userprofile%\Ubiquiti Unifi\), и выполните команду: java -jar libace.jar installsvc
В результате выполнения команды должно появиться такое сообщение:
На этом этапе мы зарегистрировали службу UfiFi контроллера.
Затем, откройте оснастку управления службами (команда services.msc) и удостоверьтесь, что служба UniFi Contoller присутствует в списке и ей присвоен необходимый тип запуска (например, Автоматический):
Для запуска UniFi Controller как службы Windows нажмите кнопку Запустить, или воспользуйтесь командой net start «UniFi Controller» для запуска службы в режиме командной строки.
Важно знать, что теперь, перед обновлением контроллера UniFi нужно будет останавливать службу командой java -jar libace.jar stopsvc (может меняться в зависимости от того, откуда Вы запускаете команду). Затем запускать обновление контроллера, затем, после окончания обновления запускать команду java -jar libace.jar startsvc для старта службы.
Так же, если во время запуска службы UniFi Controller происходит ошибка, из разряда «Служба UniFi Controller» завершена из-за внутренней ошибки Неверная функция:
Ошибка «Служба UniFi Controller» завершена из-за внутренней ошибки Неверная функция
Или ошибка «Не удалось запустить службу «UniFi Controller» Специфическая ошибка службы: 1.:
Ошибка «Не удалось запустить службу «UniFi Controller» Специфическая ошибка службы: 1.
то вам обязательно нужно проверить установленную Java или переустановить её (просто пройдите по ссылке на официальный сайт и скачайте версию под разрядность своей ОС: https://www.java.com/en/download/manual.jsp), если вы установили контроллер на х64-разрядной версии ОС – на всякий случай скачайте и установите обе версии Java (для х 586 и 64-битных ОС).
После переустановки Java запустите службу UniFi Contoller повторно. С вероятностью в 99% она запустится без ошибок.
На этом всё, теперь вы умеете настраивать запуск UniFi Contoller как службу в операционных системах Microsoft Windows, а так же умеете исправлять ошибки при запуске контроллера UniFi.
Если есть вопросы – задавайте в комментариях, подписывайтесь на обновления, делитесь статьей в социальных сетях.
UniFi — Run the Controller as a Windows Service
This article describes how to set up the UniFi Network Controller to run as a Windows service, and how to update it when it’s running this way. It applies to Windows 8 and 10, but does not apply to Window Server versions.
Table of Contents
Introduction
Windows services are often useful since they are background applications which don’t require any attention from the end-user. The service launches upon startup, without any intervention from the user. The service is a direct replacement for running the controller software manually (via the icon or a scheduled task), so there is no need to run the UniFi Network Controller application if it is being run as a Windows service.
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):
4. Once in the root of the UniFi folder, issue the following command to install the UniFi Network Controller service:
5. Once you’re at a new command prompt line, after it says “Complete Installation…”, issue the following:
6. Close the command prompt window either by entering the exit 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.
How to Upgrade a UniFi Network Controller that is Running as a Windows Service
1. Open the UniFi Network Controller and make a backup.
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):
4. Once in the root of the UniFi folder, issue the following to uninstall the UniFi Network Controller service:
5. Once a new command prompt line is presented, that means uninstalling the service was successful. Update the UniFi Network Controller application’s version with any of the regular methods. Go to Settings > Maintenance in the Controller to upgrade to the latest public released version, or alternatively download the UniFi Network Controller installation package for Windows from the Downloads page or the Releases section of the Community.
6. Once the software update is successful, close the UniFi Network Controller application before going back to the Command Prompt.
7. In the Command Prompt issue the following to install the UniFi Network Controller service once again:
8. Once you’re at a new command prompt line, after seeing the «Complete Installation…» message, issue the following:
9. Close the Command Prompt window either by entering the exit command, or clicking the X.