DataLab Migrator
Datalab Migrator
Navodila za migracijo na PANTHEON 5.5
Migracija je postopek nadgradnje, ki se od postopka običajne nadgradnje razlikuje v tem, da spremeni strukturo podatkovne baze, prevede oblike izpisov v drugačni zapis in uredi referenčno integriteto.Migracija ne migrira v celoti SQL-I postopkov, zato je potrebno le te ročno prepisati na ARES (modul za razvoj in uporabo lastnih podprogramov).Migracija se ne izvaja diretktno v programu PANTHEON 5.0, temveč je za to potreben samostojni program dlMigration55.
1. PREDPRIPRAVA
1.1. VARNOSTNA KOPIJA (BACKUP)
Pred izvajanjem migracije obvezno izdelajte varnostne kopije vseh podatkovnih baz.
Navodila za izdelavo varnostnih kopij so priloga dokumenta, priporočena načina sta izdelava varnostne kopije:
- iz Administratorske konzole programa v panelu PODATKOVNA BAZA – VARNOSTNA KOPIJA
- Priloga 1: PA_Backup_ADKonzola.doc
- Priloga 2: PA_Backup_ADKonzola_Kratka.doc
- s programskim orodjem ISQLW direktno na strežniku MS SQL \ MSDE
- Priloga 3: PA_Backup_ISQLW.doc
1.2. EVIDENCA PODATKOVNIH BAZ – PODJETIJ
Preglejte seznam vseh podatkovnih baz oz. podjetij. Podatkovne baze, ki jih ne uporabljate, izbrišite.
1.3. SQLI-I POSTOPKI
Migrator v celoti ne migrira SQL-I postopkov v ARES. Če uporabljate SQL-I postopke, se pred migracijo posvetujete z vašim podpornikom.
1.4. IZVAJANJE MIGRACIJE
Priporočeno je, da se migracija izvaja na strežniku ali delovni postaji, na katerem je nameščen podatkovni strežnik MS SQL/MSDE in aktivne podatkovne baze.
1.5. NADGRADNJA PANTHEON 5.0
PANTHEON 5.0 pred migracijo obvezno nadgradite po standardnem postopku na zadnjo razpložljivo verzijo (build).
V primeru t.i. »ročne« nadgradnje potrebujete:
- strukture za nadgradnjo podatkovnih baz ftp://ftp.datalab.si/upgrade/si/release/STR_SI_FULL_21xx.zip
- programsko datoteko ftp://ftp.datalab.si/upgrade/si/release/dlPantheon_SI_SI_21xx.zip
kjer x pomeni zadnjo najvišjo številčno oznako builda.
1.6. PRIPRAVA MAPE
Na računalniku ali strežniku, na katerem se bo migracija izvajala, pripravite (kreirajte) novo mapo, iz katerega se bo migracija izvajala.
Uporabniki morajo imeti določene polne pravice za dostop do te mape (branje, pisanje, brisanje).
Priporočeno je, da se v mapi, kjer je nameščen PANTHEON, kreira nova podmapa z imenom »Migracija55«.
Primer:
Pantheon je namščen v mapi c:\datalab, za migracijo je kreirana podmapa c:\datalab\migracija55

1.7. PREVZEM PROGRAMA ZA MIGRACIJO
Postopek migracije se izvaja s programom »dlMigration55«, ki je uporabnikom na voljo na Datalabovem FTP strežniku na naslovu: ftp://ftp.datalab.si/Programi/DL-utils/dlMigration55.zip
Za prevzem programa kopirajte zgornjo povezavo, prilepite jo v naslovno vrstico brskalnika in pritisnite enter.

V pogovornem oknu izberite ukaz Shrani in datoteko shranite v mapo, iz katere se bo migracija izvajala (točka 1.4).

Program namestite (odkomprimirajte oz. odzipajte) v direktorij »c:\datalab\migracija« ki ste ga kreirali po navodilih v točki 1.4

