Actualización a Rational Team Concert for System z 2.0.0.2

Existen varios escenarios que puede seguir para actualizar de versiones anteriores a Rational Team Concert for System z 2.0.0.2.

En general, puede actualizar los clientes y servidores de Rational Team Concert for System z ejecutando un archivo .zip o utilizando IBM Installation Manager en plataformas que no sean z/OS.

El proceso para actualizar a Rational Team Concert for System z 2.0.0.2 es parecido al de actualizar a Rational Team Concert 2.0.0.2, salvo por las siguientes consideraciones:
Puede realizar una actualización a Rational Team Concert for System z 2.0.0.2 de varias maneras, incluidos los siguientes escenarios:
Instalación de idiomas adicionales al realizar la actualización: Si utiliza IBM® Installation Manager para instalar Rational Team Concert for System z 2.0.0.2 en un sistema donde Rational Team Concert for System z no está instalado actualmente, Installation Manager le pedirá que seleccione los idiomas que desea instalar. Sin embargo, si realiza una actualización desde una versión anterior a Rational Team Concert for System z 2.0.0.2, Installation Manager dará por supuesto que desea utilizar los idiomas ya configurados, por lo que no le pedirá que seleccione los idiomas. Para seleccionar otros idiomas, una vez haya realizado la actualización a la versión 2.0.0.2, seleccione Modificar en la pantalla principal de Installation Manager, y, a continuación, seleccione la opción que aparece. La siguiente pantalla le mostrará una lista de los idiomas disponibles. Seleccione los que necesite utilizar.
Si inicia Jazz Team Server for System z después de realizar una actualización a la versión 2.0.0.2 y selecciona antes Modificar para añadir o eliminar idiomas, deberá restablecer el servidor del siguiente modo:
  1. En un navegador web, vaya a https://server-host:9443/jazz/admin.action=com.ibm.team.repository.admin.serverReset.
  2. Pulse Solicitar restablecimiento del servidor.
  3. Cierre el servidor.

A continuación, podrá seleccionar Modificar en Installation Manager para añadir o eliminar idiomas.

Consejo: Para los problemas conocidos de Rational Team Concert for System z o información de instalación adicional, vaya a la página Rational Team Concert for System z Release Notes en Jazz.net.

Actualización de un cliente de Rational Team Concert for System z para el IDE de Eclipse

La versión de cualquier cliente del entorno de desarrollo integrado (IDE) de Eclipse debe ser 2.0.0.1 o superior para poder conectarse a un servidor v2.x. Aunque un cliente de Rational Team Concert for System z 2.0.0.1 se conectará a un servidor 2.0.0.2, se recomienda instalar el cliente de Rational Team Concert for System z 2.0.0.2 para conectarse al servidor de Rational Team Concert for System z 2.0.0.2. Podrá instalar este cliente utilizando un archivo ZIP o actualizar las instalaciones de IBM Installation Manager anteriores.
Nota: Los clientes de Rational Team Concert 2.0 pueden conectarse a los servidores de Rational Team Concert for System z 2.0; sin embargo, los clientes de Rational Team Concert no podrán utilizar las funciones específicas de Rational Team Concert for System z.

Actualización de un servidor desde un release de prueba a un release permanente

Desde el release de prueba 2.0, puede convertir el servidor en permanente adquiriendo e instalando el kit de activación de servidor que corresponda a su edición del Rational License Key Center. Los detalles se encuentran disponibles aquí: http://www.ibm.com/software/rational/support/licensing. El kit de activación consta de un archivo .jar que contiene la clave de servidor permanente. Se instala mediante la página Gestión de claves de licencia de la interfaz web de administrador del servidor.

Actualización de un servidor desde Rational Team Concert o Rational Team Concert for System z 1.0.1

Puede realizar actualizaciones directas al release 2.0 de Rational Team Concert for System z desde releases anteriores de Rational Team Concert o Rational Team Concert for System z. Es necesaria una migración de las bases de datos.

Nota: Antes de comenzar la actualización de una versión de WebSphere Application Server, restablezca el servidor navegando hasta https://servername:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset y pulsando en Solicitar restablecimiento del servidor.

