Документація/Сервер PalmOrder

Сервер PalmOrder

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

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

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

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

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

Що копіюватиНавіщо
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.