Desplegar la aplicación de servidor incluida de Rational Team Concert en Tomcat

IBM® Rational Asset Manager necesita IBM Rational Team Concert, el cual controla las funciones de ciclo de vida que el usuario puede utilizar para gestionar el desarrollo de activos. Si no tiene Rational Team Concert, se incluye una versión limitada de ese producto, que puede desplegar en un servidor Tomcat.

Antes de empezar

Si ya ha desplegado y configurado una aplicación de servidor de Rational Team Concert, puede utilizar esa aplicación en lugar de instalar una aplicación nueva. Para configurar Rational Team Concert a fin de que trabaje con Rational Asset Manager, consulte Configurar un servidor Rational Team Concert para trabajar con Rational Asset Manager.

Debe tener acceso administrativo y acceso a archivos para un servidor Tomcat que esté instalado y en ejecución.

Antes de realizar esta tarea, complete las tareas siguientes:
  1. Recuperar los archivos de aplicación
  2. Crear la base de datos para ciclos de vida

Debe disponer de un certificado de seguridad para el servidor Tomcat. La versión de Rational Team Concert incluida requiere una conexión segura.

Acerca de esta tarea

Puede mejorar el rendimiento y estabilidad de Rational Asset Manager instalando las aplicaciones web de este último y los archivos de aplicación de IBM Rational Team Concert en servidores Tomcat separados. En el presente documento, el directorio de instalación del servidor Tomcat para Rational Asset Manager es directorio_instalación_tomcat. El directorio de instalación del servidor Tomcat para Rational Team Concert es directorio_instalación_tomcat_para_rtc. Si instala todas las aplicaciones web en el mismo servidor Tomcat, los directorios son los mismos.

