Jazz lerakat átállítása a Jazz Team Server frissítése után

A lerakat átállítása az adatbázis-formátum egy másik formátumra alakítását jelenti. A lerakat átállítására akkor van szükség, ha a Jazz Team Server X verzióját Y verzióra frissíti, és az Y verzióban sémaváltozások vannak.

Mielőtt elkezdené

Ha a kétféle Jazz Team Server verzió között sémaváltozások vannak, akkor mindig át kell állítani az adatok formátumát. A Jazz Team Server tömörített fájljait előzőleg az X és az Y verzió esetében is ki kell bontani.

Erről a feladatról

Az adatátállítás folyamata általában két lépésből áll:

lerakatátállítás ábrája

Az exportálási és importálási műveletekhez a repotools alkalmazás használható.
Megjegyzés: A Jazz Team Server kiszolgálót a lerakat átállítása idejére le kell állítani. Az átállítás a számítógép konfigurációjától, operációs rendszerétől, az adatbázistól stb. függően hosszú ideig is eltarthat. A kiesést tehát érdemes megfelelően ütemezni.

A teljes szöveges nyilvántartás átállítása

A Jazz Team Server egy adatbázison kívüli nyilvántartást is kezel, amely a teljes szöveges keresések feldolgozásához szükséges adatokat tárolja. A nyilvántartás helyét a teamserver.properties fájlban található com.ibm.team.fulltext.indexLocation tulajdonsággal lehet beállítani. Ha átállítja az adatbázist, de meg szeretné tartani az indexeléshez használt korábbi nyilvántartást, akkor gondoskodnia kell róla, hogy a -rebuildTextIndices lerakateszközben használt hely megegyezzen a kiszolgáló által használt hellyel. A kiszolgáló indításakor, illetve a -rebuildTextIndices parancs futtatásakor a teljes szöveges nyilvántartás helyének abszolút elérési útja megjelenik a naplófájlokban. A kiszolgáló naplófájljának ellenőrzésével és a repotools_rebuildTextIndices naplófájl ellenőrzésével összehasonlíthatja a két könyvtárat.
Tipp: Ha a teamserver.properties fájlban beállított könyvtár relatív útvonal, akkor egy figyelmeztetés kerül a naplófájlba. Javasoljuk, hogy ezt a tulajdonságot abszolút könyvtárelérési útként konfigurálja.
A teljes szöveges indexek létrehozásával kapcsolatos bővebb információkért lásd a -rebuildTextIndices témakört.

A Jazz Team Server átállítása nagyon erőforrás-igényes folyamat, amely az átállítandó adatmennyiségtől függően jelentős időbe telhet. Íme egy ellenőrzőlista arról, hogy mi mindenre kell figyelni a gyakori buktatók elkerüléséhez.

Operációs rendszer:
  • Windows rendszeren győződjön meg róla, hogy a "lemezre írás gyorsítótárazása" minden érintett lemezen engedélyezve van.
  • Windows rendszeren tiltsa le a "Windows indexelő szolgáltatást".
  • Gondoskodjon róla, hogy az ideiglenes könyvtár, adatbázis és .tar fájl a leggyorsabb meghajtón legyen (ideális esetben egy sávos/RAID/10 lemezen).
  • Linux rendszeren (DB2 adatbázis esetén) gondoskodjon a kernel megfelelő hangolásáról. Az erre vonatkozó DB2 adminisztrátori témakört itt találja: http://publib.boulder.ibm.com/infocenter/db2luw/v9r5/topic/com.ibm.db2.luw.qb.server.doc/doc/t0008238.html
Jazz Team Server beállítása:
  • Az alábbi tulajdonságok teamserver.properties fájlban történő beállításával gondoskodjon arról, hogy a leggyorsabb lemezt használja:
    com.ibm.team.repository.tmpdir
    com.ibm.team.scm.vcs.tmpdir
    com.ibm.team.scm.tmpdir
    com.ibm.team.fulltext.indexLocation
