Kapcsolódó információk:
› Paraméterezési útmutatók
Korábbi változatok
...
A működéshez szükséges a QsBackup
telepítőcsomagon kívül:Fdb
Service.zip
- Java Runtime Environment - JRE 1.7
- Firebird SQL kliens
- 7zip konzol utility - Windows esetén a
<SupHome>\UTIL
könyvtárban található, Linux esetén csomagból javasolt telepíteni.
...
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 QsBackup
file tartalmazza. A működési paramétereket a Fdb
Service.jarQsBackup
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.Fdb
Service.ini
...
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, valamint a notifikációs e-mailek küldési paramétereit is!, valamint a notifikációs e-mailek küldési paramétereit is!
Panel | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
Kódblokk | ||||||
---|---|---|---|---|---|---|
| ||||||
; QsBackupFdbService Copyright QSoft Kft. 2013 ; -------------------------------------------- ; ; A file neve kötelezően: QsBackupFdbService.ini ; Ez a fájl tartalmazza a szolgáltatás indítási és működési paramétereit. ; ; A konfigurációs file két szekcióra van bontva: [Startup] és [Backup] ; A [Startup] szekció csak egyszer töltődik be, a alkalmazás/szolgáltatás indításánál. ; A [Startup] szekció kritikus fontosságú, tehát ha bármely paraméter hiányzik vagy hibás, fatális hiba keletkezik. ; ; A [Backup] szekció minden alkalommal betöltődik, a mentés indulása előtt (napi 1x). ; A [Backup] szekció ütemezést paraméterező kulcsait, az ütemezett napokat, illetve ütemezett időt ; a program folymatosan figyeli. ; A [Backup] konfiguráció is adhat hibákat, de ezek nem fogják leállítani a programot/szolgáltatást. ; Ez esetben a LOG fájlokat kell megvizsgálni, főleg startupnál, hogy megbizonyosodjunk abban ; hogy minden lényeges paraméter megfelelően lett megadva. ; ---------------------------------------------------------------------------------------------------------------- ; Az induláshoz szükséges paraméterek. Változtatás esetén a szolgáltatás újraindítása szükséges! [Startup] ; A SUP renszerindítási könyvtára. Itt található a SUP.INI és SERVERS.INI konfigurációs file. ; Pl.: ; Windows op. rendszer: C:\Qsoft\SUP\SysData ; Linux op. rendszer: /usr/local/qsoft/SysData SysIniPath=C:\QSoft\SUP\SysData ; A szolgáltatás képes egy egyszerű http alapú webszolgáltatást biztosítani html formátumban futás közben. ; Itt lehet megadni a portot, amin elérhető/hosztolható a webszolgáltatás. ; -1 esetén ki van kapcsolva, javasolt az 1024 fölötti portok használata. ; Ha be van kapcsolva, weben keresztül monitorozható az alkalmazás. Pl.: supserver:8080 ; A portot a tüzfalon engedélyezni kell! ; A SUP rendszerben javasolt bekapcsolni a szolgáltatás muködésének figyelését, a ; "Szerviz | Technikai funkciók | Rendszerinformációk" menüpontban, ahol a [Mentés paraméterei] adatlapon ; be kell állítani a QsBackupFdbService szolgáltatás elérhetoséget. ; A SUP kliens rendszeresen ellenorzi a szolgáltatás állapotát, és hibát jelez, ha a szolgáltatás leállt. ; DEFAULT = 8080 ;WebservicePort=8080 ; A szolgáltatás kihagyja-e az első napot indításnál, vagy ne ; DEFAULT = False ;ServiceSkipFirstDay=False ; Az INI file ütemezési bejegyséseinek vizsgálati gyakorisága (milliseconds) ; Ennyit vár a szolgáltatás 2 vizsgálat között. ; Alap példa: A szolgáltatás megvizsgálja az .INI fájlt 30 percente, hátha változott az ütemezett ; napok vagy idő értéke, ; ha igen, frissíti a saját értékeit. Ez lehetové teszi hogy a szolgáltatást kézzel napi több ; alkalommal is lehet futtatni. ; DEFAULT = 30 * 60 * 1000 = 1800000 (30 minutes) ; A teszteléshez célszerű ennél gyakoribb beállítást használni. Pl.: 5000 (5 sec) ;ServiceInitimeCheckInterval=5000 ; A gyakoriság amivel a szolgáltatás az időpontot vizsgálja (elértük-e már az ütemezett idot) (milliseconds) ; DEFAULT = 5 * 1000 = 5000 (5 seconds) ;ServiceScheduledCheckInterval=5000 ; Az időmennyiség, amennyivel a szolgáltatás késésben lehet az ütemezett backup elvégzésével (seconds) - avagy ha ennyit vagy kevesebbet késik, még lefuthat aznap ; Ha ez az érték -1, a szolgáltatás végtelen idot késhet, mindenképpen le fog futni aznap ; Alap példa: A szolgáltatásnak 11:20-kor kellett volna elvégeznie az ütemezett backupot, de egyéb hatások miatt ; (rendszer fennakadás, alacsony prioritás, stb..) késobb vizsgálja az ütemezett idopontot, pl. 11:23-kor, ettol függetlenül ; a szolgáltatás még elvégezheti a backupot, mivel 5 perc késésen belül van ; DEFAULT = 60 * 60 = 3600 (60 minutes) ;ServiceScheduledCheckMaxlate=300 ; ---------------------------------------------------------------------------------------------------------------- ; Adatbázis mentés paraméterei [Backup] ; Ütemezés paraméterei ; Mely napokon mentse az aktív állapotú cégeket. ; Formátum: MON, TUE, WED, THU, FRI, SAT, SUN ScheduledWeekDaysAct=MON, TUE, WED, THU, FRI ; Mely napokon mentse az archív állapotú cégeket. ScheduledWeekDaysArc=SAT ; Futtatás időpontja. Pl.: 22:00 ( http://en.wikipedia.org/wiki/ISO_8601 ) ; Időzítés nélküli futtatásra nincs lehetőség. ScheduledTime=23:00:00 ; A szükséges utility és path beállítások ; A tömörített mentések helye. Ide készülnek a mentések. ; A mentéseket erősen ajánlott NEM ugyanarra a lemezre készíteni, ; mint ahol a mentendő adatbázis file-ok (FDB) vannak! ; Pl. ; Windows op. rendszer: C:\Qsoft\Mentes ; Linux op. rendszer: /usr/local/qsoft/mentes BackupPath=C:\QSoft\Mentes ; A Firebird SQL GBAK utility elérhetösége. ; Pl. ; Windows op. rendszer: C:\Program Files\Firebird25\BIN\GBAK.exe ; Linux op. rendszer: /usr/bin/gbak GbakExe=C:\Program Files\Firebird25\bin\gbak.exe ; A tömörítéshez szükséges 7ZIP archiver elérhetősége. ; Pl. ; Windows op. rendszer: C:\Qsoft\SUP\UTIL\7ZA.EXE ; Linux op. rendszer: /usr/lib/p7zip/7zr ArchiverExe=C:\QSoft\SUP\UTIL\7ZA.EXE ; Notifikációs paraméterek ; Adminisztrátor e-mail címe. Ide kerül elküldésre minden esemény, ; és a futási LOG. Minden futási napon egy darab e-mail. ; Vesszővel felsorolva több cím is megadható. EmailToAdmin=admin@sajatdomain.hu ; Csak abban az esteben küld e-mailt, és a LOG-ot, ha a futás során ; hiba keletkezik. ; Vesszővel felsorolva több cím is megadható. EmailToError=admin@sajatdomain.hu ; Levelező szerver adatai az értesítok küldéséhez. ; SmtpHost: Üres HOST esetén nem küld értesítést ; SmptPort: default: 25, secure: 465, gmail: 587 ; SmtpUser, SmtpPwd üres esetén [none], vagyis nincs autentikáció ; SmtpAuth: none, starttls, tls, ssl SMTPHost=smtp.sajatdomain.hu SMTPPort=25 SMTPUser= SMTPPwd= SMTPAuth=none |
...
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.
Nagy adatbázis, vagy sok könyvelt cég mentése során hasznos lehet a ScheduledWeekDaysAct
kulcsra beírható 'TEST' kulcsszó, mely az ütemezésbe csak a Sysdata adatbázist veszi bele, és hamar eljut a notifikációs levél küldéséhez.
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ő.
...