Migrace úložiště je proces převodu obsahu databáze z jednoho formátu do jiného. Migrace úložiště je nezbytná, když provádíte upgrade produktu Jazz Team
Server z verze X na verzi Y, přičemž ve verzi Y došlo ke změnám schématu.
Migraci dat je třeba provést, když mezi dvěma verzemi produktu Jazz Team
Server došlo ke změnám schématu.
Musíte extrahovat komprimované soubory Jazz Team
Server verze X i verze Y.
Obecně je migrace dat tvořená dvěma kroky:
- Export dat, která jsou ve verzi X úložiště Jazz do souboru TAR.
- Import dat ze souboru TAR do verze Y úložiště Jazz.
Pro operace exportu a importu lze použít nástroje Repotools.
Poznámka: Při migraci úložiště je třeba produkt Jazz Team
Server zastavit. Migrace může trvat dlouho, v závislosti na konfiguraci vašeho počítače, jeho operačním systému, databázi a tak dále. Proto si odstávku řádně naplánujte.
Migrace produktu Jazz Team
Server je velmi náročný proces, který může trvat poměrně dlouho, v závislosti na velikosti migrovaných dat. Následuje kontrolní seznam věcí, na které je třeba dát pozor, abyste se vyhnuli běžným nástrahám.
Operační systém:
- V systému Windows se ujistěte, že je pro všechny zúčastněné disky povoleno "zapisovat údaje z mezipaměti na disk".
- V systému Windows zakažte službu "Windows Indexing Service".
- Ujistěte se, že se dočasný adresář database a soubor .tar nacházejí na nejrychlejším disku (nejlépe na prokládaném/RAID/10 disku).
- V systému Linux (pro DB2) se ujistěte, že máte správně vyladěné jádro podle zde uvedeného tématu o administraci DB2: http://publib.boulder.ibm.com/infocenter/db2luw/v9r5/topic/com.ibm.db2.luw.qb.server.doc/doc/t0008238.html.
Nastavení serveru Jazz Team Server:
DB2:
- DB2 se standardně snaží zvětšit velikost fondu vyrovnávacích pamětí podle potřeby. Pokud tuto funkci nevypnete, není třeba DB2 konfigurovat pro optimalizaci výkonu.
- Chcete-li zkontrolovat fond vyrovnávacích pamětí, postupujte takto:
- Připojte se k databázi Jazz, do které chcete importovat, napsáním následujícího příkazu na příkazový řádek:
db2 connect to <název_databáze>.
- Potom spusťte tento příkaz:
db2 "select bufferpoolid, bpname from syscat.bufferpools"
Výstupem bude identifikátor fondu vyrovnávacích pamětí v tomto formátu:BUFFERPOOLID BPNAME
------------ ----------------------------------
1 IBMDEFAULTBP
1 record(s) selected.
- Ve výše uvedeném příkladě je identifikátor fondu vyrovnávacích pamětí 1. Dále spusťte tento příkaz:
db2mtrk -d
Výstupem budou přibližně následující data:Tracking Memory on: 2009/06/04 at 22:19:17
Memory for database: <databaseName>
utilh pckcacheh other catcacheh bph (1) bph (S32K)
64.0K 384.0K 128.0K 128.0K 95.4M 832.0K
bph (S16K) bph (S8K) bph (S4K) shsorth lockh dbh
576.0K 448.0K 384.0K 64.0K 2.5M 20.8M
apph (269) apph (268) apph (267) apph (266) apph (265) apph (262)
64.0K 64.0K 64.0K 64.0K 64.0K 64.0K
appshrh
128.0K
Tučně zvýrazněný výstup označuje fond vyrovnávacích pamětí přidělený vaší databázi.
Zahájení migrace:
- Zastavte produkt Jazz Team
Server verze X. Chcete-li zastavit produkt Jazz Team
Server, spusťte soubor server.shutdown.sh pro systémy Linux, nebo soubor server.shutdown.bat pro systémy Windows zabalené v adresáři [instalační_adresář]/jazz/server.
- Vytvořte zálohu úložiště Jazz. Tato záloha představuje jen preventivní opatření pro případ, že by se při migraci něco pokazilo.
- V případě databáze Derby vytvořte archivní kopii celého adresáře databáze.
- V případě databáze DB2 vygenerujte archivní soubor databáze s informacemi o datu a čase v určeném adresáři pomocí příkazu DB2 backup.
- Vytvořte zálohu fulltextového indexu. Umístění fulltextového indexu je určeno ve vlastnosti com.ibm.team.fulltext.indexLocation v souboru teamserver.properties.
- Dat v úložišti vyexportujte pomocí nástrojů Repotools. Skripty (repotools.sh pro Linux a repotools.bat pro Windows) jsou zabaleny v adresáři [instalační_adresář]/jazz/server.
Příklad: repotools -export toFile=./file_name.tar
Poznámka: Informace z protokolů a chybové zprávy se zobrazují v konzole a zapisují do souboru protokolu. Soubor protokolu obsahuje informace ladění o počtu vyexportovaných položek, době potřebné pro export položek, chyby a další užitečné informace.
Soubor protokolu je standardně vytvořen ve stejném adresáři jako skript repotools. Umístění souboru protokolu je možné změnit pomocí parametru logFile.
Tím jste vyexportovali obsah úložiště do souboru TAR.
- Zkopírujte soubor teamserver.properties z adresáře [instalační_adresář]/jazz/server verze X do adresáře [instalační_adresář]/jazz/server verze Y.
- Z verze Y naimportujte pomocí nástrojů Repotools data ze souboru TAR do úložiště.
Příklad:
repotools -import fromFile=./file_name.tarPoznámka: Volba -import zaprotokoluje informace o naimportovaných a přeskočených položkách a také o chybách při importu.
Nyní můžete spustit produkt Jazz Team
Server verze Y.