Si ha instalado el release anterior desde un archivo .zip (por ejemplo en Linux® for System z), no se producirá ninguna intersección con la instalación anterior. Puede instalar el release 2.0 desde un archivo zip en una nueva ubicación o bien utilizar IBM Installation Manager para instalar una instancia de 2.0.

Si ha utilizado IBM Installation Manager para instalar el release anterior, puede instalar la versión 2.0 como una instancia distinta o bien actualizar la instancia anterior a la 2.0 Si instala una instancia distinta del servidor para el release 2.0, seleccione Crear nuevo grupo de paquetes en la página Instalar paquetes del asistente de instalación.

Nota: Para actualizar un despliegue de WebSphere Application Server de Jazz Team Server for System z, elimine el archivo jazz.war anterior y despliegue el archivo 2.0 jazz.war.

Para completar la actualización, consulte el apartado Copia de los archivos de configuración obligatorios desde una instalación del servidor anterior. y Instalación de las claves de activación de la versión 2.0.

Actualización de Rational Team Concert for System z 1.0.1 en z/OS

Se han realizado cambios estructurales en la base de datos del repositorio en la versión 2.0 que impedirán que vuelva a utilizar la base de datos de Rational Team Concert for System z 1.0.1 en z/OS. El proceso de actualización a la versión 2.0 desde Rational Team Concert for System z v1.0.1 consta de estos tres pasos:
  1. Exportar el contenido de la base de datos de la versión 1.0.1 utilizando las herramientas del repositorio.
  2. Instalar y configurar Jazz Team Server for System z v2.0 en la plataforma de destino que desee. Se creará una nueva base de datos durante este paso. Consulte el apartado Instalación de Rational Team Concert for System z en z/OS para obtener información sobre la instalación de Jazz Team Server for System z 2.0 en su plataforma de destino.
  3. Importar el archivo .tar creado en el paso número uno a la base de datos del repositorio de la versión 2.0 utilizando las herramientas del repositorio.
Exportación de la base de datos de repositorio de Rational Team Concert for System z 1.0.1
Utilice el miembro BLZEXPOR de hlq101.SBLZSAMP para exportar el contenido de la base de datos del repositorio. La muestra JCL de este miembro utiliza el mandato exportar de las herramientas del repositorio para crear un archivo .tar que incluye el contenido del repositorio.

Configure BLZEXPOR siguiendo las instrucciones que se incluyen en el JCL de muestra. Envíe el JCL modificado y compruebe el registro de trabajo. El trabajo solo se habrá ejecutado correctamente si termina con el código de retorno 300.

El archivo de exportación se colocará en la ubicación HFS especificada por @jazzExport@. El nombre del archivo será @dbexport@.tar, tal y como se especifica en BLZEXPOR.

Importación de la base de datos exportada en Jazz Team Server for System z v2.0 en z/OS
Importación a una base de datos Derby en z/OS
Utilice el miembro BLZIMPO2 en hlq200.SBLZSAMP para importar el archivo .tar versión 1.0.1 en la base de datos Derby de Jazz Team Server for System z v2.0. Configure BLZIMPO2 tal y como se describe en los comentarios del JCL, especificando el archivo .tar exportado desde la base de datos v1.0.1.

Envíe el JCL modificado y compruebe el registro de trabajo para comprobar que las herramientas del repositorio se completaron correctamente.

Importación a una base de datos DB2 en z/OS
Utilice el miembro BLZIMPOR en hlq200.SBLZSAMP para importar el archivo .tar versión 1.0.1 en la base de datos DB2 de Jazz Team Server for System z v2.0. Configure BLZIMPOR tal y como se describe en los comentarios del JCL, especificando el archivo .tar exportado desde la base de datos v1.0.1.

Envíe el JCL modificado y compruebe el registro de trabajo para comprobar que las herramientas del repositorio se completaron correctamente.

Para completar la actualización, consulte el apartado Copia de los archivos de configuración obligatorios desde una instalación del servidor anterior..

Actualización de un servidor de Rational Team Concert for System z desde la versión 2.0.0.1 a la 2.0.0.2

