Actualización de 3.0 a 3.0.1 utilizando el script de actualización

Este tema describe los pasos necesarios para actualizar Jazz Team Server y la Gestión de cambios y configuración de la versión 3.0 a la 3.0.1.

Antes de empezar

Antes de actualizar el servidor, asegúrese de que tiene una copia de seguridad completamente actualizada y válida de la base de datos de repositorio de Rational Team Concert y Jazz Team Server v3.0.

Además, asegúrese de que los relojes en todas las máquinas estén sincronizados utilizando el NTP (Network Time Protocol - Protocolo de hora en red). 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 pretende actualizar varios productos, consulte Orden de actualización para que le ayude a decidir qué actualizar primero.

Importante: Para utilizar el script de actualización en un entorno distribuido donde instaló Gestión de cambios y configuración por separado desde Jazz Team Server, el script de actualización tiene que poder acceder a la unidad o al sistema de archivos donde está instalado Jazz Team Server. En Windows, por ejemplo, la correlación debe tener la forma <mapped drive letter>:\server\conf. Una vía de acceso absoluta (\\<machine name>\<installdir>server\conf) no funcionará. La unidad montada se tiene que configurar con privilegios lectura-escritura-ejecución para la cuenta de administrador.
Si está utilizando la base de datos de Derby, copie las bases de datos JTS y CCM de 3.0 a 3.0.1. Para obtener más información, consulte el apartado Copia de seguridad y restauración de la base de datos Derby.
Nota: Si está utilizando la misma base de datos, no es necesaria la migración de datos. Pero si está conmutando la base de datos mientras actualiza, debe exportar los datos desde la base de datos anterior e importarla a la nueva base de datos.

Actualización de Jazz Team Server (JTS)

  1. Revise los temas de la sección en Planificación del despliegue y de la actualización según sea necesario.
  2. Cierre el servidor JTS 3.0.
  3. Si no tiene instalado Jazz Team Server como parte de la instalación de CLM, instale Jazz Team Server en una ubicación nueva del disco. Si ya ha instalado Jazz Team Server y lo actualizó a la versión 3.0.1 y desea instalar y actualizar la aplicación Gestión de cambios y configuración, continúe con Actualización de Gestión de cambios y configuración (CCM).
  4. Durante la instalación, seleccione Utilizar raíces de contexto de aplicación 3.x predeterminadas.
  5. Al final de la instalación, seleccione ninguno para Qué programa desea iniciar.
  6. Vaya a <3.0.1JTS_install_dir>/server y ejecute el siguiente mandato:
    Nota: Puede ejecutar el script especificando todos los argumentos en la línea de mandatos. Como alternativa, si va a volver a ejecutar el script de actualización varias veces, también puede editar el archivo de parámetros del script y ejecutar una línea de mandatos abreviada. Consulte el siguiente paso opcional para obtener instrucciones acerca del archivo de parámetros.
    Importante: Aunque el archivo de script está ubicado en el directorio de actualización, debe ejecutarse desde el directorio del servidor. Igualmente, si las vías de acceso contienen espacios, asegúrese de que las delimita entre comillas.
    Windows
    upgrade\jts_upgrade.bat -oldJTSHome <3.0JTS_install_dir>\server\conf 
    UNIX
    upgrade/jts_upgrade.sh -oldJTSHome <3.0JTS_install_dir>/server/conf 

    Si necesita más detalle acerca de las opciones de línea de mandatos, consulte jts_upgrade.

    El script completa estas tareas con las interacciones de usuario indicadas:
    • Ejecuta el mandato -migration_jts_updateConfigurationFiles y actualiza los archivos de configuración y Tomcat. Entre [E] para ejecutar el mandato, [S] para saltarse el paso o pulse [Intro] para cancelar la ejecución del script.
    • Una vez se hayan fusionado los archivos de configuración satisfactoriamente, entre [C] para continuar. Se abre una ventana Notepad (o un editor vi en los sistemas UNIX) en los que puede verificar el archivo de Jazz Team Server teamserver.properties. Verifique que la raíz del URI público marcada por la propiedad com.ibm.team.repository.server.webapp.url es correcta. Verifique también que las propiedades de la base de datos son correctas. Cuando lo haya hecho, guarde los cambios si los hubiera y cierre el editor para continuar con la ejecución del script.
      Importante: No modifique las propiedades para conectarse a la base de datos de almacén de datos, incluso si están establecidas actualmente en Derby. Utilice el asistente de configuración de servidor sólo para modificar estas propiedades.
      Para obtener información sobre la verificación de los archivos de configuración, consulte Verificación de los archivos de configuración durante la actualización.
    • Continúe ejecutando el script hasta que vea el mensaje que dice que JTS se actualizó correctamente.
  7. Opcional: Como alternativa al paso anterior, puede abrir el archivo de parámetros del script, modificar los valores predeterminados y ejecutar una forma abreviada de la línea de mandatos.

    Las versiones en inglés y traducidas de los archivos jts_params están ubicadas en el directorio <3.0.1JTS_install_dir>/server/upgrade/params .

    1. Para obtener el nombre exacto del archivo de parámetros para su idioma en el directorio <3.0.1JTS_install_dir>\server\upgrade , ejecute el mandato locale.bat -jts -showParamFileName en Windows o el mandato locale.sh -jts -showParamFileName en UNIX.
    2. Abra jts_params o una versión traducida para editar y especificar valores para cada uno de los parámetros. Uno de los parámetros que debe establecerse es la vía de acceso al directorio OLD_JTS_HOME.
  8. Si está utilizando Apache Tomcat, consulte Configuración de Apache Tomcat.
  9. Si está utilizando WebSphere Application Server, desinstale la aplicación web instalada anteriormente y vuelva a desplegar los archivos jts.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.
  10. Inicie el servidor JTS.
  11. Continúe con Ejecutar el asistente de configuración para configurar el servidor.

