1. 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.

 Javaslat

Windows alapú adatbázis szerver esetén a letöltést, és az adatbázisok felújítását lehetőség szerint, célszerű közvetlenül a szerveren végezni.

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.

2. Á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.

 Javaslat

Az adatbázis főverzió minden cégnél A015 kell, hogy legyen. Emellett célszerű, ha az adatbázis patch verziószám is minden cégnél a legfrissebb - azaz A015 - P005

3. 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.

 Megjegyzés

Amennyiben Önnél be van üzemelve a QsBackupFdbService modul, ez a lépés elhagyható.

4. 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.

5. 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.

 Megjegyzés

A felújító CD-ROM letölthető CD-ISO formátumban van terjesztve. Kérjük jelezze a support@qsoft.hu címen, ha Ön hagyományos CD-t kér postán.

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.

6. 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.

 Javaslat

Az adatbázisok felújítását valamelyik gyorsabb kliens gépen, vagy ha van rá lehetőség közvetlen a szerveren célszerű futtatni. A felújítás az archív állapotú cégeket is kell, hogy érintse.
A felújítás elkezdése előtt meg kell győződni arról, hogy van-e elegendő szabad lemezterület.

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ó.

 Figyelem

Többszörös licence telepítése esetén (több SysData könyvtár) a felújítás első ütemét mindegyik licencre külön-külön végre kell hajtani. Ezt úgy történhet a legegyszerűbben, hogy a DbVer.exe nevű programot be kell másolni a szerverre, a <SUPHome>\BIN könyvtárba. Ezután létre kell hozni egy-egy parancsikont, ahol az 'Indítás helye'-ként a megfelelő SysDataCegXX könyvtárat kell megadni.

7. Adatbázis szerver csere

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

 Megjegyzés

A Firebird SQL egy igen széles körben használt adatbázismotor, amit több szoftver gyártó is használ. Normál telepítési mód esetén egy szerveren csak egyféle verzió üzemelhet. Abban az esetben, ha Önnél más szoftver is használ Firebird SQL-t, de más verzió szükséges, a frissítés előtt kérjük konzultáljon az adott szoftver gyártójával és a QSoft-tal.

• 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.

8. 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.

 Megjegyzés

Alapértelmezés szerint a Firebird SQL 3.0 átállással egyidőben a QSoft távmanagelő szoftver is frissítésre kerül. Egyes víruskereső programok (pl.: Avast) ezt a műveletet meg tudják akadályozni.
Ha a QSoft távmanagelő szoftver automatikus telepítése során hiba történne, futtassa a <CD-Meghajtó>\SUP_Setup\Tavman3_Setup.exe alkalmazást.

9. 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.

 Javaslat

Az adatbázisok felújítását lehetőség szerint közvetlenül a szerver gépen, vagy valamelyik gyorsabb kliens gépen célszerű futtatni. A felújítás az archív állapotú cégeket is kell, hogy érintse.

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.

 Figyelem

Ez a lépés csak az adatbázis szerver és a kliensek cseréje után hajtható végre! Az adatbázisok visszatöltése rendkívül időigényes. Az adatbázis mentés időtartamának kb. a 3-4-szerese.

 Megjegyzés

Az adatbázis szerver migráció, ill. az A015-ről A016-ra való felújítás az adatbázis tárolási formátum konvertálásával jár, mely során megváltoznak a cégadatbázisok, és a rendszeradatbázis nevek is. Az eddigi FB2_Cegnev.fdb adatbázis file elnevezése FB3_Cegnev.fdb-re változik.
Példa: a QSoft Kft. SUP^® adatbázisának a neve a felújítás során a következőképpen módosul:
   FB2_QSoft.fdb   -->  FB3_QSoft.fdb-re változik.

 Figyelem

Az adatbázis migráció az eredeti (FB2_*.fdb) file-okat nem törli, ezeket később archiválni kell.
Emiatt a felújítás elkezdése előtt meg kell győződni arról, hogy van-e elegendő szabad lemezterület a gépen.

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ó.

 Megjegyzés

Az adatbázis felújítás második üteme sok cég esetén több menetben is elvégezhető, de a felújítás időtartama alatt a rendszer nem használható.

10. 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.

11. 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.

12. 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.

 Javaslat

A régi Firebird SQL 2.5 tárolási formátumú adatbázisok végleges törlése előtt legalább fél évet célszerű várni.

 Figyelem

Hálózatos környezetben erősen ajánlott az adatbázis file-okat olyan helyen tárolni, amit a felhasználók SMB megosztásként nem érhetnek el. Amennyiben ez most nem így lenne, a verzió váltás jó lehetőség ennek a potenciális problémának a megoldására. Az adatbázis file-ok helyét a SERVERS.INI-ben kell beállítani.

13. 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.

 Figyelem

Ha Önnél külső fejlesztésű szoftverek is vannak, melyek a SUP^® rendszer adatbázisát használják, a felújítás előtt konzultáljanak a fejlesztővel.

• 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.

   Figyelem
  

  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.

   Figyelem
  

  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 
  

   Megjegyzés
  

  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.

   Figyelem
  

  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.

   Figyelem
  

  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 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.

   Figyelem
  

  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.