Datoteko odkomprimirajte z desnik klikom na datoteko »dlMigration55« in iz menija izberite ukaz »Extract All...«

Določite mapo, kamor se program odkomprimira.

Za dokončanje postopka kliknite na gumb Dokončaj.

Po končanem postopku se v mapi namesti program za migracijo.
2. MIGRACIJA
2.1. ZAŽENITE PROGRAM »DLMIGRATION55.EXE«

Vpišite uporabniško ime in pripadajoče geslo, s katerim se prijavljate v PANTHEON 5.0.
Uporabnik mora imeti polne pravice, migracije ne izvajajte z uporabnikom z omejenimi pravicami v PANTHEON-u.
V seznamu Podjetje izberite podjetje oz. podatkovno bazo, ki jželite migrirati. Če migrirate več podatkovnih baz, ni pomembno katero podatkovno bazo izberete.
Program v polju Strežnik prikaže ime podatkovnega strežnika in v polju Podatkovna baza naziv podatkovne baze, ki je izbrana.
Za nadaljevanje postopka migracije kliknite na gumb »Nadaljuj«.
2.2. NADGRADNJA PODATKOVNE BAZE

- Poti – Novosti: vpišite pod do mape, iz katere so bo migracija vršila, mapo lahko tudi izberete iz seznama (s klikom v polje se na koncu prikaže gumb za izbiro mape).
- Poti – varnostna kopija: določite ali pustite privzeto določeno mapo, kamor naj migrator shrani varnostno kopijo pod. baz.
- Poti - Program: določite pot do mape, kjer je nameščen PANTHEON.
2.2.1. Izbor nastavitev migracije
Nastavitev
|
Opis
|
Varnostna kopija
|
Če je nastavitev izbrana se izdelajo varnostne kopije podatkovnih baz. Če so bile varnostne kopije že kreirane predhodno (točka 1.1), lahko to nastavitev odznačite.
|
Kopija podatkovne baze
|
V primeru izbranega parametra se za vsako podatkovno bazo, ki se bo migrirala samodejno ustvari kopija podatkovne baze. Obvezno v tem primeru določite pripono nove podatkovne baze (glej spodaj).
Migrira se kopija podatkovnih baz, obstoječe pod. baze se ne migrirajo in so po migraciji še vedno na verzijo 5.0
Če se parameter označi preverite, ali imate dovolj prostora na diskovnem pogonu, kjer so aktivne podatkovne baze, ker se količina podatkov za baze podvoji !
|
Pripona nove (P55) podatkovne baze (sufix)
|
Če se migrirajo kopije pod. baz (glej zgoraj), obvezno določite pripono, ki naj pomensko loči nazive podatkovnih baz. Pripona se doda na konec obstoječega imena pod. baze.
Primer: obstoječe ime pod. baze »SigmaSistemi«, novo ime pod. baze »SigmaSistemiP55«, ker je bila določena pripona »P55«
Pri izbiri pripone določite pomensko kratko ime brez presledkov, šumnikov in posebnih znakov.
|
Prenos novosti iz strežnika
|
Nastavitev mora biti obvezno izbrana, v naspronem primeru se migracija ne izvede uspešno.
Parameter je uporaben v primeru, če ročno prenesemo datoteke potrebne za nadgradnjo iz Datalab FTP strežnika v postopku napredne migracije.
|
Avtomatsko napolni null vrednosti
|
Parameter naj bo označen.
|
Avtomatsko uredi referenčno integriteto
|
Parameter naj bo označen.
|
Kontrola podatkov med staro in novo bazo
|
Parameter naj bo označen. Podrobneje je parameter opisan v poglavju 5.
|
Nadgradnja programov
|
Če je nastavitev izbrana migrator po končani migraciji podatkovnih baz samodejno nadgradi (zamenja) programske datoteke. Iz mape iz katere se izvaja migracije prekopira datoteko »Pantheon55_SQL.exe« v mapo, kjer je nameščen program.
|
Nadgradjujem na verzijo (redna - beta)
|
Obvezno izberite Redna verzija.
|
Podatkovne baze na strežniku
|
V seznamu podatkovnih baz označite podatkovne baze, ki jih želite migrirati. Priporočeno so označene vse podatkovne baze.
|
Postopek migracije zaženite s klikom na gumb Migracija.
2.2.2. Izvajanje migracije
V statusnem oknu na desni strani programa se bo izpisovala aktivnost migratorja in aktivnosti vezi popravila refernečne integritete. Migracija časovno trajala cca. 1 uro / 1 GB podatkov, odvisno od zmogljivosti strojne opreme.
Migrator bo v direktorij iz katerega se vrši nadgradnja samodejno prenesel:
Migracija podatkovnih baz je končana ko se v statusnem oknu izpiše sporočilo:
Konec: Nadgradnja podatkovne baze (1)
Konec: Nadgradnja uspešna
Napake in sporočila prikazane v statusnem oknu se shranijo v mapo iz katere se vrši migracija z imenom »NadgradiBaze_časovna_oznaka_nastanka.log«
3. ZAGON PANTHEON 5.5
3.1. STREŽNIK
Po končani migraciji podatkovne baze v mapi, iz katere se je vršila migracija odkomprimirajte datoteko »dlPantheon_SQL_SI_SI_55xxxx.7z« in jo kopirajte v mapo, v kateri je nameščen PANTHEON.