Puede realizar una actualización directamente al release de Rational Team Concert for System z 2.0.0.2 desde releases anteriores. Es posible que sean necesarias acciones adicionales para las actualizaciones de repositorio; consulte la página Rational Team Concert for System z Release Notes en Jazz.net para obtener más detalles.

Nota: Antes de comenzar la actualización de una versión de WebSphere Application Server, restablezca el servidor navegando hasta https://servername:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset y pulsando en Solicitar restablecimiento del servidor.

Si ha instalado el release anterior desde un archivo .zip (por ejemplo en Linux for System z), no se producirá ninguna intersección con la instalación anterior. Puede instalar el nuevo release desde un archivo zip en una nueva ubicación o bien utilizar IBM Installation Manager para instalar una instancia de 2.0.

Si ha utilizado IBM Installation Manager para instalar el release anterior, puede instalar la versión 2.0 como una instancia distinta o bien actualizar la instancia anterior a la 2.0 Si instala una instancia distinta del servidor para el release 2.0, seleccione Crear nuevo grupo de paquetes en la página Instalar paquetes del asistente de instalación.

Nota: Para actualizar un despliegue de WebSphere Application Server de Jazz Team Server for System z, elimine el archivo jazz.war anterior y despliegue el archivo 2.0 jazz.war.

Para completar la actualización, consulte el apartado Copia de los archivos de configuración obligatorios desde una instalación del servidor anterior. y Instalación de las claves de activación de la versión 2.0.

Actualización de un servidor desde una edición de Rational Team Concert for System z a otra

Las ediciones de Rational Team Concert for System z (Starter, Standard y Enterprise) e suministran en modalidad de prueba. Para actualizar de una versión a otra, tiene que cargar un conjunto combinado de de claves de activación de prueba para su edición de destino. Esta s claves de prueba combinadas puede descargarlas en https://jazz.net/downloads/rational-team-concert-z/.

Las claves de activación de prueba combinadas están incluidas en un archivo .zip de su edición de destino. Este archivo .zip combinado se instala utilizando la página de gestión de claves de licencia de la interfaz web administrativa del servidor.

Rational Team Concert for System z se distribuye como modalidad de prueba de Starter Edition únicamente para instalarse en z/OS en la versión 2.0.0.1 y Standard Edition en la versión 2.0.0.2. Si tiene que actualizar a otra edición de Rational Team Concert for System z en z/OS, tiene que actualizar primero a la edición que necesita y, a continuación, cargar los kits de activación del servidor permanentes y las licencias de acceso de cliente de su edición.

Actualización desde Rational Team Concert for System z 2.0.0.1 a Rational Team Concert for System z 2.0.0.2 en z/OS

El paquete de instalación SMP/E contiene RTCz 2.0.0.1. Necesita PTF para actualizar los componentes de z/OS a 2.0.0.2. Los PTF se encuentran disponibles en ShopzSeries, IBM Support Portal, Jazz.net o el canal de servicio normal.

Busque los siguientes APAR y ordene los PTF correspondientes: PM04798, PM04800, PM04802, PM05340, PM05341, PM05342 y PM05701.

Estos PTF se aplican a la instalación base de Rational Team Concert for System z 2.0.0.1 mediante SMP/E. En los PTF, se incluye información adicional acerca de los pasos para aplicarlos.

Se requieren pasos de configuración adicionales para actualizar la configuración existente después de aplicar los PTF.

Actualizaciones de configuración de WebSphere Application Server

