Migración del repositorio de Jazz después de actualizar Jazz Team Server for System z.

La migración del repositorio es el proceso de convertir los contenidos de la base de datos de un formato a otro. La migración del repositorio es necesaria cuando se actualiza Jazz Team Server for System z desde versión X a la versión Y, donde la versión Y tiene cambios de esquema.La migración del repositorio también se necesita para actualizar de Rational Team Concert a Rational Team Concert for System z.

Antes de empezar
Debe realizar una migración de datos si existen cambios en el esquema entre las dos versiones de Jazz Team Server for System z. Debe haber extraído los archivos comprimidos de Jazz Team Server for System z de las versiones X e Y o haber instalado ambas versiones utilizando IBM Installation Manager en grupos de paquetes distintos o en sistemas distintos.
Por qué y cuándo se efectúa esta tarea
Por lo general, la migración de datos es un proceso que consta de dos pasos:

diagrama de migración del repositorio

Puede utilizar la aplicación de herramientas de repositorio para las operaciones de importación y exportación.
Nota: Jazz Team Server for System z debe detenerse cuando se realiza una migración del repositorio. La migración puede tardar mucho tiempo, en función de la configuración del sistema, del sistema operativo, de la base de datos, etc. Por lo tanto, planifique la interrupción como mejor le convenga. Para obtener instrucciones específicas sobre cómo importar y exportar bases de datos en z/OS, consulte Actualizar desde Rational Team Concert for System z 1.0.1 en z/OS, en Actualización a Rational Team Concert for System z 2.0.

La migración de Jazz Team Server for System z es un proceso intensivo que puede llevar una cantidad de tiempo considerable en función del tamaño de los datos que se van a migrar. A continuación, figura una lista de comprobación de lo que es necesario tener en cuenta para evitar los errores comunes.

Sistema operativo:
  • En Windows, asegúrese de que esté habilitado "memoria caché de escritura en disco" para todos los discos implicados.
  • En Windows, inhabilite "Servicio de indexación de Windows".
  • Asegúrese de que el directorio temporal, la base de datos y el archivo .tar se encuentran en el disco más rápido (idealmente, un disco en bandas/RAID/10)
  • En Linux (para DB2), asegúrese de que ha ajustado el kernel de forma correcta según el tema relativo a la administración de DB2 incluido aquí: http://publib.boulder.ibm.com/infocenter/db2luw/v9r5/topic/com.ibm.db2.luw.qb.server.doc/doc/t0008238.html
Configuración de Jazz Team Server:
  • Configure las siguientes propiedades (en teamserver.properties) para asegurarse de que se accede al disco más rápido:
    com.ibm.team.repository.tmpdir
    com.ibm.team.scm.vcs.tmpdir
    com.ibm.team.scm.tmpdir
    com.ibm.team.fulltext.indexLocation
DB2:
  • De forma predeterminada, DB2 intenta aumentar el tamaño de la agrupación de almacenamiento intermedio según resulte necesario. Salvo que haya inhabilitado esta opción, DB2 debería funcionar bien con las configuraciones predefinidas.
  • Para comprobar esta memoria de almacenamiento intermedio, lleve a cabo lo siguiente:
    1. Conéctese a la base de datos de Jazz a la que quiere importar escribiendo los siguiente en el indicador de mandatos:
      db2 connect to <databaseName>
    2. A continuación, ejecute el siguiente mandato:
      db2 "select bufferpoolid, bpname from syscat.bufferpools"
      Esto generará un identificador de agrupación de almacenamiento intermedio con el siguiente formato:
      BUFFERPOOLID BPNAME
      ------------ ----------------------------------
                 1 IBMDEFAULTBP
      
        1 registro(s) seleccionado(s).
    3. En el ejemplo anterior, el identificador de la agrupación de almacenamiento intermedio es 1. A continuación, ejecute el siguiente mandato:
      db2mtrk -d
      Esto generará unos datos similares a estos:
      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
      La salida en negrita indica el tamaño de agrupación de almacenamiento intermedio asignado a la base de datos.
Oracle:
  • Inhabilitar papelera de reciclaje: realiza un seguimiento de todos los elementos que se eliminan, rellena el disco y puede provocar problemas de hecho. Ejecute los siguientes mandatos en sqlplus:
    "ALTER SYSTEM SET RECYCLEBIN" = 'OFF' 
    "PURGE RECYCLEBIN"
  • Inhabilitar retención de historial de estadísticas: realiza un seguimiento del tiempo de ejecución de los métodos anteriores.
    "exec dbms_stats.ALTER_STATS_HISTORY_RETENTION (0)"
    "exec dbms_stats.PURGE_STATS ( current_timestamp )"
  • Asegúrese de que el espacio de tabla de Oracle cubre un solo archivo.

Para iniciar la migración:

  1. Detenga Jazz Team Server for System z de la versión X. Para detener Jazz Team Server for System z, ejecute server.shutdown.sh para Linux o server.shutdown.bat para Windows empaquetado en [installDir]/jazz/server.
  2. Realice una copia de seguridad del repositorio de Jazz. La copia de seguridad es un medida de prevención en caso de que se produzcan problemas con la migración.
    1. En el caso de Derby, realice una copia archivada del directorio entero de la base de datos.
    2. Con DB2, utilice el mandato de seguridad de DB2 para generar un archivo de archivado de base de datos con información de fecha y hora en el directorio de destino especificado.
  3. Realice una copia de seguridad del índice de texto completo. La ubicación del índice de texto completo se encuentra en la propiedad com.ibm.team.fulltext.indexLocation del archivo teamserver.properties.
  4. Ejecute las herramientas de repositorio para exportar los datos del repositorio. Los scripts repotools.sh para Linux y repotools.bat para Windows están empaquetados en el directorio [installDir]/jazz/server.

    Ejemplo: repotools -export toFile=./file_name.tar

    Nota: Los mensajes de error y la información de registro se muestran en la consola y en el archivo de anotaciones. El archivo de anotaciones contiene información acerca del número de elementos exportados, la hora de exportación de los elementos, los errores y otra información útil. El archivo de anotaciones se crea de forma predeterminada en el mismo directorio como el script de herramientas de repositorio. Puede cambiar la ubicación del archivo de anotaciones con el parámetro logFile.
    Ahora habrá exportado el contenido del repositorio en un archivo TAR.
  5. Copie el archivo teamserver.properties de [installDir]/jazz/server de la versión X a [installDir]/jazz/server de la versión Y.
  6. En la versión Y, ejecute las herramientas de repositorio para importar los datos del archivo TAR en el repositorio.
    Ejemplo: repotools -import fromFile=./file_name.tar
    Nota: La opción -import registra información acerca de los elementos importados y omitidos, así como de los errores que se han producido durante la importación.
Qué hacer a continuación
Ahora podrá iniciar el Jazz Team Server for System z de la versión Y.