Desplegar las aplicaciones de servidor de Rational Asset Manager en Tomcat 5.5

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

Antes de empezar

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

Es necesario que conozca la ubicación de los siguientes archivos .jar de JDBC para el servidor de bases de datos:
  • Para IBM DB2:db2jcc_license_cu.jar y db2jcc.jar
  • Para Oracle:ojdbc5.jar. Si está utilizando Oracle 10, debe todavía utilizar el archivo ojdbc5.jar de Oracle 11. Puede descargar los archivos desde Oracle.
  • Para Microsoft SQL Server:sqljdbc.jar. Puede descargar los archivos desde Microsoft.

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.

Nota: Si desea desplegar Rational Asset Manager y la aplicación incluida de Rational Team Concert en aplicaciones de servidor Tomcat diferentes de una misma máquina, los diferentes servidores Tomcat deben estar configurados para utilizar puertos seguros y no seguros diferentes para evitar conflictos. Para obtener más información sobre puertos en Tomcat 5.5, consulte la documentación de Apache Tomcat.

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. Extraiga los archivos de biblioteca compartida a la carpeta directorio_instalación_tomcat\shared\lib:
    1. Encuentre y extraiga el archivo ubicación_extracción_archivador\apps\tomcat\sharedLib.zip.
    2. Copie todo el contenido del archivo sharedLib.zip en el directorio directorio_instalación_tomcat\shared\lib.
    3. Si instala Rational Team Concert en un servidor Tomcat diferente, copie el contenido extraído del archivo sharedLib.zip en el directorio directorio_instalación_tomcat_para_rtc\shared\lib para el otro servidor Tomcat.
  4. 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\shared\lib:
    Importante: Si está instalando en Linux for zSeries, no dé este paso
    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 completo del archivo rlsibmratl812.zip extraído en el directorio directorio_instalación_tomcat\shared\lib.
  5. Para Windows: Para Linux:Para AIX: Modifique el script de inicio del servidor Tomcat para Rational Asset Manager:
    Importante: Si está instalando en Linux for zSeries, no dé este paso
    1. Encuentre el archivo de inicio de Tomcat y ábralo en un editor de texto. En Windows, este archivo es directorio_instalación_tomcat\bin\startup.bat. En Linux, AIX, o Linux para zSeries, el archivo es directorio_instalación_tomcat/bin/startup.sh.
    2. En el archivo de inicio, escriba el texto siguiente:
      • Para Windows:
        set JAVA_OPTS=-Djava.library.path="directorio_instalación_tomcat\shared\lib"
      • Para Linux:Para AIX:
        export JAVA_OPTS="-Djava.library.path=directorio_instalación_tomcat/shared/lib"
  6. Desde el directorio ubicación_extracción_archivador/apps/tomcat/, copie los archivos siguientes en el directorio directorio_instalación_tomcat/webapps/:
    • com.ibm.ram.repository.web.tomcat_runtime.war
    • com.ibm.ram.repository.web.ws.tomcat_runtime.war
    • ramhelp.war
    • rmcabdgovernprocess.war
  7. Para cambiar la vía de acceso de contexto de las aplicaciones, renombre los archivos de aplicación WAR. Utilice los nombres siguientes.
    Tabla 1. Vías de acceso de contexto para archivos de aplicación web de Rational Asset Manager
    Nombre de archivo original Nombre de archivo nuevo Vía de acceso de contexto resultante Descripción
    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
    ramhelp.war ram.help.war ram.help Aplicación de ayuda y asistencia al usuario de Rational Asset Manager
    rmcabdgovernprocess.war ram.process.war ram.process Aplicación de documentación para procesos de desarrollo y administración basados en activos
  8. Configure el servidor Tomcat para que Rational Asset Manager acceda a su base de datos:
    1. En un editor de texto, abra el archivo directorio_instalación_tomcat\conf\server.xml.
    2. Encuentre las líneas de server.xml que comiencen por <Connector y que contengan port="8080" o port="8009". Cambie el inicio de esas líneas por <Connector URIEncoding="UTF-8".
    3. Entre las etiquetas de apertura y de cierre para recursos JNDI globales, <GlobalNamingResources> y </GlobalNamingResources>, escriba 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. Por ejemplo, el atributo "url" puede tener este aspecto: jdbc:db2://localhost:50000/RAMDB
    Escriba este texto para su servidor de bases de datos, sustituyendo las variables siguientes:
    • En los atributos username y password, sustituya su_nombre_de_usuario y su_contraseña por un ID de usuario y una contraseña que tengan acceso administrativo completo al servidor de bases de datos.
    • En el atributo url, sustituya nombre_servidor_bases_de_datos_completo y número_puerto_base_de_datos por la dirección de servidor y número de puerto correspondientes a su base de datos, y sustituya nombre_base_de datos_Rational_Asset_Manager por el nombre de la base de datos para activos. Por ejemplo, para DB2, el atributo url puede tener este aspecto: jdbc:db2://localhost:50000/RAMDB.
    • Los valores mostrados para los atributos maxWait, maxActive y maxIdle son valores de ejemplo y se pueden ajustar de acuerdo con las necesidades de rendimiento.
    • Para IBM DB2:
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="com.ibm.db2.jcc.DB2Driver"
      username="su_nombre_de_usuario"
      password="su_contraseña"
      url="jdbc:db2://nombre_servidor_bases_de_datos_completo:número_puerto_base_de_datos/nombre_base_de datos_Rational_Asset_Manager"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
    • Para Oracle:
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="oracle.jdbc.driver.OracleDriver"
      username="su_nombre_de_usuario"
      password="su_contraseña"
      url="jdbc:oracle:thin:@nombre_servidor_bases_de_datos_completo:número_puerto_base_de_datos:nombre_base_de datos_Rational_Asset_Manager"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
    • Para Microsoft SQL Server:
      <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://nombre_servidor_bases_de_datos_completo:número_puerto_base_de_datos:nombre_base_de datos_Rational_Asset_Manager"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
  9. Configure el servidor Tomcat para el inicio de sesión único para todas las aplicaciones:
    1. En un editor de texto, abra el archivo directorio_instalación_tomcat\conf\server.xml.
    2. Busque el texto siguiente:
      <!--
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
      -->
    3. Elimine la marca de comentario para el elemento <Valve>:
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
  10. Copie los siguientes archivos JAR en la carpeta directorio_instalación_tomcat\common\lib:
    • Para IBM DB2:
      • db2jcc_license_cu.jar
      • db2jcc.jar
    • Para Oracle:
      • ojdbc5.jar (Puede descargar este archivo desde Oracle. Si está utilizando Oracle 10, descargue el paquete de Oracle 11 para encontrar el archivo ojdbc5.jar).
    • Para Microsoft SQL Server:
    Estos archivos están disponibles en el proveedor de bases de datos, normalmente en la carpeta /java/ de la instalación de la base de datos.
  11. 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\conf\tomcat-users.xml.
    2. Añada un usuario denominado admin y asigne los roles admin y manager 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" />

      El nombre de este usuario debe ser admin.

  12. Dependiendo de la configuración utilizada, despliegue o configure Rational Team Concert.

Comentarios