Los siguientes pasos son necesarios para configurar de forma correcta WebSphere Application Server in Rational Team Concert for System z 2.0.
  1. Asegúrese de que están instalados los fixpack de WebSphere Application Server más recientes y el SDK de Java™ asociado. Si realiza el despliegue en WebSphere Application Server 7.0, es esencial que al menos WebSphere Application Server 7.0.0.3 esté instalado. Con WebSphere Application Server 6.1, es esencial que al menos esté instalado WebSphere Application Server 6.1.0.25.
  2. Elimine las propiedades JVM personalizadas anteriores:
    1. com.ibm.team.repository.provision.profile
    2. com.ibm.team.server.configURL
    3. log4j.configuration
  3. Si no está disponible todavía, añada la nueva propiedad JVM personalizada JAZZ_HOME y establezca su valor como:
    file:///<JazzInstallDir>/server/conf
    en sistemas diferentes a z/OS.
    En sistemas diferentes a z/OS, establezca el valor como:
    file:///@confPath@
    donde @confPath@ es una vía de acceso de configuración establecida en BLZCPDIR.
  4. Asegúrese de que esté seleccionada la configuración de WebSphere Application Server: Utilizar datos de autenticación disponibles cuando se acceda a un URI sin protección. Si va a utilizar la consola de soluciones integradas (Integrated Solutions Console) de WebSphere Application Server, realice lo siguiente:
    1. Navegue hasta Seguridad > Administración, aplicaciones e infraestructura seguras > Seguridad web - Valores generales.
    2. Seleccione Utilizar datos de autenticación disponibles cuando se acceda a un URI sin protección.
  5. Asegúrese de que ha desplegado el archivo jazz.war de Rational Team Concert for System z. El archivo jazz.war debe actualizarse a la versión más reciente de Rational Team Concert for System z.

Copia de los archivos de configuración obligatorios desde una instalación del servidor anterior.

Copie los siguientes archivos desde el servidor de origen en el servidor de destino. En primer lugar, cambie el nombre de los archivos originales de la instalación del servidor actualizada para crear copias de seguridad. Si ha utilizado IBM Installation Manager para realizar una actualización a Rational Team Concert for System z 2.0, se habrá creado un directorio de copia de seguridad con los archivos de configuración de la versión 1.0.1 con un nombre como backup-config-<timestamp> en el subdirectorio del servidor de la ubicación de instalación.

Si va a realizar una actualización a la edición Standard o Enterprise y ha adquirido el Developer Client Activation Kit para la edición Starter, debe comprar e instalar el Developer Client Activation Kit para las ediciones Standard o Enterprise a fin de poder utilizar esas licencias de cliente. Las asignaciones de licencias de desarrollador seguirán activas, pero las licencias de desarrollador se desactivarán hasta que no se instale el kit de activación correcto.

Instalación de las claves de activación de la versión 2.0

El release de Rational Team Concert for System z 2.0 utiliza las claves de activación de Rational Team Concert for System z 2.0. Si se actualiza un servidor desde la versión 1.0.1 a la 2.0 o desde Rational Team Concert a Rational Team Concert for System z, después de la actualización volverá a una licencia de prueba y deberá obtener las claves de activación de Rational Team Concert for System z 2.0 en el Rational License Key Center. A continuación figuran los nombres de las claves aplicables de cada kit:

  • IBM Rational Team Concert for System z Starter Edition - Server License Activation Kit V2.0 Multiplatform (jazz_team_server_starter_zSeries-release.jar)
  • IBM Rational Team Concert for System z Starter Edition - Developer Client License Activation Kit V2.0 Multiplatform (rtcz_starter_developer_unlocked.jar)
  • IBM Rational Team Concert for System z - Contributor Client License Activation Kit V2.0 Multiplatform (rtcz_all_contributor_unlocked.jar)
  • IBM Rational Team Concert for System z Standard Edition - Server License Activation Kit V2.0 Multiplatform (jazz_team_server_standard_zSeries-release.jar)
  • IBMRational Team Concert for System z Developer Client License Activation Kit V2.0 Multiplatform (rtcz_standard_developer_unlocked.jar)
  • IBM Rational Team Concert for System z Floating Developer Client License Activation Kit V2.0 Multiplatform (rtcz_std_floating-developer_unlocked.jar)
  • IBM Rational Team Concert for System z - Floating Contributor Client License Activation Kit V2.0 Multiplatform (rtcz_std_floating-contrib_unlocked.jar)
  • IBMRational Team Concert for System z Enterprise Edition - Server License Activation Kit V2.0 Multiplatform (jazz_team_server_enterprise_zSeries-release.jar)

Configuración de una línea de tiempo de proyecto

En Rational Team Concert 1.0.1 o Rational Team Concert for System z 1.0.1, los proyectos pueden tener varias líneas de tiempo (anteriormente denominadas "líneas de desarrollo") y todas estas líneas se consideraban iguales.