Prikaz komprimirane programske datoteke »dlPantheon_SQL_SI_SI_55xxxx.7z«, ki jo odkomprimirajte v isto mapo.

Prikaz odkomprimirane programske datoteke »Pantheon55_SQL.exe«, ki jo kopirajte v mapo, kjer je nameščen program Pantheon™.

Kreiranje bljižnjice za PANTHEON 5.5 na namizje.

3.2. DELOVNE POSTAJE
Za delovanje PANTHEON-a 5.5 na delovnih postajah je potrebno programsko datoteko »Pantheon55_SQL.exe« iz mape na strežniku (iz katere se je vršila migracija) preko omrežja prekopirati v mapo, kjer je nameščen PANTHEON. Do te datoteke se kreira bljižnjica na namizje za hitrejši zagon programa.
Za odkomprimiranje potrebujete program 7zip, ki ga lahko pridobite na spletni strani http://www.7zip.com
3.3. ZAGON PROGRAMA
Ob prvem zagonu programa osvežite seznam podjetij s klikom na gumb »Osveži«. Program bo prikazal migrirane podatkovne baze za verzijo PA55, nemnigrirane podatkovne baze verzije PA50 v seznamu niso prikazane.

4. PRIMER LOGA NADGRADNJE

Log nadgradnje je sestavljen iz vsebinsko ločenih delov, ki se izpisujejo enako, kot migrator izvaja migracijo podatkovnih baz po posameznih fazah. Log nadgradnje si lahko ogledate po končani migraciji v oknu »Pregled loga nadgradnje«. Log se samodejno shrani po končani migraciji v mapo, iz katere se je migracija izvajala oz. v mapo, ki je določena kot mapa za novosti.
Ime datoteke loga je sestavljeno iz imena »NadgradiBaze«, podčrtaja in časovne oznake nastanka loga (leto, mesec, dan, ura v formatu LLLLMMDDUUMMSS).
Primer: NadgradiBaze_20081022081859.log
1. Faze migracije:
- Začetek nadgrajevanja (faza 1)
- Priprava podatkov (B-pred nadgradnjo)
- Priprava podatkov (A-po nadgradnji samo build 500000)
- Priprava podatkov (B-pred nadgradnjo)
- Priprava podatkov (A-po nadgradnji)
- Priprava podatkov (R-popravilo reportov)
- Priprava podatkov (R-konverzija reportov)
- Napake pri primerjavi podatkov med P50 in P55 !
- Polnjenje manjkajočih zapisov (RI).
- Kontrola uporabnikov
- Konec nadgrajevanja (faza 2)
5. DODATNE INFORMACIJE