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:
- Exportación de los datos que hay 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 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:
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
a la que quiere importar escribiendo los 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:
- 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.
- 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.
- En el caso de Derby, realice una copia archivada del directorio entero
de la base de datos.
- 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.
- 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.
- 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.
- Copie el archivo teamserver.properties
de [installDir]/jazz/server de la versión X a [installDir]/jazz/server de
la versión Y.
- 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.tarNota: 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.