Linux — Құжаттама PalmOrder

Linux үшін портативті JVM дистрибутивін пайдаланыңыз. Оны қолмен немесе жүйелік қызмет ретінде бастауға болады. Төменде /opt/palmorder-server каталогы мен бір жүйе пайдаланушысы palmorder үшін мысал келтірілген.

Қолмен бастау

Java Runtime немесе JDK 25 нұсқасын орнатыңыз, таратуды ашыңыз және config/application.yml өңдеңіз. PalmOrderServer каталогында мына әрекеттерді орындаңыз:

./run.sh

Терминал терезесі ашық болғанша сервер жұмыс істейді. Қалыпты тоқтату үшін Ctrl+C түймесін басыңыз. Жалпы талаптар мен іске қосу параметрлері Portable JVM» бетінде сипатталған.

Systemd қызметін дайындаңыз

Java Runtime немесе JDK 25 нұсқасын орнатыңыз.
/opt/palmorder-server ішінде портативті JVM дистрибутивін шығарыңыз.
/opt/palmorder-server/config/application.yml өңдеңіз және әдепкі әкімші құпия сөзін өзгертіңіз.
Жүйе пайдаланушысын жасаңыз және оған сервер каталогына рұқсат беріңіз:

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

PATH жүйесінде Java қолжетімді болмаса, төменде көрсетілгендей қызмет файлында 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 басқа пайдаланушыдан немесе басқа серверде іске қосылса, алмасу каталогтарына кіруді бөлек конфигурациялаңыз.

Жаңартпас бұрын қызметті тоқтатып, сақтық көшірме жасаңыз. Жаңа нұсқа басқа каталогта ашылған болса, бірлік файлындағы WorkingDirectory және ExecStart мәндерін өзгертіңіз, содан кейін sudo systemctl daemon-reload орындаңыз. Жаңарту және сақтық көшірме бөлімін қараңыз.