UniFi — Переход на другую версию фирменного ПО через SSH

Описано, как вручную перейти на более новую (или на более старую) версию фирменного ПО, используя SSH. Дальнейшую информацию о том, как подключить устройство, используя SSH см. в разделе "Другие статьи по этой теме" в конце данной статьи.

При некоторых сценариях, при устранении неполадок может требоваться ручная настройка. У некоторых пользователей возникают проблемы с настройкой точек доступа UAP, пока они не обновят фирменное ПО до версии, одинаковой с контроллером (в большинстве случаев при удаленной установке). 

При устранении неполадок часто бывает так, что проблема обнаружена и требуется изменить версию фирменного ПО на одной или нескольких UAP без изменения версии ПО контроллера. Это возможно сделать. Если на контроллере Вы используете версию, отличную от той, которая была поставлена вместе с контроллером, то сначала убедитесь, что опция Automatic Upgrades (Автоматические обновления) в контроллере выключена.

Содержание

1. Шаги процедуры

   1. Стандартный метод обновления фирменного ПО по SSH

   2. Локальное обновление фирменного программного обеспечения

2. Определение версии фирменного ПО

3. Устранение неполадок

4. Другие статьи по этой теме

Шаги процедуры

Имеется множество способов сделать это. Есть способ, при котором UAP запросит фирменное ПО с контроллера и выполнит обновление. Имеется также способ, называемый локальным обновлением, при котором процесс обновления запускается UAP самостоятельно. В данной статье будут детально описаны оба способа.

Стандартный метод обновления фирменного ПО по SSH (путем связи с контроллером)

Обновление http://ip-of-controller:8080/dl/firmware/BZ2/version-of-ap-see-ref-table-below/firmware.bin

Примечания:

• Пользователи, обновляющие USG или USG-Pro-4 должны сначала вызвать консоль и ввести команду sudo su, чтобы обновить псевдоним,

• указывающий на URL, так чтобы этот псевдоним указывал на контроллер, локальный web-хост или на наш CDN (или другой хорошо известный хост).

Процесс локального обновления фирменного ПО (запускается UAP самостоятельно).

Чтобы выполнить локальное обновление, необходимо переименовать файл firmware.bin в fwupdate.bin, а затем скопировать его в папку /tmp на UAP.

Итак, Вам необходимо скопировать файл из соответствующей папки контроллера. Параметры "версии" см. в таблице ниже, для этой версии в таблице указано наименование папки соответствующей модели UAP.

При работе под Linux:

• Откройте приложение Terminal (Терминал).

• scp /usr/lib/unifi/dl/firmware/binary/version/firmware.bin user@ip.of.uap:/tmp/fwupdate.bin

При работе на Mac: 

• Откройте приложение Terminal (Терминал).

• scp /Applications/UniFi.app/Contents/Resources/dl/firmware/binary/version/firmware.bin user@ip.of.uap:/tmp/fwupdate.bin

Например, в Linux, если требуется скопировать двоичный файл 3.2.1 в стандартную UAP для локального обновления, необходимо ввести команду:

scp /usr/lib/unifi/dl/firmware/BZ2/3.2.1.2601/firmware.bin user@ip.of.uap:/tmp/fwupdate.bin 

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

Пользователям Windows необходимо скопировать файл с помощью WinSCP или MobaXterm (есть и другие программы для этого, например, PSCP и т.п.). После того, как Вы скопируете файл в папку /tmp/, рекомендуется переименовать его (так как Вы, наверное, пожелаете оставить локальный файл с именем firmware.bin).

Затем подключитесь по SSH и введите соответствующую команду, чтобы начать локальное обновление.

syswrapper.sh upgrade2 &

Примечания:
Убедитесь, что Вы используете соответствующий двоичный файл фирменного ПО для соответствующего устройства. Данный метод полезен для некоторых тестовых фирменных ПО, которые могут не содержать wget. Вы можете применить этот метод и по другим причинам, например для обновления некоторого устройства UniFi до другой версии фирменного ПО без изменения существующей версии контроллера.

USG/USG-Pro поддерживает локальное обновление, однако Вы можете пожелать в качестве имени файла использовать upgrade.tar Вы должны поместить файл с обновлением в папку, в которую разрешена запись, так что лучше всего использовать /home/username/ (замените username на имя пользователя с правами администратора). Вам необходимо запустить соответствующую команду. Допустим, Вы находитесь в домашней папке, а файл имеет имя upgrade.tar .

Введите команду 'sudo syswrapper.sh upgrade upgrade.tar'

Определение версии фирменного ПО

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

Чтобы отыскать версию фирменного ПО, можно исследовать всю структуру. Убедитесь, что найдена согласующаяся версия фирменного ПО (см. ниже). Например, фирменное ПО для стандартной UAP, LR, OD, OD5 и PicoM2 находится в папке BZ2. Для текущих моделей AC используйте фирменное ПО из папки U7E. В таблице ниже приведены все папки с фирменным ПО. Кроме того, на него ссылается файл bundles.json (находится в папке с фирменным ПО), но его читать немного сложнее, чем таблицу ниже. 

MSW:

Vista+: C:\Users\username\Ubiquiti UniFi\dl\firmware

XP: C:\Documents and Settings\username\Ubiquiti UniFi\dl\firmware

Linux: /usr/lib/unifi/dl/firmware

Mac: /Applications/UniFi.app/Contents/Resources/dl/firmware

Как и для версии 4.8.14 мы приводим прямые ссылки на файлы с фирменным ПО в нашем CDN. Вы можете использовать эти ссылки в пользовательском интерфейсе (UI) контроллера для выполнения специальных вариантов обновления. Как и 4.8.14, версия контроллера также имеет ссылку, так что Вы можете щелкнуть по ней мышью, чтобы получить ссылки на двоичные файлы. Кроме того, как и для версии 4.8.14, хостинг фирменного ПО USG/USG-Pro-4 осуществляется в нашем CDN; теперь оно не поставляется вместе с контроллером и ссылки на него также есть в таблице ниже. И контроллер, и ссылки на CDN работают через SSH.

*минимальная поддерживаемая версия для AC-EDU

Устранение неполадок

В некоторых случаях, сценарии пользователей могут быть полезны другим читателям. Если у Вас есть что-либо, что следует добавить в данный раздел, пожалуйста, отправьте нам по e-mail соответствующее сообщение (на адрес helpcenter_feedback@ubnt.com).

• После первоначальной установки неправильной версии, пользователь пытался загрузить правильную версию, но постоянно получал ошибку "Invalid Firmware" (Неправильное фирменное ПО) при попытках выполнить обновление по SSH. Проблему удалось устранить следующим образом: пользователь вошел в папку tmp и сначала удалил файл fwupdate.bin, а затем выдал команду обновления еще раз (при этом сначала надо убедиться, что на контроллере выбрана правильная папка).

Другие статьи по этой теме

• Как установить соединение, используя SSH