UniFi controller migration

English version below.

Все банально до безобразия. Миграция контроллера на другую физическую машину очень проста. Задача была следующая: Нужно перевести контроллер с рабочей машины на Windows на отдельный сервер под Linux. Причина не важна, в принципе. Экономия клиентской лицензии уже достаточная причина.

1. Берем Ubunut 16.04 LTS. Обновляем до актуальной версии, я делаю с помощью ansible, настраивая сразу удобное для себя окружение.
2. Скачиваем последнюю версию контроллера на машину. У меня это 5.2.9 была: wget http://dl.ubnt.com/unifi/5.2.9/unifi_sysvinit_all.deb
3. Пытаемся поставить пакет, но он ругнется на зависимости, это нормально. sudo dpkg -i unifi_sysvinit_all.deb
4. Ставим OpenJDK + mongoDB + jsvc: sudo apt-get install openjdk-8-jre-headless mongodb-server jsvc
5. Устанавливаем все что требуется по зависимостям: sudo apt-get -f install

После этих действий ничего у меня не заработало 🙂 На удивление сразу не смог понять причину, пришлось заняться googling’ом. Оказалось что Mongo жаждет просто память и побольше свободного места, а я, в целях экономии, поднял инстанс на 512Mb/8Gb наивно полагая что мне этого хватит. Пришлось увеличить характеристики до 2Gb/20Gb и все заработало само.

6. Обращаемся в админку нового контроллера: https://new_ip:8443/ и вам предложат либо настроить руками, либо восстановить из backup. Нам нужен второй вариант.
7. Бэкап на старом контроллере делается тут: https://old_ip:8443/manage/site/default/settings/maintenance. Старая версия у меня была 4.8.18 и она без проблем восстановилась на 5.2.9.

Заходим в dashboard и смотрим на грустную картину – нет ни одной точки доступа WiFi. Осталось перенастроить точки WiFi, их у меня две. Подключаемся к ним по SSH и выполняем 1 команду:

8. set-inform http://new_ip:8080/inform

После этого идем снова в dashboard и радуемся.

English version

Goal: To migrate UniFi controller from Windows workstation onto Linux virtual server and upgrade it from 4.8.12 up to 5.2.9 version.

Steps:
1. New host with Ubuntu 16.04 LTS 2Gb/20Gb/1-2CPU
2. sudo apt-get update && sudo apt-get upgrade -y && sudo apt-get dist-upgrade -y
3. sudo apt-get install openjdk-8-jre-headless mongodb-server jsvc
4. wget http://dl.ubnt.com/unifi/5.2.9/unifi_sysvinit_all.deb (or newer version)
5. sudo apt-get -f install (install dependences)

Next step: open new UniFi dashboard by url https://new_ip:8443/ and restore old configuration from backup (https://old_ip:8443/manage/site/default/settings/maintenance).

And last step: re-configure your WiFi AP to use new UniFi controller.

ssh onto every AP and run simple command: set-inform http://new_ip:8080/inform