Kapcsolódó információk:
Paraméterezési útmutatók

Kapcsolódó témakör: Adatbázisok mentése - visszatöltése

Az adatbázisok automatikus mentését egy JAVA-ban fejlesztett alkalmazás biztosítja. A JAVA platform lehetővé teszi, hogy a szolgáltatás Windows és Linux környezetben is használható legyen. Az üzemeltetéshez JRE 1.7 futtatási környezet szükséges, mely Windows környezethez ingyenesen letölthető az Oracle weboldaláról.

Telepítés

A működéshez szükséges a QsBackupFdbService.zip telepítőcsomagon kívül.

  • Java Runtime Environment - JRE 1.7
  • Firebird SQL kliens
  • 7zip utility - Windows esetén a telepítő tartalmazza, Linux esetén csomagból javasolt telepíteni.
 Figyelem

A 64 bites Windows esetén előfordulhat, hogy a programot alkalmazásként futtatva tökéletesen működik, service-ként azonban nem települ. Ez esetben csak 32 bites JRE van telepítve a 64 bites Windows-on. Telepíteni kell a JRE 64 bites változatát.

 

A szolgáltatást arra a gépre célszerű telepíteni, ahol a SUP® rendszer elindulásához, és működéséhez szükséges SUP.INI file fizikailag található. Más szóval arra a gépre, ahol a <SupHome> könyvtár van. Ezen lehet Windows vagy Linux operációs rendszer. A telepítő készlet ZIP formátumban érhető el, melyet ki kell csomagolni a futtatási könyvtárba. A ZIP file lehetőség szerint NE legyen elhelyezve ugyanabban a könyvtárban, mint a futtatandó és a konfigurációs állomány.
A működtetéséhez szükséges file-okat a <SupHome>\LIB könyvtárba célszerű elhelyezni. Az alkalmazást a QsBackupFdbService.jar file tartalmazza. A működési paramétereket a QsBackupFdbService.ini file-ban kell beállítani. Emellett néhány további .BAT file is található a telepítő készletben, mely elsősorban a Windows környezetben történő működtetéshez ad segítséget.

A működéshez szükséges a Firebird SQL kliens, ill. ennek a GBAK utility modulja. A mentett file-ok tömörítéséhez szükséges 7ZIP program Windows verziója a telepítő készlet része, Linux alatt pedig a csomagkezelőből kell feltenni.

 Megjegyzés

A telepítéshez adminisztrátori jogosultság szükséges!

Paraméterek beállítása

A szolgáltatás működtetéséhez szükséges INI file a <SupHome>\LIB\QsBackupFdbService.ini néven található meg.  Az ebben levő paraméterek vezérlik a program működését. Az alapvető működési paramétereket az indulásakor olvassa fel, és a változásuk esetén a szolgáltatás újraindítása szükséges. A paraméterek másik csoportja minden egyes időzített futtatáskor újraolvasásra kerül, így ezek a szolgáltatás újraindítása nélkül megváltoztathatók. A működési paraméterek a telepítés során felmásolásra került QsBackupFdbService.ini file-ban vannak dokumentálva.

A legfontosabb indítási paraméter, a [Startup] szekció SysIniPath bejegyzése, mely a mentés indításához szükséges adatbázis kapcsolódást írja le.

 Figyelem

A SUP.INI file [SysData] szekciójban, a SysDataGDB kulcson csak regisztrált szerverneves hivatkozás használható! A régi natív hivatkozás használata esetén a program hibát jelez!

 

A [Backup] szekcióban kell beállítani a futáshoz szükséges GBAK és 7ZIP konzol utility elérhetőséget. Továbbá itt kell beállítani az ütemezést is.

Működés tesztelése alkalmazásként

A paraméterek beállítása után célszerű ellenőrizni a működést még alkalmazás módban, és csak a sikeres teszt után véglegesíteni service-ként. Mivel ez egy konzolalkalmazás, parancssorból a JAVA -jar QsBackupFdbService.jar parancs kiadásával lehet indítani. A futás során keletkező információkat a konzolra, ill. az aktuálisan futtatott JAR file alá létrehozott .\LOG könyvtárban létrehozott naplózó file-okba írja.

A tesztfutás során a [Backup] szekcióban  ScheduledTime beállítással kell időzítést beállítani a jelenlegi rendszeridőnél egy-két  perccel későbbre. Amikor az ütemezett időpont bekövetkezik, a konzolon, ill. a <SupHome>\LIB\LOG könyvtárban keletkező file-okban ellenőrizhető a futás eredménye.

A normál működés, ill. a futás során keletkezett hibák külön napló file-ba kerülnek. Ezek elküldése külön kérhető.

Szolgáltatás indítása - Windows környezet

Az alkalmazás módú sikeres tesztelés után kerül sor a Windows service-ként történő telepítésre. Ezt az srv_install.bat file indításával lehet kezdeményezni. A szolgáltatás telepítése előtt az srv_install.bat file tartalma esetenként szintén átszerkesztendő, az aktuális működési környezetre adaptálva. További információ a file kommentekben. A JAR file Windows szolgáltatásként történő indításához szükséges a telepítő csomag részeként megtalálható PRUNSRV.EXE.

 Figyelem

A telepítő nem indítja el a szolgáltatást. Ezt a SERVICES.MSC futtatásával, lehet kezdeményezni. A szolgáltatások listájában meg kell keresni a QsBackupFdbService bejegyzést, az indítás típusát át kell állítani automatikusra, és el kell indítani a szolgáltatást.

Szolgáltatás indítása - Linux környezet

Az alkalmazás módú sikeres tesztelés után kerül sor a Linux daemon-ként történő telepítésre.....  ???

Szolgáltatás működésének figyelése

A SUP® rendszerben a Szerviz | Technikai funkciók | Rendszerinformációk menüpontban, a Mentés paraméterei adatlapon be kell állítani a QsBackupFdbService szolgáltatás elérhetőséget. A SUP kliens rendszeresen ellenőrzi a szolgáltatás állapotát, és hibát jelez, ha leállt.

A szolgáltatás ellenőrzése nemcsak a SUP® rendszerben, hanem egy böngésző segítségével is ellenőrizhető. Egyszerűen be kell írni a címsorba a gép nevét/IP címét, és a QsBackupFdbService.ini -ben beállított port számot.
Pl.:
   http://supserver:8080

A megjelenő webes felületen megtekinthetők a futással kapcsolatos legfontosabb információk.

 Megjegyzés

Olyan formátumban kell beállítani az elérhetőséget, hogy a SUP klienst futtató gépről elérhető legyen. A beállítást célszerű ellenőrizni a [Teszt] nyomógombbal.