Actualización a los releases de fixpack de la versión 3.0.1

Utilice este tema para actualizar la solución de Rational existente para productos CLM a los releases de fixpack de la versión 3.0.1.

Antes de empezar

Importante:
  • En los ejemplos siguientes, 3.0.1 hace referencia al directorio en el que está instalado el servidor 3.0.1, y 3.0.1.x hace referencia al directorio en el que está instalado el nuevo servidor con el fixpack 3.0.1 (3.0.1.1 o posterior).
  • Todos los ejemplos son para Linux. Debe modificar en consecuencia para Windows u otros sistemas operativos.
  • El proceso de actualización de 3.0.1 al release de fixpack 3.0.1 utiliza la base de datos de CLM existente. Los mandatos addTables y createWarehouse actualizarán estas bases de datos a los formatos 3.0.1.x.
  • Si ha instalado todas las aplicaciones Jazz en el mismo servidor de aplicaciones, debe actualizar todas las aplicaciones al fixpack 3.0.1 al mismo tiempo. Si ha desplegado cada aplicación en un servidor de aplicaciones aparte, las aplicaciones se pueden agrupar independientemente.
  • No ejecute jts/setup. Todo está ya configurado. Utilice jts/admin para ver o cambiar la configuración.
  • Se proporcionan instrucciones para utilizar el script de derivador de actualización y para realizar la actualización manualmente.

Actualización desde la versión 2

Acerca de esta tarea

Las instrucciones para actualizar de la versión 2 a los releases de fixpack 3.0.1 son iguales que para actualizar de la versión 2 a 3.0.1. Para obtener más información, consulte Actualización a la solución Rational para CLM.

Actualización de la versión 3.0.1 utilizando Tomcat

