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.
Por qué y cuándo se efectúa esta tarea
Por lo general, la migración de datos es
un proceso de dos pasos:
- Exportación de datos que se encuentran en la versión
X del repositorio de Jazz
a un archivo TAR.
- Importación de datos del archivo TAR a la versión
Y del repositorio de Jazz.
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:
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:
- 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>
- 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.
- 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.
Para
iniciar la migración: