Hlavní informace

Dokumentace Easy Project

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.

Image20180517163039_1.png

 

2. Instalace

Máte-li zmíněný gem instalovaný na Ruby, můžete spustit instalaci aplikace pomocí jednoduchého příkazu:

Image20180517163039_2.png

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:

Image20180517163039_3.png

Pokud aktualizujete už existující Easy Project, pak použijte příkaz:

Image20180517163039_4.png

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. 

Založte si Easy Project zdarma

Všechny funkce | SSL ochrana | Denní zálohy

nebo

bez platby a bez instalace