O IBM® Rational Asset Manager requer o IBM Rational Team Concert,
que controla as funções de ciclo de vida que você pode usar para gerenciar o
desenvolvimento de ativos. Se você ainda não tiver o Rational Team Concert,
uma versão limitada desse produto será incluída, a qual pode ser implementada
em um servidor Tomcat.
Antes de Iniciar
Se você já implementou e configurou um aplicativo do servidor Rational Team Concert,
você pode usar o aplicativo existente em vez de instalar um novo aplicativo. Para configurar o Rational Team Concert para trabalhar
com o Rational Asset Manager,
consulte Configurando um Servidor Rational Team Concert para Trabalhar com o Rational Asset Manager.
É necessário ter acesso
administrativo e de
arquivo a um servidor Tomcat que esteja instalado e em execução.
Você deve ter um certificado de segurança para seu servidor Tomcat.
A versão incluída do Rational Team Concert requer
uma conexão segura.
Sobre Esta Tarefa
É possível melhorar o desempenho e a estabilidade do Rational Asset Manager instalando
seus aplicativos da Web e os arquivos de aplicativos para o
IBM Rational Team Concert incluído em
servidores Tomcat separados. Em todo este documento, o diretório de instalação para o servidor Tomcat para o Rational Asset Manager é
referido como tomcat_install_directory.
O diretório de instalação para o servidor Tomcat para o Rational Team Concert é tomcat_for_rtc_install_directory.
Se você estiver instalando todos os aplicativos da Web no mesmo servidor Tomcat,
os diretórios serão os mesmos.
Procedimento
- Verifique se todos os servidores do repositório
estão configurados para a mesma data, hora e fuso horário atuais.
- Recupere os arquivos de aplicativos no archive apropriado
para o Tomcat e para o seu sistema operacional. Os arquivos de aplicativos estão na pasta
archive_extract_location/apps/tomcat/.

Extraia os arquivos de biblioteca do Rational Licensing Key Server
V8.1.2
para a pasta
tomcat_for_rtc_install_directory\shared\lib:
Importante: Não conclua esta etapa no Linux para zSeries
- Localize e extraia o arquivo
archive_extract_location\sharedLibs\rlsclients_rlsibmratl_812.zip.
- No arquivo .zip extraído, localize o arquivo
rlsibmratl812.zip
para o sistema operacional e a arquitetura. Por exemplo, o arquivo para Windows de 32 bits está no diretório win32.
- Extraia o conteúdo do arquivo
rlsibmratl812.zip
apropriado.
- Copie o conteúdo extraído do arquivo
rlsibmratl812.zip
para o diretório tomcat_for_rtc_install_directory\shared\lib.
Se você estiver instalando o Rational Asset Manager e o Rational Team Concert no
mesmo servidor de aplicativos, você já concluiu esta etapa.
- Na mídia de instalação, localize o arquivo archive_extract_location/apps/tomcat/RTC-server.zip.
- Extraia RTC-server.zip para um local
na sua unidade de disco rígido, que é referida nessas instruções
como rtc_install_dir.
- Localize o arquivo rtc_install_dir/jazz/server/ramjazz_war.ear e o extraia. Para extrair arquivos .ear, você pode usar um
utilitário grátis, como 7-Zip. No pacote ramjazz_war.ear extraído,
copie o arquivo ramjazz.war no diretório tomcat_for_rtc_install_directory/webapps/.
- Configure uma porta segura no seu servidor Tomcat para o Rational Team Concert:
- Crie um certificado de segurança que identifique seu servidor Tomcat para o
Rational Team Concert para
conexões SSL. Você pode usar o comando Java JDK keytool
para criar um certificado autoassinado. De forma alternativa, você pode solicitar um
certificado que seja assinado por uma autoridade de certificação confiável.
Para obter mais informações sobre como criar certificados autoassinados com o comando
keytool, consulte a
documentação
do Oracle Java.
Você pode criar um certificado autoassinado com o seguinte comando
keytool de exemplo:
keytool -genkey -alias tomcat -keystore tomcat_for_rtc_install_directory/.keystore
Ao executar este comando, será solicitada a você uma senha
para o arquivo keystore. A senha padrão é changeit,
mas você deve especificar uma diferente. Será necessário lembrar essa
senha para inseri-la no arquivo server.xml mais
tarde.
Se estiver utilizando um IBM JRE,
muitas versões incluem a ferramenta da IBM
ikeyman no diretório IBM_Java_JRE_install_location/jre/bin/.
Essa ferramenta pode ser usada para criar e gerenciar certificados de segurança no
servidor. Para obter informações adicionais sobre como usar a ferramenta iKeyman, consulte o iKeyman User's Guide.
Também incluímos um certificado simples na pasta rtc_install_dir/jazz/server/;
o arquivo de certificado é ibm-team-ssl.keystore
- No arquivo tomcat_for_rtc_install_directory\conf\server.xml, localize a tag <Connector> com o atributo scheme="https".
O arquivo padrão inclui uma tag <Connector> de exemplo
para a porta 8443 que está comentada.
- Copie e cole o seguinte 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" />
Em que:
- keystore_file é o
nome do arquivo do seu arquivo keystore. Ele pode ser um caminho absoluto ou
relativo a partir do diretório-raiz do seu servidor Tomcat(tomcat_for_rtc_install_directory).
Se você usou o comando simples acima, este será .keystore.
Se você utilizar o certificado incluído, ele será rtc_install_dir/jazz/server/ibm-team-ssl.keystore .
- keystore_password é a senha
para o arquivo keystore. Se você utilizar o arquivo keystore incluído,
ele será ibm-team .
- keystore_protocol é o
protocolo para o keystore. Mais provavelmente, é TLS ou SSL_TLS.
Se você utilizar o arquivo keystore incluído, ele será SSL_TLS .
- keystore_algorithm é o
algoritmo X509 para o keystore. Mais provavelmente, é SunX509 ou IbmX509,
dependendo da origem do certificado. Se você utilizar o arquivo keystore incluído,
ele será IbmX509 .
- Você pode alterar o valor de porta para usar uma porta
além de 8443 para o conector não SSL (por
padrão, porta 8080). Se alterar o valor de porta,
altere o valor do atributo redirectPort para que
corresponda ao número da porta para o conector SSL.
Para obter informações adicionais sobre como configurar o SSL para Tomcat, consulte Configuração do SSL do Apache Tomcat 5.5 - INSTRUÇÕES e Configuração do Apache Tomcat - Referência.

