Migración del repositorio de Jazz tras actualizar Jazz Team Server

La migración de repositorio es el proceso de convertir el contenido de la base de datos de un formato a otro. La migración de repositorio es necesaria al actualizar Jazz Team Server de la versión X a la versión Y, donde la versión Y tiene cambios de esquema.
Antes de empezar
Debe realizar migración de datos si hay algún cambio de esquemas entre las dos versiones de Jazz Team Server. Debe haber extraido los archivos comprimidos de Jazz Team Server de las dos 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 de dos pasos:

diagrama de migración de repositorio

Puede utilizar la aplicación repotools para la operación de exportación e importación.
Nota: Jazz Team Server debe detenerse cuando migre el repositorio. La migración puede llevar mucho tiempo en función de la configuración de su máquina, del sistema operativo, de la base de datos, etc. Por lo tanto, planifique la parada adecuadamente.

Migración del directorio de texto completo

Jazz Team Server gestiona un directorio fuera de la base de datos que almacena todos los datos necesarios para procesar consultas de texto completas. La ubicación del directorio está configurada en el archivo teamserver.properties en la propiedad com.ibm.team.fulltext.indexLocation. Cuando migre la base de datos y desee utilizar el directorio anterior que se utilizó para indexar, debe asegurarse de que la ubicación utilizada en la herramienta del repositorio -rebuildTextIndices coincide con la ubicación utilizada por el servidor. Al iniciar el servidor o ejecutar el mandato -rebuildTextIndices, la vía de acceso absoluta a la ubicación del directorio de texto completo estará impresa en los archivos de registro. Puede comprobar el archivo de registro del servidor y el archivo de registro repotools_rebuildTextIndicies para comparar los dos directorios.
Consejo: Si el directorio configurado en el archivo teamserver.properties es una vía de acceso relativa, se imprimirá un aviso en el archivo de registro. Se recomienda configurar esta propiedad para que sea una vía de acceso absoluta al directorio.
Para obtener más información sobre la creación de índices de texto completos, consulte -rebuildTextIndices.

La migración de Jazz Team Server es un proceso muy intensivo que puede llevar una cantidad de tiempo considerable en función del tamaño de los datos que se migren. A continuación se muestra una lista de comprobación de cosas que buscar para evitar escollos comunes.

Sistema operativo:
  • En Windows, asegúrese de que "caché de escritura en disco" está habilitado para todos los discos involucrados
  • En Windows, inhabilite el servicio de indexación
  • Asegúrese de que el directorio temporal, la base de datos y el archivo .tar se encuentren en la unidad más rápida (de forma ideal, en striped/RAID/10 disk)
  • En Linux (para DB2), asegúrese de que tiene adecuadamente optimizado el kernel de acuerdo al tema de administración de DB2 a continuación: 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 propiedades siguientes (en teamserver.properties) para asegurarse de que se acceda 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:
  • DB2, de forma predeterminada, intenta agrandar el tamaño de agrupación de almacenamiento intermedio tanto como sea necesario. A menos que lo haya inhabilitado, DB2 debería tener un buen rendimiento predeterminadamente.
  • Para comprobar la agrupación de almacenamiento intermedio, haga lo siguiente:
    1. Conéctese a la base de datos de Jazz a la que desee importar escribiendo lo siguiente en el indicador de mandatos:
      db2 connect to <databaseName>
    2. A continuación, ejecute el mandato siguiente:
      db2 "select bufferpoolid, bpname from syscat.bufferpools"
      Ello dará como resultado un identificador de agrupación de almacenamiento intermedio en este formato:
      BUFFERPOOLID BPNAME
      ------------ ----------------------------------
                 1 IBMDEFAULTBP
      
        1 record(s) selected.
    3. En el ejemplo anterior, el identificador de agrupación de almacenamiento intermedio is 1. A continuación, ejecute el mandato siguiente:
      db2mtrk -d
      Ello dará como resultado datos similares a los siguientes:
      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
      El resultado bold indica el tamaño de agrupación de almacenamiento intermedio asignada para la base de datos.
Oracle:
  • Inhabilitar papelera de reciclaje: ello realiza el seguimiento de todos los elementos que se supriman, rellena el disco y puede causar problemas efectivamente. Ejecute los mandatos siguientes en sqlplus:
    "ALTER SYSTEM SET RECYCLEBIN" = 'OFF' 
    "PURGE RECYCLEBIN"
  • Inhabilitar retención de historial de estadísticas: ello realiza el seguimiento del tiempo de ejecución de métodos pasados:
    "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 abarca sólo un único archivo

Para iniciar la migración:

  1. Detenga Jazz Team Server de versión X. Para detener Jazz Team Server, 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 sólo una medida de precaución en caso de que algo vaya mal con la migración.
    1. Para Derby, realice una copia archivada de todo el directorio 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 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 está especificada en la propiedad com.ibm.team.fulltext.indexLocation del archivo teamserver.properties.
  4. Ejecute repotools para exportar los datos en el 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: La información de registro y los mensajes de error se muestran en la consola y en un archivo de registro. El archivo de registro contiene información de depuración acerca de número de elementos exportados, hora de exportación de elementos, errores y otra información útil. El archivo de registro se crea de forma predeterminada en el mismo directorio que el script repotools. Puede cambiar la ubicación del archivo de registro utilizando el parámetro logFile.
    Ahora ha exportado el contenido del repositorio a un archivo TAR.
  5. Copie el archivo teamserver.properties de [installDir]/jazz/server de versión X a [installDir]/jazz/server de versión Y.
  6. Desde versión Y, ejecute repotools para importar los datos desde el archivo TAR al repositorio.
    Ejemplo: repotools -import fromFile=./file_name.tar
    Importante: Si su 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 saltados, así como de errores durante la importación.
Qué hacer a continuación
Ahora puede iniciar Jazz Team Server de versión Y.

Comentarios