SlovnikTerminologie: NasazeniAplikace |
from Wiki KIVu |
Existuje i krátký návod na rozchození užitečný pro vývoj na lokále (Březen 2013).
Před vlastním nasazením aplikace je třeba mít nainstalován potřebný software.
Základní popis jejich instalace se nachází na následujících řádcích.
Pro úspěšný běh aplikace je třeba mít nainstalovanou Javu 5.0 nebo vyšší. V případě problému zkuste najít řešení problému na URL: http://java.sun.com/javase/
%JAVA_HOME%/bin
a zakončete středníkem.
"sudo apt-get install sun-java6-jdk sun-java6-plugin"
"update-java-alternatives -l"
a vyberete výchozí verzi příkazem "sudo update-java-alternatives -s java-6-sun"
"java"
a "javac"
, kdy by oba měly vypsat nápovědu.
javac
, který nemůže najít žádné *.java soubory, zkuste do PATH
přidat pouze znak '.'
(tečka) a zakončit znakem ';'
(středník).
Maven je nástroj sloužící k snazšímu řízení projektů. Zároveň je to kus software, který programátorům usnadňuje jejich činnost. Dal by se přirovnat k nástroji Ant, jen s tím rozdílem, že v antu programátor musí nadefinovat, co vlastně ant má provést, kdežto v mavenu jen stačí nadeklarovat, co chce programátor provést. Doporučená verze je 2.0.8, avšak je velmi pravděpodobné, že pro všechny verze řady 2.0.x poběží aplikace korektně. Aktuální verze (listopad 2009) je 2.2.1.
Maven lze stahnout z http://maven.apache.org/download.html Podrobny navod se da najit v dokumentaci a nebo ve volne stazitelne knize Better builds with Maven, volne stazitelna z http://www.exist.com/better-build-maven.
%MAVEN_HOME%/bin
a zakončete středníkem. Tim zajistime, ze OS bude hledat pro spusteni prikazu mvn(spustitelny soubor) ve spravnem adresari.
"mvn -version"
. POZOR: JE NUTNE BYT PRIPOJEN K ITERNETU! Pri prvnim spusteni temer kazdeho prikazu nebo pripadne pridani knihovny do pom.xml se vzdy tahaji potrebne knihovny a soubory z hlavni repository z netu. Pokud se vypise verze mavenu, tak mate spravne nastaveny krok 4 a muzete pokracovat dále), jinak opakujte. Muze se take stat, ze nemate nastaveny JAVA_HOME
v PATH
, takže je nutné tuto systémovou proměnnou pridat podle návodu uvedeného výše.
maven2
příkazem "sudo apt-get install maven2"
, pokud Vaše distribuce založená na Debianu nemůže balík najít, zkuste ho najít ručně příkazem "sudo apt-cache search maven2"
.
Nyní by jste měli mít připraven maven k použití. To se lehce ověří příkazem "mvn -version"
, po kterém maven vypíše mimo jiné verzi operačního systému a běžícího mavenu. Doporučuji spouštět maven jen s připojením k internetu a to z toho důvodu, že maven si stahuje do lokálního repositáře potřebné balíčky z výchozích repositářů.
Na úplném začátku je tedy doporučeno jednou spustit alespoň příkazy:
* mvn clean * mvn compile * mvn war:war * mvn javadoc:javadoc * mvn jetty:run
Více informací můžete najít v anglickém jazyce na URL: http://maven.apache.org/download.html
Postgresql je databázový server, se kterým pracuje aplikace SPOT. Jediná verze databázového serveru, se kterou je aplikace úspěšně otestována je verze 8.1 (zde je lokální kopie ke stažení Δ). S verzemi nižšími jsou problémy a verze vyšší nejsou zatím kompletně otestovány. Z těchto vyšších verzí je otestována pouze verze 8.4.1, která také způsobuje problémy, hlavně kvůli novým datovým typům.
Obrázkový tutoriál instalace Postgres 8.1 na OS windows turorial-postgres-instalace-win.zip [0,7 MB]
readme.txt
s podrobnějšími informacemi
V případě problémů zkuste najít řešení na URL: http://www.postgresql.org/docs/8.1/interactive/index.html
Návod instalace je určen pro linux. Práce v psql konzoli je nezávislá na platformě, tato konzole se v OS windows nachází standartně v c:\Program Files\PostgreSQL\8.1\bin\psql.exe
nebo ji můžete spusit přes tlačíko Start -> PostgreSQL 8.1 -> 'psql' to postgres
$ sudo apt-get install postgresql
#yum install postgresql
$ sudo passwd postgres
#Změní heslo uživaleli 'postgres'
$ sudo /etc/init.d/postgresql-* restart
#Restartuje server
$ su postgres
#Přihlášení jako administrátor databáze
$ createdb postgres
#vytvoří databázi nazvanou 'postgres'
$ psql postgres
#přihlášení do databáze 'postgres'
postgres=# ALTER USER postgres with password 'postgres';
#nastaví heslo uživateli 'postgres' v databázi na 'postgres'
postgres=# \i spot.sql
#provedení příkazů ze souboru, př. nahraje dump databáze projektu
$ dropdb postgres
#smaže databázi nazvanou 'postgres'
$ pg_dump dbname > outfile
#záloha databáze
$ psql dbname < outfile
#obnova databáze
postgres=# select * from pg_stat_activity;
#zjisteni jake selecty prave probihaji v databazi
Start -> Spustit
-> napsat services.msc
-> vybrat službu PostgreSQL Database server 8.1
, kliknout pravým tlačítkem a vybrat požadovanou událost (Spustit, Restartovat
atd.)
Požadované operace v konzoli pomocí příkazů:
sudo /etc/init.d/postgresql restart
- restartování databáze
sudo /etc/init.d/postgresql start
- spuštění databáze
sudo /etc/init.d/postgresql stop
- zastavení databáze
active
na '1'.
Tento počítač
-> pravym tlačítkem myši -> Spravovat
-> vyberte něco jako 'Mistni uzivatele a skupiny', -> 'Uzivatele'
-> vybeter uživatele postgres
a změňte mu heslo na Vámi vybrané (doporučeno 'postgres'
)
Start -> Spustit
-> napsat services.msc
-> vybrat službu PostgreSQL Database server 8.1
, kliknout pravým tlačítkem a vybrat Vlastnosti
, vybrat Typ spuštění
a zvolit ručně
.
Sekundární přihlašování
, její stav lze zjistit kliknutím na Start -> Spustit
-> napsat services.msc
-> vybrat službu Sekundární přihlašování
, pravým tlačítkem kliknout na Spustit
, dále na Vlastnosti
a vybrat Typ spuštění
automaticky
Lehký servletový kontejner, na kterém rozběháte aplikaci bez nutnosti instalace kontejneru. Aplikace by měla bez problému běžet na verzi 6.1.x. Testováno jen pro verze 6.1.8 – 6.1.12rc3.
Nyní to záleží na zvycích vývojáře jak to vyřeší se servletovým kontejnerem.
Při importu slov ze souboru je k překódování obsahu souboru do správného kódování (UTF8?) používán program enca. Pokud jste si jisti, že uživatelé aplikace budou importovat soubory pouze ve správném kódování, není potřeba program instalovat (nedoporučuje se).
sudo apt-get install enca
. V linuxových distribucích využívající balíčkovací systém rpm slouží pro nainstalování programu příkaz sudo yum install enca
. Program enca se nachází standartně v repozitářích debianu i ubuntu. K instalaci na linuxových systémech je také možné použít jednoduchý bash skript v adresáři ./src/scripts.
Zde jsou popsány konfigurační soubory aplikace, přes které se dá do jisté míry upravit chování aplikace. Všechny konfigurační soubory se nachází na tomto umístění:./src/main/webapp/WEB-INF/properties/
./src/main/resources/WEB-INF/properties/jdbc.properties
- přístup k postgresql(heslo a jméno databáze a uživatele, který k ní má práva). Tento soubor je nutné editovat, jinak se aplikace nepřipojí k DB a je více méně k ničemu. Více o JDBC na stránce NavrhAplikace
./src/main/resources/WEB-INF/classes/log4j.properties
- nastavení cesty, kam se budou zapisovat logy, jméno logovacího souboru, zakázání výpisu logu do příkazové řádky nebo do souboru, velikost logovacího souboru, případně jiné atributy logování. Defaultně se logy nacházejí v ./logs
./src/main/resources/WEB-INF/classes/spot.properties
mvn compile
. Tento a další příkazy se volají z kořenového adresáře projektu.
mvn war:war
, který se volá z kořenového adresáře projektu. Tedy toho adresáře, ve kterém se nachází soubor pom.xml
. Nebo je možné spustit skript buildwar.cmd
(windows) nebo buildwar.sh
(linux) v adresáři /.src/scripts/, který se postará o kompletní překompilování tříd a sestavení finálního war souboru.
target
, který obsahuje mimo jiné požadovaný war archiv aplikace.
Pozn: Poslední dva body platí i pro spouštění update skriptů
spot.properties
odkomentovat spravne nastaveni posilani emailu - smtp server, uzivatel, heslo, ssl (od verze 2.8.1: tento bod preskocit, odesilani funguje jen pres seznamovy email - tj. stejny jako na lokale)
header.jsp
javascripty (+ google link ?) kvuli google analytics (na localhostu by behem vyvoje melo zustat zakomentovane)
pom.xml
a spot.properties
; ve footer.jsp
se nacita uz z properties, nekdo tam to nacitani verze uz vyresil
jdbc.properties
zmenit podle nastaveni ostreho serveru hodnoty jdbc.url, jdbc.username, jdbc.password
log4j.properties
podle potreby změnit cesty k logu: log4j.appender.R.File, log4j.appender.U.File
spot_zcu_cz
tak aby příkazy typu ALTER TABLE ... OWNER TO ...;
prošly bez warningů.
./scripts/install.sh
.
Před samotným nasazením na ostrý server je doporučeno vyzkoušet tento release na testovacím serveru, podrobnosti na stránce BetaSpot
WAR archiv nahrajte do adresáře webapps
, který se nachází v kořenovém adresáři servletového kontejneru jetty.
/scripts/install.sh
/scripts/spot_update.sql
/scripts/install.sh
/scripts/2009-11-23/2009-11-23.sql
ERROR: syntax error at or near "2" na znaku 26242
, řešením je využít příkazovou řádku databáze postgres (viz návod u databáze Postgres uvedený výše)
Tutoriál pro windows: turorial-spot-app-spusteni.zip [0,4 MB]
mvn clean, mvn compile, mvn war:war
{SPOT}/target
zkopírovat do {jetty}/webapps
celou složku spot-2.0-rcX
, kde {SPOT}
je adresář projektu Spot a {jetty}
je kořenový adresář rozbaleného archivu jetty
java -jar start.jar
z kořenového adresáře kontejneru (kam jste rozbalili archiv s jetty). Aplikace by měla nyní běžet na http://localhost:8080/spot-2.0-rcX
(v případě problémů vyzkoušejte i http://localhost:8080/spot
)
mvn jetty:run
. Tímto příkazem se spouští servletový kontejner, který je pluginem do mavenu a v něm aplikace. Toto ovšem není ideální řešení pro produkční nasazení aplikace. Jde jen o testovací spouštění aplikace. Přihlašovací údaje pro administrátorský účet aplikace jsou username: admin, password:admin