A felújítás sikeréhez szükséges, hogy kövesse pontosan, lépésről-lépésre a leírt műveleteket.

Rögzítés
download download

Felújító CD letöltése

Az A016 verzióhoz, a szokásos módon telepítő CD-t adunk. A CD tartalmazza a Firebird SQL 3.0 átálláshoz szükséges eszközöket.

A korábbi évektől eltérően a CD-t csak azoknak küldjük el postán, akik ezt külön kérik.

A CD-ISO letölthető a következő helyről: http://dl.sup.hu/a016
A letöltéshez, a telepítéskor átadott adatlapon található, SUP licencet azonosító, partnerkód - licencekód páros megadása szükséges.
Ez lekérdezhető a SUP^® számviteli modulban a Szerviz | Névjegy menüpontban. A partnerkód ki van írva, erre duplán kattintva a licence azonosító adatok a vágólapra másolódnak.

A CD-ISO sikeres letöltése után a következő lépések egyikét kell végrehajtani:

• Windows 10 operációs rendszert használva a letöltött SUP_Kovetes_A016.ISO file-t megnyitva, az automatikusan felcsatolódik, és a következő szabad meghajtó betűjelén azonnal használható.
  Amennyiben nem így történne, az ISO file-hoz a Windows Intéző nevű alkalmazást kell társítani.
  
  
• A letöltött SUP_Kovetes_A016.ISO file alapján írni kell egy CD-ROM-ot, és azt lehet használni.
  
  
• Windows 7 operációs rendszer esetén szükséges egy segédprogram, ami a CD-ISO-t felcsatolja CD meghajtóvá. Ilyen pl.: a WinCDEmu, nevű eszköz.

Rögzítés
prepare prepare

Általános előkészületek

Lépjen be a SUP^® rendszerbe olyan ügyintézővel, aki minden jogosultsággal rendelkezik. Nyissa meg a Szerviz | Könyvelt cégek menüpontot.
Az [F10-Listázás] funkciót indítva, kérje le az adatbázis verzió adatokat is tartalmazó nyomtatási képet. Fontos, hogy az [x]Archív állapotú cégek is jelenjenek meg.

A cégek listáját ki kell értékelni. Nem lehet benne olyan cég, ahol a cég adatbázisa nem érhető el, az adatbázis főverzió nem A015, vagy valamely korábbi felújítás során hibás maradt.

Rögzítés
backup backup

Adatbázis mentés

A felújító CD használata előtt célszerű a szokásos módon - a Szerviz | Adatbázisok mentése menüpont segítségével - menteni az összes cég adatbázisát. Az archív állapotú cégek adatbázisait is menteni kell.

A mentés időtartama előzetes információt adhat a teljes felújítási procedúra várható időtartamára vonatkozóan. Ez tulajdonképpen egy normál biztonsági mentés, amit egyébként is célszerű naponta végezni.

Rögzítés
spec spec

Munkavégzés leállítása

A felújítás időtartama alatt a SUP^® rendszer moduljai nem használhatók.

Le kell állítani az állandóan, vagy szolgáltatásként futó modulokat is (QsBackupFdbService, DbConnector, Excel függvénycsomag, SUP webes lekérdező modulok)

Ha más fejlesztők által készített alkalmazás is csatlakozik az adatbázishoz (Pl.: ODBC kapcsolaton keresztül) azt is le kell állítani a felújítás időtartamára.

Rögzítés
autorun autorun

Követés CD indítása

Az első lépésben letöltött és a Sajátgép (vagy Ez a gép) alkalmazásban valamilyen meghajtó betűjelen már elérhető felújító CD alapesetben automatikusan elindul.
Ha ez mégsem történne meg, futtassa a lemezegység főkönyvtárában található pl: E:\AutoRun.exe alkalmazást.

Ezek után elindul a felújító keretprogram kezelőfelülete. A felújító keretprogram lépésről lépésre végigvezet a folyamaton.

Rögzítés
backup backup

Felújítás, első ütem - adatbázisok mentése

A Firebird SQL 3.0 verzióra váltáshoz a korábbi tárolási formátum migrációját fogja elvégezni. Ez a gyakorlatban az összes adatbázis mentését, és visszatöltését (az új formátumban) jelenti. Sajnos ezt csak több ütemben lehet kivitelezni: mentés -> szerver-csere -> visszatöltés.

Először a régi formátumban tárolt adatbázisokat le kell menteni. Ehhez válassza az „Adatbázisok mentése” funkciót. A felújító keretprogram telepíti a korábbi verzióváltásoknál használt DbVer program új verzióját, és el is indítja azt.

