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: iroda@monguz.hu 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</parameter> 3. <Parameter name="url">jdbc:postgresql://localhost:5432/jadox_server</parameter> 4. <Parameter name="user">postgres</parameter> 5. <Parameter name="password">postinor</parameter> 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"> <Connector port="8080" protocol="http/1.1" connectiontimeout="20000" redirectport="8443" URIEncoding="UTF-8" />
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</param-value> á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).