Este tema describe el proceso manual para actualizar Rational Team Concert versión
2 a la versión 3.0.1.
Antes de empezar
Antes de actualizar el servidor, asegúrese de que cuenta con una copia de seguridad reciente y válida de la base de datos de repositorio de Rational Team Concert v2.
Asegúrese de que los relojes de todas
las máquinas están sincronizados mediante el protocolo de hora en red (NTP). La hora es el elemento crítico que permite que un evento de un
nodo de red se correlacione con un evento correspondiente de otro. Para evitar problemas, se pueden superar estos retos
mediante el despliegue empresarial del servicio NTP. Para obtener más información sobre
NTP, visite http://www.ntp.org/ Además,
todos los servidores deben utilizar el mismo método de autenticación para los usuarios.
Si utiliza Derby para el servidor Rational
Team Concert v2, asegúrese de que la base de datos de repositorio se copia de RTC2.X_install_dir/server/repositoryDB al directorio 3.0.1CCM_install_dir/server/conf/jazz/derby .
Si pretende actualizar varios productos, consulte Orden de actualización para que le ayude a decidir qué actualizar primero.
Procedimiento
- Revise los temas de la sección en Planificación del despliegue y de la actualización según sea necesario.
- Verifique el archivo teamserver.properties existente de la versión 2 para la propiedad del URL público com.ibm.team.repository.server.webapp.url.
Debe utilizar el mismo URL público en la versión 3.0.1. Si no se ha establecido el URL público, utilice la interfaz de web administrativa de la versión 2 (Propiedades avanzadas) para establecer el URL de nombre de host calificado (https://hostname.example.com:port) antes de la actualización.
La línea de URL público en teamserver.properties debe parecerse a:
com.ibm.team.repository.server.webapp.url=https\://<hostname.example.com>\:9443/jazz
- Cierre el servidor de la versión 2.
- Si no lo tiene instalado, instale Jazz Team Server y la aplicación de Gestión de cambios y configuración (CCM) en una ubicación nueva. Si ya ha instalado Jazz Team
Server, instale la aplicación de Gestión de cambios y configuración.
- Durante la instalación, seleccione Utilizar raíz de contexto de Rational Team
Concert 2.x para conservar la raíz de contexto /jazz.
- Al final de la instalación, seleccione Ninguno
en Qué programa desea iniciar.
- Cree una base de datos distinta para Jazz Team Server con los
mismo parámetros, pero con un nombre de base de datos diferente que su base de datos de v2. Para obtener más información sobre la creación
de bases de datos, consulte Configuración de la base de datos.
Nota: Se necesita una base de datos Jazz Team Server separada de la base de datos de CCM.
Cree una base de datos de Jazz Team Server nueva si no lo ha hecho todavía.
Importante: Abra ventanas de línea de mandatos independientes para
ejecutar los mandatos repotools de la versión 2 y la versión 3. Utilice ventanas de línea de mandatos independientes para garantizar que no hay conflictos
entre la variables de entorno utilizadas por los mandatos de la versión 2 y la versión 3.
- Vaya a <3.0.1CCM_install_dir>/server y ejecute el siguiente mandato para fusionar el archivo de configuración de Jazz y Tomcat (amigos incluidos).
repotools-jazz -migration_ccm_updateConfigurationFiles oldApplicationHome=<dir_instalación_2.x>/server/conf
De
forma predeterminada, el mandato -migration_ccm_updateConfigurationFiles
actualiza los archivos de configuración de Jazz y de Tomcat. Si no está instalado Tomcat y desea actualizar
sólo los archivos de configuración de Jazz, debe especificar
el parámetro updateTomcatFiles=false.
Las siguientes tareas se completan con el mandato
-migration_ccm_updateConfigurationFiles :
- Archivos de configuración de Jazz:
- teamserver.properties (fusiona 1 archivo de Rational Team Concert
en 2 archivos para el servidor del equipo y la aplicación)
- friendsconfig.rdf (copia 1 archivo de Rational Team Concert
en 1 archivo de aplicación)
- Archivos de Tomcat:
- tomcat-users.xml (copias)
Recuerde: Sólo para base de datos de usuario Tomcat. Se copia el archivo tomcat-users.xml (no se fusiona con el archivo existente). Si está actualizando varias aplicaciones CLM con un JTS común, debe fusionar manualmente la información de grupo y usuarios en el archivo tomcat-users.xml. La información de grupo y usuario será diferente si los usuarios son parte de diferentes grupos en diferentes aplicaciones.
Por ejemplo, userA tiene JazzAdmins en CCM y rol JazzUsers en QM. Además, si algunos usuarios están presentes en una aplicación y no en la otra o viceversa, deben añadirse manualmente al archivo tomcat-users.xml.
- server.xml (fusiones)
- Archivos web.xml contenidos en los archivos war de aplicación (fusiona 1 archivo de Rational Team Concert en 2 archivos para el servidor del equipo y la aplicación)
Importante: Es posible que haya modificado otros
archivos en Rational Team Concert versión 2; por ejemplo, el archivo log4j.properties. Debe fusionar estos
archivos de forma manual.
Para obtener detalles acerca del mandato repotools, consulte -migration_ccm_updateConfigurationFiles.
Recuerde: En los siguientes ejemplos, la ubicación del archivo teamserver.properties se basa en la instalación predeterminada. Si ha modificado el diseño del archivo para el despliegue,
asegúrese de que está utilizando las ubicaciones correctas.
Además, en los siguientes pasos
se da por supuesto que el despliegue se ha realizado en un solo servidor.
De forma predeterminada, el valor del parámetro newJTSHome se deriva de newApplicationHome. Si va a utilizar servidores distintos para CCM y Jazz Team Server, especifique el parámetro newJTSHome para apuntar a la ubicación de Jazz Team Server. Esta forma, las propiedades de ubicación de la base de datos, correo electrónico y LDAP se fusionarán desde el archivo teamserver.properties de Rational Team Concert versión 2.
Igualmente, los archivos de configuración tomcat se copiarán a la ubicación de Jazz Team Server.
- Compruebe que cada archivo de propiedades actualizado contiene la siguiente información:
- Las propiedades se copiaron desde el archivo teamserver.properties de la versión 2.
- Entradas válidas del proveedor de base de datos (asegúrese de que existe la base de datos especificada en /conf/jts/teamserver.properties ).
Para obtener más información, consulte el apartado Verificación de los archivos de configuración durante la actualización.
- Verifique que friendsconfig.rdf se copia de <RTC2.X_install_dir>/server/conf/jazz a <3.0.1CCM_install_dir>/server/conf/jazz.
- Verifique que se copió tomcat-users.xml .
- Abra el archivo server.xml de la versión 3 y verifique que contiene la información de la versión 2 (números de puerto, valores LDAP y otras modificaciones).
- Abra el archivo web.xml de la versión 3 y verifique que contiene la información de la versión 2 (valores LDAP y otras modificaciones).
- Verifique que existe un URL público diferenciado y válido com.ibm.team.repository.server.webapp.url en los archivosteamserver.properties . (El URL para la aplicación CCM debe ser el mismo que el que se ha utilizado con Rational Team Concert versión 2.)
- Abra una ventana de mandatos y vaya al directorio <3.0.1CCM_install_dir>/server .
- Ejecute el siguiente mandato para añadir tablas a la base de datos:
repotools-jazz -addTables
- Ejecute el siguiente mandato para exportar información de usuario desde la base de datos de Rational Team Concert:
repotools-jazz -migration_exportJTSData toFile=jtsData.tar
Nota: Si va a seguir este proceso más de una vez, utilice un nombre de archivo distinto para el segundo archivo tar. Por ejemplo, utilice jtsData2.tar.
- ejecute el siguiente mandato para importar información de usuario a la base de datos de Jazz Team Server:
Nota: Si no utiliza la base de datos de Derby predeterminada, asegúrese de que la base de datos de Jazz Team Server a la que se hace referencia en el archivoconf/jts/teamserver.properties es una nueva base de datos y se ha creado y existe.
repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=rtc-mapping.txt createTables
Nota: Si va a seguir este proceso más de una vez, utilice un nombre de archivo distinto para el segundo archivo tar. Por ejemplo, utilice jtsData2.tar.
Atención: Al importar los datos de Jazz Team Server de la segunda instalación de la aplicación CCM, no utilice el parámetro
createTables.
Si las aplicaciones CLM ya están instaladas en Jazz Team Server y utiliza el parámetro createTables, perderá los datos de usuario del
servidor.
- Ejecute el siguiente mandato para exportar la información de usuario de Jazz Team Server a la base de datos de Rational Team Concert:
repotools-jazz -migration_importUserMapping fromMappingFile=rtc-mapping.txt
- Ejecute el siguiente mandato para recrear los índices de texto:
repotools-jazz -rebuildTextIndices
- Ejecute el siguiente mandato para recrear los índices Lucene y RDF:
repotools-jazz -reindex
- Si el producto de la versión 2 tenía una ubicación de índice no predeterminada y desea continuar para utilizar una ubicación personalizada para los índices, debe modificar el archivo teamserver.properties de la versión 3.0.1 para añadir la ubicación de índice.
- Cambie el valor de com.ibm.team.fulltext.indexLocation=conf/jts/indices/workitemindex
a la ubicación de vía de acceso completa del índice de texto completo. Por ejemplo, com.ibm.team.fulltext.indexLocation=c:/indices/workitemindex.
- Cambie el valor de com.ibm.team.jfs.index.root.directory=indices
por la ubicación de vía de acceso completa del directorio raíz de índice JFS. Por ejemplo, com.ibm.team.jfs.index.root.directory=c:/indices.
- Verifique lo siguiente:
- Asegúrese de que la ubicación de la base de datos Jazz Team Server es diferente de la ubicación de la base de datos de la aplicación.
- Asegúrese de que el índice y otras propiedades relacionadas con el archivo no se comparten entre la aplicación y Jazz Team Server.
- Asegúrese de que el archivo friendconfig.rdf se renombra a friendconfig.rdf.saved.
- Si está utilizando Apache Tomcat, consulte Configuración de Apache Tomcat.
- Si está utilizando WebSphere Application Server, desinstale las
aplicaciones web instaladas anteriormente y vuelva a desplegar los archivos
jts.war, ccm.war
y clmhelp.war proporcionados con la instalación 3.0.1.
Para obtener detalles adicionales, consulte Configuración de WebSphere Application Server para la actualización de la versión 3.
- Configure el servidor y cualquier aplicación CLM que instaló.
Ejecute el asistente de configuración del servidor si está actualizando Jazz Team Server junto con la Gestión de cambios y configuración o cualquiera de las aplicaciones de CLM. (Consulte Ejecutar el asistente de configuración) Utilice la interfaz web administrativa si está añadiendo la aplicación Gestión de cambios y configuración a un Jazz Team Server establecido. (consulte Registrar aplicaciones con Jazz Team Server.