A partir dos produtos da versão 4.0 para a solução Rational para Collaborative Lifecycle Management (CLM), os administradores podem alterar o URI público de um Jazz Team Server ou de um aplicativo da solução Rational para CLM após a implementação ao usar a operação de renomeação de servidor. Essas mudanças requerem atualizações correspondentes nos recursos da solução Rational para CLM que sejam baseados no URI. Para o ClearQuest Bridge, esses links de artefatos para os recursos de produtos da solução Rational para CLM (IBM Rational Team Concert, IBM Rational Quality Manager e IBM Rational Requirements Composer) estão armazenados em arquivos de configuração do servidor web ClearQuest e em registros OSLCLinks no banco de dados de usuários do ClearQuest.
O ClearQuest fornece a ferramenta clm_server_rename.pl para remapear links estruturais de URI que são armazenados em arquivos de configuração da web do ClearQuest e em registros OSLCLinks. Use a ferramenta para remapear o protocolo, nome do host, número da porta e contexto de aplicativo de links estruturais.
Executando a ferramenta
É obrigatório ter privilégios de administrador local e de super usuário do ClearQuest para executar a ferramenta clm_server_rename.pl.
A ferramenta está localizada neste diretório no arquivo cqweb.war:
O programa cqperl.exe está localizado no diretório onde o ClearQuest está instalado.
Antes de executar a ferramenta clm_server_rename.pl, é uma boa prática configurar a variável de ambiente TEMP como um diretório ao qual você tenha acesso de gravação. Caso contrário, assegure-se de ter acesso de gravação ao diretório no qual a ferramenta está sendo executada.
Você deve executar a ferramenta várias vezes.
Por exemplo, se o ClearQuest estiver integrado ao IBM Rational Team Concert e o IBM Rational Quality Manager e se o Jazz Team Server para Rational Team Concert e o servidor Rational Quality Manager forem renomeados, você deverá executar a ferramenta com a opção -remapconfigfiles duas vezes: uma para remapear os URIs para os links de artefatos do Rational Team Concert e outra para remapear os URIs para os links de artefatos do Rational Quality Manager.
Por exemplo, se o ClearQuest estiver integrado com o IBM Rational Team Concert e com o IBM Rational Quality Manager e se o Jazz Team Server para Rational Team Concert e o servidor Rational Quality Manager forem renomeados, você deverá executar a ferramenta com a opção -update duas vezes: uma para remapear os URIs para os links de artefatos do Rational Team Concert e outra para remapear os URIs para os links de artefatos do Rational Quality Manager.
Consulte Remapeando URIs Após Renomear um Servidor CLM para obter os detalhes completos do procedimento.
Consulte a seção Opções e Argumentos para obter uma descrição das opções da linha de comandos.
A ferramenta clm_server_rename.pl somente remapeia links estruturais que estão armazenados em arquivos de configuração do servidor web ClearQuest e em registros OSLCLinks. A ferramenta não remapeia links integrados que estejam armazenados em registros do ClearQuest. Esses links de âncora integrados podem estar incluídos em anexos de registros ou em campos como descrições ou notas. Dependendo do esquema, esses campos podem se tornar somente leitura depois do envio ou depois que uma nota é incluída. Isso significa que os links de âncora integrados permanecerão quebrados após a ferramenta ser executada. É possível criar código para corrigir esses links, se necessário.
Um exemplo de um link de âncora integrado que permanece quebrado depois da execução da ferramenta envolve a integração da solução Rational para CLM entre o Rational ClearQuest e o Rational Quality Manager. Quando um artefato do Rational Quality Manager é vinculado a um registro do ClearQuest, o Rational Quality Manager insere um link de URI no artefato no campo de descrição do registro.
Remapeia os links públicos de artefatos de URI do Jazz Team Server para os aplicativos da solução Rational para CLM. Especificamente, essa opção remapeia URIs que estão armazenadas em arquivos de configuração do servidor da web ClearQuest. A ferramenta faz uma cópia dos arquivos de configuração antes de remapear os URIs.
Depois de executar a ferramenta com essa opção, você deve reiniciar o servidor da web ClearQuest. Em seguida, a comunicação entre servidores no servidor da web é reconfigurada e os usuários podem criar novos links de URI para os artefatos da solução Rational para CLM. No entanto, seguir os links existentes para os artefatos da solução Rational para CLM não funcionará até que a ferramenta seja executada novamente com a opção -update.
Quando a ferramenta é executada com essa opção, ela captura as mudanças nos registros OSLCLinks em um arquivo de log. Se a variável de ambiente TEMP estiver configurada, o arquivo de log será gravado no diretório especificado; caso contrário, o arquivo de log será gravado no diretório no qual ele está sendo executado, desde que você tenha acesso de gravação. A convenção de nomenclatura de arquivo a seguir é usada para o arquivo de log:
sendo que:
Por exemplo, clm_server_rename_20120405_211711.
C:\was_profiles\MyCQWebServer\installedApps\Node02Cell\TeamEAR.ear\cqweb.war\WEB-INF\classes>cqperl clm_server_rename.pl -username admin -password secret -dbset 7.0.0 -dbname SAMPL -oldprefix https://clm7.mycompany.com/ccm/ -newprefix https://clm7.mycompany.com/jazz/ -remapconfigfiles
Iniciado: Remapeando URIs no arquivo de configuração friendsconfig.rdf.
Concluído: Remapeando URIs no arquivo de configuração friendsconfig.rdf.
Iniciado: Remapeando URIs no arquivo de configuração project-area-links.rdf.
Concluído: Remapeando URIs no arquivo de configuração project-area-links.rdf.
Iniciado: Remapeando URIs no arquivo de configuração oauth-consumers.rdf.
Concluído: Remapeando URIs no arquivo de configuração oauth-consumers.rdf.
cqperl clm_server_rename.pl -username admin -password secret -dbset 8.0.0 -dbname SAMPL -oldprefix https://servername.com:9443/jazz/ -newprefix https://servername.com:9443/ccm/ -preview 5
cqperl clm_server_rename.pl -username admin -password secret -dbset 8.0.0 -dbname SAMPL -oldprefix http://servername.com:9443/jazz/ -newprefix https://servername.com:9443/jazz/
cqperl clm_server_rename.pl -username admin -password secret -dbset 7.0.0 -dbname SAMPL -oldprefix http://servername.com:9443/jazz/ -newprefix https://newservername.com:9443/jazz/