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:
- Aplique o JazzInterop 1.04 ao seu esquema.
- Atualize o banco de dados do usuário.
- Aplique o JazzInterop 1.05 ao seu esquema.
- Atualize o banco de dados do usuário.
- Aplique o JazzInterop 1.06 ao seu esquema.
- 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:
- 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.
- 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"
- 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
- Abra o ClearQuest Designer
clicando em . 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 . 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.
- 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
- Clique em . 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
.
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.