DB2:
  • A DB2 alapértelmezés szerint megpróbálja a szükséges méretűre növelni a puffertárat. Ha nem tiltotta le a műveletet, akkor ezt a DB2 külön beállítás nélkül elvégzi.
  • A puffertár ellenőrzéséhez tegye a következőket:
    1. A következő parancs parancssorba írásával csatlakozzon ahhoz a Jazz adatbázishoz, amelybe importálni szeretné az adatokat:
      db2
      connect to <adatbázisnév>
    2. Ezután futtassa a következő parancsot:
      db2 "select bufferpoolid, bpname from syscat.bufferpools"
      Ennek hatására megjelenik egy puffertár-azonosító a következő formátumban:
      BUFFERPOOLID BPNAME
      ------------ ----------------------------------
                 1 IBMDEFAULTBP
      
        1 record(s) selected.
    3. A fenti példában a puffertár azonosítója 1. Ezután futtassa a következő parancsot:
      db2mtrk -d
      A kimenetben az alábbihoz hasonló adatok jelennek meg:
      Tracking Memory on: 2009/06/04 at 22:19:17
      
      Memory for database: <adatbázisnév>
         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
      A félkövér kimenet jelzi az adatbázis számára lefoglalt puffertárméretet.
Oracle:
  • Tiltsa le a lomtárat - ez minden törölt elemet nyilvántart, és a lemezt teleírva problémákat okozhat. Futtassa a következő parancsot az sqlplus sorban:
    "ALTER SYSTEM SET RECYCLEBIN" = 'OFF' 
    "PURGE RECYCLEBIN"
  • Tiltsa le a statisztikai előzmények megtartását - ez minden korábbi metódus futtatási környezetét nyilvántartja.
    "exec dbms_stats.ALTER_STATS_HISTORY_RETENTION (0)"
    "exec dbms_stats.PURGE_STATS ( current_timestamp )"
  • Győződjön meg róla, hogy az Oracle táblaterület egyetlen fájlra korlátozódik.

Az átállítás indítása:

Eljárás

  1. Állítsa le az X verziójú Jazz Team Server kiszolgálót. A Jazz Team Server leállításához Linux rendszeren futtassa a server.shutdown.sh parancsfájlt, Windows rendszeren pedig a server.shutdown.bat parancsfájlt, amely a [telepítésiKönyvtár]/jazz/server elérési úton található.
  2. Készítsen biztonsági másolatot a Jazz lerakatról. A biztonsági mentés megelőző intézkedés arra az esetre, ha valami hiba történne az áttérés során.
    1. A Derby adatbázisban készítsen egy archív másolatot a teljes adatbáziskönyvtárról.
    2. A DB2 adatbázisnál használja a DB2 backup parancsát az adatbázis archívumfájljának előállításához a megadott célkönyvtárban található dátum- és időpontadatokkal.
  3. Készítsen biztonsági másolatot a teljes szöveges indexről. A teljes szöveges index helyét a teamserver.properties fájl com.ibm.team.fulltext.indexLocation tulajdonsága határozza meg.
  4. A repotools parancsfájl futtatásával exportálja a lerakatban tárolt adatokat. A parancsfájlok - Linux rendszerre a repotools.sh, Windows rendszerre a repotools.bat a [telepítésiKönyvtár]/jazz/server könyvtárban találhatók.

    Példa: repotools -export toFile=./fajlnev.tar

    Megjegyzés: A naplóadatok és hibaüzenetek a konzolon és egy naplófájlban is megjelennek. A naplófájl hibakeresési és egyéb hasznos információkat tárol az exportált elemekről, az elemek exportálási idejéről és a hibákról. A naplófájl alapértelmezés szerint abban a könyvtárban jön létre, ahol a repotools parancsfájl található. A naplófájl helyét a logFile paraméter beállításával módosíthatja.
    Ezzel egy TAR fájlba exportálta a lerakat tartalmát.
  5. Másolja a teamserver.properties fájlt az X verzió [telepítésiKönyvtár]/jazz/server könyvtárából az Y verzió [telepítésiKönyvtár]/jazz/server könyvtárába.
  6. Az Y verzióból futtassa a repotools parancsfájlt, és importálja a lerakatba a TAR fájlban tárolt adatokat.
    Példa: repotools -import fromFile=./fajlnev.tar
    Fontos: Ha nem Derby adatbázist használ, akkor létre kell hoznia egy új adatbázist, mielőtt futtatja az importáló eszközt.
    Megjegyzés: Az -import beállítás információkat naplóz az importált és kihagyott elemekről, valamint az importálás során előforduló hibákról.

Mi a következő lépés?

Most már elindíthatja az Y verziójú Jazz Team Server kiszolgálót.

Visszajelzés