b

Üzemeltetési dokumentáció

Naviscon Informatikai Zrt. 1037 Budapest, Montevideó utca 16/b.

Tartalomjegyzé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

2.

Verzió

Dátum

Szerző/k

v0.1

2014.03.03.

Kőhegyi Marianna

Felülvizsgálta

Leírás Üzemeltetési dokumentáció első átadott verziója.

Bevezetés 2.1 A dokumentum tartalma, célja és célközönsége A dokumentum célja, hogy a rendszer üzemeltetőinek támogatást adjon a termék üzemeltetésének elsajátításához.

2.2 Célzott olvasókör Jelen dokumentum megcélzott olvasókörét a rendszer üzemeltetői képezik

2.3 A rendszer célja, kiemelt feladatai: Az Erdészeti szakmai rendszer térinformatikai műszaki-gazdasági nyilvántartó rendszer, amely elősegíti, a felhasznál oknak tervezési, elemzési, munkaszervezési és adatszolgáltatási feladatait. A rendszer analitikus nyilvántartást vezet az objektumokról, a hozzájuk kapcsolt tervezett vagy tényleges műveletekről (gazdasági alapfolyamatok) és a termelt vagy felhasznált naturáliákról. Ennek megfelelően a rendszer felhasználó szempontból több részből áll: 

Erdőgazdálkodás. -

Erdőállomány nyilvántartás EANY megjelenítés, riportok, térképi megjelenítés

-

Fahasználat Tervezés, riportok, fatömeg becslési jegyzőkönyvek, térképi megjelenítés

-

Erdőművelés Tervezés, riportok, e-lap, térképi megjelenítés

-

Erdőgazdálkodási hatósági bejelentések Tervezett erdőgazdálkodási tev. bejelentése Bejelentett fahasználat tev. teljesítése Bejelentett erdőművelés. tev. teljesítése Riportok

-

Csemetekert

-

Közjólét 4 / 18

Területek nyilvántartása, riportok, térképi megjelenítés Tervezés, riportok, térképi megjelenítés -

Természetvédelem

-

Erdővédelem – Erdőkezelés Védekezések rögzítése Tervezés, riportok, érképi megjelenítés Erdőkezelés rögzítése Tervezés, riportok, érképi megjelenítés



Vadgazdálkodás



Mezőgazdaság



Ingatlan



Karbantartás A rendszerhez szükséges alapadatok karbantartása. -

felhasználok

-

jogosultsá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

3. Rövidítések: 

ESZR: Erdészeti szakrendszer



GWT: Google Web Toolkit



EJB: Enterprise JavaBeans



EAR: Enterprise Archive



RHEL: Red Hat Enterprise Linux



RPC: Remote Procedure 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 konfigurációs és alapvető parancsok ismerete. Alapvető PostgreSQL adatbázis ismerete. Előnyt jelent JBoss 7.1.1.Final(WildFy) alkalmazásszerver és GeoServer ismeretek

5 / 18

5. Az alkalmazás működési logikája:

1. ábra Több rétegű alkalmazás működési logikája

2. ábra Az alkalmazás működési logikája

Az alkalmazás a következő elemekből áll: 

Entity Bean: Perzisztencia réteg (Hibernate) perzisztens réteg: adatbázisban tárolt perzisztens adatokat tartalmazza



Adatbázis



Enterprise JavaBeans (EJB) 6 / 18

Üzleti réteg: üzleti logika implementációját tartalmazzák 

GWT Servlet



Böngészőben futó JavaScript

Az alkalmazás hálózaton keresztül jut el a felhasználóhoz, annak böngészőjébe, ott már kizárólag javascriptként fut. Minden, ami a böngészőbe történik, kliens oldali folyamatnak nevezünk. A GWT RPC-t használ szerver oldal eléréséhez, ez valójában egy AJAX hívás a http protokoll felett, és az itt megjelenő szerviz forgalom nem egyenlő a web szervizével, mivel ennek megvalósítása tulajdonképpen egy servlet. Elemek kapcsolata: Felhasználó a böngészőből (JavaScript) RPC hívás segítségével adatokat 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 logikáért. Amennyiben szükséges az EJB a perzisztencia rétegen keresztül olvassa vagy írja az adatbázist.

6. Az alkalmazás működési logikája: Lásd rendszerterv „Külső rendszerkapcsolatok” fejezet

7. Jogosultsági rendszer, szerepkörök leírása: 8. Lásd: A rendszerterv „Jogosultsági rendszer, szerepkörök leírása” fejezete tartalmazza. 9. Jogosultsági rendszer, szerepkörök leírása: 10. Rendszerkörnyezet o

