Telepítési és üzemeltetési útmutató JaDoX 3
Monguz Kft. 6725 Szeged, Kálvária sgt. 87. Tel.: 62/433-660 www.monguz.hu E-mail:
[email protected]
Szeged, 2010
Telepítés 1. Az adatbázis (min postgres 8.3): •
sudo apt-get install postgres-contrib-8.3
•
install.sh innen futtatja : /usr/share/postgresql/8.3/contrib/_int.sql
•
8.3 felett nyilván át kell írni 8.x-re a fentieket
•
postgres userként : sh install.sh
•
2 DB jön létre : 1. jadox_server 2. jadox_web
•
logokat /tmp/jadox_install-ba rakja
2. JaDoX user létrehozás (WIKI.IBASE-n is fenn van): /usr/sbin/useradd -c 'Monguz Kft Jadox user' -m -p '$1$Fw3hsDNN$5PbqxISBTLZcGmdoQ9.2V/' -g ikron jadox
3. JaDoX home (/home/jadox) alatt könyvtár létrehozása : •
server
•
server/jadox
•
jadox könyvtárba kicsomagolni a tgz-ből a server-t.
•
Szerver alatt adatbázis elérés és portok belövése (szabad portra): 1. conf/jadoxsrv.xml 2. <Parameter name="rmiPort">1099 3. <Parameter name="url">jdbc:postgresql://localhost:5432/jadox_server 4. <Parameter name="user">postgres 5. <Parameter name="password">postinor
•
importTmpDir paraméter és storeDir paraméter a fent létrehozott könyvtárakra kell, hogy mutassanak, default ez : (/home/jadox/server/jadox/_imports és /home/jadox/server/jadox/_store)
4. JaDoX web (/opt/jadox_web létrehozása, tgz-ből web kicsomagolása ide) : •
Portok beállítása
•
Ellenőrizni kell, hogy melyik port szabad.
netstat -tnlp | grep választott_port_száma •
Ha a választott port még nincs használatban, akkor azt a conf/server.xml fájlban állíthatjuk be. A következő tulajdonságokat kell megadnunk. <Server port="38005" shutdown="SHUTDOWN">
•
Adatbázis kapcsolat beállítása Az adatbáziskapcsolatot 4 helyen kell megadnunk. 1. conf/Catalina/localhost/jetspeed.xml 1. username, password és url-t kell beállítani 2. database/database.properties 1. db.username 2. db.password 3. jdbc.url 3. lib/JaDoX_Utils.jar/hibernate.cfg.xml és hibernate_rss.cfg.xml 1. connection.url 2. connection.username 3. connection.password
5. Amennyiben a server portját át kellett állítani default-ról (1099), akkor a jadox_web/webapps/jetspeed/WEB-INF/web.xml-ben •
<param-value>1099 átállítása a megfelelőre
6. Indítóscriptek létrehozása •
a server alatt start/linux könyvtár alatt a két indító script
•
/etc/init.d-be, a könyvtár eléréseket beállítani benne (ha nem default)
•
majd : 1. update-rc.d jadox defaults 99 00 2. update-rc.d tomcat_jadox defaults 99 00
Végül ezek indítása : /etc/init.d/jadox start /etc/init.d/tomcat_jadox start
Üzemeltetés A Jadox alkalmazás szerver alapértelmezett telepítési helye : –
/home/jadox/jadox/server (port : 1099)
–
indító script : /etc/init.d/jadox [stop|start]
A Jadox web szerver alapértelmezett telepítési helye : –
/home/jadox/jadox_web (port : 8080)
–
indító script : /etc/init.d/tomcat_jadox [stop|start]
A Jadox által importált és konvertált fájlok : –
importált fájlok: /home/jadox/jadox/_imports
–
konvertált szolgáltatási példányok : /home/jadox/jadox/_store
A PostgreSQL adatbázis nevek, amiket létrehozunk : –
jadox_server
–
jadox_web
Mentés (Backup) : Naponta érdemes menteni az alábbiakat a teljes visszaállíthatóság érdekében. Könyvtárak (teljes tartalom): –
/home/jadox/jadox/_imports
–
/home/jadox/jadox/_store
–
/home/jadox/jadox/server
–
/home/jadox/jadox/web
Adatbázisok mentése (teljes dump-ok a Postgresből) : –
jadox_server –
root-ként :
pg_dump -E UTF-8 -f /backup/jadox_server_20100531.dump -U postgres -h localhost jadox_server –
postgres userként (su – postgres) :
pg_dump -E UTF-8 -f /backup/jadox_server_20100531.dump jadox_server –
jadox_web –
root-ként :
pg_dump -E UTF-8 -f /backup/jadox_web_20100531.dump -U postgres -h localhost jadox_web
–
postgres userként (su – postgres) :
pg_dump -E UTF-8 -f /backup/jadox_web_20100531.dump jadox_web
Leállások Amennyiben a felület nem elérhető, azaz a böngészőben nem jön be a Jadox kezdőoldala, akkor valószínűsíthető, hogy a webszerverrel van baj, log-ok ellenőrzése-mentése után a legtöbb esetben újraindítás segíthet (/etc/init.d/tomcat_jadox stop;/etc/init.d/tomcat_jadox start). Ha a felület elérhető, de nem használható a böngészés-keresés funkció, akkor a szerver alkalmazás állt le. Hasonlóképp újraindítás segíthet a logok ellenőrzése-mentése után (/etc/init.d/jadox stop;/etc/init.d/jadox start). A log-okat eljuttatva hozzánk várhatóan meg tudjuk mondani a leállás okát (általános hibák : elfogy a hely a szerveren, memóriagondok).