A tényleges felújítást végző felújító (DbVer) program automatikusan érzékeli, hogy első ütemként el kell végezni az összes adatbázis mentését. Ennek időtartama várhatóan már megbecsülhető a SUP^® rendszeren belül, a Szerviz | Adatbázisok mentése - visszatöltése menüpontban végzett művelet alapján.
A munkakönyvtárként a szerver oldali könyvtárszerkezeten belül a SysData\TempFb25To30 könyvtár lesz használva.
A felújításról naplófile készül DbVer*.log néven. Ha a felújítás során hiba történt, annak leírása a naplófile-ban található.

Rögzítés
fbserver fbserver

Adatbázis szerver csere

Kérjük az alábbi esetek szerint járjon el.

• Egyedülálló számítógép: a felújító keretprogramban válassza a „Firebird SQL verzió csere” funkciót. Ez automatikusan lecseréli az adatbázismotort. 
  
  
• Több gépes környezet Windows szerverrel: a felújító keretprogramot  a szerver gépen kell futtatni. Válassza a „Firebird SQL verzió csere” funkciót. Ez automatikusan lecseréli az adatbázismotort.
  A funkció a <CD-Meghajtó>\SUP_Setup\FB30_QSoft_Setup.exe-t indítja. A telepítő a megadott könyvtárból természetesen közvetlenül is indítható. Az FB30_QSoft_Setup.exe egy szokásos Windows varázsló rendszerű telepítő, mely felismeri a gépen található adatbázismotor verzióját, és amennyiben ezt szükségesnek tartja, lecseréli FireBird SQL 3.0 verzióra.
  
  
• Több gépes környezet Linux szerverrel: a Firebird SQL 3.0 verziójú adatbáziskezelőt a Linux csomagkezelőből egyszerűen lehet telepíteni. A telepítés során kötelezően használandó jelszó: „masterkey”. A telepítéssel kapcsolatos további részletek az on-line dokumentációban.
  A sikeres telepítés után be kell másolni a szerverre a <CD-Meghajtó>\SUP_Kiegeszitok\firebird-qsoft.conf file-t a Linux szerver megfelelő könyvtárába és a firebird.conf-ban ezt include-olni kell. A QSoft-os konfig beillesztése után újra kell indítani a szolgáltatást.
  
  
• USB eszközre telepített - hordozható SUP^_® példány: az USB meghajtóra telepített példányok telepítését a QSoft végzi. Kérjük küldje be a Firebird SQL 2.5 alatt futó eszköz tartalmát, és elvégezzük a felújítást.

Rögzítés
fbclient fbclient

Adatbázis kliens csere

A Firebird SQL kliens csere műveletet minden SUP^® rendszert futtató kliens gépen végre kell hajtani. Ebben a felújító keretprogram nem ad segítséget.

Legegyszerűbben úgy lehet elvégezni, hogy a <CD-Meghajtó>\SUP_Setup\FB30_QSoft_Setup.exe alkalmazást be kell másolni a szerver oldali könyvtárszerkezetben pl.: a <SupHome>\Install.dsk könyvtárba, és minden kliens gépen onnan futtatni.
Az FB30_QSoft_Setup.exe egy szokásos Windows varázsló rendszerű telepítő, mely felismeri a gépen található adatbázis kliens verzióját, és amennyiben ezt szükségesnek tartja, lecseréli FireBird SQL 3.0 verzióra.

Rögzítés
dbver dbver

Felújítás, második ütem - visszatöltés, felújítás A016-ra

Következő lépésként a felújító keretprogramban válassza az „Adatbázisok visszatöltése” funkciót.

A felújító (DbVer) automatikusan érzékeli, hogy második ütemként a korábban lementett adatbázisokat vissza kell tölteni a Firebird SQL 3.0 új tárolási formátumában, ezután történik a verzió váltás.

Az adatbázis felújítás a biztonsági mentések következtében, valamint az új formátumú adatbázisok SUP^® rendszerbe való visszatöltése miatt hosszú ideig tart. Előzetes számítások alapján egy átlagos cég normál adatbázismentéséhez képest 3-4 szeres felújítási idővel lehet számolni.
A felújításról naplófile készül DbVer*.log néven. Ha a felújítás során hiba történt, annak leírása a naplófile-ban található.

Rögzítés
supkov supkov

SUP^® rendszerkövetés telepítése

A sikeres verzió váltás után a keretprogramban válassza a „SUP rendszerkövetés telepítése” funkciót. Ez a szokásos módon telepíti az új verziót.
Elegendő egy gépen alkalmazni, hálózatos telepítés esetén a szerver gépre kell irányítani.
A SUP^® követés verzió letölthető a szokásos módon az internetről is.