Térképszerver éles és teszt Host: EEVRVIR Memória: 12GB Operációs rendszer: Cent Os

o Alkalmazás szerver: éles node - teszt node: Host: 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 dokumentumban kapott helyett, lásd „ESZR erdészeti szakmai rendszer telepítési dokumentá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ó állományok. Egyedül a log fájlok azok amiket az alkalmazás szerver naponta archivál(ezen lehet finítani még). A log fájlok a következő könyvtárban találhatóak: /usr/share/jboss-as-7.1.1.Final/standalone-<node név>/log.

12.3

Térkép szerver

A térkép szerveren nem keletkeznek archiválandó állományok. Egyedül a log fájlok azok amiket a szerver archivál. A log fájlok a következő könyvtárban találhatóak: /usr/local/geoserver/logs

13. Hibakezelés 13.1

Alkalmazás szerver log fájlok Szerver által használt loggolási paraméterek beállításara a /usr/share/jboss-as7.1.1.Final/standalone-<node név>/configuration/standalone.xml ad lehetőséget. Keressük meg a következő részt: <subsystem xmlns="urn:jboss:domain:logging:1.1"> <pattern-formatter pattern="%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n"/> <pattern-formatter pattern="%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n"/> <suffix value=".yyyy-MM-dd"/> 8 / 18



Itt lehet beállítani a log fájl helyét, tartalmát illetve a naplozási szintet, mely szabályozható globálisan illetve külön csomagokra és osztályokra is megadható. A rendszer most minimális információt naplozza, de ha a paraméterező file-ban beállítjuk DEBUG szintre, akkor nyomon követhetjük a rendszer futását. Alapértelmezetten két aktuális fájl található a könyvtárban /usr/share/jboss-as7.1.1.Final/standalone-<node név>/log, a boot.log és a server.log. A boot.log minden induláskor felülíródik, de a tartalma belekerül a server.log-ba is így nem veszik el. A server.log fájl bizonyos időközönként archiválásra kerül server.log.év-hónap-nap formátumban. 14. Mentés és visszaállítás 14.1

Adatbázis Ajánlott az adatbázis teljes tartalmáról napi szinten inkrementális fizikai mentést készíteni.

14.2

Térképszerver log fájlok A térképszerver adminisztrációs felületén lehet megnézni illetve módosítani a szerver beállításait. A log fájl alapértelmezett helye: /usr/share/geoserver/logs Ezt a helyet módosíthatjuk az adminisztrációs felületen a Settings/Global menüben a Log location pontban. Az adminisztrációs felület a következő címen érhető el: Éles :6061/geoserver Teszt:6161/geoserver Alapértelmezett konfigurációs fájl: /usr/share/geoserver/logs/DEFAULT_LOGGING.properties Térkép szerver logging.properties

Itt lehet beállítani a log fájl helyét, tartalmát illetve a naplózási szintet, mely szabályozható globálisan illetve külön csomagokra és osztályokra is megadható. Alapértelmezetten naponta új log fájl keletkezik a következő formátumban: év_hónap_nap.request.log.

9 / 18

15. Környezet és elérés 15.1

A térképszerver (geoserver) o

A térképszerver telepítési helye: /usr/share/geoserver /usr/share/geoserver-teszt

o

Állományok: Az adminisztrációs felületét a következő címen lehet elérni: éles:http://:6061/geoserver teszt:http://:6161/geoserver

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ő parancsokkal lehetséges, Linux konzol programmal: Éles: service geoserver start service geoserver stop service geoserver status Éles: service geoserver –teszt start service geoserver –teszt stop service geoserver-teszt status

15.2

Alkalmazás szerver : o

A szerver telepítési helye:

/usr/share/jboss-as-7.1.1.Final 10 / 18

o

Állományok Alkalmazás EAR fájl helye: /usr/share/jboss-as-7.1.1.Final/standalone-<node-név>/deployments/eszr-ear.ear Konfigurációs fájl helye: /usr/share/jboss-as-7.1.1.Final/standalone-<node-név>/configuration/standalone.xml Log fájl helye: /usr/share/jboss-as-7.1.1.Final/standalone-<node-név>/log/server.log

o

Az alkalmazás elérhető a következő URL címen: http://:8081/eszr http://: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ő parancsokkal lehetséges, linux konzol programmal: Éles : service jboss-eles start service jboss-eles stop service jboss-eles status teszt : service jboss-teszt start service jboss-teszt stop service jboss-eles status

