Produto | Tipo de Comando |
---|---|
MultiSite | Subcomando de multiutil |
Plataforma |
---|
UNIX |
Windows |
–exp/ort
[–cl/an clan-name ] [ –site site-name ] –fam/ily family-name
–u/ser username [–p/assword ] password [–max/size max-packet-size
[–lim/it num-packets ] ]
{ { –sh/ip| –fsh/ip }
–wor/kdir directory [ –sc/lass storage-class ]
[–pex/pire date ]
[–not/ify email ]
| –out { packet-file-pname | staging-area-pname } }
replica ...
–imp/ort
[–cl/an clan-name ] [ –site site-name ] –fam/ily family-name
–u/ser username [–p/assword ] password
{ –rec/eive[ –sc/lass storage-class ]
| { packet-file-pname | staging-area-pname } ... }
[ -plug/epoch ]
A sincronização de uma réplica com uma ou mais réplicas irmãs é um processo de três fases:
Conteúdo de um pacote de atualização:
Em todos os casos, syncreplica –export cria um único pacote lógico de atualização para ser utilizado de qualquer modo nos destinos especificados; o pacote pode ser utilizado para atualizar apenas essas réplicas específicas.
O MultiSite está projetado para uma atualização eficiente de réplicas. syncreplica –export tenta excluir operações que tenham sido enviadas anteriormente. (Entretanto, não há nenhum dano ao enviar uma operação várias vezes para a mesma réplica; a primeira operação é importada e as operações idênticas subseqüentes são ignoradas).
syncreplica –export armazena arquivos temporários no diretório especificado com a opção –workdir. Esse diretório ainda não deve existir e é excluído após a criação do pacote de exportação.
Um pacote de atualização é aplicado às réplicas apropriadas associadas ao servidor de sincronização que recebeu o pacote. Não é necessário especificar réplicas ou localizações do armazenamento específicas.
O processo de importação aplica os pacotes de atualização na ordem correta. Portanto, você pode especificar pacotes em qualquer ordem na linha de comandos.
A réplica do banco de dados não é bloqueada para operações normais do banco de dados durante a fase de importação, mas é bloqueada para todas as outras operações do MultiSite.
syncreplica –import não processa um pacote de atualização nas seguintes situações:
Nesses casos, syncreplica –import exibe uma mensagem explicativa.
Em alguns casos, syncreplica –import começa a aplicar operações a uma réplica, mas falha com uma mensagem de erro. Por exemplo, um outro processo pode ter bloqueado o banco de dados, causando falha na importação. Após o desbloqueio do banco de dados, você pode executar syncreplica –import para processar novamente o pacote de atualização inteiro.
Não há danos ao importar pacotes de atualização já processados com êxito; a mesma alteração não será feita duas vezes.
Se uma única chamada de syncreplica –import aplicar um pacote com êxito a todas as réplicas de destino associadas ao servidor de sincronização, o pacote de atualização será excluído quando o comando concluir seu trabalho. Se o pacote for processado com vários comandos syncreplica –import, ele não será excluído.
Os ganchos do Rational ClearQuest não são disparados em resposta a alterações feitas durante a importação do pacote.
O syncreplica resolve conflitos de nomenclatura entre objetos criados em réplicas diferentes.
O syncreplica não informa os usuários do Rational ClearQuest das atualizações em réplicas. Todos os usuários ativos vêem as atualizações em alguns segundos, por meio das rotinas normais de polling do banco de dados no Rational ClearQuest.
Se um pacote não puder ser entregue, ele será enviado por meio do recurso de armazenamento e redirecionamento para o servidor de sincronização da réplica de origem. Uma mensagem de correio é enviada ao administrador de armazenamento e redirecionamento. Isso ocorre após a falha de todas as 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.
Você deve ter privilégios de Superusuário.
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: o nome da família é MASTR.
A opção –limit limita o número de pacotes gerados pelo syncreplica; cada pacote não é maior que max-packet-size. Utilize essa opção quando o espaço em disco para seu compartimento de armazenamento ou área de migração de dados é limitado.
A utilização de –fship (forçar envio) chama o servidor de remessa para enviar o pacote de atualização imediatamente. A utilização de –ship não chama esse servidor.
Os pacotes de atualização não são entregues automaticamente; utilize um método apropriado para entregá-los. É possível criar um pacote utilizando –out e 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.
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: o nome da família é MASTR.
Varre os compartimentos de armazenamento do host atual. Quaisquer pacotes de atualização não processados destinados para réplicas associadas a esse host são aplicados às réplicas apropriadas no host. Com –sclass, syncreplica varre apenas os compartimentos de armazenamento da classe de armazenamento especificada.
Se syncreplica localizar quaisquer pacotes de criação de réplicas, ele enviará correio para o administrador de armazenamento e redirecionamento. (Se o host atual for um host do Windows e uma notificação de e-mail não estiver ativada, uma mensagem aparecerá no Visualizador de Eventos do Windows.) Utilize mkreplica para importar esses pacotes de criação de réplicas.
multiutil syncreplica -export -clan telecomm -site boston_hub
-family SAMPL -user susan -p passwd -out c:\cqms\sanfran_hub_sync.xml
sanfran_hub
Multiutil: Packet file `c:\cqms\sanfran_hub_sync.xml' generated
multiutil syncreplica -export -clan telecomm -site boston_hub
-family DEV -user susan -p passwd -maxsize 500mb -workdir c:\work
-ship -sclass cq_default sanfran_hub
Multiutil: Packet file
`C:\work\sync_BOSTON_HUB_26-March-02_10-55-16.xml' generated
multiutil: Shipping order
"C:\temp\cqms\ms_ship\outgoing\sh_o_sync_BOSTON_HUB_26-March-02_
10-55-16.xml" generated.
multiutil syncreplica -export -clan telecomm -site boston_hub
-family DEV -user susan -password p -maxsize 500mb -workdir
c:\work -fship -sclass cq_default sanfran_hub
Multiutil: Packet file
`C:\work\sync_BOSTON_HUB_26-March-02_10-56-43.xml' generated
multiutil: Shipping order "C:\cqms\ms_ship\outgoing\sh_o_sync_
BOSTON_HUB_26-March-02_10-56-43.xml" generated.
multiutil: Attempting to forward/deliver generated packets...
multiutil: -- Forwarded/delivered packet
C:\cqms\ms_ship\outgoing\sync_BOSTON_HUB_26-March-02_10-
---- NOTA: consulte o log de eventos NT para verificar os erros.
multiutil syncreplica -import -clan telecomm -site sanfran_hub
-family DEV
-user jcole -p passwd -receive -sclass cq_storage
Multiutil: 4 transactions from boston_hub have been replayed
into the MASTR database
Multiutil: 2 transactions from boston_hub have been replayed
into the DEV database
Multiutil: Deleting packet C:\temp\cqms\ms_ship\incoming\sync_
boston_hub_22-January-02_11-10-34.xml
multiutil syncreplica -import -clan telecomm -site sanfran_hub
-family DEV -user jcole -p passwd c:\cqms\sanfran_hub_sync.xm
Multiutil: 1 transactions from boston_hub have been replayed
into the MASTR database
Multiutil: 2 transactions from boston_hub have been replayed
into the DEV database
Multiutil: Deleting packet c:\cqms\sanfran_hub_sync.xml
multiutil syncreplica -import -clan telecomm -site sanfran_hub
-family DEV -user jcole -p passwd c:\cqms\sanfran_hub_sync.xml
Multiutil: The UPDATE_PACKET packet sent from boston_hub at
2002-01-22 15:15:50 is destined for schema revision 2, not 1;
re-execute syncreplica after site admin has upgraded database.
Multiutil: 2 transactions from boston_hub have been replayed
into the MASTR database
Multiutil: Preserving packet c:\cqms\sanfran_hub_sync.xml.
multiutil syncreplica -import -clan telecomm -site boston_hub
-family DEV -user susan -p passwd -receive
Multiutil: 1 transactions from SANFRAN_HUB have been replayed
into the MASTR database
Multiutil: 2 transactions from SANFRAN_HUB have been replayed
into the DEV database
Multiutil: Deleting packet C:\temp\cqms\ms_ship\incoming\sync_
SANFRAN_HUB_07-February-02_11-24-49.xml