Actualización de la versión a 3.0.1 utilizando el script de actualización

Puede utilizar el script de actualización para minimizar el número de mandatos que debe ejecutar manualmente al actualizar los datos de aplicación.

Antes de empezar

Antes de actualizar el servidor, asegúrese de que cuenta con una copia de seguridad completamente actualizada y válida de la base de datos de repositorio de Rational Team Concert versión 2.

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, estos requerimientos se pueden superar mediante el despliegue de empresa del servicio de 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.

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 la base de datos Rational Team Concert (<RTC2_install_dir>\server\repositoryDB) de 2 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.

Si pretende actualizar varios productos, consulte Orden de actualización para que le ayude a decidir qué actualizar primero.

Procedimiento

  1. Revise los temas de la sección en Planificación del despliegue y de la actualización según sea necesario.
  2. 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
  3. Cierre el servidor de la versión 2.
  4. 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 y lo actualizó a la versión 3.0.1, instale únicamente la aplicación Gestión de cambios y configuración.
  5. Durante la instalación, seleccione Utilizar raíz de contexto de Rational Team Concert 2.x.
  6. Al final de la instalación, seleccione Ninguno para Qué programa desea iniciar .
  7. 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.x. 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 JTS Team Server nueva si no lo ha hecho todavía.
  8. Vaya a <CCM3.0.1_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.

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

    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.

    Si instaló la versión 3.0.1 de Jazz Team Server junto con la aplicación CCM, y es la primera o única aplicación que está instalando, la sintaxis del mandato es la siguiente:

    Windows
    upgrade\ccm_upgrade.bat -oldApplicationHome <RTC2.x_install_dir>\server\conf -createJTSTables
    UNIX
    upgrade/ccm_upgrade.sh -oldApplicationHome <RTC2.x_install_dir>/server/conf -createJTSTables
    Nota: El parámetro -createJTSTables se aplica a instalaciones donde está instalando Jazz Team Server 3.0.1 por primera vez.

    SI instaló la versión 3.0.1 de Jazz Team Server por separado desde la aplicación CCM, como en un despliegue distribuido, tiene que especificar la ubicación del servidor Jazz Team Server 3.0.1 y ejecutar el script desde el directorio de instalación de CCM 3.0.1. En este caso, incluya el argumento -newJTSHome .

    Windows
    upgrade\ccm_upgrade.bat -oldApplicationHome <RTC2.x_install_dir>\server\conf -newJTSHome <JTS3.0.1InstallDir>\server\conf
    UNIX
    upgrade/ccm_upgrade.sh -oldApplicationHome <RTC2.x_install_dir>/server/conf -newJTSHome <JTS3.0.1InstallDir>/server/conf
    Nota: i tiene un despliegue distribuido y no ha configurado Jazz Team Server, puede añadir el parámetro -createJTSTables al ejemplo de la línea de mandatos de arriba.
    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.
      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 CCM se actualizó correctamente.
  9. 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. Para obtener el nombre exacto del archivo de parámetros para su idioma, en el directorio <3.0.1CCM_install_dir>\server\upgrade , ejecute locale.bat -ccm -showParamFileName en Windows o locale.sh -ccm -showParamFileName en los sistemas 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.
  10. Si está utilizando Apache Tomcat, consulte Configuración de Apache Tomcat.
  11. 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.
  12. 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 calidad 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.


Comentarios