En Rational Team Concert for System z 2.0, los proyectos pueden seguir teniendo varias líneas de tiempo, pero solo una de ellas se puede marcar como la "línea de tiempo del proyecto". Al migrar la base de datos a la versión 2.0, la línea de tiempo primaria del proyecto no se conoce, por lo que los proyectos no tendrán una línea de tiempo de proyecto establecida. Podrá actualizar de forma manual los proyectos para establecer la línea de tiempo de proyecto después de que realice la actualización a la versión 2.0.

Configuración de la instantánea de gestión de control de código fuente

La instantánea de gestión de control de código fuente (SCM) para el depósito de datos recopila datos sobre las corrientes, incluida la información sobre el tamaño de las corrientes y la actividad (conjunto de cambios y cambios en archivos/carpetas) dentro de él. En la versión 1.0.1, esta instantánea recopilaba de forma automática información sobre todas las corrientes. Dado que puede ser una operación cara, en la versión 2.0, se han añadido opciones de configuración a la instantánea de SCM para permitirle decidir cuáles son las corrientes que deben recopilar los datos. El efecto inmediato de este cambio es que no se recopilará ningún dato, salvo que configure la instantánea.

Para configurar la instantánea de SCM, realice los pasos siguientes:
  1. Debe tener permiso de escritura para la corriente para lo que desea recopilar los datos.
  2. Vaya a la página Informes en la interfaz web de Rational Team Concert for System z.
  3. En el panel de navegación situado a la izquierda, seleccione Administrar instantánea de SCM. Se mostrará una lista de corrientes.
  4. Seleccione Una o varias corrientes y, a continuación, elija Guardar cambios.

Se recopilarán datos para las corrientes seleccionadas en todas las instantáneas posteriores.

Cambios incompatibles con informes BIRT

Si ha utilizado el diseñador de informes BIRT para crear sus propias plantillas de informe, es posible que se encuentre con algún problema cuando intente utilizar estos informes en la versión 2.0. Tenga en cuenta las siguientes cuestiones:
  • Cambios en el orden de resolución de las clases Java y JavaScript™: si ha escrito código JavaScript en el informe BIRT que utiliza la sentencia importPackage() para importar el paquete java.lang, tenga en cuenta que las referencias sin calificar de Object en el código, que antes se referían a la clase Java es posible que se refieran ahora a la clase JavaScript y, por lo tanto, no funcionen de forma correcta. Otras clases con nombres idénticos entre JavaScript y Java, como java.util.Date, pueden presentar el mismo problema. La solución es calificar de forma plena la referencia a la clase Java y eliminar la sentencia importPackage().
  • Cambios en el proceso del conjunto de datos: en el pasado, el acto de enlazar un elemento (como una etiqueta) a un conjunto de datos, hacía que se procesaran los conjuntos de datos en su totalidad cuando se representaba el elemento. Esto resultaba útil porque significaba que podía imponer un orden en el proceso de los conjuntos de datos utilizando etiquetas ocultas enlazadas a los conjuntos de datos en el orden en que debían procesarse. Ahora, un enlace de este tipo solo procesará la primera fila del conjunto de datos. Para aplicar el comportamiento anterior, utilice un elemento de texto dinámico e invoque cierto código JavaScript, que forzará el proceso del conjunto de datos completo. Total.count() es una buena opción.
  • Los errores del diseñador de informes BIRT pueden causar pérdidas de datos: Estos problemas surgen cuando se abre un archivo de diseño de informes BIRT creado en BIRT 2.2.2 (Rational Team Concert 1.0) con el diseñador de informes BIRT 2.3.2 (Rational Team Concert 2.0). Se han observado los siguientes problemas:
    • Al editar un conjunto de datos por primera vez con BIRT 2.3.2, en la página Parámetros, es posible que hayan desaparecido los campos Valor predeterminado y Parámetro de informe. La solución es volver a especificar los valores o copiar y pegar los valores de una versión anterior del editor. Una vez guardado el archivo con los nuevos valores, no volverá a producirse el problema.
    • Al editar un archivo de diseño de informes por primera vez con BIRT 2.3.2, es posible que se haya perdido el valor predeterminado de los parámetros del informe. Es posible que esto suceda después del anterior problema descrito. La solución es volver a especificar los valores o copiar y pegar los valores de una versión anterior del editor. Una vez guardado el archivo con los nuevos valores, no volverá a producirse el problema.
    Nota: Estos problemas pueden ser muy graves si no se tienen en cuenta, dado que los datos recogidos en el informe podrían ser incorrectos. Compruebe todos los conjuntos de datos y los parámetros del informe al editarlo por primera vez con el diseñador de informes BIRT 2.3.2. Estos problemas no se producirán con los nuevos informes creados con las herramientas de BIRT 2.3.2.

    Los cambios anteriores se realizan en todos los informes predefinidos de Rational Team Concert for System z 2.0. No requieren ninguna acción por parte del usuario. Sin embargo, si ha creado plantillas de informes de forma manual en el área de proyecto con uno de los informes predefinidos de Rational Team Concert for System z 2.0 y no ha especificado un identificador adecuado (coherente con el uso de Rational Team Concert for System z), la plantilla de informe no se renovará cuando se migre. Es decir, el contenido quedará obsoleto y no funcionará. En ese caso, deberá cargar un contenido nuevo para las plantillas afectadas mediante el archivo predefinido .rptdesign.

