Migrace úložiště Jazz po upgradu serveru Jazz Team Server

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.
Než začnete
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.
Informace o této úloze
Obecně je migrace dat tvořená dvěma kroky:

diagram migrace úložiště

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 atd. Proto si odstávku řádně naplánujte.

Migrace fulltextového adresáře

Jazz Team Server spravuje adresář mimo databázi, kde jsou uložena všechna data nezbytná ke zpracování fulltextových dotazů. Umístění adresáře je nakonfigurováno v souboru teamserver.properties pod vlastností com.ibm.team.fulltext.indexLocation. Pokud při migraci vaší databáze chcete použít předchozí adresář používaný k indexaci, musíte se ujistit, že umístění použité v nástroji úložiště -rebuildTextIndices souhlasí s umístěním používaným serverem. Při spouštění serveru nebo spuštění příkazu -rebuildTextIndices se absolutní cesta k umístění fulltextového úložiště vytiskne do souborů protokolu. Můžete zkontrolovat soubor protokolu serveru a soubor protokolu repotools_rebuildTextIndicies a oba adresáře porovnat.
Tip: Pokud je adresář nakonfigurovaný v souboru teamserver.properties relativní cestou, do souboru protokolu bude vytisknuto varování. Doporučuje se konfigurovat tuto vlastnost jako absolutní cestu k adresáři.
Další informace o vytváření fulltextových indexů viz -rebuildTextIndices.

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:
  • Nastavte následující vlastnosti (v souboru teamserver.properties), abyste zajistili přístup ke svému nejrychlejšímu disku:
    com.ibm.team.repository.tmpdir
    com.ibm.team.scm.vcs.tmpdir
    com.ibm.team.scm.tmpdir
    com.ibm.team.fulltext.indexLocation
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:
    1. 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>.
    2. 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.
    3. 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.
Oracle:
  • Zakažte koš - ten neustále sleduje všechny odstraněné prvky, zaplňuje disk a může způsobit problémy. Spusťte následující příkazy v sqlplus:
    "ALTER SYSTEM SET RECYCLEBIN" = 'OFF' 
    "PURGE RECYCLEBIN"
  • Zakažte uchování statistické historie - to neustále sleduje běh použitých metod:
    "exec dbms_stats.ALTER_STATS_HISTORY_RETENTION (0)"
    "exec dbms_stats.PURGE_STATS ( current_timestamp )"
  • Ujistěte se, že tabulkový prostor Oracle zahrnuje pouze jeden soubor.

Zahájení migrace:

  1. 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.
  2. 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.
    1. V případě databáze Derby vytvořte archivní kopii celého adresáře databáze.
    2. 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.
  3. 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.
  4. 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 protokolování 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.
  5. 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.
  6. Z verze Y naimportujte pomocí nástrojů Repotools data ze souboru TAR do úložiště.
    Příklad: repotools -import fromFile=./file_name.tar
    Důležité: Pokud vaše databáze není Derby, musíte před spuštěním nástroje importu vytvořit novou databázi.
    Poznámka: Volba -import zaprotokoluje informace o naimportovaných a přeskočených položkách a také o chybách při importu.
Jak pokračovat dále
Nyní můžete spustit produkt Jazz Team Server verze Y.

Váš názor

Byla tato pomoc užitečná? Zpětnou vazbu můžete poskytnout na stránkách Jazz.net (registrace je požadována): Komentář na fóru nebo odeslat chybu