Procedimiento

  1. Instale CLM 3.0.1.x. No ejecute la configuración. Para configuraciones distribuidas, instale la aplicación CLM 3.0.1 correspondiente a la aplicación 3.0.1.x que ya ha instalado.
    Nota: Siempre debe actualizar primero Jazz Team Server.
  2. Detenga el servidor 3.0.1.
  3. Si está utilizando Derby, pase la base de datos de Derby de 3.0.1 a 3.0.1.x:
    cp -R <dir_instal_3.0.1>/server/conf/jts/derby/repositoryDB
    <dir_instal_3.0.1.x>/server/conf/jts/derby
    cp -R <dir_instal_3.0.1>/server/conf/ccm/derby/repositoryDB
    <dir_instal_3.0.1.x>/server/conf/ccm/derby
    cp -R <dir_instal_3.0.1>/server/conf/qm/derby/repositoryDB
    <dir_instal_3.0.1.x>/server/conf/qm/derby
  4. Si está utilizando DB2, Oracle, o SQL Server, haga una copia de seguridad de la base de datos.
  5. Si está utilizando los scripts de derivador de actualización, vaya al paso 11
  6. Conserve los archivos de registro de usuarios de la versión 3.0.1.
    1. Si está utilizando el registro de usuarios de Tomcat, conserve sus archivos 3.0.1 tomcat-users.xml y server.xml:
      cp <dir_instal_3.0.1>/server/tomcat/conf/tomcat-users.xml
      <dir_instal_3.0.1.x>/server/tomcat/conf/tomcat-users.xml
      cp <dir_instal_3.0.1>/server/tomcat/conf/server.xml
      <dir_instal_3.0.1.x>/server/tomcat/conf/server.xml
    2. Si está utilizando un registro de usuarios LDAP, conserve los archivos server.xml y web.xml de la versión 3.0.1 en los servidores de aplicaciones adecuados:
      cp <dir_instal_3.0.1>/server/tomcat/conf/server.xml <dir_instal_3.0.1.x>/server/tomcat/conf/server.xml
      cp <dir_instal_3.0.1>/server/tomcat/webapps/admin/WEB-INF/web.xml
      <dir_instal_3.0.1.x>/server/tomcat/webapps/admin/WEB-INF/web.xml
      cp <dir_instal_3.0.1>/server/tomcat/webapps/jts/WEB-INF/web.xml
      <dir_instal_3.0.1.x>/server/tomcat/webapps/jts/WEB-INF/web.xml
      cp <dir_instal_3.0.1>/server/tomcat/webapps/ccm/WEB-INF/web.xml
      <dir_instal_3.0.1.x>/server/tomcat/webapps/ccm/WEB-INF/web.xml
      cp <dir_instal_3.0.1>/server/tomcat/webapps/qm/WEB-INF/web.xml
      <dir_instal_3.0.1.x>/server/tomcat/webapps/qm/WEB-INF/web.xml
      cp <dir_instal_3.0.1>/server/tomcat/webapps/rm/WEB-INF/web.xml
      <dir_instal_3.0.1.x>/server/tomcat/webapps/rm/WEB-INF/web.xml
  7. Copie los índices de JFS/text de 3.0.1 en 3.0.1.x. (Para sistemas distribuidos, vaya al servidor adecuado para copiar los archivos.)
    cp -R <dir_instal_3.0.1>/server/conf/jts/indices
    <dir_instal_3.0.1.x>/server/conf/jts
    cp -R <dir_instal_3.0.1>/server/conf/ccm/indices <dir_instal_3.0.1.x>/server/conf/ccm
    cp -R <dir_instal_3.0.1>/server/conf/qm/indices <dir_instal_3.0.1.x>/server/conf/qm
  8. Copie los archivos de configuración de aplicación de 3.0.1 en 3.0.1.x. (Para sistemas distribuidos, vaya al servidor adecuado para copiar los archivos.)
    cp <dir_instal_3.0.1>/server/conf/jts/teamserver*.properties
    <dir_instal_3.0.1.x>/server/conf/jts
    cp <dir_instal_3.0.1>/server/conf/ccm/teamserver*.properties
    <dir_instal_3.0.1.x>/server/conf/ccm
    cp <dir_instal_3.0.1>/server/conf/qm/teamserver*.properties  <dir_instal_3.0.1.x>/server/conf/qm
    cp <dir_instal_3.0.1>/server/conf/admin/admin.properties*
    <dir_instal_3.0.1.x_>/server/conf/admin
    cp <dir_instal_3.0.1>/server/conf/admin/friends.rdf*  <dir_instal_3.0.1.x>/server/conf/admin
    cp <dir_instal_3.0.1>/server/conf/rm/fronting.properties  <dir_instal_3.0.1.x>/server/conf/rm
    cp <dir_instal_3.0.1>/server/conf/rm/friendsconfig.rdf  <dir_instal_3.0.1.x>/server/conf/rm
  9. Ejecute el mandato repotools -addTables para asegurarse de que la base de datos tiene las tablas correctas. (Para sistemas distribuidos, vaya al servidor adecuado y ejecute el mandato repotools.)
    cd <dir_instal_3.0.1.x>/server
    ./repotools-jts.sh -addTables noPrompt
    ./repotools-ccm.sh -addTables noPrompt
    ./repotools-qm.sh -addTables noPrompt
  10. Si tiene un almacén de datos configurado, ejecute el mandato repotools-jts -createWarehouse para actualizar el esquema del almacén de datos a 3.0.1.x.
    cd <dir_instal_3.0.1.x>/server
    ./reportools-jts.sh -createWarehouse
  11. Si está utilizando los scripts de derivador de actualización, sitúese en el directorio <dir_instal_3.0.1.x>/server.
    upgrade/jts_upgrade.sh -oldJTSHome <dir_instal_3.0.1>/server/conf
    upgrade/ccm_upgrade.sh -oldApplicationHome <dir_instal_3.0.1>/server/conf
    upgrade/qm_upgrade.sh -oldApplicationHome <dir_instal_3.0.1>/server/conf
    upgrade/rm_upgrade.sh -oldApplicationHome <dir_instal_3.0.1>/server/conf
  12. Inicie los servidores.
  13. Active las licencias de 3.0.1.x si es necesario. Por ejemplo, con releases objetivo, debe activar las Licencias de acceso temprano enviadas con el objetivo. Para el release final de 3.0.1.x, puede seguir utilizando sus licencias 3.0.1.
    1. Inicie la sesión como administrador en la versión 3.0.1.x de Jazz Team Server.
    2. Navegue a la página Administración de servidor > Gestión de claves de licencia y active las licencias.
    Nota: No es necesario ejecutar la configuración en el sistema 3.0.1.x, puesto que está ya configurado.

Actualización de la versión 3.0.1 utilizando WebSphere Application Server

Procedimiento