Importación de los datos de elementos de trabajo en el depósito de datos

En Rational Team Concert for System z 2.0, existen varios cambios de esquema en las tablas de elementos de trabajo del depósito de datos. Como consecuencia de ello, al migrar desde la versión 1.0.1 a la 2.0, el importador no tendrá en cuenta los datos sobre los elementos de trabajo en el depósito. Como resultado, cuando inicia el servidor 2.0 por primera vez, es posible que los informes sobre elementos de trabajo no funcionen correctamente. La solución es esperar a que la instantánea de los elementos de trabajo se ejecute por primera vez o elemento de trabajo o hacer que se ejecute de forma manual una vez iniciado el servidor. En la primera ejecución tras la migración, la instantánea de los elementos de trabajo reconstituirá la información sobre el historial completo de los elementos de trabajo en el depósito de datos. Esto también significa que es muy probable que la primera ejecución de la instantánea tras la migración lleve más tiempo que el promedio de una ejecución nocturna.

Descubrimiento de informes nuevos

En Rational Team Concert for System z 2.0, se han añadido varios informes nuevos. Aunque estos informes aparecen en las plantillas de proceso nuevo que se entregan con Rational Team Concert for System z, no se añaden de forma automática a las áreas de proyecto al realizar la migración de los datos a Rational Team Concert for System z 2.0. Para descubrir y desplegar estas nuevas plantillas de informes en las áreas de proyecto existentes después de la migración, realice estos pasos:
  1. En el cliente Eclipse, abra la vista Artefactos de equipo.
  2. Expanda el área de proyecto e Informes.
  3. Pulse con el botón derecho del ratón sobre Plantillas de informe y seleccione Desplegar plantillas nuevas.

El diálogo que se abre le ayudará a descubrir cualquier plantilla de informe que esté disponible, pero no se haya desplegado todavía en el área de proyecto. Puede seleccionar una o varias y se crearán. Después de la creación, podrá crear otros informes a partir de esas plantillas con las acciones de menú disponibles.

Personalizaciones

Los cambios que realice en los tipos de elemento de trabajo, flujos de trabajo, roles y manejadores de sucesos se conservan después de actualizar desde la versión 1.0.1 a la 2.0. Si ha personalizado una plantilla de proceso predefinida (como Scrum), tenga en cuenta que si vuelve a desplegar la plantilla predefinida (en la vista Plantillas de proceso), se sobrescribirán las personalizaciones. Si necesita volver a desplegar la plantilla predefinida, deberá cambiar primero el nombre y el ID de la plantilla predefinida que haya personalizado para que no se sobrescriba.


Comentarios

¿Le ha servido de ayuda? Puede incluir sus comentarios en Jazz.net (registro obligatorio): Comentarios en el foro o envíe un error