Aplikácia arcsynchro je samostatný program (súbor arcsynchro.exe sa nachádza v inštalačnom adresári v podadresári Bin alebo Bin64).
Slúži na:
- synchronizáciu redundantných archívov: zaplátanie diery v archívnej/trezorovej databáze, ktorá vznikla vypnutím jedného z procesov D2000 Archív (napr. [1]_SELF.ARC)
- migráciu archívnych/trezorových databáz medzi rôznymi databázami (Oracle, PostgreSQL, Sybase) a medzi rôznymi operačnými systémami
- kopírovanie dát z archívnych databáz do trezorových a naopak
Spúšťa sa ručne z príkazového riadku . Na alebo je spúšťané automaticky pri štarte procesom D2000 Archív na zaplátanie aktuálnej diery v archíve (viď parameter ArcsynchroAuto). Na spustenie potrebuje iba informácie o zdrojovej a cieľovej archívnej databáze, ktoré synchronizuje (do cieľovej databázy dopĺňa záznamy zo zdrojovej). Teda nie je potrebný bežiaci proces proces D2000 Server ani žiadny iný proces systému D2000, iba bežiace databázové servery. Od verzie systému D2000 v7.01.010 je podporované aj zapisovanie do trezorových databáz (Oracle aj Sybase).
Od verzie systému D2000 v7.01.016 je podporované čítanie z trezorových databáz Sybase, ktoré umožňuje migráciu archívov a trezorov na platformu Oracle.
Obsah
Obsah |
---|
Poznámka: na vytvorenie DSN vzdialenej archívnej databázy sa pre PostgreSQL dá použiť nástroj D2SMC. V kontextovom menu na položke konkrétneho archívu (štandardne SELF.ARC ) treba vybrať "Create PostgreSQL ODBC for redundant archive".
Následne je nutné zadať symbolický názov vzdialeného archívu a voliteľne názov alebo IP adresu vzdialeného servera. Ak sa nezadá, použije sa názov vzdialeného archívu zadaný v prvom riadku.
Obsah
Obsah |
---|
Deklarácia
Blok kódu | ||||
---|---|---|---|---|
| ||||
arcsynchro [voliteľné parametre] source target time_start time_end [id|+id|-id|mask] arcsynchro [voliteľné parametre] [/TD time_delta] /A source target [id|+id|-id|mask] arcsynchro [voliteľné parametre] [/TD time_delta] /AN source target arcsynchro [voliteľné parametre] [/TD time_delta] /AX source target [id|+id|-id|mask] arcsynchro [voliteľné parametre] /A+ source target [id|+id|mask] arcsynchro /CLD source target |
Parametre
/SU source_user | Meno užívateľa pre source (potrebné, ak je iné ako štandardné). Poznámka: ak je arcsynchro spúšťané procesom D2000 Archív (parameter ArcsynchroAuto), tak používané meno/heslo je prenášané automaticky. Pokiaľ je teda rovnaké meno/heslo pre source a target archívne databázy, nie je nutné parametre /SU, /SP, /TU a /TP používať. | ||||||||||||||||||||||||||||||||||||||||
/SP source_password | /SP source_password | Heslo užívateľa pre source (potrebné, ak je iné ako štandardné). Viď poznámku pri parametri /SU. | |||||||||||||||||||||||||||||||||||||||
/TU target_user | Meno užívateľa pre target (potrebné, ak je iné ako štandardné). Viď poznámku pri parametri /SU. | ||||||||||||||||||||||||||||||||||||||||
/TP target_password | Heslo užívateľa pre target (potrebné, ak je iné ako štandardné). Viď poznámku pri parametri /SU. | ||||||||||||||||||||||||||||||||||||||||
| TNS (ak je source Oracle databáza) alebo DSN (ak je source ľubovoľná databáza prístupná cez nakonfigurované ODBC) archívu, ktorý obsahuje platné archívne záznamy. | ||||||||||||||||||||||||||||||||||||||||
| TNS alebo DSN archívu, v ktorom chýbajú záznamy. | ||||||||||||||||||||||||||||||||||||||||
time_start | Začiatok časového intervalu, v ktorom sa dopĺňajú chýbajúce archívne záznamy. | ||||||||||||||||||||||||||||||||||||||||
time_end | Koniec časového intervalu, v ktorom sa dopĺňajú chýbajúce archívne záznamy. | ||||||||||||||||||||||||||||||||||||||||
| Identifikátor (číslo) archívneho objektu, ktorý sa bude synchronizovať. Ak je id=113, tak príslušná archívna tabuľka je DT0000113 (názvy spracúvaných archívnych tabuliek sú vypisované pri behu programu). | ||||||||||||||||||||||||||||||||||||||||
+id -id +id -id | Identifikátor (číslo) archívneho objektu, od ktorého (+id) resp. do ktorého (-id) resp. v akom intervale (+id -id) prebieha synchronizácia.
Ďalej sa dá tento parameter použiť po prerušení práce arcsynchro (napr. v dôsledku straty konektivity na databázový server) a pokračovať od konkrétneho archívneho objektu (keďže archívne objekty sú synchronizované v poradí podľa číselných identifikátorov). | ||||||||||||||||||||||||||||||||||||||||
mask | Maska pre názov archivovanej premennej. V maske je možné použiť špeciálne znaky (? *), čím je možné synchronizovať zvolené premenné. Maska nie je citlivá na veľké/malé písmená. Príklad: maske H11?E* vyhovujú premenné H11_Edo, H11re, h111Element. Nevyhovujú jej premenné H11abEdo, H11Edo, H12_edo | ||||||||||||||||||||||||||||||||||||||||
| Automatická synchronizácia archívov na základe informácií o dobách výpadkov archívu, ktoré sa nachádzajú v cieľovom archíve (tabuľka
Archív pri štarte vytvorí nový záznam v tabuľke ARC_HOLE a počas práce doň pravidelne zapisuje. Štruktúra tabuľky ARC_HOLE je nasledovná:
Pokiaľ sa synchronizuje archív aj trezor, spracované budú diery so Status=10.
| ||||||||||||||||||||||||||||||||||||||||
/AN | Rovnaký význam ako /A, ale neopravuje záplatami - skončí po výpise zoznamu dier, ktoré by boli synchronizované. Slúži na zistenie množstva a veľkosti dier, ktoré potrebujú synchronizáciu. | ||||||||||||||||||||||||||||||||||||||||
/AX | Rovnaký význam ako /A, ale Status v tabuľke ARC_HOLE po plátaní diery sa nezmení. Poznámka: Tento parameter sa dá použiť na synchronizáciu archívov s 3 alebo viacerými inštanciami. Na zaplátanie diery v databáze1 za použitia databázy2 a databázy3 je potrebné spustiť: arcsynchro /AX databáza2 databáza1 arcsynchro /NU /A databáza3 databáza1 Prvý riadok zapláta dieru v databáze1 dátami z databázy2, ale nechá dieru označenú ako nesynchronizovanú. Druhý riadok zapláta (iba vkladá údaje, neaktualizuje) dieru v databáze1 dátami z databáz3 a označí dieru ako zaplátanú. Zvyčajne stačí na plátanie diery jeden príkaz arcsynchro. Uvedený príklad dokáže zaplátať dieru, aj keď databáza2 a databáza3 obsahujú nekompletné dáta (t.j. archívy [2] a [3] mali tiež drobné výpadky počas dlhšie trvajúceho výpadku archívu [1]). | ||||||||||||||||||||||||||||||||||||||||
/A+ | Pre každý archivovaný objekt sa synchronizuje celá jeho časová hĺbka (podľa konfigurácie objektov) až do aktuálneho času. Parameter je použiteľný pri kopírovaní celého archívu do nového archívu. Štandardne sa dá nahradiť vhodne zvolenými time_start a time_end parametrami (time_start musí byť dostatočne ďaleko v minulosti, aby pokryl najväčšiu nakonfigurovanú časovú hĺbku), ale v prípade, že zdrojový archív má vypnuté mazanie hodnôt, by takýto prístup dosynchronizoval aj staré hodnoty. Poznámka: Konfigurácia je zisťovaná zo zdrojovej alebo cieľovej databázy (viď popis parametra /TAD). | ||||||||||||||||||||||||||||||||||||||||
/ATEanchor td/ATD | td | /TD time_delta/ATASynchronizujú sa archívne objekty so zapnutým archivovaním (/ATE, prednastavená voľba), s vypnutým (/ATD) alebo všetky (/ATA). Parameter je použiteľný pri kopírovaní celého archívu do nového archívu, pokiaľ je želané kopírovanie aj hodnôt starých archívnych objektov s vypnutým archivovaním. Pre tieto objekty sa v cieľovej databáze vytvoria príslušné tabuľky, pokiaľ neexistovali. | |||||||||||||||||||||||||||||||||||||||
| Veľkosť okolia diery v Veľkosť okolia diery v archíve, ktoré bude tiež synchronizované. Pri zápise do archívu môžu prichádzať z komunikácie aj hodnoty so starším alebo novším časom ako je aktuálny. Po výpadku archivačného procesu následne chýbajú aj novšie a staršie dáta z okolia diery. Preto je možné zadaním parametra time_delta nastaviť veľkosť okolia diery (v sekundách), ktoré bude tiež synchronizované. Prednastavené time_delta = 10. | ||||||||||||||||||||||||||||||||||||||||
| Veľkosť okolia od konca diery v archíve, ktoré bude tiež synchronizované. Pri zápise do archívu môžu byť vkladané (zvyčajne zo skriptu) aj dáta s budúcim časom (napr. príprava prevádzky). Po výpadku archivačného procesu následne chýbajú aj novšie dáta ako je čas konca diery. Preto je možné zadaním parametra future_delta nastaviť čas dát pripočítaný ku koncu diery (v sekundách), ktoré bude tiež synchronizované. Prednastavené future_delta = 0. | ||||||||||||||||||||||||||||||||||||||||
/NU | Ak sa v cieľovej archívnej databáze hodnota archívneho objektu s konkrétnym časom už nachádza (takže vloženie hodnoty zlyhá), nebude následne hodnota aktualizovaná. Parameter slúži na zrýchlenie | /NU | Ak sa v cieľovej archívnej databáze hodnota archívneho objektu s konkrétnym časom už nachádza (takže vloženie hodnoty zlyhá), nebude následne hodnota aktualizovaná. Parameter slúži na zrýchlenie synchronizácie, pokiaľ cieľová archívna databáza obsahuje iba diery a nie dáta s inými hodnotami, ako zdrojová databáza. | ||||||||||||||||||||||||||||||||||||||
/U | Vykoná sa aktualizácia štruktúr tabuliek v archívnej databáze. Pokiaľ je aspoň jedna z tabuliek v archívnej databáze neaktuálna (napr. tabuľky ARCHIV_DEF, ARC_HOLE, UTC_OFFSET), utilita Arcsynchro bez prepínača /U skončí s chybovým hlásením. S použitím prepínača /U sa štruktúra databázy aktualizuje (to ale môže vadiť, pokiaľ by niekto omylom použil nový arcsynchro na opravenie dier v staršej aplikácii, ktorá by potom nebola schopná s upgradovaným archívom pracovať). | ||||||||||||||||||||||||||||||||||||||||
/UX | Bude sa pracovať aj so starými (neaktualizovanými) štruktúrami tabuliek v archívnej databáze. Tento parameter umožňuje synchronizovať dáta zo starších D2000 aplikácií (napr. D2000 verzia 8.0 bez podpory UTF8) bez potreby aktualizovať starú archívnu databázu. Toto môže byť výhodné pri príprave migrácie na novú verziu D2000, pokiaľ sa mení aj databázová platfoma pre D2000 Archiv. | ||||||||||||||||||||||||||||||||||||||||
| Arcsynchro najskôr vykoná aktualizáciu hodnoty (update). Pokiaľ nie je v dôsledku aktualizácie modifikovaný žiaden riadok, až potom sa vykoná vloženie hodnoty (insert). Parameter je implementovaný iba v ODBC verzii. Pozn: parameter má zmysel pre archívy na platforme PgSql PostgreSQL na minimalizáciu generovania transakčných ID (XID) pri použití DSN s nastavením "Level of rollback on errors" na hodnotu Transaction. Pozn: pre PgSql pre PostgreSQL od verzie 9.5 je možné na redukciu generovania XID použiť parameter /UP. Pozn: identickú funkcionalitu v archíve zapína parameter archívu SelectBeforeUI. | ||||||||||||||||||||||||||||||||||||||||
| Parameter zapína použitie SQL príkazu "UPSERT" (kombinácia Insert a Update SQL príkazu), ktorý je podporovaný pre databázu PostgreSql databázu PostgreSQL od verzie 9.5. V takom prípade bude vkladanie hodnôt do archívu a trezorov realizované pomocou príkazu INSERT .. ON CONFLICT .. DO UPDATE. Parameter je implementovaný iba v ODBC verzii. Pozn: parameter má zmysel pre archívy na platforme PgSql PostgreSQL na minimalizáciu generovania transakčných ID (XID) pri použití DSN s nastavením "Level of rollback on errors" na hodnotu Transaction. Pozn: pre staršie verzie PgSql verzie PostgreSQL ako 9.5 je možné na redukciu generovania XID použiť parameter /UF. Pozn: identickú funkcionalitu v archíve zapína parameter archívu Upsert. | ||||||||||||||||||||||||||||||||||||||||
| Synchronizujú sa iba primárne archívy, nie štatistické ani vypočítané. | ||||||||||||||||||||||||||||||||||||||||
| Parameter je prípustný iba vtedy, ak je zadaný aj parameter id 4554776 (synchronizácia dát jedného objektu s konkrétnym identifikátorom). Vtedy sa hodnoty objektu s identifikátorom id 4554776 načítané zo zdrojovej databázy vkladajú do cieľovej archívnej databázy do tabuliek objektu s identifikátorom tid. Ak sa synchronizujú dáta do trezorov, tak sa identifikátor objektu id nahradí pri vkladaní do cieľového trezoru identifikátorom tid. Pozn: Parameter /TID je použiteľný pri spájaní aplikácií a ich archívov, ak dochádza k zmene HOBJ objektov (ID objektu v zdrojovej aplikácii a zdrojovom archíve je iné ako v cieľovej aplikácii/archíve). | ||||||||||||||||||||||||||||||||||||||||
| Arcsynchro nebude písať do štandardného logu arcsynchro.log ale do logu s časovou značkou arcsynchro yyyy-mm-dd hh-mi-ss.log. Možnosť použitia - viď poznámka. |
Parametre pre trezory
| DSN zdrojovej trezorovej databázy (iba pre Sybase). Parameter môže byť použitý iba raz. Parameter implicitne zapína aj parameter /TAD (t.j. z trezorovej databázy sa načítavajú iba hodnoty objektov, ktorých definície sú v cieľovej archívnej databáze). Poznámka: Ak je použitý parameter /ST, parameter source (DSN zdrojového archívu) bude ignorovaný. | |||||||||||||||
| tt
| tt
| TT STPG trezor_ | dsnname | DSN cieľovej Meno zdrojovej trezorovej databázy | . (pre PostgreSQL). Zvyčajne vo formáte appname_TREZOR_n, napr. Test_TREZOR_11. Parameter môže byť použitý iba raz. Parameter implicitne zapína aj parameter /TAD (t.j. z trezorovej databázy sa načítavajú iba hodnoty objektov, ktorých definície sú v cieľovej archívnej databáze). Poznámka: Ak je použitý parameter /STPG, parameter source (DSN zdrojového archívu) bude použitý na pripojenie sa k PostgreSQL trezoru (aby nemuselo byť vytvorené zvlášť DSN pre každý PostgreSQL trezor). Preto musí byť source DSN zdrojového archívu, ktorý sa nachádza na rovnakom PostgreSQL serveri ako trezor. | ||||||||||
| DSN cieľovej trezorovej databázy (pre Sybase/Oracle). Pre cieľovú databázu na Sybase môže byť parameter opakovaný aj viackrát (napr. pre synchronizáciu aktuálnej a predchádzajúcej trezorovej databázy: /TT app.curr_trezor /TT app.prev_trezor). Poznámka: Ak sa nepodarí otvoriť prvú trezorovú databázu, arcsynchro skončí s chybou. Chyba otvorenia druhej alebo ďalšej databázy je ignorovaná (aby sa umožnilo štandardné použitie s aktuálnym a predchádzajúcim trezorom, pričom predchádzajúci už nemusí byť dostupný). Poznámka: Ak sa nepodarí otvoriť prvú trezorovú databázu, arcsynchro skončí s chybou. Chyba otvorenia druhej alebo ďalšej databázy je ignorovaná (aby sa umožnilo štandardné použitie s aktuálnym a predchádzajúcim trezorom, pričom predchádzajúci už nemusí byť dostupný). | |||||||||||||||
| Pre zdrojovú databázu na Oracle: synchronizujú sa dáta z trezoru trezor_id. Parameter je použiteľný pre Oracle trezory, ktoré sú umiestnené v tej istej databáze ako archív. Parameter umožňuje naplnenie cieľovej databázy, prípadne trezorov cieľovej databázy (Oracle, PostgreSQL, Sybase) z trezoru Oracle databázy. Príklady:
Pozn: Synchronizovať sa budú dáta iba z trezorov, ktoré sú namontované (aktuálny, predchádzajúci a staršie, ktoré sú namontované príkazom MOUNT_TREZOR). | |||||||||||||||
| Pre cieľovú databázu na Oracle: synchronizovať sa majú aj trezory. Parameter je použiteľný pre Oracle trezory, ktoré sú umiestnené v tej istej databáze ako archív. Ak sú trezory vo zvláštnej databáze, je nutné použiť parameter /TT trezor_dsndatabáze, je nutné použiť parameter /TT trezor_dsn. Pozn: Synchronizovať sa budú dáta iba do trezorov, ktoré sú namontované na zápis (aktuálny, predchádzajúci a staršie, ktoré sú namontované príkazom MOUNT_TREZOR WRITE). | |||||||||||||||
/PTO | V cieľovej databáze sa synchronizujú iba trezory, nie samotný archív. Parameter target bude ignorovaný, pokiaľ sa použije parameter /TT trezor_dsn a nepoužije sa parameter /TAD. | |||||||||||||||
/TTP trezor_password | Heslo na pripojenie sa k cieľovej trezorovej databáze. | |||||||||||||||
| Arcsynchro použije definíciu archívnych objektov z cieľovej databázy. Štandardne sa používa definícia archívnych objektov zo zdrojovej databázy, tento prepínač je potrebný, ak je nakonfigurovaný v cieľovom Oracle archíve iný počet trezorových segmentov ako v zdrojovom archíve a synchronizujú sa dáta aj do trezorov. Bez prepínača /TAD by archív ukladal dáta do trezorového segmentu 0 (ak počet trezorových segmentov v zdrojovom archíve je menší ako v cieľovom) alebo by nenašiel trezorový segment, do ktorého má dáta ukladať (ak počet trezorových segmentov v zdrojovom archíve je väčší ako v cieľovom). | |||||||||||||||
/TTPGN maskN | Pre cieľovú databázu na PostgreSQL: synchronizovať sa majú aj trezory. | |||||||||||||||
| Pre trezory na PostgreSQL od verzie 9.5: dáta sa do trezorov nevkladajú cez ODBC, ale vytvorí sa súbor v adresári path, v ktorom budú dáta v textovej forme. Po vložení počtu riadkov, ktorý zodpovedá štartovaciemu parametru /CM (default 1000, ale odporúčame pri použití /FM zvýšiť až na 1000000) sa pomocou PostgreSQL rozšírenia 'file_fdw' vytvorí tzv. foreign table (externá tabuľka) mapovaná na tento súbor a dáta sa vložia do trezoru z nej (upsert). Tento postup obchádza pomalosť ODBC, ktoré spracúva riadky po jednom. Podmienkou je, aby adresár path bol čitateľný pre PostgreSQL databázu (t.j. arcsynchro musí bežať na tom istom počítači ako databáza). Použitím parametra /FM sa zrýchlilo načítavanie dát v konkrétnom prípade cca 3-násobne (z 2400 na 7050 riadkov za sekundu). |
Iné parametre
| Kopírovanie obsahu tabuľky LOG_DATA. Kopírovanie je nutné pri pridávaní novej inštancie archívu do už existujúcej aplikácie alebo pri prechode na novú databázu (napr. pri prechode zo Sybase nižšej verzie na vyššiu, alebo z Sybase na Oracle platformu a opačne). Tabuľka LOG_DATA obsahuje údaje o prechode archívu na monotónny čas a o začiatku zmenovej archivácie. Pokiaľ sa budú do archívnej databázy kopírovať staršie dáta (zo staršej archívnej databázy), je nutné nakopírovať z neho aj obsah tabuľky LOG_DATA a až následne spustiť archiváciu. V opačnom prípade dôjde k zlej interpretácii starých údajov a k ich prípadnému poškodeniu pri prepočtoch. Kopírovanie obsahu tabuľky LOG_DATA je nutné spustiť pred tým, ako proces D2000 Archiv začne zapisovať do novej archívnej databázy dáta. Doporučený postup je nasledovný:
| ||||||
/DD | Detailné ladiace výpisy. Po zapnutí parametra budú na obrazovku aj do logovacieho súboru arcsynchro.log zapisované rozšírené | /DD | Detailné ladiace výpisy. | ||||
/DC count | Po zapnutí nastavení parametra na nenulovú hodnotu count budú na obrazovku aj do logovacieho súboru arcsynchro.log zapisované rozšírené ladiace výpisy. | /DC count | Po nastavení parametra na nenulovú hodnotu count budú na obrazovku aj do logovacieho súboru arcsynchro.log zapisované písmená 'I' resp. 'U' po vložení (Insert) resp aktualizovaní (Update) count hodnôt v archíve.|||||
Kotva | /cm | /cm | /CM countCommitovanie v archívnej databáze bude po count vložených/aktualizovaných hodnotách. Prednastavená hodnota tohto parametra je 1000. | písmená 'I' resp. 'U' po vložení (Insert) resp aktualizovaní (Update) count hodnôt v archíve. Poznámka: Na obrazovke sa výpisy zobrazujú priebežne, v logovacom súbore až po ukončení spracovania jedného archívneho objektu. | |||
---|---|---|---|---|---|---|---|
| Commitovanie v archívnej databáze bude po count vložených/aktualizovaných hodnotách. Prednastavená hodnota tohto parametra je 1000. | ||||||
| Dodatočná podmienka pre ArchivDef tabuľku (tabuľka s definíciami archívnych objektov v archíve). Príklad použitia: pri použití arcsynchro na kopírovanie dát z trezorových segmentov (napr. z Oracle databázy) do trezorových segmentov (napr. PostgreSQL databáza) je možné špecifikovať /XADC "TRZ_SEG=2". Synchronizované budú iba objekty, ktoré sú v trezorovom segmente č. 2. Toto môže zrýchliť kopírovanie dát (zdrojový trezorový segment nie je dotazovaný na dáta objektov, ktoré sa nachádzajú v iných trezorových segmentoch). |
Popis
Utilita Arcsynchro slúži na synchronizáciu archívnych databáz po výpadku jedného z archívov (target). Pripojí sa k archívnej databáze, ktorá obsahuje údaje (source) a údaje, ktoré sú z časového intervalu <time_start, time_end> skopíruje do cieľového archívu.
Archivované hodnoty, ktoré sa už v cieľovom archíve nachádzajú, sú prepísané (UPDATE).
Od verzie systému D2000 v7.00.031 je podporovaný mód automatickej synchronizácie, ktorá získava potrebný time_start/time_end priamo z archívu (viď popis parametra /A).
Pre verzie 7.01.025 a novšie: formát začiatočného a koncového času time_start, time_end je 'YYYY-MM-DD HH:MI:SS' a je to lokálny čas (čas užívateľa).
Pre verzie 7.01.024 (Release 65) a staršie: formát začiatočného a koncového času time_start, time_end závisí od konkrétnej databázy a operačného systému a priamo sa porovnáva s časmi v archívnej databáze. Pre databázu Oracle sa nastaví časový formát na YYYY-MM-DD HH24:MI:SS.
Po spustení vypisuje Arcsynchro informácie o synchronizácii na obrazovku ako aj do súboru arcsynchro.log v aktuálnom adresári. Tento súbor obsahuje navyše aj informácie o čase spustenia a ukončenia programu ako aj časové pečiatky všetkých oznamov.
Pre platformu Sybase je nutné vytvoriť DSN pre všetky trezory, ktoré sa majú synchronizovať.
Pre platformu Oracle udáva DSN (arcsynchro.exe) alebo TNS (arcsynchro_ora.exe) cieľovú databázu. Synchronizovať sa budú všetky trezory, ktoré sú namontované na zápis (aktuálny, predchádzajúci a staršie, ktoré sú namontované príkazom MOUNT_TREZOR).) alebo TNS (arcsynchro_ora.exe) cieľovú databázu.
Príklad
Databáza Sybase pod Windows:
arcsynchro.exe dbsrvmain dbsrvbackup "2001-03-30 15:00:00" "2001-03-30 15:30:00"Databáza Oracle:
arcsynchro_ora.exe /SU myapp_archiv /TU myapp_archiv dbsrvmain dbsrvbackup "2004-03-13 10:40" "2004-03-14 03:12:25"
Databáza Oracle so synchronizáciou trezorov:
arcsynchro_ora.exe /TTO /TAD /SU myapp_archiv /TU myapp_archiv /A dbsrvA dbsrvB
Databáza Sybase, synchronizujú sa aj dva trezory (aktuálny a predchádzajúci):
arcsynchro.exe /TT TrzCurr /TT TrzPrev dbsrvmain dbsrvbackup "2004-03-13 10:40" "2004-03-14 03:12:25"
Databáza Oracle, synchronizujú sa všetky dostupné trezory (aktuálny, predchádzajúci a staršie trezory pripojené na zápis):
arcsynchro_ora.exe /TTO /SU myapp_archiv /TU myapp_archiv dbsrvmain dbsrvbackup "2004-03-13 10:40" "2004-03-14 03:12:25"
Kopírovanie dát zo starého Sybase trezoru TrzSrc do Oracle archívu TrzDstArc a do Oracle trezorov v tomto archíve:
arcsynchro /TTO /ST TrzSrc unusedDSN TrzDstArc "2006-07-27 07:00:00" "2006-07-27 08:00:00"
Kopírovanie dát zo starého Sybase trezoru TrzSrc do Oracle archívu TrzDstArc a do Oracle trezorov v tomto archíve, pričom Oracle trezory používajú segmenty (nutný /TAD parameter):
arcsynchro /TAD /TTO /ST TrzSrc unusedDSN TrzDstArc "2006-07-27 07:00:00" "2006-07-27 08:00:00"
Automatické patchovanie archívu a trezorov na PostgreSQL, pričom nie sú použité trezorové segmenty a patchujú sa iba primárne archívy:
arcsynchro /LOGDT /PO /TTPG0 MyAPP_TREZOR_#ID# /A MyApp.Archiv.Arc2 MyApp.Archiv.PG
Návratové kódy
0 | Úspešné ukončenie programu. |
1 | Chybné parametre programu. |
2 | Chyba pripojenia sa k zdrojovej databáze zadanej parametrom source 4554776. |
3 | Chyba pripojenia sa k zdrojovej trezorovej databáze zadanej parametrom /ST. |
4 | Chyba pripojenia sa k cieľovej databáze zadanej parametrom target 4554776. |
5 | Chyba pripojenia sa k samostatnej cieľovej trezorovej databáze na platforme Oracle zadanej parametrom /TT trezor_dsn. |
6 | Chyba pripojenia sa k prvej cieľovej trezorovej databáze na platforme Sybase zadanej prvým parametrom /TT trezor_dsn. |
7 | V zdrojovej databáze source 4554776 bola začatá, ale nebola dokončená konverzia na časové rezy. |
8 | V cieľovej databáze target 4554776 bola začatá, ale nebola dokončená konverzia na časové rezy. |
9 | Cieľová databáza target 4554776 nie je na platforme Oracle a použitý bol parameter /TTO. |
10 | Chyba pri čítaní zoznamu trezorov z cieľovej databázy target 4554776 na platforme Oracle pri použití parametra /TTO. |
11 | Chyba pri čítaní zoznamu trezorov zo samostatnej trezorovej databázy /TT trezor_dsn na platforme Oracle pri použití parametra /TTO. |
12 | Chyba pri zistení parametrov zdrojovej trezorovej databázy zadanej parametrom /ST. |
13 | Chyba pri synchronizácii dát (napr. rozpad spojenia s databázou). |
Poznámka 1
Pokiaľ sa arcsynchro.exe (ODBC verzia) používa na prístup k Oracle databáze Oracle9i, je nutné, aby verzia ODBC bola vyššia ako 9.2.0.0 (súčasť inštalácie Oracle ODBC). Verzia 9.2.0.0 obsahuje chyby pri práci s časovými značkami (timestamp) a vracia nulový počet riadkov pre špecifikované časové obdobie, aj keď sa riadky v databáze nachádzajú.
Odporúčame použiť patch na ODBC ovládače 9.2.0.6 a vyššie.Upozornenie: Oracle patchset 9.2.0.6 (cca 200MB) neobsahuje patch ODBC 9.2.0.6 (cca 2MB), ale je potrebné ho stiahnuť samostatne z web stránok Oracle.
Poznámka 2
Pri použití parametra /A (automatická synchronizácia) sa diera v cieľovej databáze neoznačí ako zaplátaná, pokiaľ bol zadaný parameter id alebo mask. Pokiaľ bol zadaný parameter +id alebo nebola špecifikovaná maska a úspešne prejde synchronizácia, diera v cieľovej databáze sa označí ako zaplátaná (status=20).
Poznámka 3
Ak pri synchronizácii archívov založených na Oracle databáze nastane chyba "ORA-01555 Snapshot too old", je nutné zväčšiť Undo Retention čas v databáze a zopakovať synchronizáciu. Táto chyba môže nastať najmä pri synchronizácii archívoch, ktoré obsahujú veľké štruktúrované premenné.
Arcsynchro spúšťané priamo z archívu
Kotva | ||||
---|---|---|---|---|
|
Parameter ArcsynchroAuto sa použije, iba ak je archív spustený ako inštančný proces (Pokiaľ nie je, predpokladá sa, že existuje iba jediný archív a nie je odkiaľ ho dosynchronizovať. Konfigurácia systému s redundantnými kernelmi, z ktorých každý má lokálne spustený archív, nie je podporená, pretože je považovaná za nesprávnu.).
Príklady:
C:\D2000\D2000.exe\bin\arcsynchro.exe /PO /A MyApp.Arc2 MyApp.Archiv
C:\D2000\D2000.exe\bin\arcsynchro_ora.exe /PO /TTO /TAD /SU myapp_archiv /TU myapp_archiv /A Arc2 Arc1 (platforma Oracle, aj so synchronizáciu trezorov)
V oboch prípadoch je použitý parameter /PO, aby sa synchronizovali iba primárne archívy, keďže sa neskôr prepočítajú všetky vypočítané a štatistické archívy.
Ešte pred spustením arcsynchro, si archív načíta z databázy zoznam nezaplátaných archívnych dier (záznamy z tabuľky ARC_HOLE, kde Status=10). Po spustení arcsynchro archív periodicky kontroluje, či sa stav týchto riadkov nezmenil.
Pokiaľ sa Status niektorej archívnej diery zmení na hodnotu -1 (blokovaná diera) alebo 30 (do diery neboli vložené žiadne hodnoty), archív si iba vnútorne vymaže dieru zo zoznamu sledovaných.
Pokiaľ sa Status niektorej archívnej diery zmení na hodnotu 20 (synchronizovaná diera) alebo 25 (synchronizovaná aj v trezore), archív urobí tieto činnosti:
Zistí si čas začiatku a konca diery (z tabuľky ARC_HOLE) a rozšíri tento interval o ArcsynchroTimeDelta sekúnd (kvôli existencii oneskorujúcich sa hodnôt) na < From_time - ArcsynchroTimeDelta ; To_time + ArcsynchroTimeDelta >.Kotva arcsynchrotimedelta arcsynchrotimedelta - Pre primárne archívy zistí, či boli v diere vložené nejaké hodnoty. Ak áno, vymaže cache primárneho archívu, aby neobsahovala informácie staršie ako koniec diery.
Pre vypočítané a štatistické archívy sa takisto vymaže cache a spustí sa prepočet (recalc) za rozšírený časový interval. Pokiaľ bol nastavený parameter archívu ArcsynchroBackground na hodnotu 1, prepočet sa vykoná na pomocnom výpočtovom tasku, inak sa vykoná na hlavnom tasku/taskoch.Kotva arcsynchrobackground arcsynchrobackground
Táto funkcionalita umožňuje, aby sa po zaplátaní diery archív korektne "doinicializoval" a pokiaľ boli v diere vložené hodnoty primárnych archívov, dočítal si ich a ďalej s nimi počítal (inak by bral do úvahy iba hodnoty vyčítané pri štarte archívu).
Info | ||
---|---|---|
| ||
O utilite Arcsynchro si môžete prečítať blogy: |