⚠️ Uvedené informácie v článku platia iba pre lokálnu / serverovú inštaláciu ABRA Flexi na macOS.
Flexi na macOS beží ako dve systémové služby, ktoré sa spúšťajú automaticky po štarte počítača. Tento článok popisuje, ako ich ručne spustiť, zastaviť a čo robiť, keď sa nespustia.
ℹ️ Týka sa iba inštalácie Flexi na vlastný počítač alebo server s macOS (on-premise). Pri cloudových inštanciách (adresa nazevfirmy.flexibee.eu) služby spravuje ABRA a zákazník k nim nemá prístup. Všetky príkazy zadávajte v Termináli pod účtom s právami administrátora.
Ktoré služby Flexi používa
eu.flexibee.server – aplikačný server Flexi
eu.flexibee.postgresql – databázový server PostgreSQL
Definície oboch služieb sú uložené v adresári /Library/LaunchDaemons/ ako súbory eu.flexibee.server.plist a eu.flexibee.postgresql.plist. Bez týchto súborov služby nemožno spustiť.
Overenie, či služby bežia
ps aux | grep -i flexi
Ak sa vo výpise objavia procesy Javy a PostgreSQL pod používateľom winstrom, služby bežia.
Spustenie a zastavenie služby
Pre jednorazové spustenie alebo zastavenie už zaregistrovanej služby:
launchctl start eu.flexibee.server
launchctl stop eu.flexibee.server
Rovnaké príkazy platia aj pre databázu, iba sa použije názov eu.flexibee.postgresql.
Trvalé vypnutie a zapnutie služby
Ak potrebujete službu vypnúť natrvalo (napríklad kvôli údržbe), použite 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 príkaze unload sa služba nespustí sama ani po reštarte počítača. Znovu ju aktivujete až príkazom load. Databázu vypínajte vždy až po aplikačnom serveri.
Služba sa nespustí alebo po inštalácii chýba
Najčastejšou príčinou je nedokončená inštalácia: inštalátor skončí všeobecnou chybou, ale tvári sa ako dokončený – dokončí sa však bez PostgreSQL a bez registrácie služieb.
Krok 1: Skontrolujte inštalačný log
Log nájdete v súbore /var/log/flexibee-install-log.txt. Úspešná inštalácia je zakončená riadkom Postinstall successfull. Ak log končí fázou Preinstall a neobsahuje žiadne riadky Postinstall, doinštalačný skript vôbec neprebehol.
Krok 2: Overte existenciu súborov služieb
V adresári /Library/LaunchDaemons/ musia byť oba súbory .plist uvedené vyššie. Ak chýbajú, služby nemožno spustiť ani príkazom load.
Krok 3: Spustite skript Postinstall ručne
Skript Postinstall je súčasťou pripojeného inštalačného obrazu (DMG). Spustite ho v Termináli pod sudo. Hlásenia typu File exists pri knižniciach alebo service already loaded sú neškodné – znamenajú iba to, že daná časť už bola vytvorená. Po dobehnutí skriptu overte beh služieb podľa postupu vyššie.
Krok 4: Ak problém pretrváva
Vykonajte inštaláciu znova z čerstvo stiahnutého balíčka. Ak ani to nepomôže, kontaktujte podporu a priložte obsah súboru /var/log/flexibee-install-log.txt spolu s verziou macOS.