Migración del repositorio de Jazz después de actualizar Jazz Team Server

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 desde versión X a la versión Y, donde la versión Y tiene cambios de esquema.
Antes de empezar
Debe realizar una migración de datos si existen cambios en el esquema entre las dos versiones de Jazz Team Server. Debe haber extraído los archivos comprimidos de Jazz Team Server de las versiones X e Y.
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 repotools para las operaciones de importación y exportación.
Nota: Jazz Team Server debe detenerse cuando se realiza una migración del repositorio. La migración puede tardar mucho tiempo, en función de la configuración de la máquina, del sistema operativo, de la base de datos, etc. Por lo tanto, planifique la interrupción como mejor le convenga.

Migración del directorio de texto completo

Jazz Team Server gestiona un directorio fuera de la base de datos que almacena todos los datos que son necesarios para procesar las consultas de texto completo. La ubicación del directorio se configura en el archivo teamserver.properties en la propiedad com.ibm.team.fulltext.indexLocation. Cuando migra la base de datos y desea utilizar el directorio anterior que se utilizaba para idexar, debe asegurarse de que la ubicación utilizada en la herramienta del repositorio -rebuildTextIndices se ajusta a la ubicación utilizada por el servidor. Cuando inicia el servidor o al ejecutar el mandato -rebuildTextIndices, la vía de acceso absoluta a la ubicación del directorio de texto completo se imprime en los archivos de registro. Es posible comprobar el archivo de registro del servidor y el archivo de registro repotools_rebuildTextIndicies con el fin de comparar ambos directorios.
Consejo: Si el directorio configurado en el archivo teamserver.properties es una vía de acceso relativa, se imprimirá una aviso en el archivo de registro. Se recomienda configurar esta propiedad con el fin de que sea una vía de acceso al directorio absoluta.
Para obtener más información acerca de cómo crear índices de texto completos, consulte -rebuildTextIndices.

La migración de Jazz Team Server 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 "memoria caché de escritura en disco" esté habilitado para todos los discos implicados.
  • En Windows, inhabilite el "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 correctamente el kernel según el siguiente tema relativo a la administración de DB2: 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 manera predeterminada, DB2 intenta aumentar el tamaño de la agrupación de almacenamiento intermedio según resulte necesario. Salvo que se 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 que desea importar escribiendo lo 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 suprimen, 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 de la versión X. Para detener Jazz Team Server, ejecute server.shutdown.sh para Linux o server.shutdown.bat para Windows empaquetado en [dir_instalación]/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. Para DB2, utilice el mandato de copia de seguridad de DB2 para generar un archivo de archivado de base de datos con la 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 repotools para exportar los datos del repositorio. Los scripts, repotools.sh para Linux y repotools.bat para Windows, están empaquetados en el directorio [dir_instalación]/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 registro. El archivo de registro 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 registro se crea de forma predeterminada en el mismo directorio como el script repotools. Puede cambiar la ubicación del archivo de registro 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 repotools para importar los datos del archivo TAR en el repositorio.
    Ejemplo: repotools -import fromFile=./file_name.tar
    Importante: Si la base de datos no es Derby, debe crear una base de datos nueva antes de ejecutar la herramienta de importación.
    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 de la versión Y.

Comentarios