Nota: Si su entorno no soporta el convertidor, por ejemplo AIX o Solaris, debe instalar la versión 3.0.1.x de converter.war en el conversor dedicado. Para obtener información detallada, consulte Instalación de la aplicación de conversor de Rational Requirements Composer.

  1. Instale CLM 3.0.1.x. No ejecute la configuración. Para configuraciones distribuidas, instale la aplicación CLM 3.0.1 correspondiente a la aplicación 3.0.1.x que ya ha instalado.
    Nota: Siempre debe actualizar primero Jazz Team Server.
  2. Haga una copia de seguridad del perfil WebSphere Application Server.
    1. Abra un indicador de mandatos y sitúese en el directorio <WAS_Install>/bin. Por ejemplo, /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin.
    2. Ejecute el siguiente mandato:
      ./backupConfig <vía de acceso a un archivo comprimido para crear copia de seguridad del perfil> (por
      ejemplo ./backupConfig /root/was_backups/clm_301_profile.zip)
      Nota: El perfil del que se ha realizado una copia de seguridad se puede restaurar si es necesario ejecutando el mandato ./restoreConfig. Por ejemplo, ./restoreConfig /root/was_backups/clm_301_profile.zip.
  3. Desinstale las aplicaciones de 3.0.1 de WebSphere Application Server.
    1. Inicie la sesión en WebSphere Application Server Integrated Solutions Console, en https://<nombre de host>:9043/ibm/console/logon.jsp.
    2. Pulse Aplicaciones > Tipos de aplicaciones > Aplicaciones empresariales de WebSphere.
    3. Escriba la correlación de roles de seguridad de las aplicaciones de 3.0.1 jts_war, ccm_war y qm_war para ayudarle a correlacionarlas con las equivalentes de 3.0.1.x en el paso 16
    4. Detenga y desinstale las aplicaciones de 3.0.1 siguientes: jts_war, admin_war, ccm_war, qm_war, rm_war, clmhelp_war, converter_war.
    5. Guarde los cambios en la configuración principal cuando se le solicite.
  4. Actualice las propiedades personalizadas JAZZ_HOME y log4j.configuration.
    1. Inicie la sesión en WebSphere Application Server Integrated Solutions Console, en https://<nombre de host>:9043/ibm/console/logon.jsp.
    2. Pulse Servidores > Tipos de servidor > Servidores de aplicaciones WebSphere.
    3. Pulse el nombre del servidor para abrirlo. El nombre del servidor predeterminado es server1.
    4. En la sección Infraestructura del servidor, pulse Java y gestión de procesos > Definición de procesos.
    5. En Propiedades adicionales, pulse Máquina virtual Java.
    6. En Propiedades adicionales, pulse Propiedades personalizadas.
    7. Pulse JAZZ_HOME y actualice su valor en file:///<dir_instal_3.0.1.x>/server/conf. Por ejemplo, file:///opt/IBM/JazzTeamServer_3.0.1.x/server/conf.
    8. Pulse log4j.configuration y actualice su valor a file:///<dir_instal_3.0.1.x>/server/conf/startup_log4j.properties. Por ejemplo, file:///opt/IBM/JazzTeamServer_3.0.1.x/server/conf/log4j.properties.
    9. Si está conectando con la base de datos Oracle o SQL Server, asegúrese de que ORACLE_JDBC_DRIVER_FILE o SQLSERVER_JDBC_DRIVER_FILE señala al archivo de controlador JDBC correcto.
    10. Guarde los cambios en la configuración principal cuando se le solicite.
      Nota: Para obtener más información, consulte Configuración de un WebSphere Application Server.
  5. Detenga WebSphere Application Server.
  6. Elimine el contenido relacionado con CLM de los directorios wstemp y temp en el perfil. En función de las aplicaciones instaladas anteriormente, los directorios siguientes están presentes en el perfil y se pueden eliminar: jts_war, admin_war, ccm_war, qm_war, rm_war, clmhelp_war, converter_war.
    <directorio de perfil>/wstemp (por ejemplo /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/wstemp)
    <directorio de perfil>/temp (por ejemplo /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)
  7. Elimine los registros relacionados con CLM del directorio de registros en el perfil.
    <directorio de perfil>/logs (por ejemplo /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs)
  8. Prepare las bases de datos para las aplicaciones CLM 3.0.1.x.
    1. Si está utilizando Derby, pase la base de datos de Derby de 3.0.1 a 3.0.1.x:
      cp -R <dir_instal_3.0.1>/server/conf/jts/derby/repositoryDB
      <dir_instal_3.0.1.x>/server/conf/jts/derby
      cp -R <dir_instal_3.0.1>/server/conf/ccm/derby/repositoryDB <dir_instal_3.0.1.x>/server/conf/ccm/derby
      cp -R <dir_instal_3.0.1>/server/conf/qm/derby/repositoryDB <dir_instal_3.0.1.x>/server/conf/qm/derby
    2. Si está utilizando DB2, Oracle, o SQL Server, haga una copia de seguridad de la base de datos.
  9. Si está utilizando los scripts de derivador de actualización, vaya al paso 14
  10. Copie los índices de JFS/text de 3.0.1 en 3.0.1.x. (Para sistemas distribuidos, vaya al servidor adecuado para copiar los archivos.)
    cp -R <dir_instal_3.0.1>/server/conf/jts/indices <dir_instal_3.0.1.x>/server/conf/jts
    cp -R <dir_instal_3.0.1>/server/conf/ccm/indices <dir_instal_3.0.1.x>/server/conf/ccm
    cp -R <dir_instal_3.0.1>/server/conf/qm/indices <dir_instal_3.0.1.x>/server/conf/qm
  11. Copie sus archivos de configuración de aplicación de 3.0.1 a 3.0.1.1. (Para sistemas distribuidos, vaya al servidor adecuado para copiar los archivos.)
    cp <dir_instal_3.0.1>/server/conf/jts/teamserver*.properties
    <dir_instal_3.0.1.x>/server/conf/jts
    cp <dir_instal_3.0.1>/server/conf/ccm/teamserver*.properties <dir_instal_3.0.1.x>/server/conf/ccm
    cp <dir_instal_3.0.1>/server/conf/qm/teamserver*.properties  <dir_instal_3.0.1.x>/server/conf/qm
    cp <dir_instal_3.0.1>/server/conf/admin/admin.properties* <dir_instal_3.0.1.x_>/server/conf/admin
    cp <dir_instal_3.0.1>/server/conf/admin/friends.rdf*  <dir_instal_3.0.1.x>/server/conf/admin
    cp <dir_instal_3.0.1>/server/conf/rm/fronting.properties  <dir_instal_3.0.1.x>/server/conf/rm
    cp <dir_instal_3.0.1>/server/conf/rm/friendsconfig.rdf  <dir_instal_3.0.1.x>/server/conf/rm
  12. Ejecute el mandato repotools -addTables para asegurarse de que la base de datos tiene las tablas correctas. (Para sistemas distribuidos, vaya al servidor adecuado y ejecute el mandato repotools.)
    cd <dir_instal_3.0.1.x>/server
    ./repotools-jts.sh -addTables noPrompt
    ./repotools-ccm.sh -addTables noPrompt
    ./repotools-qm.sh -addTables noPrompt
  13. Si tiene un almacén de datos configurado, ejecute el mandato repotools-jts -createWarehouse para actualizar el esquema del almacén de datos a 3.0.1.x.
    cd <dir_instal_3.0.1.x>/server
    ./reportools-jts.sh -createWarehouse
  14. Si está utilizando los scripts de derivador de actualización, sitúese en el directorio <dir_instal_3.0.1.x>/server.
    upgrade/jts_upgrade.sh -oldJTSHome <dir_instal_3.0.1>/server/conf
    upgrade/ccm_upgrade.sh -oldApplicationHome <dir_instal_3.0.1>/server/conf
    upgrade/qm_upgrade.sh -oldApplicationHome <dir_instal_3.0.1>/server/conf)
    upgrade/rm_upgrade.sh -oldApplicationHome <dir_instal_3.0.1>/server/conf
  15. Inicie WebSphere Application Server.
  16. Despliegue los archivos war de 3.0.1.x en WebSphere Application Server.
    1. Inicie la sesión en WebSphere Application Server Integrated Solutions Console, en https://<nombre de host>:9043/ibm/console/logon.jsp.
    2. Pulse Aplicaciones > Tipos de aplicaciones > Aplicaciones empresariales de WebSphere.
    3. Instale los archivos jts_war, admin_war, ccm_war, qm_war, rm_war, clmhelp_war, converter_war.
    4. Correlacione los roles de seguridad adecuadamente para las aplicaciones siguientes: jts_war, ccm_war, qm_war.
      Nota: Para obtener más información, consulte Despliegue de aplicaciones CLM en WebSphere Application Server.
  17. Mientras está en la página Enterprise Applications, inicie las aplicaciones siguientes: jts_war, admin_war, ccm_war, qm_war, rm_war, clmhelp_war, converter_war.
  18. Restablezca el servidor para JTS, CCM y QM:
    https://jts_server.mydomain.com:9443/jts/admin#action=com.ibm.team.repository.admin.serverReset
    https://ccm_server.mydomain.com:9443/ccm/admin#action=com.ibm.team.repository.admin.serverReset
    https://rqm_server.mydomain.com:9443/qm/admin#action=com.ibm.team.repository.admin.serverReset
    Nota: Debe reiniciar los servidores para que el restablecimiento del servidor entre en vigor.
  19. Active las licencias 3.0.1.x si es necesario. Por ejemplo, con releases objetivo, debe activar las Licencias de acceso temprano enviadas con el objetivo. Para el release final de 3.0.1.x, puede seguir utilizando sus licencias 3.0.1.
    1. Inicie la sesión como administrador en la versión 3.0.1.x de Jazz Team Server.
    2. Navegue a la página Administración de servidor > Gestión de claves de licencia y active las licencias.
    Nota: No es necesario ejecutar la configuración en el sistema 3.0.1.x, puesto que está ya configurado.
    Nota: Para obtener la información más reciente sobre el proceso de actualización, consulte CLM Upgrading Knowledge Collection.

Comentarios