–exp/ort[
–cl/an clan-name ] [ –site site-name ] –fam/ily family-name
–u/ser username [–p/assword ] password
[–max/size size ] [–c/omments comments ]
[–size id-block-size ] [ –thres/hold id-block-threshold ]
{
{–sh/ip | –fsh/ip} -wor/kdir temp-dir-pname
[–sc/lass storage-class ]
[ –pex/pire date-time ]
[–not/ify e-mail-addr ]
| –out packet-file-pname } hostname:site-name ...
–imp/ort
{ –site site-name–repo/sitory db-info [ –vendor
vendor-type ] db-params
}
{ [ –data/base db-info [ –vendor vendor-type ] db-params
[ –c/omments comments ] { packet-file-pname|packet-dir-path }...
–imp/ort {
[–cl/an clan-name ] [ -site site-name ] –u/ser username
[–p/assword ] password { –data/base db-info
[ –vendor vendor-type ] db-params
[ –c/omments comments ] { packet-file-pname|packet-dir-path }...
O comando mkreplica –export pode levar um longo tempo. O banco de dados e o repositório de esquemas ficam bloqueados enquanto uma exportação está em progresso. Certifique-se de que todos os usuários tenham efetuado logout antes de você executar mkreplica –export.
A criação de uma nova réplica é um processo de três fases:
Em cada novo site, o administrador deve criar bancos de dados do fornecedor vazios para os dados de réplica. Se essa for a primeira réplica no novo site, você precisará de, pelo menos, dois bancos de dados do fornecedor vazios, um para a réplica do repositório de esquemas e outro para a réplica do banco de dados do usuário.
Quando um banco de dados é replicado pela primeira vez, o oplog (log de operações) do banco de dados é ativado. Todas as operações a serem replicadas são registradas no oplog. O log de operações continua até que todas as réplicas sejam excluídas, deixando apenas o conjunto de bancos de dados original. Observe que a criação de réplicas adicionais é registrada em entradas do oplog. As réplicas existentes são informadas de uma nova réplica por meio do mecanismo de sincronização padrão.
O MultiSite controla quantos números de ID de registro são alocados para cada réplica. Essa alocação é feita utilizando blocos de IDs (grupos de IDs).
Por padrão, ao ser criada, cada réplica é designada a um bloco de 4.096 IDs. Quando uma réplica atinge um limite de 1.024 IDs restantes para uso, ela é alocada para um outro bloco de 4.096 IDs para assegurar que todos os IDs sejam exclusivos. A alocação de blocos de IDs é manipulada internamente pelo repositório de esquemas de trabalho durante a sincronização.
Dependendo do nível de atividade de uma família de réplicas, pode ser útil aumentar o tamanho dos blocos de IDs alocados para uma réplica. Por exemplo, com as configurações padrão, se você tentar enviar um grande número de defeitos, os primeiros 4.096 serão enviados com êxito, mas os envios posteriores falharão.
Para controlar a quantos IDs uma réplica é alocada, você pode utilizar a opção –size combinada com a opção –threshold ao criar uma réplica com o comando mkreplica –export. Essas configurações podem ser modificadas com o comando chreplica.
Cada chamada de mkreplica –export cria um único pacote lógico de criação de réplicas. (Isso será verdadeiro mesmo se você criar várias novas réplicas com um comando mkreplica). Cada pacote inclui uma ou mais especificações de réplicas, cada uma indicando o nome da nova réplica e o servidor de sincronização associado à nova réplica.
O banco de dados do usuário e o repositório de esquemas são bloqueados durante a fase de exportação.
A opção –maxsize divide um único pacote lógico em vários pacotes físicos para que fique em conformidade com as limitações do meio de transferência.
Se uma importação de réplica for interrompida ou falhar por algum motivo (uma interrupção de energia, por exemplo), você deverá excluir os bancos de dados do fornecedor, criar um novo banco de dados do fornecedor para a operação de importação com falha e executar novamente mkreplica –import.
É possível ter uma importação bem-sucedida do repositório de esquemas, mas uma importação com falha da réplica do banco de dados do usuário. Nesse caso, é necessário excluir e recriar o banco de dados do fornecedor que foi destinado à replica do banco de dados do usuário.
Os pacotes de criação de réplicas não são excluídos após a importação. Depois de importar um pacote de criação de réplicas com mkreplica –import, você deve excluir o pacote.
Se um pacote não puder ser entregue, ele será enviado por meio do recurso de armazenamento e redirecionamento de volta para o administrador no site da réplica de origem. Uma mensagem de correio é enviada ao administrador de armazenamento e redirecionamento. Isso ocorre após a falha de repetidas tentativas de entrega do pacote e a expiração do tempo designado; isso também pode ocorrer quando o host de destino é desconhecido ou um arquivo de dados não existe. As definições de configuração de armazenamento e redirecionamento especificam o período de expiração, o endereço de e-mail do administrador e o programa de notificação.
Bloqueios: esse comando falhará se o banco de dados estiver bloqueado (por exemplo, durante o processo de upgrade) ou enquanto uma outra operação do Rational ClearQuest MultiSite estiver sendo desempenhada.
Outro: não é possível replicar um banco de dados para um host que esteja executando uma versão diferente do MultiSite. Você pode executar mkreplica –export em qualquer site; no entanto, sempre execute-o no site do repositório de esquemas de trabalho para evitar a criação de vários sites com o mesmo nome.
Site: site atual. Se houver mais de um site nesse host, –site será obrigatório.
Família: nenhum padrão; você deve especificar uma família.
Família do repositório de esquemas: não aplicável. Quando você executa o mkreplica, o repositório de esquemas associado da família do banco de dados do usuário especificada é incluído no pacote de criação de réplicas.
Padrão: nenhum.
–fship (forçar envio) chama shipping_server para enviar o pacote de criação de réplicas. –ship coloca o pacote em um compartimento de armazenamento. Para enviar o pacote, chame shipping_server.
A partição de disco na qual o compartimento de armazenamento está localizado (no host de envio e no host de recebimento) deve ter espaço disponível igual ou maior que o tamanho do pacote de criação de réplicas.
Padrão: mkreplica coloca o pacote no local do compartimento de armazenamento especificado para a classe cq_default.
Os pacotes de criação de réplicas não são entregues automaticamente; utilize um método apropriado para entregá-los. É possível criar um pacote utilizando –out e, subseqüentemente, entregá-lo utilizando o recurso de armazenamento e redirecionamento.
O argumento date-time pode ter um dos seguintes formatos:
Especifique o horário no formato de 24 horas, em relação ao fuso horário local. Se você omitir o horário, o valor padrão será 00:00:00. Se omitir date, o valor padrão será today. Se você omitir o século, o ano ou uma data específica, será utilizado o mais recente. Especifique UTC se você desejar que o horário seja resolvido para o mesmo momento no tempo, independentemente do fuso horário. Utilize o operador mais (+) ou menos (-) para especificar um deslocamento positivo ou negativo para o horário UTC. Se você especificar UTC sem deslocamentos de hora ou minuto, a configuração padrão será GMT (Hora de Greenwich). (As datas anteriores a 1 de janeiro de 1970 (UTC - Universal Coordinated Time) são inválidas).
Se ocorrer um defeito em um host do Windows que não tenha a notificação de e-mail ativada, aparecerá uma mensagem no Visualizador de Eventos do Windows. A mensagem inclui o valor e-mail-address especificado com essa opção e uma nota solicitando que esse usuário seja informado do status da operação.
O hostname pode ser o endereço IP do host ou o nome do computador, por exemplo, minuteman. Pode ser necessário anexar um nome de domínio de IP, por exemplo, minuteman.purpledoc.com.
No Linux e no sistema UNIX, utilize o comando uname –n para exibir o nome do computador. No Windows, o nome do computador está acessível a partir do ícone Sistema no Painel de Controle. No Windows 2000, clique na guia Identificação de Rede. No Windows NT Server 2003, clique na guia Nome do Computador.
Ao importar uma réplica, você deve especificar os parâmetros do banco de dados do fornecedor para a réplica do repositório de esquemas e do banco de dados do fornecedor para a réplica do banco de dados do usuário. Esses bancos de dados devem ser criados antes da importação de um pacote de réplicas.
Se você também especificar um ou mais argumentos packet-dir-path, mkreplica procurará pacotes adicionais nesses diretórios.
Site: site atual. Se houver mais de um site nesse host, –site será obrigatório.
Especificando db-info e db-params para DB2, Oracle e Microsoft SQL Server
Cada fornecedor do banco de dados tem um número de porta padrão:
Fornecedor | Porta Padrão |
---|---|
DB2 | 50000 |
Oracle | 1521 |
Microsoft SQL Server | 1433 |
Se o banco de dados utilizar diferentes portas, você deverá especificar isso utilizando o parâmetro connect-options. Por exemplo, se você tiver um banco de dados Oracle na porta 1526, digite o seguinte comando:
multiutil mkreplica -imp -site SITEA -repo CQDEV -server cqsvr3 -vendor ORACLE -dbo admin_1 admin_1 -con PORT=1526 -data CQDEV -server cqsvr3 -vendor ORACLE -dbo admin_2 admin_2 -con PORT=1526 C:\TEMP\admin\mk_SITEA.xml
Importante: Para obter mais informações sobre os valores com suporte nos bancos de dados de fornecedores, consulte o tópico "Propriedades do Banco de Dados do Fornecedor" na seção Administrando o Rational ClearQuest da Ajuda.
Se você também especificar um ou mais argumentos packet-dir-path, mkreplica procurará pacotes adicionais nesses diretórios.
Padrão: nenhum.
multiutil mkreplica -export -clan telecomm -site boston_hub -family DEV
-u susan -p passwd -out c:\cqms\boston_hub.xml goldengate:sanfran_hub
Multiutil: Packet file `c:\cqms\boston_hub.xml' generated
multiutil mkreplica -export -clan telecomm -site boston_hub -family LAB
-user susan -p passwd -out c:\cqms\lab.xml goldengate:sanfran_hub
Multiutil: Packet file `c:\cqms\lab.xml' generated
multiutil mkreplica -export -clan testing -site tokyo -family TEST
-user masako -p passwd -fship -workdir c:\cqms\working -sclass
cq_default taronga:sydney
Multiutil: Packet file
`c:\cqms\working\mk_TOKYO_29-January-02_09-47-27.xml' generated
multiutil: Shipping order
"C:\temp\cqms\ms_ship\outgoing\sh_o_mk_TOKYO_29-January-02_09-47-27.xml"
generated.
multiutil: Attempting to forward/deliver generated packets...
multiutil: -- Forwarded/delivered packet
C:\temp\cqms\ms_ship\outgoing\mk_TOKYO_29-January-02_09-4
multiutil mkreplia -export -clan telecomm -site boston_hub -family DEV
-user susan -password passwd -c "make a new replica for sanfran_hub"
-ship -workdir c:\temp\working -sclass cq_default
-pexpire 22-November-2003
goldengate:sanfran_hub
multiutil mkreplica -import -site sanfran_hub
-repository sanfran_schemarepo
-vendor SQL_SERVER -server sb_server -dbologin jcole passwd
-database sanfran_userdb -vendor SQL_SERVER
-dbologin jcole passwd
multiutil mkreplica -import -clan testing -site sydney -user bfife
-p passwd -database syd_userdb -vendor SQL_SERVER
-dbologin bfife passwd