Partilhar via


Solucionando problemas de Conversor ClearQuest

[Observação: Este tópico é pré-versão documentação e está sujeitas a alterações em versões futuras. Tópicos em branco são incluídos sistema autônomo espaços reservados.]

Se ocorrerem problemas ao migrar os itens de trabalho do ClearQuest para Team Foundation Server, o Conversor ClearQuest registra erros e avisos em um arquivo de relatório. A melhor maneira de solucionar problemas é analisar o arquivo de relatório para determinar o que ocorreu.As seguintes informações auxiliam na solução de problemas e erros que ocorrem com Conversor ClearQuest.

Nesta seção

Solucionando problemas de análise

License.dll arquivo não foi encontrado

Nenhum relatório de análise e análise de falha foi criado

Solucionando problemas de migração

O comando falha de migrar

Erros críticos quando conecta o conversor

Erros críticos ao provisionamento item de trabalho tipos

Não expandir seções do relatório de análise ou relatório de migração

Alterações de esquema do item de trabalho não migrar para o Team Foundation servidor

item de trabalho Migração falha devido a falha ao carregar do anexo

Solucionando problemas de análise

Quando ocorrem problemas de executar o comando de análise, é reportado um erro no console e o arquivo de relatório é gerado com detalhes sobre os problemas ocorridos.Na maioria das vezes, você pode corrigir a causa do erro e reiniciar o conversor.Se você não tiver certeza sobre a causa do erro, procurar número do erro ou texto exato no Team Foundation obter ajuda. Alguns erros também listam um erro interno foi reportado da ClearQuest API o conversor usa.Esses erros, você pode encontrar informações adicionais na documentação do ClearQuest.

License.dll arquivo não foi encontrado

Quando você executa o comando ANALYZE, você poderá receber o erro, "Este aplicativo falhou ao iniciar porque license.dll não foi encontrado.Reinstalar o aplicativo pode corrigir esse problema." Depois de clicar em OK, receber uma mensagem de erro adicional, "TF61118: telefonar de ClearQuest API falhou com o seguinte erro: Recuperando a fábrica de classes COM para o componente com CLSID {94773112 - 72E8 - 11 D 0-A42E-00A024DED613} falha devido ao seguinte erro: 8007007e.Consulte ClearQuest documentação para obter mais ajuda."

Estes erros ocorrem quando o conversor não pode carregar as bibliotecas ClearQuest, porque o caminho de bibliotecas não está configurado corretamente.

Solução

  • Verifique se o cliente ClearQuest está instalado no computador.Isso instala as bibliotecas necessárias.

  • Verifique se não você está executando o conversor de em uma janela de console que foi iniciada antes da instalação ClearQuest.Se você, abra uma nova janela do console e execute novamente o conversor.

  • Verifique se que a variável de ambiente caminho não foi modificada depois que o ClearQuest foi instalado.Variável de ambiente caminho deve conter caminhos para os arquivos DLL por ClearQuest instalados.Se esses caminhos estiverem faltando, talvez seja necessário reinstalar o ClearQuest.

Nenhum relatório de análise e análise de falha foi criado

Se o conversor for incapaz de carregar o arquivo de configuração, o comando analisar falhará e nenhum relatório será criado.

Solução

  • Use um editor XML ou ferramenta e verifique se o arquivo de configuração XML está bem formado.

  • Verifique se os elementos e atributos XML no arquivo de configuração estão especificados corretamente.Se você receber erros de validação, a mensagem de erro indicará o valor sem suporte e indica número de linha onde o valor está localizado.Para obter mais informações, consulte O arquivo de configuração item de trabalho conversor.

Solucionando problemas de migração

Quando o conversor é executado com o comando de migrar, há vários pontos, onde pode ocorrer um erro.Primeiro o conversor lê o arquivo de configuração e conecta-se ao banco de dados ClearQuest usando as informações de conexão especificada.Em seguida, o conversor provisiona os tipos de itens de trabalho especificado em Team Foundation Server. Finalmente, o conversor migra os itens de trabalho do ClearQuest para Team Foundation Server.

sistema autônomo o conversor está sendo executado, ele imprime sistema autônomo mensagens de status para o console.Você pode usar as mensagens de status para determinar em que ponto migração falhou.Por exemplo, se a última mensagem de status bem-sucedido "Validação de usuários no Team Foundation", é provável que o erro preocupações com o arquivo de MAP de usuário.

A chave para solução de problemas de migração é examinar os erros são relatados.sistema autônomo a seguir são relatados erros.

  1. Será exibida uma mensagem no console indica erros ocorreram.Por exemplo, se houver 2 avisos e 1 erro, você recebe a seguinte mensagem de Migração concluída com 2 avisos, 1 erro (s).

  2. Um arquivo de relatório de migração é criado, contendo informações mais específicas sobre os avisos e erros.O nome do arquivo de relatório é CQMigrationReport.xml.

Observação:

Em alguns casos, o conversor não pode gerar um arquivo de relatório e você verá uma saída de mensagem de erro no console.

O comando falha de migrar

Durante a migração, o conversor pode sofrer um erro crítico em qualquer ponto no time.Um erro crítico pára o conversor e nenhum outro item de trabalho é migrado.Um erro crítico pode ocorrer antes de itens de trabalho são realmente migrados ou depois de alguns funcionar itens tenham sido migrados.Quando a migração falha, você encontrar um dos dois seguintes sintomas:

  • Você verá um erro crítico e a mensagem ‘ migração falha ’ no arquivo de relatório de migração, CQMigrationReport.xml.Você verá uma string no arquivo de relatório semelhante à seguinte: Falha na migração {erro crítico 1 | 2 erros | 4 avisos}.

  • A migração falha com uma saída de erro no console, mas nenhum relatório é gerado.

Solução

  • Corrigir fonte do erro e reinicie o conversor.Quando você reiniciar o conversor, ele não irá migrar novamente itens de trabalho que já foram migrados.O conversor não cria itens de trabalho duplicado.

  • As causas de falhas críticas variam e então, fazer as mensagens de erro.A maioria das mensagens de erro fornece informações que identificam a causa do que há de errado.Você também pode encontrar mais informações sobre alguns erros, pesquisando o texto do erro em Team Foundation obter ajuda. Finalmente, examine as questões de solução de problemas para o comando de análise listadas anteriormente neste tópico.Muitos dos problemas mesmos se aplicam ao comando migrar.

Erros críticos quando conecta o conversor

Erros críticos podem ocorrer quando o conversor tenta se conectar ao ClearQuest ou Team Foundation Server. Encontrar um ou mais mensagens de erro no relatório que indica um problema de conexão.

Solução

Verificar se pode se conectar para ClearQuest por meio do cliente ClearQuest e Team Foundation Server por meio de Team Explorer. Problemas de conexão são freqüentemente mais fáceis diagnosticar pelas mensagens desses clientes.Além disso, lembre-se iniciar esses clientes, quando você fez logon na conta de usuário que executará o conversor.Isso armazenará em cache os dados necessários para que o conversor para serem executados corretamente.

Erros críticos ao provisionamento item de trabalho tipos

Erros críticos que ocorrem quando item de trabalho tipos são provisionados pode ocorrer devido a problemas de nomeação de campo.Você encontrar uma mensagem de erro semelhante à seguinte:

"Migração falhou devido ao" TF61013: O conversor não foi possível prover tipo de item de trabalho especificado no \\<computername>\e$\temp\CQOGF\Defect.xml arquivo por causa do seguinte erro: TF26177: O campo Microsoft.TeamFoundation.Converters.Priority_String não é possível renomear de 'Priority String' para 'Priority seqüência1'.Team Foundation não dá suporte renomeando campos."

Os campos em Team Foundation Server tem um escopo de nome no nível do servidor. A combinação de nome, nome de referência e tipo para um campo deve ser único no servidor.A fase de análise de conversor tem lógica para evitar conflitos.Quando o conversor detecta uma colisão, ele modifica os nomes de campo gerado adequadamente.No entanto pode haver um intervalo de time entre quando os nomes de campo são gerados do comando de análise e, quando você executar o comando de migração.Um tipo de item de trabalho no servidor pode ser modificado nesse período de time antes do confronto.Ou poderia tiver editado o gerado item de trabalho tipos e inadvertidamente escolhido um nome colide com um campo existente.

Solução

  • Modificar os tipos de itens de trabalho para resolver o conflito, modificando o nome, o nome de referência ou ambos.Com freqüência, você poderá usar apenas os nomes de campo que já existem.Para exibir os tipos de itens de trabalho existente, você deve exportar os arquivos de definição de tipo de item de trabalho do Team Foundation Server. Para obter mais informações, consulte witexport.

  • Use o witfields Utilitário de linha de comando para renomear ou excluir o campo em conflito em Team Foundation Server. No entanto, sabe que renomear e excluir campos de item de trabalho existentes nem sempre é possível.Para obter mais informações, consulte witfields.

Não expandir seções do relatório de análise ou relatório de migração

Seções do relatório de análise ou relatório de migração não expandir corretamente nas configurações de segurança padrão do Internet Explorer.Os botões expandir e recolher são controlados por scripts e a segurança padrão do Internet Explorer impede que os scripts sejam executados.

Solução

Você pode corrigir esse problema alterando a segurança do Internet Explorer para permitir o conteúdo ativo para o relatório.

Para alterar a segurança para permitir o conteúdo ativo de relatórios

  1. Localizar a BAR de segurança amarelo na parte superior do navegador lê Para ajudar a proteger sua segurança, o Internet Explorer impediu este arquivo de exibição de conteúdo ativo que possa acessar seu computador.

  2. clicar na BAR amarela de segurança e, em seguida, clicar Permitir conteúdo bloqueado.

  3. Sobre o Aviso de segurança diálogo, clicar Sim.

Alterações de esquema do item de trabalho não migrar para o Team Foundation servidor

Alterações de esquema do item de trabalho não são aplicadas se o tipo de item de trabalho já foi configurado.Isso normalmente ocorre quando você executar o comando de migrar uma vez, modificar as definições de tipo de item de trabalho nos arquivos de MAP de esquema e, em seguida, execute o comando migrar novamente.As modificações não aparecem no Team Foundation Server. Além disso, o seguinte aviso será exibido no relatório de migração; "tipo de item de trabalho < nome do tipo > não pode ser criado porque já existe no seuTeam Foundation Server."

O conversor tem verificações explícitas para certificar-se de que ele não substitui um tipo de item de trabalho existente.Portanto, assim que o tipo de item de trabalho é configurado pelo conversor, mesmo quando você modificar o tipo de item de trabalho, sistema autônomo alterações não são incorporadas porque o tipo de item de trabalho já foi configurado.

Solução

Para atualizar os tipos de itens de trabalho a Team Foundation servidor, use o witimport tipos de utilitário de linha de comando para importar o item de trabalho do Team Foundation Server. Em seguida, o conversor usará tipos atualizados quando você migra os itens de trabalho.Tenha cuidado para não modificar ou excluir dados de item de trabalho quando você usa o witimport Utilitário de linha de comando. Para obter mais informações, consulte witimport.

item de trabalho Migração falha devido a falha ao carregar do anexo

Se forem maiores do que o dimensionar do anexo permitidos anexos, esses anexos não serão migrados.Além disso, o seguinte erro é listado no arquivo de relatório de migração; "TF61015: Anexo <filename>Salvar falhou para o item de trabalho <id>com o seguinte erro: O arquivo que está sendo carregado é maior do que o dimensionar da máximo de carregar de arquivos permitidos (4 MB)."

Solução

  • Você pode aumentar o dimensionar máximo de anexos no Team Foundation servidor para corrigir esse problema. O dimensionar padrão é 4 MB, mas você pode aumentar o dimensionar para até 2 GB (2147483648 bytes).

Para conjunto o dimensionar máximo de anexo para itens de trabalho

  1. No Internet Explorer, localizar a seguinte URL:

    http:// <tfsserver >: 8080/WorkItemTracking/v1.0/ConfigurationSettingsService.asmx?op=SetMaxAttachmentSize

    onde <tfsserver> representa o nome dos Team Foundation servidor.

  2. No maxSize caixa, digite o dimensionar máximo de anexo em bytes e, em seguida, clicar Chamar.O dimensionar máximo de anexo é 2 gigabytes.

Observação:

Para executar este procedimento, você deve ser um membro do Administradores agrupar o Team Foundation camada de aplicativo servidor e um participante Equipe Foundation administradores agrupar.Para obter mais informações, consulte Team Foundation servidor Permissões.

Consulte também

Conceitos

Team Foundation servidor Permissões

Outros recursos

Solucionando problemas de migração do item de trabalho