11 / 18

16. Hibakezelési eljárásrend Amennyiben a rendszer hibásan működik a hibakeresés a naplófájlok elemzésével kell kezdeni. A hiba jelentkezésének időpontja környékén vizsgáljuk meg a naplófájlt és keressünk java kivételeket (Exception). Az így felderített hiba okát meg kell szüntetni, értesíteni a rendszerért felelős személyeket.

16.1

Hibák tipizálása A tesztelés során előforduló hibákat 4 csoportba soroljuk aszerint, hogy azok az üzletmenet során az alkalmazás (adott funkció) használatát mennyiben érintik. A hibatípusok az alábbiak:

Hiba besorolás

Leírás

1

Fatális hiba, a rendszer nem működik.

2

Komoly hiba. A funkció az elsődleges üzleti követelményeknek nem felel meg. (specifikáció alapján meg nem valósított funkció)

3

Normá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 operatív munkát. (pl. működést nem - részfunkciót sem - akadályozó 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ő, további funkcionális kiegészítésre irányuló kívánságot fogalmaz meg. A funkció használhatóságát jelentéktelen mértékben befolyásolja. (pl. dizájnnal kapcsolatos é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 (), amikor a hiba keletkezett. A billentyűzeten lévő Ctrl+PrintScreen gomb (jobb felső sarok körül kell keresni) lenyomásával készíthetünk képernyőmentést. Ezután nyissuk meg pl: a Paint alkalmazást (Start menü -> Minden program -> Kellékek -> Paint). A CTRL és a V billentyűk együttes lenyomá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 +.jpg.

2. Írja le folyamatot, vagyis a hibát hogy lehet előidézni milyen adatok, melyik felület… pl: 1. EANY lekérdezés megnyitása,2. 2014 01 konté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: login ablak jobb alsó sarok 5. a rendszergazdától elkérni arra az időszakra, amikor a hiba keletkezett a naplóbejegyzést (alkalmazás szerver napló fájlt.) és a hibabejelentéshez csatolni kell Amennyiben az alkalmazás indítása sikertelen akkor a /usr/share/jboss-as-7.1.1.Final/standalone<nodenev>/deployments/ könyvtárban megjelenik egy „eszr-ear.ear.failed „ elnevezésű fájl, mely tartalmazza a hiba oká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 hozzátartozó failed fájlt, és a kijavított eart oda kell másolni és újra elindítani a a szervert. Amíg a failed a fájl létezik addig a server nem deployolja újra az alkalmazást.

Hibák kód prefix A tesztelés során előforduló hibákat hibakódokkal lássuk el. A hibakódokhoz tartozó prefixek a következőek legyenek. Hibakod prefix Leírás

17.

EG_

Erdőgazdálkodás

VG_

Vadgazdálkodás

IN_

Ingatlan

MG_

Mezőgazdaság

KB_

Karbantartás

Változáskövetés, verziófrissítés A mennyiben az alkalmazás adatbázisa változik, a változást SQL script formában kerül átadásra az Erdőgazdaságok számára. Adatbázis változásakor, erős törekvés, hogy adatok ne vesszenek el, a script az aktuális állapotban hiba nélkül futtatható legyen. Minden frissítés előtt z adatbázist kötelező menteni, ha bármilyen probléma merül fel, akkor az eredeti állapot 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 jboss-eles/jboss-teszt stop

2

Készítsünk biztonsági mentést a előzőleg kitelepített ear 7.1.1.Final/standalone<node-nev>/deployments/eszr-ear.ear

fájlról: /usr/share/jboss-as-

hozzunk létre egy könyvtárat datumfolder/verzioszam másoljuk bele az előző ear file-t 3

Írjuk felül a eszr-ear.ear fájlt. a. Ellenőrizzük, hogy a jboss felhasználónak korlátlan hozzáférése legyen a fájlra, illetve, hogy Ő maradt-e a tulajdonos. b. Töröljük a következő könyvtárakat: /usr/share/jboss-as-7.1.1.Final/standalone-<node név>/data /usr/share/jboss-as-7.1.1.Final/standalone-<node név>/tmp

4.Indítsuk újra az alkalmazásszervert: service jboss-eles/jboss-teszt start 5. ha nem sikerül telepíteni az alkalmazást, akkor 1,3,4 pontokat csináljuk meg újra csak az elmásolt eart fájlt másoljuk vissza.

18.

A rendszer monitorozá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. Monitorozási pontok: o

HTTP GeoServer: Ellenőrzni, „:6061/geoserver/web”

hogy

a

következő

URL-len

figyel-e

a

térképszerver

„:6161/geoserver/web”

18.2

o

Hiba esetén: Amennyiben az ellenőrzési pont hibát mutat, abban az esetben nem fut a térkép szerver, esetleg a tűzfal blokkolja a portot. A következő paranccsal ellenőrizhető, hogy a térképszerver fut-e: „service geoserver status”, ha nem fut a „service geoserver start” paranccsal indítható.

o

GeoServer load title: Egy konkrét előre megadott csempe letöltése. Ellenőrzi, hogy a térképszerver megfelelően van-e konfigurálva, képes-e csempéket szolgáltatni.

o

Hiba esetén: Amennyiben ez a pont hibás, de maga a térképszerver elérhető, akkor rosszul van beállítva, esetleg nincs megadva térkép. A „ESZR erdészeti szakmairendszer telepítési dokumentáció” tartalmazza a térképszerver beállításait, ellenőrizzük, hogy megfelelő-e.

Alkalmazás szerver o

Ellenőrzni kell , hogy a JBoss példányok futnak-e futnak-e-e, és hogy elérhetőek-e az alkalmazások alkalmazás ellenőrzése http://ipaddress:8081/eszr megjelenik a login ablak 14 / 18

http://ipaddress:8181/eszr megjelenik a login ablak jboss server példány ellenőrzése: http://ipaddress:8081 alkalmazás server bejelentkező oldala jelenik meg http://ipaddress:8181 alkalmazás server bejelentkező oldala jelenik meg o

Hiba esetén: Amennyiben az ellenőrzési pont hibát mutat lehetséges, hogy nem fut az alkalmazás szerver. A következő paranccsal ellenőrizhető „service jboss-eles status”, ha nem fut a „service jboss-eles start” „service jboss-teszt status”, ha nem fut a „service jboss-teszt start” paranccsal indítható.

19.

o

Amennyiben a hiba továbbra is fenn áll ellenőrizzük a log fájlokat.

o

CPU usage: A szerver CPU használatáról ad információkat. Ezt a figyelési pontot csak információ jelleggel érdemes bekötni, riasztást nem kell definiálni rá, hiszen előfordulhat, hogy bizonyos ideig megnő a CPU terhelés.

o

JVM memory status: A java virtuális gép Heap memória használatát mutatja. Ezt a figyelési pontot csak információ jelleggel érdemes bekötni, riasztást nem kell definiálni rá, hiszen előfordulhat, hogy bizonyos ideig megnő a memória használat.

o

Ellenőrizni kell, hogy az adatbázis szerver elérhető-e, működése megfelelő. Ha az adatbázis szerver elérhető, de nem rég volt újraindítva elképzelhető, hogy az alkalmazás szerver még nem aktualizálta a connection-pool-t akkor érdemes újrainditani az alkalmazás szervert. Általánosságban elmondható, hogy minden olyan esetben, amikor le kell állítani az adatbázist, az újraindítást követően az alkalmazás szervereket is újra kell indítani (hiszen ilyenkor megpróbálja életben tartani a nyitott kapcsolatokat, de az adatbázis oldalon már nincs meg a kapcsolat párja).

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 logging.properties log4j.rootLogger=WARN, geoserverlogfile, stdout log4j.appender.stdout=org.apache.log4j.ConsoleAppender log4j.appender.stdout.layout=org.apache.log4j.PatternLayout log4j.appender.stdout.layout.ConversionPattern=%d{dd MMM HH:mm:ss} %p [%c{2}] - %m%n log4j.appender.geoserverlogfile=org.apache.log4j.RollingFileAppender # Keep three backup files. log4j.appender.geoserverlogfile.MaxBackupIndex=3 # Pattern to output: date priority [category] - message log4j.appender.geoserverlogfile.layout=org.apache.log4j.PatternLayout log4j.appender.geoserverlogfile.layout.ConversionPattern=%d %p [%c{2}] - %m%n log4j.category.log4j=FATAL log4j.category.org.geotools=WARN log4j.category.org.geotools.factory=WARN log4j.category.org.geoserver=INFO log4j.category.org.vfny.geoserver=INFO log4j.category.org.springframework=WARN log4j.category.org.geowebcache=INFO log4j.category.org.geowebcache.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:

Adatok, melyekkel a hiba keletkezett: Megjegyzés Tesztelést végezte* Név Szervezeti egység/beosztás

17 / 18

Ábrajegyzék 2. ábra

18 / 18