Aplicando o pacote JazzInterop aos esquemas de réplica MultiSite

O Assistente de Configuração do ClearQuest Connector configura seu ambiente do IBM® Rational ClearQuest aplicando o pacote JazzInterop a um esquema e, em seguida, atualizando um banco de dados do usuário para uma nova versão do esquema. No entanto, em um ambiente ClearQuest Multisite, você deve aplicar manualmente o pacote aos esquemas de réplica e fazer o upgrade das réplicas de banco de dados do usuário. O assistente aplica o pacote apenas à réplica que está conectada ao ClearQuest Gateway.
Por Que e Quando Desempenhar Esta Tarefa
O pacote JazzInterop inclui um script global Perl, ChangeHistoryScripts, e os seguintes tipos de registro para o esquema:
  • JazzConnectorChangeEvents
  • JazzConnectorQueryInfo
  • JazzConnectorSyncHistory

Consulte a Ajuda do Rational ClearQuest MultiSite para obter detalhes sobre a seqüência de etapas a seguir ao aplicar os pacotes e atualizar bancos de dados dos usuários.

Sempre aplique a versão mais recente (aquela com o número mais alto) do pacote JazzInterop para o esquema. Se tiver aplicado anteriormente uma versão mais antiga do pacote ao seu esquema, atualize de forma incremental à versão mais recente. Por exemplo, se a última versão foi 1.06, para fazer o upgrade de 1.03 para 1.06, execute as seguintes tarefas:
  1. Aplique o JazzInterop 1.04 ao seu esquema.
  2. Atualize o banco de dados do usuário.
  3. Aplique o JazzInterop 1.05 ao seu esquema.
  4. Atualize o banco de dados do usuário.
  5. Aplique o JazzInterop 1.06 ao seu esquema.
  6. Atualize o banco de dados do usuário.

Para aplicar o pacote JazzInterop a um esquema e atualizar o banco de dados do usuário:

  1. Em um computador executando Windows®, copie a pasta diretório de instalação/gateway/cqPackage/JazzInterop e cole-a na pasta cq-install-dir/packages.
  2. Navegue para a pasta cq-install-dir. Utilize o comando packageutil para registrar o pacote JazzInterop com ClearQuest. Se desejar aplicar múltiplas versões do pacote ao seu esquema para obter a versão mais recente do pacote, execute este comando várias vezes, especificando uma versão do pacote diferente toda vez antes de prosseguir para a próxima etapa. Por exemplo:
    packageutil registerpackage JazzInterop versão do pacote "C:\Arquivos de
    Programas\Rational\ClearQuest\packages\JazzInterop\versão do pacote"
  3. Execute o seguinte comando para ativar o pacote JazzInterop para atualizar os tipos de registro que você incluiu ao seu esquema aplicando outros pacotes a ele.
    packageutil enablepackageediting -dbset dbset_name clearquest_login
    clearquest_password -enable user
    O usuário especificado com o parâmetro clearquest_password deve ter privilégios de designer do esquema. A conta de usuário do administrador possui privilégios de superusuário, que inclui privilégios de designer do esquema. Por exemplo:
    packageutil enablepackageediting -dbset my_schema_repo admin "" -enable admin
  4. Abra o ClearQuest Designer clicando em Iniciar > Todos os Programas > IBM Rational ClearQuest > ClearQuest Designer. Na visualização Explorer do Repositório de Esquema, clique com o botão direito do mouse em uma versão de esquema e selecione Pacotes > Aplicar Pacote. Expanda a pasta JazzInterop e selecione a versão do pacote a aplicar. Clique em Avançar. Selecione os tipos de registro que deseja ativar para sincronização. Clique em Concluir. Efetue o registro de entrada da nova versão do esquema.
  5. Utilize o comando packageutil enablepackageediting novamente com a opção -disable para retornar os tipos de registro para de Leitura. Por exemplo:
    packageutil enablepackageediting -dbset my_schema_repo admin "" -disable admin
  6. Clique em Visualizar > Administração de Banco de Dados. Clique com o botão direito do mouse no banco de dados do usuário no qual deseja fazer upgrade e clique em Fazer Upgrade do Banco de Dados. A janela Fazer Upgrade do Banco de Dados do Usuário é aberta. Selecione a nova versão do esquema na lista Versões e clique em OK.
O que Fazer Depois
Se decidir posteriormente aplicar o pacote JazzInterop a um tipo de registro com estado adicional no mesmo esquema, comece executando o comando packageutil enablepackageediting novamente com a opção -enable. Abra o Designer do ClearQuest e efetue o registro de saída do esquema. Na visualização Explorer do Repositório de Esquema, expanda a pasta Tipos de Registro. Dê um clique duplo em um tipo de registro e selecione Configurar Tipo de Registro para Pacotes. Selecione o pacote JazzInterop e clique em OK. Efetue o registro de entrada da nova versão do esquema. Execute o comando packageutil enablepackageediting com a opção -disable. Atualize o banco de dados do usuário com a nova versão do esquema.

Utilize um procedimento diferente para aplicar o pacote JazzInterop a um tipo de registro sem estado adicional. Abra o Designer do ClearQuest e efetue o registro de saída do esquema. Na visualização Explorer do Repositório de Esquema, expanda a pasta Tipos de Registro - Sem Estado. Expanda a pasta do tipo de registro sem estado. Dê um clique dublo em Ações. Clique em Nova Ação. Digite Change_History no campo Nome da Ação. Selecione BASE no campo Tipo. Feche a caixa de diálogo Ação para salvar a alteração. Clique na célula Notificação para a ação Change_History. Clique novamente e selecione SCRIPTS > PERL. Dê um clique duplo na célula para abrir o editor de scripts. Cole a seguinte linha no editor depois da última linha de comentário: JazzCQConnector($actionname, $actiontype);. Salve suas alterações e feche o editor. Feche a matriz Ações. Efetue o registro de entrada do esquema. Atualize o banco de dados do usuário com a nova versão do esquema.


Feedback

Isso ajudou? É possível fornecer feedback em Jazz.net (é necessário registrar-se): Comentar nos fóruns ou submeter um erro