Üzemeltetési dkumentáció Naviscn Infrmatikai Zrt. 1037 Budapest, Mntevideó utca 16/b.
Tartalmjegyzék 1. VERZIÓKÖVETÉS 4 2. BEVEZETÉS 4 2.1 A DOKUMENTUM TARTALMA, CÉLJA ÉS CÉLKÖZÖNSÉGE 4 2.2 CÉLZOTT OLVASÓKÖR 4 2.3 A RENDSZER CÉLJA, KIEMELT FELADATAI: 4 3. RÖVIDÍTÉSEK: 5 4. ÜZEMELTETÉSHEZ SZÜKSÉGES ALAPISMERETEK: 5 5. AZ ALKALMAZÁS MŰKÖDÉSI LOGIKÁJA: 6 6. AZ ALKALMAZÁS MŰKÖDÉSI LOGIKÁJA: 7 7. JOGOSULTSÁGI RENDSZER, SZEREPKÖRÖK LEÍRÁSA: 7 8. LÁSD: A RENDSZERTERV JOGOSULTSÁGI RENDSZER, SZEREPKÖRÖK LEÍRÁSA FEJEZETE TARTALMAZZA. 7 9. JOGOSULTSÁGI RENDSZER, SZEREPKÖRÖK LEÍRÁSA: 7 10. RENDSZERKÖRNYEZET 7 11. TELEPÍTÉSI/INSTALLÁLÁSI LEÍRÁS: 8 12. ARCHIVÁLÁS LEÍRÁSA: 8 12.1 ADATBÁZIS 8 12.2 ALKALMAZÁS SZERVER 8 12.3 TÉRKÉP SZERVER 8 13. HIBAKEZELÉS 8 2 / 18
13.1 ALKALMAZÁS SZERVER LOG FÁJLOK 8 14. MENTÉS ÉS VISSZAÁLLÍTÁS 9 14.1 ADATBÁZIS 9 14.2 TÉRKÉPSZERVER LOG FÁJLOK 9 15. KÖRNYEZET ÉS ELÉRÉS 10 15.1 A TÉRKÉPSZERVER (GEOSERVER) 10 15.2 ALKALMAZÁS SZERVER : 10 16. HIBAKEZELÉSI ELJÁRÁSREND 12 16.1 HIBÁK TIPIZÁLÁSA 12 16.2 HIBÁK LEÍRÁSA ( HIBABEJELENTŐ MINTA HIBA BEJELENTŐ TEMPLATE) 13 17. VÁLTOZÁSKÖVETÉS, VERZIÓFRISSÍTÉS 13 18. A RENDSZER MONITOROZÁSA: 14 18.1 TÉRKÉPSZERVER 14 18.2 ALKALMAZÁS SZERVER 14 19. ADATBÁZIS TÁBLÁK: 15 FÜGGELÉK 16 1. TÉRKÉP SZERVER LOGGING.PROPERTIES 16 2. HIBA BEJELENTÉS 17 ÁBRAJEGYZÉK 18 2. ÁBRA 18 3 / 18
1. Verziókövetés Verzió Dátum Szerző/k Felülvizsgálta Leírás v0.1 2014.03.03. Kőhegyi Marianna Üzemeltetési dkumentáció első átadtt verziója. 2. Bevezetés 2.1 A dkumentum tartalma, célja és célközönsége A dkumentum célja, hgy a rendszer üzemeltetőinek támgatást adjn a termék üzemeltetésének elsajátításáhz. 2.2 Célztt lvasókör Jelen dkumentum megcélztt lvasókörét a rendszer üzemeltetői képezik 2.3 A rendszer célja, kiemelt feladatai: Az Erdészeti szakmai rendszer térinfrmatikai műszaki-gazdasági nyilvántartó rendszer, amely elősegíti, a felhasznál knak tervezési, elemzési, munkaszervezési és adatszlgáltatási feladatait. A rendszer analitikus nyilvántartást vezet az bjektumkról, a hzzájuk kapcslt tervezett vagy tényleges műveletekről (gazdasági alapflyamatk) és a termelt vagy felhasznált naturáliákról. Ennek megfelelően a rendszer felhasználó szempntból több részből áll: Erdőgazdálkdás. - Erdőállmány nyilvántartás EANY megjelenítés, riprtk, térképi megjelenítés - Fahasználat Tervezés, riprtk, fatömeg becslési jegyzőkönyvek, térképi megjelenítés - Erdőművelés Tervezés, riprtk, e-lap, térképi megjelenítés - Erdőgazdálkdási hatósági bejelentések Tervezett erdőgazdálkdási tev. bejelentése Bejelentett fahasználat tev. teljesítése Bejelentett erdőművelés. tev. teljesítése Riprtk - Csemetekert - Közjólét 4 / 18
Területek nyilvántartása, riprtk, térképi megjelenítés Tervezés, riprtk, térképi megjelenítés - Természetvédelem - Erdővédelem Erdőkezelés Védekezések rögzítése Tervezés, riprtk, érképi megjelenítés Erdőkezelés rögzítése Tervezés, riprtk, érképi megjelenítés Vadgazdálkdás Mezőgazdaság Ingatlan Karbantartás A rendszerhez szükséges alapadatk karbantartása. 3. Rövidítések: - felhasználk - jgsultság kezelés - szervezeti egység karbantartás - közigazgatási egységek karbantartása - műveletek karbantartása - térképek karbantartása - paraméterek karbantartása ESZR: Erdészeti szakrendszer GWT: Ggle Web Tlkit EJB: Enterprise JavaBeans EAR: Enterprise Archive RHEL: Red Hat Enterprise Linux RPC: Remte Prcedure Calls 4. Üzemeltetéshez szükséges alapismeretek: A rendszer üzemeltetéséhez elengedhetetlen, RHEL adminisztrációs ismeretek, úgymint Linux felhasználókezelés, hálózati knfigurációs és alapvető parancsk ismerete. Alapvető PstgreSQL adatbázis ismerete. Előnyt jelent JBss 7.1.1.Final(WildFy) alkalmazásszerver és GeServer ismeretek 5 / 18
5. Az alkalmazás működési lgikája: 1. ábra Több rétegű alkalmazás működési lgikája 2. ábra Az alkalmazás működési lgikája Az alkalmazás a következő elemekből áll: Entity Bean: Perzisztencia réteg (Hibernate) perzisztens réteg: adatbázisban tárlt perzisztens adatkat tartalmazza Adatbázis Enterprise JavaBeans (EJB) 6 / 18
Üzleti réteg: üzleti lgika implementációját tartalmazzák GWT Servlet Böngészőben futó JavaScript Az alkalmazás hálózatn keresztül jut el a felhasználóhz, annak böngészőjébe, tt már kizárólag javascriptként fut. Minden, ami a böngészőbe történik, kliens ldali flyamatnak nevezünk. A GWT RPC-t használ szerver ldal eléréséhez, ez valójában egy AJAX hívás a http prtkll felett, és az itt megjelenő szerviz frgalm nem egyenlő a web szervizével, mivel ennek megvalósítása tulajdnképpen egy servlet. Elemek kapcslata: Felhasználó a böngészőből (JavaScript) RPC hívás segítségével adatkat kér, illetve küld a Servlet felé. A Servlet meghívja a szükséges EJB függvényeket, melyek felelősek az üzleti lgikáért. Amennyiben szükséges az EJB a perzisztencia rétegen keresztül lvassa vagy írja az adatbázist. 6. Az alkalmazás működési lgikája: Lásd rendszerterv Külső rendszerkapcslatk fejezet 7. Jgsultsági rendszer, szerepkörök leírása: 8. Lásd: A rendszerterv Jgsultsági rendszer, szerepkörök leírása fejezete tartalmazza. 9. Jgsultsági rendszer, szerepkörök leírása: 10. Rendszerkörnyezet Térképszerver éles és teszt Hst: EEVRVIR Memória: 12GB Operációs rendszer: Cent Os Alkalmazás szerver: éles nde - teszt nde: Hst: EEVRVIR Memória: 12GB Operációs rendszer: Cent Os 7 / 18
11. Telepítési/Installálási leírás: Külön dkumentumban kaptt helyett, lásd ESZR erdészeti szakmai rendszer telepítési dkumentáció. 12. Archiválás leírása: 12.1 Adatbázis 12.2 Alkalmazás szerver Az alkalmazás szerveren nem keletkeznek archiválandó állmányk. Egyedül a lg fájlk azk amiket az alkalmazás szerver napnta archivál(ezen lehet finítani még). A lg fájlk a következő könyvtárban találhatóak: /usr/share/jbss-as-7.1.1.final/standalne-<nde név>/lg. 12.3 Térkép szerver A térkép szerveren nem keletkeznek archiválandó állmányk. Egyedül a lg fájlk azk amiket a szerver archivál. A lg fájlk a következő könyvtárban találhatóak: /usr/lcal/geserver<példány név>/lgs 13. Hibakezelés 13.1 Alkalmazás szerver lg fájlk Szerver által használt lgglási paraméterek beállításara a /usr/share/jbss-as- 7.1.1.Final/standalne-<nde név>/cnfiguratin/standalne.xml ad lehetőséget. Keressük meg a következő részt: <subsystem xmlns="urn:jbss:dmain:lgging:1.1"> <cnsle-handler name="console"> <level name="info"/> <frmatter> <pattern-frmatter pattern="%d{hh:mm:ss,sss} %-5p [%c] (%t) %s%e%n"/> </frmatter> </cnsle-handler> <peridic-rtating-file-handler name="file"> <frmatter> <pattern-frmatter pattern="%d{hh:mm:ss,sss} %-5p [%c] (%t) %s%e%n"/> </frmatter> <file relative-t="jbss.server.lg.dir" path="server.lg"/> <suffix value=".yyyy-mm-dd"/> <append value="true"/> </peridic-rtating-file-handler> <lgger categry="cm.arjuna"> <level name="warn"/> <lgger> <lgger categry="jacrb.cnfig"> <level name="error"/> </lgger> <rt-lgger> <level name="info"/> 8 / 18
14. Mentés és visszaállítás 14.1 Adatbázis <handlers> <handler name="console"/> <handler name="file"/> </handlers> </rt-lgger> </subsystem> Itt lehet beállítani a lg fájl helyét, tartalmát illetve a naplzási szintet, mely szabályzható glbálisan illetve külön csmagkra és sztálykra is megadható. A rendszer mst minimális infrmációt naplzza, de ha a paraméterező file-ban beállítjuk DEBUG szintre, akkr nymn követhetjük a rendszer futását. Alapértelmezetten két aktuális fájl található a könyvtárban /usr/share/jbss-as- 7.1.1.Final/standalne-<nde név>/lg, a bt.lg és a server.lg. A bt.lg minden induláskr felülíródik, de a tartalma belekerül a server.lg-ba is így nem veszik el. A server.lg fájl biznys időközönként archiválásra kerül server.lg.év-hónap-nap frmátumban. Ajánltt az adatbázis teljes tartalmáról napi szinten inkrementális fizikai mentést készíteni. 14.2 Térképszerver lg fájlk A térképszerver adminisztrációs felületén lehet megnézni illetve módsítani a szerver beállításait. A lg fájl alapértelmezett helye: /usr/share/geserver<példány>/lgs Ezt a helyet módsíthatjuk az adminisztrációs felületen a Settings/Glbal menüben a Lg lcatin pntban. Az adminisztrációs felület a következő címen érhető el: Éles <térképszerver hst>:6061/geserver Teszt<térképszerver hst>:6161/geserver Alapértelmezett knfigurációs fájl: /usr/share/geserver<példány>/lgs/default_logging.prperties Térkép szerver lgging.prperties Itt lehet beállítani a lg fájl helyét, tartalmát illetve a naplózási szintet, mely szabályzható glbálisan illetve külön csmagkra és sztálykra is megadható. Alapértelmezetten napnta új lg fájl keletkezik a következő frmátumban: év_hónap_nap.request.lg. 9 / 18
15. Környezet és elérés 15.1 A térképszerver (geserver) A térképszerver telepítési helye: /usr/share/geserver /usr/share/geserver-teszt Állmányk: Az adminisztrációs felületét a következő címen lehet elérni: éles:http://<hst>:6061/geserver teszt:http://<hst>:6161/geserver Az alkalmazás szerver service-ként fut. A szerver leállítása és újraindítása és státuszának lekérése a következő parancskkal lehetséges, Linux knzl prgrammal: Éles: Éles: service geserver start service geserver stp service geserver status service geserver teszt start service geserver teszt stp service geserver-teszt status 15.2 Alkalmazás szerver : A szerver telepítési helye: /usr/share/jbss-as-7.1.1.final 10 / 18
Állmányk Alkalmazás EAR fájl helye: /usr/share/jbss-as-7.1.1.final/standalne-<nde-név>/deplyments/eszr-ear.ear Knfigurációs fájl helye: /usr/share/jbss-as-7.1.1.final/standalne-<nde-név>/cnfiguratin/standalne.xml Lg fájl helye: /usr/share/jbss-as-7.1.1.final/standalne-<nde-név>/lg/server.lg Az alkalmazás elérhető a következő URL címen: http://<hst>:8081/eszr http://<hst>:8181/eszr Az alkalmazás szerver service-ként fut. A szerver leállítása és újraindítása és státuszának lekérése a következő parancskkal lehetséges, linux knzl prgrammal: Éles : teszt : service jbss-eles start service jbss-eles stp service jbss-eles status service jbss-teszt start service jbss-teszt stp service jbss-eles status 11 / 18
16. Hibakezelési eljárásrend Amennyiben a rendszer hibásan működik a hibakeresés a naplófájlk elemzésével kell kezdeni. A hiba jelentkezésének időpntja környékén vizsgáljuk meg a naplófájlt és keressünk java kivételeket (Exceptin). Az így felderített hiba kát meg kell szüntetni, értesíteni a rendszerért felelős személyeket. 16.1 Hibák tipizálása A tesztelés srán előfrduló hibákat 4 csprtba srljuk aszerint, hgy azk az üzletmenet srán az alkalmazás (adtt funkció) használatát mennyiben érintik. A hibatípusk az alábbiak: Hiba besrlás Leírás 1 Fatális hiba, a rendszer nem működik. 2 Kmly hiba. A funkció az elsődleges üzleti követelményeknek nem felel meg. (specifikáció alapján meg nem valósíttt funkció) 3 Nrmál hiba. Az elsődleges üzleti követelmények kielégíthetők a funkcióval, a funkció aktuális használhatósága jelentős mértékben nem hátráltatja az peratív munkát. (pl. működést nem - részfunkciót sem - akadályzó hiba; a specifikációnak megfelelő, de az üzleti követelményeknek nem 100%-ban megfelelő funkció) 4 Apró hiba. Elgépelés. Az észrevétel specifikációtól eltérő, tvábbi funkcinális kiegészítésre irányuló kívánságt fgalmaz meg. A funkció használhatóságát jelentéktelen mértékben beflyáslja. (pl. dizájnnal kapcslats észrevételek) 12 / 18
16.2 Hibák leírása ( hibabejelentő minta Hiba bejelentés) 1. Készíteni kell a felületen egy képernyőmentés (), amikr a hiba keletkezett. A billentyűzeten lévő Ctrl+PrintScreen gmb (jbb felső sark körül kell keresni) lenymásával készíthetünk képernyőmentést. Ezután nyissuk meg pl: a Paint alkalmazást (Start menü -> Minden prgram -> Kellékek -> Paint). A CTRL és a V billentyűk együttes lenymásával beilleszthetjük a képernyőképet, innentől kezdve kedvünk szerint méretezhetjük. A végén mentsük el a fájlt <nev>+<datum>.jpg. 2. Írja le flyamatt, vagyis a hibát hgy lehet előidézni milyen adatk, melyik felület pl: 1. EANY lekérdezés megnyitása,2. 2014 01 knténer kiválasztása 3. hiba keletkezett 3. leírni milyen böngésző, melyik verziója pl. IE7 4. leírni az alkalmazás verzióját: lgin ablak jbb alsó sark 5. a rendszergazdától elkérni arra az időszakra, amikr a hiba keletkezett a naplóbejegyzést (alkalmazás szerver napló fájlt.) és a hibabejelentéshez csatlni kell Amennyiben az alkalmazás indítása sikertelen akkr a /usr/share/jbss-as-7.1.1.final/standalne<ndenev>/deplyments/ könyvtárban megjelenik egy eszr-ear.ear.failed elnevezésű fájl, mely tartalmazza a hiba kát (java kivétel). A hiba javítás után a szervert le kell állítani,ki kell törölni az eszr-ear.ear fájlt és a hzzátartzó failed fájlt, és a kijavíttt eart da kell máslni és újra elindítani a a szervert. Amíg a failed a fájl létezik addig a server nem deplylja újra az alkalmazást. Hibák kód prefix A tesztelés srán előfrduló hibákat hibakódkkal lássuk el. A hibakódkhz tartzó prefixek a következőek legyenek. Hibakd prefix Leírás EG_ VG_ IN_ MG_ KB_ Erdőgazdálkdás Vadgazdálkdás Ingatlan Mezőgazdaság Karbantartás 17. Váltzáskövetés, verziófrissítés A mennyiben az alkalmazás adatbázisa váltzik, a váltzást SQL script frmában kerül átadásra az Erdőgazdaságk számára. Adatbázis váltzásakr, erős törekvés, hgy adatk ne vesszenek el, a script az aktuális állaptban hiba nélkül futtatható legyen. Minden frissítés előtt z adatbázist kötelező menteni, ha bármilyen prbléma merül fel, akkr az eredeti állapt visszaállítható legyen. Alkalmazás frissítés esetén a Erdőgazdaság számára átadásra kerül egy új eszr-ear.ear fájl(teszt/eles). Az alkalmazás frissítés lépései: 13 / 18
1 Alkalmazás szerver leállítása: service jbss-eles/jbss-teszt stp 2 Készítsünk biztnsági mentést a előzőleg kitelepített ear fájlról: /usr/share/jbss-as- 7.1.1.Final/standalne<nde-nev>/deplyments/eszr-ear.ear hzzunk létre egy könyvtárat datumflder/verziszam másljuk bele az előző ear file-t 3 Írjuk felül a eszr-ear.ear fájlt. a. Ellenőrizzük, hgy a jbss felhasználónak krlátlan hzzáférése legyen a fájlra, illetve, hgy Ő maradt-e a tulajdns. b. Töröljük a következő könyvtárakat: /usr/share/jbss-as-7.1.1.final/standalne-<nde név>/data /usr/share/jbss-as-7.1.1.final/standalne-<nde név>/tmp 4.Indítsuk újra az alkalmazásszervert: service jbss-eles/jbss-teszt start 5. ha nem sikerül telepíteni az alkalmazást, akkr 1,3,4 pntkat csináljuk meg újra csak az elmáslt eart fájlt másljuk vissza. 18. A rendszer mnitrzása: 18.1 Térképszerver Térkép szerver működése: A kliensek használat közben térképi csempéket töltenek le. Mnitrzási pntk: HTTP GeServer: Ellenőrzni, hgy a következő URL-len figyel-e a térképszerver <hst>:6061/geserver/web <hst>:6161/geserver/web Hiba esetén: Amennyiben az ellenőrzési pnt hibát mutat, abban az esetben nem fut a térkép szerver, esetleg a tűzfal blkklja a prtt. A következő paranccsal ellenőrizhető, hgy a térképszerver fut-e: service geserver status, ha nem fut a service geserver start paranccsal indítható. GeServer lad title: Egy knkrét előre megadtt csempe letöltése. Ellenőrzi, hgy a térképszerver megfelelően van-e knfigurálva, képes-e csempéket szlgáltatni. Hiba esetén: Amennyiben ez a pnt hibás, de maga a térképszerver elérhető, akkr rsszul van beállítva, esetleg nincs megadva térkép. A ESZR erdészeti szakmairendszer telepítési dkumentáció tartalmazza a térképszerver beállításait, ellenőrizzük, hgy megfelelő-e. 18.2 Alkalmazás szerver Ellenőrzni kell, hgy a JBss példányk futnak-e futnak-e-e, és hgy elérhetőek-e az alkalmazásk alkalmazás ellenőrzése http://ipaddress:8081/eszr megjelenik a lgin ablak 14 / 18
http://ipaddress:8181/eszr megjelenik a lgin ablak jbss server példány ellenőrzése: http://ipaddress:8081 alkalmazás server bejelentkező ldala jelenik meg http://ipaddress:8181 alkalmazás server bejelentkező ldala jelenik meg Hiba esetén: Amennyiben az ellenőrzési pnt hibát mutat lehetséges, hgy nem fut az alkalmazás szerver. A következő paranccsal ellenőrizhető service jbss-eles status, ha nem fut a service jbss-eles start service jbss-teszt status, ha nem fut a service jbss-teszt start paranccsal indítható. Amennyiben a hiba tvábbra is fenn áll ellenőrizzük a lg fájlkat. CPU usage: A szerver CPU használatáról ad infrmációkat. Ezt a figyelési pntt csak infrmáció jelleggel érdemes bekötni, riasztást nem kell definiálni rá, hiszen előfrdulhat, hgy biznys ideig megnő a CPU terhelés. JVM memry status: A java virtuális gép Heap memória használatát mutatja. Ezt a figyelési pntt csak infrmáció jelleggel érdemes bekötni, riasztást nem kell definiálni rá, hiszen előfrdulhat, hgy biznys ideig megnő a memória használat. Ellenőrizni kell, hgy az adatbázis szerver elérhető-e, működése megfelelő. Ha az adatbázis szerver elérhető, de nem rég vlt újraindítva elképzelhető, hgy az alkalmazás szerver még nem aktualizálta a cnnectin-pl-t akkr érdemes újrainditani az alkalmazás szervert. Általánsságban elmndható, hgy minden lyan esetben, amikr le kell állítani az adatbázist, az újraindítást követően az alkalmazás szervereket is újra kell indítani (hiszen ilyenkr megpróbálja életben tartani a nyittt kapcslatkat, de az adatbázis ldaln már nincs meg a kapcslat párja). 19. Adatbázis táblák: Minden adatbázis tábla a ESZR adatbázisban a public sémában található. 15 / 18
FÜGGELÉK 1. Térkép szerver lgging.prperties lg4j.rtlgger=warn, geserverlgfile, stdut lg4j.appender.stdut=rg.apache.lg4j.cnsleappender lg4j.appender.stdut.layut=rg.apache.lg4j.patternlayut lg4j.appender.stdut.layut.cnversinpattern=%d{dd MMM HH:mm:ss} %p [%c{2}] - %m%n lg4j.appender.geserverlgfile=rg.apache.lg4j.rllingfileappender # Keep three backup files. lg4j.appender.geserverlgfile.maxbackupindex=3 # Pattern t utput: date pririty [categry] - message lg4j.appender.geserverlgfile.layut=rg.apache.lg4j.patternlayut lg4j.appender.geserverlgfile.layut.cnversinpattern=%d %p [%c{2}] - %m%n lg4j.categry.lg4j=fatal lg4j.categry.rg.getls=warn lg4j.categry.rg.getls.factry=warn lg4j.categry.rg.geserver=info lg4j.categry.rg.vfny.geserver=info lg4j.categry.rg.springframewrk=warn lg4j.categry.rg.gewebcache=info lg4j.categry.rg.gewebcache.seed.truncatetask=warn 16 / 18
2. Hiba bejelentés HIBA BEJELENTÉS* Hiba kód: Hiba típusa( 0-4) Verzió szám: tesztelési környezet : éles/teszt Hiba dátuma: Böngésző verziója Hiba leírása: Adatk, melyekkel a hiba keletkezett: Megjegyzés Tesztelést végezte* Név Szervezeti egység/besztás 17 / 18
Ábrajegyzék 2. ábra 18 / 18