Desplegar Rational Asset Manager en Apache Tomcat V5.5 conectado a SQL Server 2005

Puede instalar IBM® Rational Asset Manager manualmente en una instalación existente de Apache Tomcat.
Antes de empezar

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

Necesitará el archivo sqljdbc.jar, que permite a Tomcat comunicarse con Microsoft® SQL Server. Su proveedor de servidor de bases de datos deberá proporcionarle estos archivos.

Por qué y cuándo se efectúa esta tarea

Si desea mejorar el rendimiento y la estabilidad de Rational Asset Manager, puede instalar las aplicaciones Web para Rational Asset Manager y los archivos de aplicación para el Rational Team Concert incluido en los servidores Tomcat independientes. A lo largo de este documento, se hará referencia al directorio de instalación para el servidor Tomcat para Rational Asset Manager como <tomcat_install_directory>, y el directorio de instalación para el servidor Tomcat para Rational Team Concert es <tomcat_for_rtc_install_directory>. Si está instalando todas las aplicaciones Web en el mismo servidor, los directorios serán el mismo.

Nota: Si tiene intención de desplegar Rational Asset Manager y el Rational Team Concert incluido en distintas aplicaciones de servidor Tomcat en la misma máquina, asegúrese de que ha configurado los distintos servidores Tomcat para utilizar distintos puertos seguros y no seguros para evitar colisiones. Para obtener más información sobre los puertos en Tomcat 5.5, consulte la documentación de Apache Tomcat.
  1. Verifique que todos los servidores del repositorio están establecidos en la misma fecha, hora y huso horario actuales.
  2. Recupere los archivos del servidor Rational Asset Manager en el archivador adecuado para Tomcat y para su sistema operativo. Los archivos de aplicación estarán en la carpeta <archive_extract_location>/apps/tomcat/.
  3. Extraiga los archivos de biblioteca compartida en la carpeta <tomcat_install_directory>\shared\lib:
    1. Busque y extraiga el archivo <archive_extract_location>\apps\tomcat\sharedLib.zip.
    2. Copie todo el contenido del archivo sharedLib.zip extraído en el directorio <tomcat_install_directory>\shared\lib.
    3. Si está instalando Rational Team Concert en otro servidor Tomcat, repita la operación de copiar los contenidos extraídos del archivo sharedLib.zip al directorio <tomcat_for_rtc_install_directory>\shared\lib para el otro servidor Tomcat.
  4. Desde el directorio <archive_extract_location>/apps/tomcat/, copie los siguientes archivos del directorio <tomcat_install_directory>/webapps/:
    • com.ibm.ram.repository.web.tomcat_runtime.war
    • com.ibm.ram.repository.web.ws.tomcat_runtime.war
    • iehs.war
    • rmcabdgovernprocess.war
  5. Para cambiar la vía de acceso de contexto de las aplicaciones, elimine los archivos de aplicación WAR. Recomendamos estos nombres:
    Tabla 1. Vías de acceso de contexto recomendadas para los archivos de aplicación Web de Rational Asset Manager
    Nombre del archivo original Nombre de archivo recomendado Vía de acceso de contexto resultado ¿Qué es?
    com.ibm.ram.repository.web.tomcat_runtime.war ram.war ram Aplicación Web primaria de Rational Asset Manager para Tomcat
    com.ibm.ram.repository.web.ws.tomcat_runtime.war ram.ws.war ram.ws Aplicación de servicios Web de Rational Asset Manager para Tomcat
    iehs.war ram.help.war ram.help Ayuda y aplicación de asistencia de usuarios de Rational Asset Manager
    rmcabdgovernprocess.war ram.process.war ram.process Aplicación de documentación para los procesos de gobierno y desarrollo basados en activos
  6. Configure el servidor Tomcat para que Rational Asset Manager acceda a SQL Server.
    1. En un editor de texto, abra el archivo <tomcat_install_directory>\conf\server.xml.
    2. Busque las líneas de server.xml que empiecen por <Connector y que contengan port="8080" o port="8009". Cambie el inicio de estas líneas por <Connector URIEncoding="UTF-8".
    3. Entre los códigos de apertura y de cierre para recursos JNDI globales <GlobalNamingResources> y </GlobalNamingResources> en server.xml, especifique el texto siguiente para su versión de Tomcat.
      Nota: Para los valores <su_nombre_de_usuario> y <su_contraseña>, utilice un ID de usuario y una contraseña que tengan acceso administrativo completo a la base de datos. Los valores mostrados para "maxWait", “maxActive" y "maxIdle" son valores de ejemplo y pueden ajustarse según sus necesidades de rendimiento.
    Entre este texto:
    <Resource name="jdbc/RAM_Con"
    type="javax.sql.DataSource"
    driverClassName="com.microsoft.jdbc.sqlserver.SQLServerDriver"
    username="<su_nombre_de_usuario>"
    password="<su_contraseña>"
    url="jdbc:microsoft:sqlserver://<fully_qualified_server_name>:<SQLServer_port_number>:<Rational_Asset_Manager_database_name>"
    poolPreparedStatements="true"
    maxWait="5000"
    maxActive="4"
    maxIdle="2"/>
  7. Añada el archivo JAR siguiente a la carpeta <directorio_instalación_tomcat>\common\lib:
    • sqljdbc.jar
    Este archivo está disponible en el proveedor de aplicaciones de base de datos.
  8. Busque el archivo <archive_extract_location>/apps/tomcat/RTC-server.zip en el soporte de instalación.
  9. Extraiga RTC-server.zip en una ubicación del disco duro, a la que se hace referencia en estas instrucciones como <rtc_install_dir>.
  10. Busque el archivo <rtc_install_dir>/jazz/server/jazz_war.ear y extráigalo. Puede utilizar el programa de utilidad gratuito 7-Zip para extraer los archivos .ear. Desde el paquete jazz_war.ear extraído, copie el archivo jazz.war al directorio <tomcat_for_rtc_install_directory>/webapps/.
  11. Configure un puerto seguro para el servidor Tomcat para Rational Team Concert:
    1. Debe crear un certificado de seguridad que identifique el servidor Tomcat para Rational Team Concert para las conexiones SSL. Puede utilizar el mandato keytool del JDK Java para crear un certificado autofirmado, o bien puede solicitar un certificado firmado por una autoridad de certificación de confianza.

      Par obtener más información sobre la creación de certificados autofirmados con el mandato keytool, consulte la Documentación de Sun Java. Con el mandato keytool puede crear un certificado autofirmado con el siguiente mandato de ejemplo: keytool -genkey -alias tomcat -keystore <tomcat_for_rtc_install_directory>/.keystore

      Si está utilizando un JRE de IBM, muchas versiones incluyen la herramienta de IBM ikeyman 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 el uso de la herramienta iKeyman, consulte iKeyman User's Guide.

    2. En el archivo <tomcat_for_rtc_install_directory>\conf\server.xml, ubique el separador <Conector> con el atributo scheme="https". El archivo predeterminado incluye una <Conector> de ejemplo para el puerto 8443 comentado.
    3. Copie y pegue este texto:
      <Connector port="8443"
           maxHttpHeaderSize="8192"
           maxThreads="150"
           minSpareThreads="25"
           maxSpareThreads="75"
           enableLookups="false"
           disableUploadTimeout="true"
           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 de archivo del archivo del almacén de claves. Puede ser una vía de acceso absoluta o bien el directorio raíz del servidor Tomcat (<tomcat_for_rtc_install_directory>);
      • <keystore_password> es la contraseña del archivo del almacén de claves;
      • <keystore_protocol> es el protocolo del almacén de claves. Probablemente sea TLS o SSL_TLS;
      • <keystore_algorithm> es el algoritmo X509 del almacén de claves. Probablemente sea SunX509 o IbmX509, dependiendo del origen del certificado.
    4. Si modifica el valor port para utilizar otro puerto distinto del 8443, para el conector no SSL (el puerto predeterminado es 8080), 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.

  12. Configure los valores de propiedades de inicio de Tomcat:
    1. Copie el siguiente archivo .jar del proveedor de bases de datos en la carpeta <rtc_install_dir>/jazz/server/sqlserversqlserver):
      • sqljdbc.jar
    2. Busque el archivo de inicio de Tomcat y ábralo en un editor de texto. En Windows® es <tomcat_for_rtc_install_directory>\bin\startup.bat. En Linux®, AIX, o Linux para zSeries, es <tomcat_for_rtc_install_directory>/bin/startup.sh.
    3. En el archivo de inicio, teclee el texto siguiente, donde <rtc_install_dir> es el directorio extraído en el paso 9, y <sqlServer_jar_dir> es la ubicación del archivo .jar de SQL Server del paso 12.a:
      • Para Windows: (sustituya los espacios de <rtc_install_dir> y <sqlServer_jar_dir> por %20):
        set SQLSERVER_JDBC=<sqlServer_jar_dir>
        set JAZZ_INSTALL_DIR=<rtc_install_dir>
        set JAVA_OPTS=-Djava.awt.headless=true -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 for zSeries::
        SQLSERVER_JDBC=<sqlServer_jar_dir>
        JAZZ_INSTALL_DIR=<rtc_install_dir>
        export JAVA_OPTS="-Djava.awt.headless=true -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"
  13. Edite el archivo de propiedades del servidor Jazz:
    1. En el directorio <rtc_install_dir>/jazz/server/conf/jazz/, busque el archivo teamserver.properties y redenomínelo como teamserver.derby.properties.
    2. En el directorio <rtc_install_dir>/jazz/server/conf/jazz/, busque el archivo teamserver.sqlserver.properties y redenomínelo como teamserver.properties.
    3. En el archivo teamserver.properties, especifique las propiedades de base de datos y conexión:
      1. En un editor de texto, abra el archivo teamserver.properties.
      2. Busque 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
      3. Edite el valor de com.ibm.team.repository.db.jdbc.location para la ubicación de SQL Server y el nombre de la base de datos para ciclos de vida:
        1. Sustituya @localhost:1433 por la ubicación y puerto para la base de datos de SQL Server.
        2. Sustituya jazz por el nombre de la base de datos de ciclos de vida; por ejemplo, RTCDB.
        3. Sustituya jazzDBUser por el nombre de usuario para la base de datos de SQL Server.
      4. En la propiedad com.ibm.team.repository.db.jdbc.password, sustituya JazzDBpswd por la contraseña para el usuario de SQL server que especificó antes.
        Nota: No cambie el texto {password} en la propiedad com.ibm.team.repository.db.jdbc.location.
      5. Añada las siguientes propiedades al archivo teamserver.properties, donde <puerto_no_seguro> es el puerto no seguro para el servidor Tomcat server (de forma predeterminada, 8080), <puerto_seguro> es el número de puerto seguro para el servidor Tomcat (de forma predeterminada, 8443), y <team_temp_dir> es una vía de acceso absoluta a un directorio para almacenar archivos temporales:
        com.ibm.team.scm.tmpdir=<team_temp_dir>
        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>
  14. 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. Ejecute el siguiente mandato:
      • Para Windows::
        repotools.bat -createTables teamserver.properties=conf\jazz\teamserver.properties
      • Para Linux:Para AIX:Para Linux for zSeries::
        ./repotools.sh -createTables teamserver.properties=conf/jazz/teamserver.properties
  15. Configure la seguridad de usuarios de los servidores Tomcat. Si pretende utiliza la seguridad LDAP, utilice primero la seguridad basada en archivos para configurar las aplicaciones y, a continuación, cambie a la autenticación LDAP una vez configuradas las aplicaciones (para obtener más información, consulte Configuración de la autenticación LDAP para Tomcat):
    1. En un editor de texto, abra el archivo <tomcat_install_directory>\conf\tomcat-users.xml (para el servidor para Rational Asset Manager).
    2. Añada un usuario denominado admin y asígnele los roles de admin y manager. Puede copiar y pegar lo siguiente entre las etiquetas <tomcat-users>:
      <user username="admin" password="" roles="admin,manager" />

      El nombre de este usuario debe ser admin.

    3. En un editor de texto, abra el archivo <tomcat_for_rtc_install_directory>\conf\tomcat-users.xml (para el servidor para Rational Team Concert). De nuevo, si está instalando las aplicaciones en el mismo servidor Tomcat, este archivo será el mismo que el del paso 15a.
    4. Pegue el siguiente texto entre las etiquetas <tomcat-users>:
      <role rolename="JazzUsers"/>
      <role rolename="JazzAdmins"/>
      <role rolename="JazzDWAdmins"/>
      <role rolename="JazzGuests"/>
    5. Añada un usuario denominado admin y asígnele los roles de admin, manager y JazzAdmins. Puede copiar y pegar lo siguiente entre las etiquetas <tomcat-users>:
      <user username="admin" password="" roles="admin,manager,JazzAdmins" />

      Si está instalando las aplicaciones en el mismo servidor, puede añadir el rol JazzAdmins al usuario que ha creado en el paso 13b.

  16. Reinicie el servidor Tomcat.
  17. Configure el usuario administrativo para Rational Team Concert:
    1. Lance la interfaz de usuario web Admin de Rational Team Concert en un navegador web en https://<nombre_máquina>:<puerto_seguro>/jazz/admin/. Tenga en cuenta que el https debe ser una conexión segura.
    2. Inicie la sesión con el ID de usuario y Contraseña para el administrador del servidor de aplicaciones. Si ve un error de "captación de información de estado de servidor," cierre y reinicie tanto el servidor de bases de datos como el servidor Tomcat y, a continuación, vuelva a iniciar una sesión.
    3. Pulse Gestión de usuarios. Ignore los errores relacionados con que hay un registro externo sin configurar.
    4. Pulse Crear usuario.
    5. Especifique los siguientes detalles:
      1. Nombre de usuario: El ID de usuario del administrador del servidor Tomcat
      2. ID de usuario: El ID de usuario del administrador del servidor Tomcat
      3. Dirección de correo electrónico: Una dirección de correo electrónico válida para el administrador del servidor Tomcat
    6. En la sección Licencias de acceso de clientes, seleccione Rational Team Concert - Desarrollador para asignar la licencia de desarrollador a ese usuario.
    7. Pulse Guardar.
    8. Finalice la sesión y vuelva a iniciar sesión en la interfaz de usuario web Admin como administrador del servidor de aplicaciones.
  18. Importe la plantilla de proceso de ciclos de vida a Rational Team Concert:
    1. En la interfaz de usuario web Admin de Rational Team Concert, pulse Gestión de plantillas de procesos. Si no puede ver el enlace Gestión de plantillas de procesos, finalice la sesión y vuelva a iniciar sesión en la interfaz de usuario web Admin.
    2. Pulse Importar plantilla y vaya al archivo com.ibm.ram.lifecycle.zip en la carpeta <archive_extract_location>/DatabaseScripts/. A continuación, pulse Aceptar. Verá que aparece la plantilla Ciclo de vida RAM.
  19. Cree un área de proyecto nueva en Rational Team Concert:
    1. En la interfaz de usuario web Admin de Rational Team Concert, pulse Gestión de área de proyectos. Si no puede ver el enlace Gestión de área de proyectos, finalice la sesión y vuelva a iniciar sesión en la interfaz de usuario web Admin.
    2. Pulse Crear área de proyectos.
    3. Especifique los siguientes detalles sobre el área de proyectos:
      • Nombre del proyecto: Ciclo de vida RAM
      • Resumen: Área de proyectos de control de ciclos de vida de Rational Asset Manager
      • Descripción: Esta área se utiliza para gestionar los ciclos de vida para Rational Asset Manager
    4. Pulse Guardar.
  20. Asigne las pertenencias adecuadas y roles de proceso para el área de proyectos:
    1. En la página Gestión de área de proyectos, pulse el área de proyecto Ciclo de vida de RAM.
    2. En la sección Administradores, pulse Añadir; y luego busque y seleccione el usuario administrador que ha creado.
    3. En la sección Miembros, pulse Añadir; y luego busque y seleccione el usuario administrador que ha creado.
    4. Después de añadir el administrador, pulse el icono Roles de proceso junto al nombre del administrador.
    5. En el diálogo Editar roles de proceso, desde la lista Roles disponibles, seleccione Administración y pulse Añadir.
    6. Pulse Finalizar.
    7. Pulse Guardar.
  21. Detenga y, a continuación, reinicie el servidor Tomcat.
  22. En un navegador web, abra Rational Asset Manager. Si ha utilizado los nombres recomendados para los archivos de aplicación, el URL será http://localhost:8080/ram/home.faces o bien, mediante un servidor Web, el URL será http://<Web_server_address>:<port>/ram/home.faces. Se abre el cliente web Rational Asset Manager.
Qué hacer a continuación
A continuación, configure la aplicación web de Rational Asset Manager. Para obtener más información, consulte la sección Configurar la aplicación del servidor Rational Asset Manager..

Comentarios