Actualización de Gestión de cambios y configuración (CCM)

  1. Revise los temas de la sección en Planificación del despliegue y de la actualización según sea necesario.
  2. Cierre del servidor CCM 3.0.
  3. Instale la aplicación CCM a una ubicación nueva en el disco.
  4. Durante la instalación, seleccione Utilizar raíces de contexto de aplicación 3.x predeterminadas.
    Importante: Si Rational Team Concert versión 3.0 se ha actualizado de la versión 2, seleccione Utilizar raíz de contexto de Rational Team Concert 2.x para conservar la raíz de contexto /jazz.
  5. Al final de la instalación, seleccione Ninguno para Qué programa desea iniciar.
  6. Vaya a <3.0.1CCM_install_dir>/server y ejecute el siguiente mandato:
    Nota: Puede ejecutar el script especificando todos los argumentos en la línea de mandatos. Como alternativa, si va a volver a ejecutar el script de actualización varias veces, también puede editar el archivo de parámetros del script y ejecutar una línea de mandatos abreviada. Consulte el siguiente paso opcional para obtener instrucciones acerca del archivo de parámetros.
    Importante: Aunque el archivo de script está ubicado en el directorio de actualización, debe ejecutarse desde el directorio del servidor. Igualmente, si las vías de acceso contienen espacios, asegúrese de que las delimita entre comillas. Además, asegúrese de proporcionar el parámetro applicationContextRoot y establézcalo ccm. De manera predeterminada applicationContextRoot es jazz.
    Windows
    upgrade\ccm_upgrade.bat -oldApplicationHome <3.0CCM_install_dir>\server\conf -applicationContextRoot ccm
    UNIX
    upgrade/ccm_upgrade.sh -oldApplicationHome <3.0CCM_install_dir>/server/conf -applicationContextRoot ccm 

    Si necesita más detalles acerca de las opciones de línea de mandatos, consulte ccm_upgrade.

    El script completa estas tareas con las interacciones de usuario indicadas:
    • Ejecuta el mandato -migration_ccm_updateConfigurationFiles y actualiza los archivos de configuración y Tomcat. Entre [E] para ejecutar el mandato, [S] para saltarse el paso o pulse [Intro] para cancelar la ejecución del script.
    • Una vez se hayan fusionado los archivos de configuración satisfactoriamente, entre [C] para continuar. Se abre una ventana Notepad (o un editor vi en los sistemas UNIX) en los que puede verificar el archivo de CCM teamserver.properties. Verifique que la raíz del URI público marcada por la propiedad com.ibm.team.repository.server.webapp.url es correcta. Verifique también que las propiedades de la base de datos son correctas. La ubicación de la base de datos debe ser diferente a la ubicación de la base de datos de JTS. Cuando lo haya hecho, guarde los cambios si los hubiera y cierre el editor para continuar con la ejecución del script. Para obtener información sobre la verificación de los archivos de configuración, consulte Verificación de los archivos de configuración durante la actualización.
    • Continue ejecutando el script hasta que vea el mensaje que dice que CCM se actualizó correctamente.
  7. Opcional: Como alternativa al paso anterior, puede abrir el archivo de parámetros del script, modificar los valores predeterminados y ejecutar una forma abreviada de la línea de mandatos.

    Las versiones en inglés y traducidas de los archivos ccm_params están ubicadas en el directorio <3.0.1CCM_install_dir>/server/upgrade/params .

    1. ara obtener el nombre exacto del archivo de parámetros para su idioma en el directorio <3.0.1CCM_install_dir>\server\upgrade , ejecute el mandato locale.bat -ccm -showParamFileName en Windows o el mandato locale.sh -ccm -showParamFileName en UNIX.
    2. Abra ccm_params o una versión traducida para editar y especificar valores para cada uno de los parámetros. Uno de los parámetros que debe establecerse es la vía de acceso al directorio OLD_AAPLICATION_HOME. Asegúrese de que la vía de acceso no contiene espacios.
  8. Si está utilizando Apache Tomcat, consulte Configuración de Apache Tomcat.
  9. Si está utilizando WebSphere Application Server, desinstale la aplicación web instalada anteriormente y vuelva a desplegar ccm.war proporcionado 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.
  10. Inicie el servidor CCM.
  11. Utilice la interfaz web administrativa si está añadiendo la Gestión de cambios y configuración a un Jazz Team Server establecido. Para obtener más información, consulte Registrar aplicaciones con Jazz Team Server.

Comentarios