Переход с TrueNAS CORE 13.3

Эта страница описывает то, что измерено на тестовой машине, а не то, что ожидается. Где что-то не проверялось — так и написано.

Что проверено

Официальный образ iX TrueNAS-13.3-U1.2 был установлен на тестовую машину и настроен: зеркальный пул, датасет, SMB-шара и iocage-джейл. Затем система обновлена образом BSDnas, собранным из FreeBSD stable/15.

проверка	результат
система поднимается	да, state: READY
конфигурация сохранена	пулы, шары, пользователи, пароли на месте
пул, созданный OpenZFS 2.2	импортируется и работает на 2.4.3
датасеты	целы
SMB-шара из 13.3	работает, enabled
iocage-джейл с userland 13.3	стартует на ядре FreeBSD 15, данные целы

Один прогон меняет FreeBSD 13.3 → stable/15, OpenZFS 2.2 → 2.4.3, Samba 4.20 → 4.23, Python портов 3.9 → 3.11 и поколение схемы конфигурации. Весь цикл на стенде — около пятнадцати минут.

Процедура

1. Сохраните резервную копию конфигурации из веб-интерфейса (System → General → Save Config). Это отдельный файл, не зависящий от состояния загрузочного устройства.
2. Загрузитесь с образа BSDnas.
3. Install/Upgrade → выберите загрузочное устройство → Upgrade Install.
4. Install in new boot environment — новая загрузочная среда создаётся рядом со старой; старая остаётся в меню загрузчика и доступна для отката.
5. По завершении извлеките носитель и загрузитесь с диска.

Первая загрузка дольше обычной: мигрирует база конфигурации. На стенде система ответила через 60–90 секунд после появления консольного меню.

Про zpool upgrade — прочтите сначала

После обновления система сообщит, что для пула доступны новые возможности. Не торопитесь.

Установлено измерением:

• Сразу после zpool upgrade пул всё ещё импортируется старой OpenZFS 2.2. Проверено: установщик 13.3 видит обновлённый пул как ONLINE и предлагает импортировать его с -f, ни словом не заикаясь о несовместимых фичах.
• Причина: zpool upgrade переводит фичи в состояние enabled, а не active. Сразу после операции активных фич — ноль.
• Старая система теряет доступ, когда какая-нибудь новая фича становится active — то есть когда ею реально воспользовались: дедупликация, длинные имена, расширение raidz и подобное.
• Фича активируется как побочный эффект обычной работы, и об этом никто не сообщает.

Так что окно отката после zpool upgrade существует — но закрывается оно молча, и полагаться на него нельзя.

Разумный порядок:

1. обновите систему;
2. убедитесь, что всё работает — шары, задачи, джейлы;
3. поживите так столько, сколько нужно для уверенности;
4. и только потом выполняйте zpool upgrade, сознательно отказываясь от возможности вернуться на 13.3.

Загрузочному пулу отдельное обновление не требуется.

Джейлы

Джейлы с userland FreeBSD 13 работают на ядре FreeBSD 15: в конфигурации ядра включены COMPAT_FREEBSD13 и COMPAT_FREEBSD14. Проверено — джейл 13.3-RELEASE-p8 после обновления стартует, команды внутри выполняются, файлы целы.

Отдельно стоит знать: ветка FreeBSD 13.x убрана с главного зеркала (download.freebsd.org отвечает 404 на 13.3 и 13.5). На системе, всё ещё работающей на 13.3, новый джейл обычным путём уже не создать — iocage не находит релиз. Существующие джейлы работают. Обход на 13.3 — архивный сервер:

iocage fetch -r 13.3-RELEASE -s archive.freebsd.org -d old-releases/amd64

Это одна из причин, почему оставаться на 13.3 неуютно: платформа функционально заморожена.

После первого перехода носитель больше не нужен

Загрузка с образа нужна один раз — чтобы переехать с TrueNAS CORE. Дальше система следует за поездом обновлений проекта и обновляется сама из System → Update. Измерено на стенде: нашла новую сборку, скачала, применила и перезагрузилась примерно за три минуты.

Манифесты отдаются по HTTPS, но криптографически пока не подписаны; каждый пакет сверяется с контрольной суммой из манифеста.

Известные шероховатости

• Служба SSH после обновления сама не поднимается — включите её заново из веб-интерфейса или через API.
• Индекс плагинов iocage от iX больше не обновляется; плагины — из собственного индекса или руками.
• Утилит аппаратных RAID arcconf, megacli и tw_cli нет: их дистрибутивы исчезли и у вендоров, и с distcache.FreeBSD.org. Под ZFS аппаратный RAID в любом случае не советуют.

Что не проверялось

Честный список того, на что эта страница не отвечает:

• обновление с версий старше 13.3 (13.0, 12.x, 11.x);
• системы с HA (два контроллера), шифрованием GELI, iSCSI под нагрузкой, доменной аутентификацией;
• пулы с raidz или с отдельными устройствами кэша и журнала — проверялось зеркало;
• поведение под реальной нагрузкой и на объёмах больше тестового стенда.