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.
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:
- Exportación de los datos que están en la versión X del repositorio de Jazz
a un archivo TAR.
- Importación de los datos del archivo TAR a la versión Y del repositorio de Jazz.
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 necesario 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 "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:
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:
- Conéctese a la base de datos de Jazz que desea importar escribiendo lo siguiente
en el indicador de mandatos:
db2 connect to <databaseName>
- 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).
- 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.
Para iniciar la migración: