Comando de Ferramentas de Repositório para Verificar um Arquivo de Mapeamento

Use o comando verifyURLMappings antes de uma renomeação para verificar se o arquivo de mapeamento é válido.

Propósito

O comandverifyURLMappings é usado para verificar um arquivo de mapeamento. Execute o comando após gerar e editar um arquivo de mapeamento, mas antes de importar o arquivo de mapeamento no servidor. verifyURLMappings deve ser executado com o comando repotools-jts e requer que o parâmetro repositoryURL aponte para um Jazz ® Team Server. O comando executa as seguinte verificações:

  • Verifica se há mapeamentos ausentes no arquivo de mapeamento gerado
  • Verifica se há URLs correspondentes com diferenças de maiúsculas e minúsculas
  • Verifica a sintaxe do arquivo de mapeamento que importURLMappings requer
  • Verifica se há origens e destinos duplicados
  • Verifica se há pares origem/destino onde origem=destino
  • Padrão/Nenhuma porta deve ter alternativas - quando nenhuma porta é especificada, significa que a URL usa uma porta padrão, como a porta 443 para HTTPS ou porta 80 para HTTP. O verifyURLMappings verifica se uma declaração de porta explícita é incluída no arquivo de mapeamentos, além da porta padrão. Não incluir uma ou outras dessas URLs pode causar problemas com um servidor renomeado. Geralmente, isso só é uma preocupação com os aplicativos IBM® Engineering Lifecycle Management ou com integrações externas, como o ClearQuest®. Não é uma preocupação ao lidar com URLs externos, como www.ibm.com.

    Para evitar o aviso Padrão/Nenhuma porta, deverá haver dois mapeamentos para uma URL sem nenhuma porta ou com o número da porta padrão. Por exemplo, se você tiver um mapeamento para http://www.eclipse.org/projects, um mapeamento também deverá ser incluído para http://www.eclipse.org:80/projects. Da mesma forma, se você tiver um mapeamento para https://www.ibm.com/news, um mapeamento também deverá ser incluído para https://www.ibm.com:443/news.

Nota: Os problemas relatados por este comando não indicam necessariamente que o arquivo de mapeamento está errado. Esses problemas, na maioria das vezes, são apenas para alertar os administradores sobre quaisquer discrepâncias entre o arquivo gerado e o arquivo verificado. Por exemplo, o comando pode indicar que você não mapeou um CCM, mas se você não renomeou um CCM, isso já não seria um erro.
Importante: O servidor deve estar em execução quando você executar o comando.

Parâmetros

Atributo Descrição Necessário Padrão
mappingFile Caminho para o arquivo de mapeamento a ser verificado. NÃO mapping.txt
adminUserId ID do usuário administrador para efetuar login no repositório do Jazz. Sim ADMIN
adminPassword Senha do administrador para efetuar login no repositório do Jazz. Sim ADMIN
repositoryURL A URL de conexão para o servidor. NÃO https://localhost:9443/jts
credentialsFile O arquivo que contém as credenciais de login do usuário administrativo. NÃO credentials.properties
certificateFile O arquivo contendo o arquivo de certificado do usuário administrador. NÃO nenhum
logFile Caminho para o arquivo de log. NÃO repotools-jts_verifyURLMappings.log
smartCard O alias para efetuar login usando um smart card, ou ? para listar aliases disponíveis. NÃO nenhum
kerberos Autentique-se com credenciais de usuário do Windows usando Kerberos/SPNEGO configurando para true. Ou autenticar com a Autenticação Integrada do Windows configurando-se como windows. NÃO Nenhum (a)

Exemplo

Para o sistema operacional Windows Abra um prompt de comandos e insira esse comando:

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-jts.bat -verifyURLMappings mappingFile=C:\mappings.txt adminUserId=adminID adminPassword=adminPswd kerberos=true

Para o sistema operacional Unix Abra uma linha de comandos ou insira este comando:

cd opt/IBM/JazzTeamServer/server/
./repotools-jts.sh -verifyURLMappings mappingFile=opt/mappings.txt adminUserId=adminID adminPassword=adminPswd