A felújítás, telepítés végrehajtása után a rendszer ismét üzemkész, a szokásos módon elindítható. A program technikai adatai a Szerviz | Névjegy menüpontban kérdezhetők le.
A FireBird SQL adatbázismotorral kapcsolatos technikai információk a Szerviz | Technikai funkciók | Rendszerinformációk menüpontban találhatók.

Rögzítés
chk chk

Ellenőrzés

A teljeskörő migráció után, a 2. lépésben leírt módon lehet legegyszerűbben ellenőrizni, hogy a migráció után minden cég adatbázis elérhető-e.
Azaz, lépjen be a SUP^® rendszerbe olyan ügyintézővel, aki minden jogosultsággal rendelkezik. Nyissa meg a Szerviz | Könyvelt cégek menüpontot.
Az [F10-Listázás] funkciót indítva, kérje le az adatbázis verzió adatokat is tartalmazó nyomtatási képet. Fontos, hogy az [x]Archív állapotú cégek is jelenjenek meg.

Minden cégnek A016-P000 verzión kell állnia.

Rögzítés
delete delete

Régi adatbázisok eltávolítása

A migráció befejező művelete, az átállás során használt munka file-ok, és a régi adatbázisok eltávolítása, archiválása.

• Munka file-ok. A migráció során használt munka file-ok a <SupHome>\SysData\Temp_FB25To30 könyvtárban keletkeznek. A migráció sikeres befejezése után már nem szükségesek. Tetszőleges eszközzel eltávolíthatók, azonban néhány hónapig archív formában célszerű még megtartani.
  A <SupHome>\SysData\7zip-Temp_FB25To30.cmd segítségével egyszerűen ZIP archívumba lehet mozgatni őket.

• Régi adatbázisok. A régi Firebird SQL 2.5 tárolási formátumú adatbázisok a migráció során nem törlődnek, azonban a továbbiakban már nincs rájuk szükség. A régi (Firebird SQL 2.5) adatbázisok nevei az FB2_ előtaggal kezdődnek.
   - Windows adatbázis szerver esetén a <SupHome>\SysData\7zip-DB-FB25.cmd segítségével egyszerűen ZIP archívumba lehet mozgatni őket.
   - Linux adatbázis szerver esetén a Windows alatt futtatható parancsfile-ben végzett művelethez hasonló módon lehet archívumba mozgatni őket.

Rögzítés
other other

Egyéb modulok és beállítások

A SUP^® rendszer automatikusan frissülő moduljai mellett, az egyéb modulokat is frissíteni kell. Ilyen lehet az Excel függvénycsomag, a DbConnector vagy az esetleges külső fejlesztésű programokhoz használt ODBC driver.

• Tűzfal beállítások
  A Firebird SQL 3.0 használata esetén a régi tűzfal beállítások megfelelőek. A tűzfal beállításokról külön dokumentációs oldal is van. A Firebird SQL a működése során két TCP portot használ. Az egyiket az általános kommunikációra használja. Ennek default értéke: 3050.
  Az ú.n. notifikációs üzenetekhez alapesetben egy random TCP portot használ. Az új QSoft-os Firebird telepítőben (FB30_QSoft_Setup.exe) ez fixen 33050 -re van állítva.
  Ezért nem feltétlenül kell az alkalmazást beállítani a tűzfal szabályok között, elegendő a portok megadása.
  
  

• Excel függvénycsomag
  Az Excel függvénycsomag frissítése szükséges. Mivel az Excel minden gépre külön van telepítve, az Excel függvénycsomagot is minden gépen külön szükséges frissíteni.

  Qsboxfigyelem
  Az Excel függvénycsomaghoz használt .NET provider sajnos jelenleg nem támogatja teljeskörűen a Firebird SQL 3.0 verzió által használt új kapcsolódási protokollt. Ezért az Excel függvénycsomag használata esetén a szerveren a firebird.conf file-ban a WireCrypt paramétert Enabled értékre kell állítani.

• QsBackupFdbService
  Az automatikus éjszakai mentést végző modul is felújításon esett át. Egyrészt tudja kezelni a Firebird SQL 3.0-val készült adatbázisokat. Emellett a Java szolgáltatást futtató ú.n. service wrappert is lecseréltük .NET-es verzióra. Ezért a továbbiakban a telepítés során nem kell figyelni a Java 32 / 64 bit környezet által okozott problémákra.
  A QsBackupFdbService modul frissítéséhez tekintse meg az erről szóló részletes dokumentációt.

  Qsboxfigyelem
  A Firebird SQL 3.0 más könyvtárba települ, ill. változott a könyvtár struktúra is. Ezért a QsBackupFdbService.ini konfigurációs file-ban a GbakExe= bejegyzést javítani kell. Pl.:    GbakExe=C:\Program Files\Firebird30\gbak.exe Azaz nem kell a <FirebirdHome>/BIN alkönyvtár hivatkozás.

