Документація/Експлуатація

Адміністратору

Оновлення та резервне копіювання

Як створити резервну копію, оновити сервер і перевірити результат.

Регулярна резервна копія дає змогу відновити сервер після збою комп’ютера, невдалого оновлення або помилкової зміни налаштувань. Перед кожним оновленням створюйте окрему копію.

Що потрібно копіювати

Зупиніть сервер, а потім скопіюйте:

Що копіюватиНавіщо
config/application.ymlНалаштування адміністратора, порту та початкових шляхів.
palmorder.sqliteСлужбові дані сервера, прив’язки пристроїв і журнал подій.
data/Файли обміну та технічні дані сервера.
Власні inbox і outboxЯкщо для пристроїв або за замовчуванням задано шляхи поза текою сервера.

Теку logs можна додати до резервної копії для діагностики, але вона не потрібна для відновлення роботи.

У macOS перелічені файли розміщено в ~/Library/Application Support/PalmOrder Server. У Windows і portable JVM-дистрибутиві — у теці PalmOrderServer або у вибраних вами шляхах.

Важливо. Не копіюйте palmorder.sqlite, коли сервер працює. Спершу штатно зупиніть його, інакше резервна копія може виявитися неповною.

Створіть резервну копію

  1. Зупиніть PalmOrder Server відповідно до способу його запуску.
  2. Створіть нову теку з датою, наприклад PalmOrder-backup-2026-08-12.
  3. Скопіюйте перелічені вище файли та теки.
  4. Переконайтеся, що копія містить palmorder.sqlite, config/application.yml і потрібні дані обміну.
  5. Зберігайте резервну копію окремо від комп’ютера сервера або на захищеному мережевому сховищі.

Якщо в inbox або outbox є документи, які ERP ще не обробила, відновлюйте їх обережно, щоб не виконати обмін повторно.

Оновіть сервер

Перед оновленням ознайомтеся з примітками до відповідного релізу. Якщо нова версія містить несумісні зміни, дотримуйтеся інструкцій саме для цього релізу.

  1. Завершіть поточні обміни та зупиніть сервер.
  2. Створіть резервну копію.
  3. Завантажте дистрибутив для своєї операційної системи.
  4. Оновіть програмні файли, не замінюючи робочі дані без потреби.
  5. Запустіть сервер і відкрийте панель керування.
  6. Перевірте Журнал, статус ліцензії, список пристроїв і один тестовий обмін.

Windows

Зупиніть службу або сервер із меню в системному треї. Розпакуйте новий дистрибутив в окрему тимчасову теку і замініть у робочій теці лише програмні файли: виконувані файли, lib, runtime, service та службові скрипти. Збережіть чинні config, data, logs і palmorder.sqlite.

Якщо у новому дистрибутиві змінився шаблон config/application.yml, порівняйте його з вашим файлом і вручну додайте потрібні нові параметри. Потім запустіть службу або застосунок.

macOS

У меню PalmOrder виберіть Quit, щоб зупинити сервер. Замініть PalmOrder Server.app у теці Applications новою версією та запустіть її. Дані в ~/Library/Application Support/PalmOrder Server зберігаються окремо від застосунку й не повинні бути замінені.

Portable JVM і Linux systemd

Розпакуйте нову версію в окрему теку. Перенесіть до неї резервну копію config, data і palmorder.sqlite, а для systemd за потреби оновіть шлях у файлі служби. Не змішуйте в одній теці lib або runtime з різних версій.

Після запуску переконайтеся, що в Журналі є запис про успішний старт. Якщо виникла проблема, зупиніть сервер, відновіть резервну копію та зверніться до сторінки Журнали та підтримка.

Відновіть резервну копію

  1. Зупиніть сервер.
  2. Відкладіть поточні config, data та palmorder.sqlite в окрему теку, не видаляючи їх одразу.
  3. Поверніть файли з резервної копії на їхні попередні місця.
  4. Перевірте права доступу до тек, особливо якщо сервер працює як служба.
  5. Запустіть сервер, увійдіть до панелі та перевірте пристрої й обмін.

Якщо відновлюєте копію на іншому комп’ютері, спочатку узгодьте це зі службою підтримки PalmOrder.