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.
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
- Verifique que todos los servidores del repositorio están establecidos en la misma fecha, hora y huso horario actuales.
- 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/.

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
- Busque y extraiga el archivo ubicación_extracción_archivador\sharedLibs\rlsclients_rlsibmratl_812.zip.
- 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.
- Extraiga el contenido del archivo rlsibmratl812.zip adecuado.
- 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.
- En el soporte de instalación, encuentre el archivo ubicación_extracción_archivador/apps/tomcat/RTC-server.zip.
- Extraiga RTC-server.zip en una ubicación de la unidad de disco
duro, que en estas instrucciones está representada por rtc_install_dir.
- 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/.
- Configure un puerto seguro para el servidor Tomcat para Rational Team Concert:
- 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
- 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.
- 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.
- 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.

Copie el
archivo .jar apropiado del proveedor de bases de datos:
- Configure los valores de propiedades de inicio de Tomcat:
- 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.
- En el archivo de inicio, escriba el texto siguiente:
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



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"
- Encuentre y renombre el archivo de propiedades
apropiado del servidor Jazz:
- En el directorio rtc_install_dir/jazz/server/conf/ramjazz/, encuentre el archivo teamserver.properties y cambie su nombre a
teamserver.derby.properties.
- Encuentre el archivo adecuado para su servidor de bases de datos:

Para DB2 en Windows: teamserver.db2.win32.properties



Para
DB2 en Linux, AIX, o Linux para zSeries: teamserver.db2.linux.properties
teamserver.oracle.properties
teamserver.sqlserver.properties
- Cambie el nombre del archivo a teamserver.properties.
- En un editor de texto, abra el archivo
teamserver.properties y modifíquelo de la manera siguiente (para su
proveedor de bases de datos):

- 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
- 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:
- 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.
- Sustituya JAZZ por el nombre de la base de datos para ciclos de vida.
- 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.
- 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.
- 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

- 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
- 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:
- Sustituya jazzDBUser por el nombre de usuario de la base de
datos Oracle (por ejemplo, RAMSCHEMA).
- 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.
- Sustituya ORCL por el nombre de la base de datos para ciclos de
vida; por ejemplo, rtcdb.
- 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.
- 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
- Si está utilizando Oracle 11: en el
archivo teamserver.properties, añada la propiedad siguiente:
com.ibm.team.repository.db.override.versioncheck=true

- 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
- 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:
- Sustituya @localhost:1433 por la ubicación y puerto de la base de
datos del servidor SQL.
- Sustituya jazz por el nombre de la base de datos para ciclos de
vida; por ejemplo, RTCDB.
- Sustituya jazzDBUser por el nombre de usuario para la base de datos
del servidor SQL.
- 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.
- 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
- Cree tablas para Rational Team Concert:
- Abra una ventana de línea de mandatos y vaya al directorio rtc_install_dir/jazz/server/.
- Entre el mandato siguiente:
- 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.
- 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.
- Entre las etiquetas <tomcat-users>, pegue el
texto siguiente:
<role rolename="JazzUsers"/>
<role rolename="JazzAdmins"/>
<role rolename="JazzDWAdmins"/>
<role rolename="JazzGuests"/>
- 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.
- Inicie el servidor Tomcat para Rational Team Concert.
Para iniciar Tomcat, ejecute el archivo siguiente:
directorio_instalación_tomcat_para_rtc\bin\startup.bat


directorio_instalación_tomcat_para_rtc/bin/startup.sh
- Configure Rational Team Concert
para trabajar con Rational Asset Manager.
Debe configurar derechos administrativos y crear un área de proyecto en Rational Team Concert.