Установка лицензии и переход на Business

Вы приобрели тарифный план и получили лицензию. На этой странице описано, что с ней делать: куда поместить файл, как применить его к работающему движку, как узнать, что установлено, и — если вы приобрели план Enterprise — как заменить бинарный файл Community на Enterprise, ничего не переустанавливая.

Лицензия — это подтверждение, а не переключатель функций во время выполнения

Она не блокирует функции уже запущенного вами программного обеспечения. Истёкшая или отсутствующая лицензия не отключает функции, и ни одна лицензия не ограничивает число учётных записей — при самостоятельном размещении количество пользователей не ограничено ни на одном уровне. Это подписанное утверждение о том, на что вы имеете право, а не ключ, разблокирующий код, уже находящийся на вашем диске.

Что она действительно ограничивает, так это ДОСТУП К АРТЕФАКТАМ, и на этом различии построена вся модель: действующая лицензия требуется для скачивания сборки Enterprise и для установки из локального комплекта (olivares upgrade --bundle); она проверяется офлайн по ключу, встроенному в ваш бинарный файл. Поэтому редакция Enterprise — это другой бинарный файл, который вы получаете с помощью токена, а не feature flag, переключаемый в уже имеющемся файле, — и поэтому говорить вам, что «она ничего не ограничивает», было бы неверно.

Что вы получили

Что вы приобрели	Что приходит	Что с этим делать
Community	устанавливать нечего	уже работает — ничего на этой странице не применяется
Business / Business Max, самостоятельное размещение	файл лицензии и токен скачивания	установить лицензию, затем перейти на бинарный файл Enterprise
Cloud	учётные данные размещённого tenant	на вашем хосте устанавливать нечего

Лицензия представляет собой один подписанный blob. Сохраните его в файл — customer.license или с любым другим именем — и сохраните токен скачивания из того же письма: они используются на разных этапах, и устанавливается только лицензия.

1 · Установить лицензию

olivares license install ./customer.license --data-dir /var/lib/olivares

Команда проверяет blob до того, как что-либо записать, по открытому ключу Ed25519, встроенному в вашу сборку. Поэтому усечённая копия из буфера обмена завершается ошибкой здесь, а не при следующем запуске. При успехе команда записывает <data-dir>/license.key с режимом 0600 — каноническую хранимую лицензию, которую движок читает по умолчанию.

Передайте - вместо пути, чтобы прочитать blob из стандартного ввода:

pbpaste | olivares license install - --data-dir /var/lib/olivares

Установка поверх существующей лицензии атомарно заменяет её и сообщает, какая лицензия была заменена.

Применить к работающему движку — без перезапуска

Работающий движок принимает новую лицензию на месте. Это можно сделать любым из следующих способов:

kill -HUP "$(pidof olivares)"                 # signal the running process
curl -X POST .../v1/console/runtime/reload    # the API half

…или собственным элементом перезагрузки в консоли. Перезапуск тоже работает, но он не нужен.

Где движок ищет лицензию, по порядку

Если вы уже внедряете лицензию другим способом, учитывайте, что файл из каталога данных имеет самый низкий приоритет среди четырёх источников. Движок разрешает их в порядке убывания приоритета:

1. --license <path> (или LicenseFile в файле конфигурации)
2. OLIVARES_LICENSE_PATH=<path>
3. OLIVARES_LICENSE=<blob> — лицензия непосредственно в окружении
4. <data-dir>/license.key — то, что записывает license install

license install отказывается выполнять установку, когда может определить, что override имеет более высокий приоритет, чем файл, который команда собирается записать: установка под таким override оставила бы файл, который движок никогда не читает, а вы увидели бы exit 0 без каких-либо изменений. Команда сообщает, какой override она обнаружила, а --force всё равно подготавливает файл — правомерный случай состоит в том, что вы собираетесь удалить override.

Что может и чего не может увидеть эта проверка

Команда читает OLIVARES_LICENSE_PATH и OLIVARES_LICENSE из окружения собственного процесса. Она не видит флаг --license (или запись LicenseFile в конфигурации), переданный уже работающему отдельным процессом движку: install и uninstall вообще не принимают флаг --license. Поэтому на хосте, где сервис был запущен с явно заданным путём, обе команды могут успешно завершиться, ничего не изменив в том, что читает движок.

Запускайте olivares license status после каждой из них. Команда разрешает лицензию с тем же приоритетом, что и движок, и сообщает, какой источник фактически действует, — именно это имеет значение.

2 · Проверить, что установлено

olivares license status --data-dir /var/lib/olivares

status работает офлайн и разрешает лицензию с тем же приоритетом, который использует движок. Поэтому он отвечает на важный вопрос — какая лицензия фактически действует — вместо вопроса «есть ли файл». Он сообщает разрешённый источник, владельца, план и срок действия.

Запускайте его после каждой установки и после удаления override.

3 · Community → Business, на месте

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

olivares upgrade --enterprise --token <TOKEN>

Команда получает подписанную сборку Enterprise для вашей платформы и проверяет подпись офлайн — артефакт с несанкционированными изменениями прерывает обновление, оставляя работающий бинарный файл неизменным, — а затем выполняет атомарную замену, сохраняя резервную копию предыдущего файла. Сначала используйте --check, если хотите увидеть план, не применяя его:

olivares upgrade --enterprise --token <TOKEN> --check

Перезапустите службу, а затем включите надстройки:

olivares enterprise enable <preset>     # starter | regulated | full

Активация управляется и аудируется: сначала показывается diff, а надстройка, которой нужен secret или проверка, переводится в подготовленное состояние, а не включается наполовину. olivares enterprise status сообщает, что активно. Эти команды существуют только в бинарном файле Enterprise — если olivares enterprise не является командой, у вас всё ещё работает сборка Community и описанная выше замена ещё не произошла.

Сделайте резервную копию перед заменой

При замене меняется бинарный файл, а не данные, но всё равно сделайте ту же резервную копию, которую требует Обновление и откат. На той странице также описан возврат к предыдущему бинарному файлу.

Удалить лицензию

olivares license uninstall --data-dir /var/lib/olivares --yes

Команда удаляет <data-dir>/license.key и сообщает, что было удалено. Как и install, она отказывается выполнять операцию, пока может увидеть override OLIVARES_LICENSE*: действует не этот файл, поэтому его удаление ничего не изменит. У неё есть и та же слепая зона: флаг --license, переданный отдельно работающему движку, для неё невидим. Это офлайн-половина собственного DELETE /v1/console/license консоли.

Удаление лицензии не отключает ничего из того, что у вас работало. Оно отзывает подтверждение; бинарный файл Enterprise продолжает вести себя как бинарный файл Enterprise, пока вы не замените его обратно.

Чего нет на этой странице

• Выпуск лицензий (license keygen / sign) — это сторона поставщика в той же команде. Клиенту она не нужна.
• Состав каждого плана приведён на страницах цен, а не здесь.
• Как работает модель — почему подписка предоставляет доступ к артефактам, а не служит переключателем, — описано в разделе Открытое ядро и лицензирование.