Copiar o arquivo .jar apropriado
do provedor de banco de dados:
- Configure as definições de
propriedade de inicialização de Tomcat:
- Localize o arquivo de inicialização do Tomcat
e abra-o em um editor de texto. No Windows, este arquivo é tomcat_for_rtc_install_directory\bin\startup.bat.
No Linux, AIX ou Linux para zSeries, o arquivo é tomcat_for_rtc_install_directory/bin/startup.sh.
- No arquivo de inicialização, digite o seguinte texto:
Substitua cada caractere de espaço no 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="tomcat_for_rtc_install_directory\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=tomcat_for_rtc_install_directory/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"
- Localize e renomeie o arquivo de propriedades do servidor Jazz apropriado:
- No diretóriortc_install_dir/jazz/server/conf/ramjazz/,
localize o arquivo teamserver.properties e renomeie-o como
teamserver.derby.properties.
- Localize o arquivo apropriado para seu servidor de banco de dados:

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



Para DB2 no Linux, AIX ou Linux para
zSeries: teamserver.db2.linux.properties
teamserver.oracle.properties
teamserver.sqlserver.properties
- Renomeie o arquivo para teamserver.properties.
- Em um editor de texto, abra o arquivo teamserver.properties
e modifique-o da seguinte maneira (para o provedor de banco de dados):

- Localize as seguintes linhas:
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 o valor de com.ibm.team.repository.db.jdbc.location
para o local do servidor DB2 e o nome
do banco de dados para ciclos de vida:
- Substitua localhost:50000 pelo local e
porta do banco de dados DB2.
Dica: Na janela de comando do DB2, digite
db2 get dbm cfg e, em seguida, localize a linha
que contém SVCENAME, que indica o nome ou número da porta do DB2. Se este comando exibir um número, use-o como o número da porta (no lugar de 50000 no exemplo
anterior). Se o comando retornar
um nome não-numérico, determine o número da porta designado para este nome
e use esse número da porta. No Linux,
o arquivo /etc/services contém o mapeamento entre
nomes e números de portas; no Windows,
o arquivo C:\windows\system32\drivers\etc\services
contém o mapeamento. Para obter informações adicionais, consulte o administrador de banco de dados
ou a documentação do banco de dados.
- Substitua JAZZ pelo nome do banco de dados para ciclos de vida.
- Substitua db2admin pelo nome de usuário para o banco de dados DB2.
Nota: O usuário do DB2 deve ter permissões para
criar tabelas, espaços de tabela e para modificar a configuração do banco de dados. Os usuários do DB2 são criados pelo
sistema operacional.
- Na propriedade com.ibm.team.repository.db.jdbc.password,
especifique a senha de usuário.
Nota: Não
altere o texto password={password} na
propriedade com.ibm.team.repository.db.jdbc.location.
- No arquivo teamserver.properties,
inclua as seguintes propriedades:
Em que:
- unsecure_port é a porta não segura para o servidor
Tomcat (por padrão, 8080)
- secure_port é o número da porta segura para o servidor
Tomcat (por padrão, 8443)
- team_temp_dir é um caminho absoluto para um diretório
para armazenar arquivos temporários
com.ibm.team.scm.tmpdir=team_temp_dir
com.ibm.team.repository.server.repourl.port.http=unsecure_port
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=secure_port