• DbConnector  modul
  A DbConnector modul több részből áll. Az alkalmazásként futó változat telepítője: <CD-Meghajtó>\SUP_Setup\DBConnector_Setup.exe
  A Windows szolgáltatásként futó változat: <CD-Meghajtó>\SUP_Setup\DBConnectorSrv.7z 
  

  Qsboxmegjegyz
  A DbConnector modul esetenként nem a <SUPHome> könyvtárba van telepítve. Ebben az esetben elegendő a letöltött telepítőből felrakott <SUPHome>\BIN\aDBConnector.exe alkalmazást átmásolni a megfelelő helyre.

  Qsboxfigyelem
  A Firebird SQL átállás miatt az adatbázis file nevek is változtak. Ezért a aDBConnector.exe programmal azonos könyvtárban levő, aDBConnector.ini file ban át kell javítani az adatbázis file nevét is. Pl.:     SysDataGDB=[EgySzerver] - FB3__SysData.fdb

• SupExport modul
  A SupExport modult szintén külön kell frissíteni, és a működését biztosító .INI file-ban a SysDataGDB bejegyzésben az adatbázis file neve FB3_ előtaggal kell kezdődjön.
  Amennyiben az exportálás formátuma Firebird SQL, a készülő export file migrálásáról külön kell gondoskodni. Az újként készülő export file már Firebird SQL 3.0 formátumú, tehát a kapcsolódó feldolgozó szoftverekben is be kell avatkozni.
  
  
• Egyéb QSoft által fejlesztett külön futtatható modulok
  Van néhány a SUP^® rendszerből indítható, de külön frissítendő modul. Ilyen pl.: a Magyar Faktor Zrt. felé dolgozó kommunikációs modul. Ezek között van olyan is, amire nem vonatkozik a SUP^® rendszerhez kötődő karbantartási szerződés. Ezek esetében a frissített verzió térítés ellenében érhető el.
  
  

• Webes lekérdezések - OIL modul
  A modul frissítéshez a QSoft biztosítja az új telepítőt, ill. segítséget nyújt a modul frissítésében.

  Qsboxfigyelem
  A sikeres Firebird SQL 3.0 kapcsolódáshoz Java 8 JRE Update 152-nél újabb környezet szükséges.

• Egyéb QSoft által fejlesztett webes modulok
  A modul frissítéshez a QSoft biztosítja az új telepítőt, ill. segítséget nyújt a modul frissítésében.
  
  

• Más gyártók által készített modulok
  Több helyen üzemel olyan fejlesztés, amely a SUP^® rendszer által használt adatbázisokhoz közvetlenül kapcsolódik. Ez többféle eszközzel, többféle módon működhet. A verzióváltás elvégzése előtt feltétlenül kérje ki a modul fejlesztőjének véleményét, hogy az átállás zökkenőmentes legyen.
  Amire figyelni kell:
   - ODBC kapcsolódás. Amennyiben az adatbázis elérés ODBC kapcsolattal történt, a drivert driver-t valószínűleg frissíteni kell.
  
   - Adatbázis név előtagok. Bármilyen adatkapcsolat használata esetén az adatbázis file-név FB2_ előtagokat FB3_ előtagra kell módosítani.

  Qsboxfigyelem
  A külső fejlesztésű szoftverek adatbázis belépési adatait (felhasználó név, jelszó) a szerver migráció nem hozza át. A szükséges belépési azonosítókat a Firebird SQL 3.0 szerver telepítése után ismét létre kell hozni.

• Adatbázis shadow file-ok
  A nagyobb adatbiztonság érdekében néhány helyen ú.n. Firebird SQL adatbázis shadow (mirror) file van használva. A migráció, visszatöltés során a shadow file-ok nem épülnek vissza, ezeket a QSoft segítségével lehet ismét beüzemelni. A shadow file-ok a elnevezése megegyezik az FDB adatbázis file-ok megnevezésével, csak .SHD a kiterjesztésük.

Befejező lépésként az előkészületi tevékenység részeként leállított átparaméterezett szolgáltatásokat el lehet indítani, és ellenőrizni a megfelelő működésüket.