Instalační manuál pro serverové řešení
Obecné informace
Easy Project je webová aplikace. Proto je instalace a vývoj trochu složitější, než obyčejné aplikace na vašem počítači.
Pro co nejsnazší vývoj doporučujeme využití virtuálního serveru (VMware), který může být postaven na zakázku.
S takovýmto VM nepotřebujete už dále sami nic instalovat. Tyto instrukce platí pro případy, kdy si manuálně instalujete Easy Project na vlastní server. Jsou určeny pro pokročilé správce serverů. Detailnější manuál je také dostupný přímo v instalačním balíčku v /doc/INSTALL
0. Než začnete
Ujistěte se, prosím, že máte vhodnou konfiguraci hardware i software - zkonzultujte detaily s Easy Project manažerem. Pečlivě si přečtěte také následující info:
- Webový server musí mít plný přístup k veřejným složkám, souborům, logům, tmp složkám -> NESPOUŠTĚJTE INSTALACI JAKO ROOT!
- Webrick web server NENÍ podporován
- Instalace automaticky nespustí CRON úkoly - toto je potřeba nastavit manuálně až po instalaci (bod 3)
- Spuštění instalace vyžaduje alespoň 250 MB volného místa na disku
- Server musí mít neomezené internetové připojení, minimálně během instalace
- Stáhněte a spusťte tuto automatickou kontrolu, pro odhalení případných problematických bodů
1. Ruby Gem instalátor
V podstatě se jedná o instalačního průvodce Easy Projectu na serveru, využitelného pro další updaty.
Instalujte si tento gem na Ruby.
2. Instalace
Máte-li zmíněný gem instalovaný na Ruby, můžete spustit instalaci aplikace pomocí jednoduchého příkazu:
Balíčky z klientské zóny mají zpravidla tuto formu: easyproject_com_u658_vEP_2017_1_2__platform_2018_02_05.zip
Takže podle tohoto příkladu bude instalační příkaz takto:
Pokud aktualizujete už existující Easy Project, pak použijte příkaz:
Instalační průvodce vás provede těmito kroky:
1) Složka - je nutné určit složku, do které se Easy Project nainstaluje
2) Stažení balíčku
3) Konfigurace databáze - vybrat typ databáze (MySQL nebo PostgreSQL)
4) Konfigurace e-mailů
5) Instalace
6) Přesun Easy Projectu – Easy Project bude přesunut na určené místo (krok 1)
7) Konfigurace webserveru
3. Po instalaci
Dále bude potřeba manuálního nastavení CRONu. CRON je využíván pro automatické úlohy serveru, jako například zpracovávání příchozích zpráv pro helpdesk, zpracování výstrah a upozornění, opakované úkoly a podobně.
Je velmi důležité, aby rake příkazy NEBYLY spouštěny jako root - jinak dojde k selhání, kvůli nedostatečným oprávněním.
Řekněme, že spouštíte Easy Project jako uživatel easy. Příkazy budou takto:
Zobrazit aktivní cron úlohy
crontab -u easy -l
Úpravy
crontab -u easy -e
Nasazení změn
sudo service cron reload
Příklad spouštění cronu každých 5 minut:
*/5 * * * * /home/easy/scripts/easy_scheduler.sh &> /dev/null
/home/easy/scripts/easy_scheduler.sh
#!/bin/bash -l
LOG_FILE="/home/easy/current/log/easy_scheduler_rake.log"
echo "$(date '+%Y-%m-%d %H:%M:%S') start rake" >> ${LOG_FILE}
cd /home/easy/current && bundle exec rake easyproject:scheduler:run_tasks RAILS_ENV=production >> ${LOG_FILE}
echo "$(date '+%Y-%m-%d %H:%M:%S') end rake" >> ${LOG_FILE}
/home/easy/scripts/easy_scheduler.sh musí být spustitelný:
sudo chmod +x /home/easy/scripts/easy_scheduler.sh
Neváhejte si najít na internetu podrobnější manuál pro nastavení cronu na vašem serveru. Není to funkce využitelná jen pro Easy Project.
