⚠️ Uvedené informace v článku platí pouze pro lokální / serverovou instalaci ABRA Flexi na macOS.
Flexi na macOS běží jako dvě systémové služby, které se spouští automaticky po startu počítače. Tento článek popisuje, jak je ručně spustit, zastavit a co dělat, když se nespustí.
ℹ️ Týká se pouze instalace Flexi na vlastní počítač nebo server s macOS (on-premise). U cloudových instancí (adresa nazevfirmy.flexibee.eu) služby spravuje ABRA a zákazník k nim nemá přístup. Všechny příkazy zadávejte v Terminálu pod účtem s právy administrátora.
Které služby Flexi používá
eu.flexibee.server – aplikační server Flexi
eu.flexibee.postgresql – databázový server PostgreSQL
Definice obou služeb jsou uložené v adresáři /Library/LaunchDaemons/ jako soubory eu.flexibee.server.plist a eu.flexibee.postgresql.plist. Bez těchto souborů služby nelze spustit.
Ověření, zda služby běží
ps aux | grep -i flexi
Pokud se ve výpisu objeví procesy Javy a PostgreSQL pod uživatelem winstrom, služby běží.
Spuštění a zastavení služby
Pro jednorázové spuštění nebo zastavení už zaregistrované služby:
launchctl start eu.flexibee.server
launchctl stop eu.flexibee.server
Stejné příkazy platí i pro databázi, pouze se použije název eu.flexibee.postgresql.
Trvalé vypnutí a zapnutí služby
Pokud potřebujete službu vypnout natrvalo (například kvůli údržbě), použijte unload a load:
sudo launchctl unload /Library/LaunchDaemons/eu.flexibee.server.plist
sudo launchctl load /Library/LaunchDaemons/eu.flexibee.server.plist
sudo launchctl unload /Library/LaunchDaemons/eu.flexibee.postgresql.plist
sudo launchctl load /Library/LaunchDaemons/eu.flexibee.postgresql.plist
⚠️ Po příkazu unload se služba nespustí sama ani po restartu počítače. Znovu ji aktivujete až příkazem load. Databázi vypínejte vždy až po aplikačním serveru.
Služba se nespustí nebo po instalaci chybí
Nejčastější příčinou je nedokončená instalace: instalátor skončí obecnou chybou, ale tváří se jako dokončený – dokončí se však bez PostgreSQL a bez registrace služeb.
Krok 1: Zkontrolujte instalační log
Log najdete v souboru /var/log/flexibee-install-log.txt. Úspěšná instalace je zakončená řádkem Postinstall successfull. Pokud log končí fází Preinstall a žádné řádky Postinstall neobsahuje, doinstalační skript vůbec neproběhl.
Krok 2: Ověřte existenci souborů služeb
V adresáři /Library/LaunchDaemons/ musí být oba soubory .plist uvedené výše. Pokud chybí, služby nelze spustit ani příkazem load.
Krok 3: Spusťte skript Postinstall ručně
Skript Postinstall je součástí připojeného instalačního obrazu (DMG). Spusťte jej v Terminálu pod sudo. Hlášky typu File exists u knihoven nebo service already loaded jsou neškodné – znamenají jen to, že daná část už byla vytvořená. Po doběhnutí skriptu ověřte běh služeb podle postupu výše.
Krok 4: Pokud problém trvá
Proveďte instalaci znovu z čerstvě staženého balíčku. Pokud ani to nepomůže, kontaktujte podporu a přiložte obsah souboru /var/log/flexibee-install-log.txt spolu s verzí macOS.