UAENRU

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

Сервер PalmOrder

Linux

Ручний запуск або systemd-служба для PalmOrder Server у Linux.

Для Linux використовуйте portable JVM-дистрибутив. Його можна запускати вручну або як systemd-службу. Нижче наведено приклад для каталогу /opt/palmorder-server та окремого системного користувача palmorder.

Ручний запуск

Встановіть Java Runtime або JDK версії 25, розпакуйте дистрибутив і відредагуйте config/application.yml. У каталозі PalmOrderServer виконайте:

./run.sh

Сервер працює, доки відкрите вікно термінала. Для штатного завершення натисніть Ctrl+C. Спільні вимоги і параметри запуску описано на сторінці Portable JVM.

Підготуйте systemd-службу

  1. Встановіть Java Runtime або JDK версії 25.
  2. Розпакуйте portable JVM-дистрибутив у /opt/palmorder-server.
  3. Відредагуйте /opt/palmorder-server/config/application.yml і змініть типовий пароль адміністратора.
  4. Створіть системного користувача та надайте йому доступ до каталогу сервера:
sudo useradd --system --home-dir /opt/palmorder-server --no-create-home palmorder
sudo chown -R palmorder:palmorder /opt/palmorder-server
sudo chmod +x /opt/palmorder-server/run.sh

Якщо Java не доступна в системному PATH, задайте JAVA_HOME у файлі служби, як показано нижче.

Створіть systemd-службу

Створіть файл /etc/systemd/system/palmorder-server.service з таким вмістом:

[Unit]
Description=PalmOrder Server
After=network.target

[Service]
Type=simple
User=palmorder
Group=palmorder
WorkingDirectory=/opt/palmorder-server
ExecStart=/opt/palmorder-server/run.sh
Restart=on-failure
RestartSec=10

# Додайте цей рядок, якщо Java встановлена поза PATH:
# Environment=JAVA_HOME=/opt/java/jdk-25

[Install]
WantedBy=multi-user.target

Завантажте конфігурацію та увімкніть службу:

sudo systemctl daemon-reload
sudo systemctl enable --now palmorder-server
sudo systemctl status palmorder-server

Після успішного запуску панель керування доступна на http://localhost:8888/ui.

Керування та діагностика

# зупинити
sudo systemctl stop palmorder-server

# запустити
sudo systemctl start palmorder-server

# перезапустити після зміни конфігурації
sudo systemctl restart palmorder-server

# переглянути повідомлення служби
sudo journalctl -u palmorder-server -e

Технічний журнал PalmOrder також зберігається у /opt/palmorder-server/logs/palmorder-server.log.

Доступи до каталогів обміну

Користувач palmorder повинен мати права запису до data, logs, palmorder.sqlite і кожного налаштованого inbox та outbox. Якщо ERP працює від іншого користувача або на іншому сервері, налаштуйте доступ до каталогів обміну окремо.

Перед оновленням зупиніть службу та створіть резервну копію. Якщо нову версію розпаковано в інший каталог, змініть у unit-файлі WorkingDirectory і ExecStart, після чого виконайте sudo systemctl daemon-reload. Дивіться Оновлення та резервне копіювання.