- Localize as seguintes linhas:
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 o valor de com.ibm.team.repository.db.jdbc.location
para o local do servidor Oracle e o nome do banco de dados para ciclos de vida:
- Substitua jazzDBUser pelo nome de usuário para
o banco de dados do Oracle (por exemplo, RAMSCHEMA.
- Substitua @localhost:1521 pelo local e porta
para o banco de dados Oracle. Se o local não for localhost,
será necessário preceder o local com duas barras (//);
por exemplo, @//oracleserver.example.com:1521.
- Substitua ORCL pelo nome do banco de dados do ciclo de vida;
por exemplo, rtcdb.
- Na propriedade com.ibm.team.repository.db.jdbc.password,
substitua JazzDBpswd pela senha para o usuário do Oracle especificada
anteriormente.
Nota: Não altere o texto {password} na
propriedade com.ibm.team.repository.db.jdbc.location.
- No arquivo teamserver.properties,
inclua as seguintes propriedades:
Em que:
- unsecure_port é a porta não segura para o servidor
Tomcat (por padrão, 8080)
- secure_port é o número da porta segura para o servidor
Tomcat (por padrão, 8443)
- team_temp_dir é um caminho absoluto para um diretório
para armazenar arquivos temporários
com.ibm.team.scm.tmpdir=team_temp_dir
com.ibm.team.repository.server.repourl.port.http=unsecure_port
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=secure_port
- Se estiver utilizando Oracle 11: No arquivo teamserver.properties,
inclua a seguinte propriedade:
com.ibm.team.repository.db.override.versioncheck=true

- Localize as seguintes linhas:
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 o valor de com.ibm.team.repository.db.jdbc.location
para o local do SQL Server e o nome do banco de dados para ciclos de vida:
- Substitua @localhost:1433 pelo local e porta
para o banco de dados SQL Server.
- Substitua jazz pelo nome do banco de dados do ciclo de vida;
por exemplo, RTCDB.
- Substitua jazzDBUser pelo nome de usuário
para o banco de dados SQL Server.
- Na propriedade com.ibm.team.repository.db.jdbc.password,
substitua JazzDBpswd pela senha para o usuário do servidor SQL
especificada anteriormente.
Nota: Não altere o texto {password} na
propriedade com.ibm.team.repository.db.jdbc.location.
- No arquivo teamserver.properties,
inclua as seguintes propriedades:
Em que:
- unsecure_port é a porta não segura para o servidor
Tomcat (por padrão, 8080)
- secure_port é o número da porta segura para o servidor
Tomcat (por padrão, 8443)
- team_temp_dir é um caminho absoluto para um diretório
para armazenar arquivos temporários
com.ibm.team.scm.tmpdir=team_temp_dir
com.ibm.team.repository.server.repourl.port.http=unsecure_port
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=secure_port
- Crie as tabelas para o Rational Team Concert:
- Abra uma janela de linha de comandos e navegue para o diretório
rtc_install_dir/jazz/server/.
- Insira o seguinte comando:
- Configure o servidor Tomcat
para segurança do usuário. Se você pretende usar a segurança LDAP, primeiro use a segurança
baseada em arquivo para configurar os aplicativos e, depois de configurá-los,
alterne para autenticação LDAP. Para
obter mais informações, consulte Configurando a Autenticação LDAP para Tomcat.
- Em um editor de texto, abra o arquivo tomcat_for_rtc_install_directory\conf\tomcat-users.xml. Novamente,
se estiver instalando os aplicativos no mesmo servidor Tomcat,
este arquivo será o mesmo no qual você modificou as configurações de segurança do usuário para os aplicativos
Rational Asset Manager.
- Entre as tags <tomcat-users>,
cole o seguinte texto:
<role rolename="JazzUsers"/>
<role rolename="JazzAdmins"/>
<role rolename="JazzDWAdmins"/>
<role rolename="JazzGuests"/>
- Inclua um usuário denominado admin e
designe a esse usuário as funções admin, manager e JazzAdmins. Para incluir este usuário,
você pode copiar e colar o seguinte texto entre as tags <tomcat-users>:
<user username="admin" password="" roles="admin,manager,JazzAdmins" />
Se
você estiver instalando os aplicativos no mesmo servidor Tomcat, inclua
a função JazzAdmins para o usuário criado quando você modificou as configurações de segurança do usuário para os aplicativos
Rational Asset Manager .
- Inicie o servidor Tomcat para
Rational Team Concert.
Para iniciar o Tomcat, execute o seguinte arquivo:
tomcat_for_rtc_install_directory\bin\startup.bat


tomcat_for_rtc_install_directory/bin/startup.sh
- Configure Rational Team Concert para
trabalhar com o Rational Asset Manager.
É necessário configurar direitos administrativos e criar uma área do projeto
no Rational Team Concert.