Установка
Обновление
Подготовьте полную копию, замените версию программы и проверьте привычный вход, подключения и историю. Ниже — порядок для Docker и Windows и способ вернуться к сохранённой установке.
На этой странице
Зафиксируйте текущую версию
Откройте «Обслуживание» → «О системе». Запишите номер, от которого обновляетесь, и найдите соответствующий образ или Windows-архив. В учебном примере исходная версия — 0.1.18.
Вы знаете прежнюю версию и где взять её сборку. Файл Compose или сценарий запуска сохранён отдельно от программы.
Остановите Holkas и сохраните данные
Сделайте полную резервную копию: база состояния, ключи, файлы и журналы операций. Если база или ключи вынесены в отдельные каталоги, скопируйте их тоже. До завершения обновления оставьте Holkas остановленным.
При изменении схемы Holkas дополнительно создаст файл backup/holkasweb-before-<новая-версия>-<дата>-<время>.db. Он содержит только базу состояния; файлы операций и ключи в него не входят.
Архив читается, в нём есть holkasweb.db и исходные keys. Копия лежит вне каталога, который вы будете заменять.
Замените программу, сохранив её настройки
Выполните инструкцию для своего способа запуска: Docker Compose, docker run или Windows. Новая версия должна открыть тот же набор данных и ключей.
Первый запуск может занять дольше обычного: Holkas переводит базу состояния на новую схему. Не запускайте две версии одновременно с одной папкой данных.
В журнале появился Now listening on, ошибок чтения базы или ключей нет. Если миграция не завершилась, сохраните журнал и используйте порядок восстановления.
Проверьте обновлённую установку
Войдите прежним пользователем. В «Обслуживании» проверьте новый номер версии; затем откройте знакомое подключение, манифест и прошлую операцию. Убедитесь, что доступные до обновления планы и журналы открываются.
Проверьте связь с тестовой базой. При необходимости постройте небольшой план без применения. Только после проверки возвращайте установку в обычную работу.
Номер версии изменился, привычные данные доступны. Если вместо них «Первый запуск» — сначала проверьте том и пути, не создавайте пустую установку поверх ожидания прежних данных.
При переходе на 0.1.25
«Соответствие ролей» перенесено с пары подключений в параметры приёмника. Для баз и Git сохранённые правила переносятся автоматически; если одной исходной роли соответствовали разные роли, остаётся последнее изменённое правило. Правила файловых приёмников (S3, файл пакета, SQL-скрипт) удаляются. После обновления проверьте параметры подключений-приёмников до первого переноса.
REST-адрес /api/v1/routes/{источник}/{приёмник}/role-map и три MCP-инструмента holkas_list_role_map, holkas_set_role_mapping, holkas_delete_role_mapping удалены. В интеграциях используйте parameters.roleMap; агент должен перечитать holkas_guide версии 22. Обновите страницу браузера после обновления сервера. Полный список изменений 0.1.25.
Docker Compose
В compose.yaml поменяйте image на выбранную опубликованную версию. Например:
image: belousov2501/holkas:0.1.36
Остальные настройки — порты, режим, переменные и том — оставьте прежними. После остановки и полной копии выполните в каталоге вашего проекта Compose:
docker compose pull holkas
docker compose up -d --no-deps holkas
docker compose logs --tail 100 holkas
Имя сервиса holkas соответствует инструкции установки; если у вас другое, замените его в командах. Новый образ можно загрузить заранее, до остановки. Сам pull работающий контейнер не обновляет; up -d пересоздаёт его с новой версией.
Если используете latest, обязательно сверяйте фактическую версию после запуска. Фиксированный тег удобнее для повторного развёртывания и возврата к прежней сборке.
Docker run
Пример ниже продолжает локальную установку: контейнер holkas, том holkas-data, локальный порт 8080. Полная копия уже должна быть готова, Holkas — остановлен. Если у вас другие настройки, перенесите их в новую команду, включая все переменные окружения и монтирования.
docker pull belousov2501/holkas:0.1.36
docker rm holkas
docker run -d \
--name holkas \
--restart unless-stopped \
-p 127.0.0.1:8080:8080 \
-v holkas-data:/data \
belousov2501/holkas:0.1.36
docker logs --tail 100 holkas
docker rm удаляет остановленный контейнер; именованный том сохраняется. Не удаляйте том. Прежний пароль администратора хранится в базе и не требует повторного задания через HolkasWeb__BootstrapAdminPassword.
Windows
Переход 0.1.18 → 0.1.20 проверен на Windows 10 Enterprise LTSC 21H2 x64. Новая сборка открыла прежнюю папку данных: сохранились пароль, сеанс входа, подключение и манифест; перед изменением схемы появилась автоматическая копия SQLite. Возврат к 0.1.18 проверен отдельно — из полного архива, снятого до обновления.
- Завершите работу Holkas через
Ctrl+Cв консоли. Дождитесь завершения процесса; одно сообщениеApplication is shutting down...ещё означает, что остановка идёт. Затем сделайте полную копию данных. Сохраните также собственный сценарий запуска и настройки. - Скачайте
holkas-web-win-x64-<версия>.zipиSHA256SUMSиз одного выпуска. Проверьте контрольную сумму. - Распакуйте архив в новую папку, например
C:\Holkas\0.1.36. Не накладывайте новый набор файлов на старый. - Запустите
C:\Holkas\0.1.36\holkas-web-win-x64\Holkas.Web.exeпод тем же пользователем Windows. Если используете свой.ps1, поменяйте в нём только путь к программе, сохранив настройки данных и порта. - Проверьте новый номер версии, прежний вход и данные. Старую папку программы оставьте до завершения проверки.
По умолчанию данные лежат в %LOCALAPPDATA%\Holkas, поэтому обе версии по очереди увидят ту же установку. При заданном HolkasWeb__DataPath или HolkasWeb__StatePath новая программа должна получить прежние значения. Одновременно обе версии не запускайте.
Автоматическая копия перед изменением схемы
Если у существующей базы есть ещё не выполненные шаги схемы, Holkas до их применения создаёт согласованную копию SQLite в backup каталога данных и выводит путь в журнал. Если схема не меняется, новой такой копии может не быть — это нормально. На чистой установке она также не нужна.
Имя holkasweb-before-0.1.20-…db означает «до миграции, которую выполняет 0.1.20», а не «база уже от 0.1.20». Сохраните сведения о прежней версии отдельно.
Это дополнительная страховка базы состояния. Она не включает ключи, журналы и другие файлы и находится на том же диске. Для надёжного возврата всей установки и потери диска нужна полная копия.
После обновления план может показать новые команды
Новая версия сравнивает объекты точнее предыдущих. Поэтому повторный план по объектам, которые вы уже переносили, может показать Update там, где раньше изменений не было: Holkas восстанавливает значение, которое старая версия перенесла неточно. Это не ошибка — разберите отличие в команде как обычно и примените, если оно верно. Что именно изменилось в сравнении, перечислено в заметках к выпускам.
Если новая версия не подошла
Остановите новую версию и сохраните её журнал и данные отдельно для разбора. Восстановите полный архив до обновления в другой пустой каталог или том, затем запустите с ним прежнюю сборку. Пошаговый пример восстановления сохраняет текущие данные и позволяет проверить результат до переключения пользователей.
Возврат только старого исполняемого файла недостаточен. Начиная с 0.1.9 Holkas отказывает в старте, если в базе есть неизвестные ему шаги схемы; более ранние версии такой защиты не имеют. Не рассчитывайте на автоматическую обратную миграцию.
При возврате к копии Holkas потеряет сведения, появившиеся после её создания. Изменения, уже применённые к базам Паруса, от этого не откатываются. Перед продолжением работы заново проверьте фактическое состояние приёмника.
Если полной копии нет, автоматическая копия SQLite может помочь восстановить состояние перед миграцией вместе с исходными ключами и прежней программой. Это не восстановление всего экземпляра: файлы могли измениться или быть очищены после обновления. Сохраните текущие данные и обратитесь в поддержку, если состав восстановления неясен.
Если данные лежат внутри папки программы
Предупреждение «Данные лежат внутри каталога программы» означает, что удаление папки программы затронет и установку. До замены файлов остановите Holkas, скопируйте полный каталог данных за пределы программы и проверьте пути запуска. Перенос описан в параметрах запуска.
Переход со старых версий через v0.1.12
В v0.1.12 появилось шифрование настроек подключений. Существующие записи преобразуются при первом старте. Для последующего чтения нужны исходные ключи из keys; сохраняйте их вместе с базой и не удаляйте старые ключи.
Копии, сделанные до шифрования, могут содержать открытые реквизиты. Ограничьте доступ к ним. Старой программой нельзя читать уже преобразованную базу: возвращайте прежнюю сборку вместе с её полной копией. Как обращаться со старыми копиями и остатками реквизитов.
Проверка новых версий
Holkas проверяет новые версии при запуске сервера и затем раз в сутки. Результат хранится в базе состояния: перезапуск не сбрасывает суточный кеш. Уведомление «Доступна версия …» рядом с текущей версией видно всем пользователям; ссылка ведёт к изменениям и файлам выпуска.
CLI при запуске получает результат проверки через свой сервер. Уведомление о новой версии CLI выводится в stderr; JSON и результаты команд в stdout, а также коды завершения не меняются. Проверка идёт параллельно команде и ограничена двумя секундами. Отсутствие связи с Aviso не препятствует работе. После неудачной проверки сервер повторяет попытку через 15 минут.
При первом создании базы состояния генерируется случайный GUID установки; для существующей базы он создаётся при первом запуске версии с этой возможностью. GUID переживает обновления, восстановление и перезапуск. Копирование базы сохраняет GUID: такие копии учитываются как одна установка. CLI использует идентификатор сервера, своего GUID у него нет.
Запрос в Aviso содержит GUID, текущую версию сервера и последнюю известную серверу версию CLI. Aviso сохраняет последний внешний IP соединения, время первого контакта и дату обновления сведений для статистики использования. Эти сведения не связаны с почтой и обращениями в поддержку. История IP не ведётся; автоматическое удаление записей установок пока не реализовано. В статистику попадают только установки, которым доступен Aviso.
Администратор может выключить автоматическую проверку на странице «Обслуживание». Параметры запуска задаются независимо от адреса поддержки:
{
"HolkasWeb": {
"Updates": {
"Enabled": true,
"Url": "https://aviso.belousov.net.ru/holkas"
}
}
}
В окружении: HolkasWeb__Updates__Enabled и HolkasWeb__Updates__Url. Выключение через параметр
запуска имеет приоритет перед интерфейсом. Без проверки сведения об установке не отправляются.
Сборки из исходников (0.0.0) не обращаются в Aviso.
Переход с 0.1.25 на 0.1.30
После обновления сервера обновите страницу браузера; агентам нужно заново прочитать holkas_guide версии 28. Хранилище состояния обновляется автоматически. Сохранение базы состояния не обновляет ранее выгруженные ZIP и файлы Git.
| Что хранится в старой поставке | Что сделать перед переносом |
|---|---|
| Временные таблицы Oracle | Выгрузите заново: старый файл без режима хранения читается как постоянная таблица. Смена режима может пересоздать таблицу и удалить строки. |
| Назначения форм и настройки регистрации таблиц классов | Для их переноса нужна новая выгрузка. При отсутствии этих сведений в старом пакете прежние настройки приёмника сохраняются. |
| Альтернативное рабочее место APP | Выгрузите заново: старое числовое MainWorkPlace больше не читается. |
| Родительские параметры отчётов REP | Выгрузите заново. В старом файле родителя нет: план может предложить обновление, которое очистит его в приёмнике. |
| Типы документов связей отчёта с разделами | Выгрузите заново для передачи типов. Если сведений в старом файле нет, прежние типы приёмника сохраняются. |
| Реестр «Объекты» класса CLO | Старые файлы классов читаются, но реестра не содержат. Для переноса реестра выгрузите класс заново. |
| DAT со ссылкой на ACATALOG | Добавьте DOCNAME в ключ ссылки. Без него — dataset_catalog_key; прежний unit у этой ссылки не нужен. |
| TPC в составе | Выберите таблицу TBP и нужные функции триггеров JFP отдельно. Запрос TPC отклоняется, манифест получает unknown_type, строка TPC старого пакета пропускается. |
| Имена ролей PostgreSQL в верхнем регистре | Старые файлы читаются; новые хранят обычные имена строчными. Git-файл перепишется при следующем изменении объекта. Для нестандартного регистра проверьте соответствие ролей. |
Пакет с отсутствующим или null обязательным списком отклоняется с именем объекта и поля. Не заменяйте такие списки на [] без проверки: пустой список может означать удаление частей приёмника. Смысл отсутствующих и пустых списков.
Для автоматизации проверьте изменения сводки и времени REST, MCP и JSON CLI. Планы с предупреждениями о совпавших объектах требуют внимания даже при нуле команд.