Procedimiento

  1. Verifique que todos los servidores del repositorio están establecidos en la misma fecha, hora y huso horario actuales.
  2. Recupere los archivos de aplicación del archivador apropiado para Tomcat y para el sistema operativo que utilice. Los archivos de aplicación residen en la carpeta ubicación_extracción_archivador/apps/tomcat/.
  3. Para Windows: Para Linux:Para AIX: Extraer los archivos de biblioteca de Rational Licensing Key Server 8.1.2 en la carpeta directorio_instalación_tomcat_para_rtc\shared\lib:
    Importante: no efectúe este paso en Linux para zSeries
    1. Busque y extraiga el archivo ubicación_extracción_archivador\sharedLibs\rlsclients_rlsibmratl_812.zip.
    2. Desde el extraídos. el archivo. zip, busque el archivo rlsibmratl812.zip para su sistema operativo y arquitectura. Por ejemplo, el archivo para Windows de 32 bits reside en el directorio win32.
    3. Extraiga el contenido del archivo rlsibmratl812.zip adecuado.
    4. Copie el contenido extraído del archivo rlsibmratl812.zip en el directorio directorio_instalación_tomcat_para_rtc\shared\lib.
    Si está instalando Rational Asset Manager y Rational Team Concert en el mismo servidor de aplicaciones, ya ha efectuado este paso.
  4. En el soporte de instalación, encuentre el archivo ubicación_extracción_archivador/apps/tomcat/RTC-server.zip.
  5. Extraiga RTC-server.zip en una ubicación de la unidad de disco duro, que en estas instrucciones está representada por rtc_install_dir.
  6. Encuentre el archivo rtc_install_dir/jazz/server/ramjazz_war.ear y extráigalo. Para extraer archivos .ear, puede utilizar el programa de utilidad gratuito 7-Zip. Desde el paquete ramjazz_war.ear extraído, copie el archivo ramjazz.war en el directorio directorio_instalación_tomcat_para_rtc/webapps/.
  7. Configure un puerto seguro para el servidor Tomcat para Rational Team Concert:
    1. Cree un certificado de seguridad por el que Rational Team Concert identificará al servidor Tomcat para las conexiones SSL. Puede utilizar el mandato keytool del JDK de Java para crear un certificado autofirmado. Como alternativa, puede solicitar un certificado que esté firmado por una autoridad de certificación de confianza.
      Para obtener más información sobre la creación de certificados autofirmados mediante el mandato keytool, consulte la Documentación de Oracle Java. Puede crear un certificado autofirmado mediante el siguiente mandato keytool de ejemplo:
      keytool -genkey -alias tomcat -keystore directorio_instalación_tomcat_para_rtc/.keystore

      Cuando ejecute el mandato, se le solicitará una contraseña para el archivo de almacén de claves. La contraseña predeterminada es changeit, pero es conveniente que especifique una contraseña diferente. Deberá recordar esa contraseña para entrarla más tarde en el archivo server.xml.

      Si está utilizando un JRE de IBM, muchas versiones incluyen la herramienta ikeyman de IBM en el directorio IBM_Java_JRE_install_location/jre/bin/. Puede utilizar esta herramienta para crear y gestionar certificados de seguridad en el servidor. Para obtener más información sobre la utilización de la herramienta iKeyman, consulte la publicación iKeyman User's Guide.

      También se incluye un certificado simple en la carpeta rtc_install_dir/jazz/server/; el archivo de certificado es ibm-team-ssl.keystore

    2. En el archivo directorio_instalación_tomcat_para_rtc\conf\server.xml, encuentre la etiqueta <Connector> que tiene el atributo scheme="https". El archivo predeterminado incluye una etiqueta <Conector> de ejemplo para el puerto 8443 que está convertida en comentario.
    3. Copie y pegue este texto:
      <Connector port="8443"
           maxHttpHeaderSize="8192" 
           maxThreads="150"
           minSpareThreads="25" 
           maxSpareThreads="75"
           enableLookups="false"
           disableUploadTimeout="true"
           connectionTimeout="20000"
           acceptCount="100"
           scheme="https"
           secure="true" 
           clientAuth="false"
           keystoreFile="keystore_file"
           keystorePass="keystore_password"
           sslProtocol="keystore_protocol"
           algorithm="keystore_algorithm"
           URIEncoding="UTF-8"
      />
      Donde:
      • keystore_file es el nombre del archivo de almacén de claves. Puede ser una vía de acceso absoluta o ser una vía relativa con respecto al directorio raíz del servidor Tomcat (directorio_instalación_tomcat_para_rtc). Si ha utilizado el mandato simple mostrado más arriba, este valor será .keystore. Si utiliza el certificado incluido, la vía de acceso será rtc_install_dir/jazz/server/ibm-team-ssl.keystore.
      • keystore_password es la contraseña del archivo de almacén de claves. Si utiliza el archivo de almacén de claves incluido, este valor será ibm-team .
      • keystore_protocol es el protocolo del almacén de claves. Lo más probable es que sea TLS o SSL_TLS. Si utiliza el archivo de almacén de claves incluido, este valor será SSL_TLS.
      • keystore_algorithm es el algoritmo X509 del almacén de claves. Lo más probable es que sea SunX509 o IbmX509, dependiendo del origen del certificado. Si utiliza el archivo de almacén de claves incluido, este valor será IbmX509.
    4. Puede cambiar el valor de port para utilizar un puerto que no sea 8443 para el conector no SSL (el puerto predeterminado es 8080). Si cambia el valor de puerto, cambie el valor del atributo redirectPort para que coincida con el número de puerto para el conector SSL.

    Para obtener más información sobre la configuración de SSL para Tomcat, consulte Apache Tomcat 5.5 SSL Configuration HOW-TO y Apache Tomcat Configuration reference.

  8. Para Oracle:Para Microsoft SQL Server: Copie el archivo .jar apropiado del proveedor de bases de datos:
    • Para Oracle: Copie el archivo ojdbc14.jar en la carpeta rtc_install_dir/jazz/server/oracle (puede ser necesario crear la carpeta oracle).

      Puede descargar el archivo desde Oracle. Si está utilizando Oracle 11, descargue el paquete de Oracle 10g para encontrar el archivo ojdbc14.jar.

    • Para Microsoft SQL Server: Copie el archivo siguiente en la carpeta rtc_install_dir/jazz/server/sqlserver (puede ser necesario crear la carpeta sqlserver):
  9. Configure los valores de propiedades de inicio de Tomcat:
    1. Encuentre el archivo de inicio de Tomcat y ábralo en un editor de texto. En Windows, este archivo es directorio_instalación_tomcat_para_rtc\bin\startup.bat. En Linux, AIX, o Linux para zSeries es directorio_instalación_tomcat_para_rtc/bin/startup.sh.
    2. En el archivo de inicio, escriba el texto siguiente:
      • Para Windows: Sustituya cada carácter de espacio contenido en rtc_install_dir por %20:
        set ORACLE_JDBC=oracle_jar_dir
        set SQLSERVER_JDBC=sqlServer_jar_dir
        set JAZZ_INSTALL_DIR=rtc_install_dir
        set JAVA_OPTS=-Djava.awt.headless=true -Djava.library.path="directorio_instalación_tomcat_para_rtc\shared\lib" -DSQLSERVER_JDBC="%SQLSERVER_JDBC%" -DORACLE_JDBC="%ORACLE_JDBC%" -DDB2I_JDBC="%DB2I_JDBC%" -DDB2Z_JDBC="%DB2Z_JDBC%" -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -DJAZZ_HOME=file:///%JAZZ_INSTALL_DIR%\jazz\server\conf -Dcom.ibm.team.repository.tempDir=%TEMP% -Xmx700M
      • Para Linux:Para AIX:Para Linux para zSeries:
        ORACLE_JDBC=oracle_jar_dir
        SQLSERVER_JDBC=sqlServer_jar_dir
        JAZZ_INSTALL_DIR=rtc_install_dir
        export JAVA_OPTS="-Djava.awt.headless=true -Djava.library.path=directorio_instalación_tomcat_para_rtc/shared/lib -DSQLSERVER_JDBC=$SQLSERVER_JDBC -DORACLE_JDBC=$ORACLE_JDBC -DDB2I_JDBC=$DB2I_JDBC -DDB2Z_JDBC=$DB2Z_JDBC -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -DJAZZ_HOME=file://"$JAZZ_INSTALL_DIR"/jazz/server/conf -Dcom.ibm.team.repository.tempDir=$TEMP_DIR -Xmx700M"
      Donde:
      • rtc_install_dir es el directorio extraído del archivo RTC-server.zip. En Windows, sustituya cada carácter de espacio contenido en rtc_install_dir por %20
      • Para Oracle: oracle_jar_dir es el directorio del archivo ojdbc14.jar (rtc_install_dir/jazz/server/oracle)
      • Para Microsoft SQL Server: sqlServer_jar_dir es el directorio del archivo sqljdbc.jar (rtc_install_dir/jazz/server/sqlserver)
      • directorio_instalación_tomcat_para_rtc es el directorio de instalación del servidor Tomcat
      • Para Windows: Para Linux:Para AIX: Si está instalando Rational Asset Manager y Rational Team Concert en el mismo servidor de aplicaciones, utilice esta variable del sistema JAVA_OPTS para sustituir la que creó cuando configuró el script de inicio del servidor Tomcat para Rational Asset Manager; esta declaración todavía incluye la opción -Djava.library.path.
  10. Encuentre y renombre el archivo de propiedades apropiado del servidor Jazz:
    1. En el directorio rtc_install_dir/jazz/server/conf/ramjazz/, encuentre el archivo teamserver.properties y cambie su nombre a teamserver.derby.properties.
    2. Encuentre el archivo adecuado para su servidor de bases de datos:
      • Para DB2:Para Windows:Para DB2 en Windows: teamserver.db2.win32.properties
      • Para DB2:Para Linux:Para AIX:Para Linux para zSeries:Para DB2 en Linux, AIX, o Linux para zSeries: teamserver.db2.linux.properties
      • Para Oracle: teamserver.oracle.properties
      • Para SQL Server: teamserver.sqlserver.properties
    3. Cambie el nombre del archivo a teamserver.properties.
  11. En un editor de texto, abra el archivo teamserver.properties y modifíquelo de la manera siguiente (para su proveedor de bases de datos):
    • Para DB2:
      1. Encuentre las líneas siguientes:
        com.ibm.team.repository.db.vendor = DB2
        com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
        com.ibm.team.repository.db.jdbc.password=db2admin
      2. Edite el valor de com.ibm.team.repository.db.jdbc.location de acuerdo con la ubicación de su servidor DB2, y el nombre de la base de datos para ciclos de vida:
        1. Sustituya localhost:50000 por la ubicación y el puerto de la base de datos DB2.
          Consejo: En la ventana de mandatos de DB2, ejecute db2 get dbm cfg, y encuentre la línea que contiene SVCENAME, que indica el nombre o número de puerto de DB2. Si este mandato muestra un número, utilícelo como número de puerto (en lugar de 50000 en el ejemplo anterior). Si el mandato devuelve un nombre no numérico, determine qué número de puerto se asignó para este nombre y utilice ese número de puerto. En Linux, el archivo /etc/services contiene la correlación entre nombres y números de puerto; en Windows, el archivo C:\windows\system32\drivers\etc\services contiene la correlación. Para obtener más información, consulte al administrador de bases de datos o vea la documentación de la base de datos.
        2. Sustituya JAZZ por el nombre de la base de datos para ciclos de vida.
        3. Sustituya db2admin por el nombre de usuario para la base de datos DB2.
          Nota: El usuario de DB2 debe tener permisos para crear tablas y espacios de tabla, y para modificar la configuración de la base de datos. Los usuarios de DB2 son creados por el sistema operativo.
      3. En la propiedad com.ibm.team.repository.db.jdbc.password, especifique la contraseña de usuario.
        Nota: No cambie el texto password={password} en la propiedad com.ibm.team.repository.db.jdbc.location.
      4. En el archivo teamserver.properties, añada las propiedades siguientes:
        Donde:
        • puerto_no_seguro es el puerto no seguro del servidor Tomcat (el valor predeterminado es 8080)
        • puerto_seguro es el número de puerto seguro del servidor Tomcat (el valor predeterminado es 8443)
        • dir_temp_team es la vía de acceso absoluta de un directorio para almacenar archivos temporales
        com.ibm.team.scm.tmpdir=dir_temp_team
        com.ibm.team.repository.server.repourl.port.http=puerto_no_seguro
        com.ibm.team.repository.user.registry.type=UNSUPPORTED
        com.ibm.team.repository.ws.allow.admin.access=false
        com.ibm.team.repository.server.repourl.port.https=puerto_seguro
    • Para Oracle:
      1. Encuentre las líneas siguientes:
        com.ibm.team.repository.db.vendor = ORACLE
        com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
        com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      2. Edite el valor de com.ibm.team.repository.db.jdbc.location para la ubicación de su servidor Oracle y el nombre de la base de datos para ciclos de vida:
        1. Sustituya jazzDBUser por el nombre de usuario de la base de datos Oracle (por ejemplo, RAMSCHEMA).
        2. Sustituya @localhost:1521 por la ubicación y el puerto de la base de datos Oracle. Si la ubicación no es localhost, debe anteponer dos barras inclinadas (//) a la ubicación; por ejemplo, @//oracleserver.example.com:1521.
        3. Sustituya ORCL por el nombre de la base de datos para ciclos de vida; por ejemplo, rtcdb.
      3. En la propiedad com.ibm.team.repository.db.jdbc.password, sustituya JazzDBpswd por la contraseña del usuario de Oracle que especificó anteriormente.
        Nota: No cambie el texto {password} en la propiedad com.ibm.team.repository.db.jdbc.location.
      4. En el archivo teamserver.properties, añada las propiedades siguientes:
        Donde:
        • puerto_no_seguro es el puerto no seguro del servidor Tomcat (el valor predeterminado es 8080)
        • puerto_seguro es el número de puerto seguro del servidor Tomcat (el valor predeterminado es 8443)
        • dir_temp_team es la vía de acceso absoluta de un directorio para almacenar archivos temporales
        com.ibm.team.scm.tmpdir=dir_temp_team
        com.ibm.team.repository.server.repourl.port.http=puerto_no_seguro
        com.ibm.team.repository.user.registry.type=UNSUPPORTED
        com.ibm.team.repository.ws.allow.admin.access=false
        com.ibm.team.repository.server.repourl.port.https=puerto_seguro
      5. Si está utilizando Oracle 11: en el archivo teamserver.properties, añada la propiedad siguiente:
        com.ibm.team.repository.db.override.versioncheck=true
    • Para Microsoft SQL Server:
      1. Encuentre las líneas siguientes:
        com.ibm.team.repository.db.vendor = SQLSERVER
        com.ibm.team.repository.db.jdbc.location=//localhost:1433;databaseName=jazz;user=jazzDBuser;password={password}
        com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      2. Edite el valor de com.ibm.team.repository.db.jdbc.location para la ubicación de su servidor SQL y el nombre de la base de datos para ciclos de vida:
        1. Sustituya @localhost:1433 por la ubicación y puerto de la base de datos del servidor SQL.
        2. Sustituya jazz por el nombre de la base de datos para ciclos de vida; por ejemplo, RTCDB.
        3. Sustituya jazzDBUser por el nombre de usuario para la base de datos del servidor SQL.
      3. En la propiedad com.ibm.team.repository.db.jdbc.password, sustituya JazzDBpswd por la contraseña del usuario del servidor SQL que especificó anteriormente.
        Nota: No cambie el texto {password} en la propiedad com.ibm.team.repository.db.jdbc.location.
      4. En el archivo teamserver.properties, añada las propiedades siguientes:
        Donde:
        • puerto_no_seguro es el puerto no seguro del servidor Tomcat (el valor predeterminado es 8080)
        • puerto_seguro es el número de puerto seguro del servidor Tomcat (el valor predeterminado es 8443)
        • dir_temp_team es la vía de acceso absoluta de un directorio para almacenar archivos temporales
        com.ibm.team.scm.tmpdir=dir_temp_team
        com.ibm.team.repository.server.repourl.port.http=puerto_no_seguro
        com.ibm.team.repository.user.registry.type=UNSUPPORTED
        com.ibm.team.repository.ws.allow.admin.access=false
        com.ibm.team.repository.server.repourl.port.https=puerto_seguro
  12. Cree tablas para Rational Team Concert:
    1. Abra una ventana de línea de mandatos y vaya al directorio rtc_install_dir/jazz/server/.
    2. Entre el mandato siguiente:
      • Para Windows:
        repotools.bat -createTables teamserver.properties=conf\jazz\teamserver.properties
      • Para Linux:Para AIX:Para Linux para zSeries:
        ./repotools.sh -createTables teamserver.properties=conf/jazz/teamserver.properties
  13. Configure el servidor Tomcat para la seguridad de usuario. Si desea utilizar la seguridad LDAP, utilice primero la seguridad basada en archivos para configurar las aplicaciones, y luego cambie a la autenticación LDAP una vez configuradas las aplicaciones. Para obtener más información, consulte Configurar la autenticación LDAP para Tomcat.
    1. En un editor de texto, abra el archivo directorio_instalación_tomcat_para_rtc\conf\tomcat-users.xml. De nuevo, si está instalando las aplicaciones en el mismo servidor Tomcat, este archivo es el mismo archivo donde modificó los valores de seguridad de usuario para las aplicaciones de Rational Asset Manager.
    2. Entre las etiquetas <tomcat-users>, pegue el texto siguiente:
      <role rolename="JazzUsers"/>
      <role rolename="JazzAdmins"/>
      <role rolename="JazzDWAdmins"/>
      <role rolename="JazzGuests"/>
    3. Añada un usuario llamado admin y asigne los roles admin, manager y JazzAdmins a ese usuario. Para añadir este usuario, puede copiar y pegar el texto siguiente entre las etiquetas <tomcat-users>:
      <user username="admin" password="" roles="admin,manager,JazzAdmins" />

      Si está instalando las aplicaciones en el mismo servidor Tomcat, añada el rol JazzAdmins al usuario que creó cuando modificó los valores de seguridad de usuario para las aplicaciones de Rational Asset Manager.

  14. Inicie el servidor Tomcat para Rational Team Concert.
    Para iniciar Tomcat, ejecute el archivo siguiente:
    • Para Windows:directorio_instalación_tomcat_para_rtc\bin\startup.bat
    • Para Linux:Para AIX:Para Linux para zSeries:directorio_instalación_tomcat_para_rtc/bin/startup.sh
  15. Configure Rational Team Concert para trabajar con Rational Asset Manager. Debe configurar derechos administrativos y crear un área de proyecto en Rational Team Concert.

Comentarios