MultiSite Control Panel

Configura o recurso de armazenamento e redirecionamento
Conceitos relacionados
Planejamento de Implementação
Referências relacionadas
mkorder
mkreplica
shipping.conf
shipping_server
syncreplica
control_panel

Aplicabilidade

Produto Tipo de Comando
MultiSite Ferramenta administrativa
Plataforma
Windows

Sinopse

%SystemRoot%\System32\ms.cpl

Para abrir o Painel de Controle MultiSite, dê um clique duplo no ícone MultiSite no Painel de Controle.

Descrição

O MultiSite Control Panel controla a operação do recurso de armazenamento e redirecionamento em cada host. Ele fornece controles para definir os parâmetros de configuração descritos nas seções seguintes. Em alguns casos, a operação correspondente falhará se um parâmetro não for definido e, em outros casos, haverá um padrão de hardcode atribuído.

Tamanho Máximo de Pacote

Padrão: 2.097.151 KB (2 GB - 1 KB)

Controla a divisão de pacotes lógicos em vários pacotes físicos. Esse valor especifica o tamanho máximo para um arquivo de pacote físico. A limitação do tamanho de pacotes físicos pode aprimorar a confiabilidade de entrega de pacotes em algumas redes. Para especificar que não haja limite, utilize 0 (zero).

Esse valor é utilizado pelos seguintes comandos (a menos que você também especifique –maxsize):

Ao chamar mkreplica ou syncreplica com –out, esse valor não é utilizado e você deve utilizar –maxsize para limitar o tamanho do pacote.

E-mail do Administrador

Padrão: nenhum.

Especifica o endereço de correio eletrônico do usuário a ser notificado quando ocorre um destes eventos:
  • Um pacote (no host local) expirado é retornado para seu host de envio.
  • Um pacote não entregue a seu próximo salto é retornado para seu host de envio.
  • syncreplica –import localiza um pacote de criação de réplicas.
Nota: Se você utilizar o Rational ClearQuest MultiSite e não utilizar o Rational ClearCase MultiSite, utilize o comando control_panel para especificar o host SMTP e o e-mail do administrador.
Para ativar a notificação de e-mail:
  1. Especifique o host SMTP a ser utilizado:
    • Se você utilizar o Rational ClearCase MultiSite, verifique se o campo Host SMTP no painel de controle ClearCase especifica um host válido. (Este campo está localizado na página Opções.)
    • Se você não utilizar o Rational ClearCase MultiSite, utilize o comando control_panel para especificar o host SMTP.
  2. Digite um endereço de e-mail no campo E-mail do Administrador do Painel de Controle MultiSite. É possível especificar apenas um endereço.
  3. (Opcional) Digite um valor diferente no campo Caminho do Programa de Notificação por E-mail.

Caminho do Programa de Notificação de E-mail

Padrão: ccase-home-dir\bin\notify.exe

Especifica o programa de correio eletrônico a ser chamado nas circunstâncias listadas em E-mail do Administrador.

Tempo Limite para Host Inalcançável (Minutos)

Padrão: Zero.

Especifica o número de minutos para o servidor de remessa aguardar antes de tentar contactar um host de destino identificado anteriormente como inalcançável.

Se o servidor de remessa tentar enviar um pacote para um host de destino e determinar que o host é inalcançável, ele criará um arquivo no diretório ccase-home-dir\var\shipping\ms_downhost. O nome do arquivo é o nome do host inalcançável. Se o valor do campo Tempo Limite para Host Inalcançável não for zero, o servidor de remessa verificará o diretório dos hosts de destino durante operações de remessas futuras.

Se o host de destino for localizado no diretório ms_downhost e a diferença entre a hora atual e a hora da última modificação do arquivo for menor que o valor de tempo limite no host do servidor de remessa, o servidor de remessa não tentará enviar pacotes ao host de destino. Se a diferença for igual ou maior que o valor de tempo limite, o servidor de remessa tentará enviar pacotes ao host de destino. Se a configuração de Tempo Limite para Host Inalcançável for zero, o servidor de remessa tentará enviar o pacote ao host de destino. (Cada tentativa de enviar um pacote para um host inalcançável leva aproximadamente 30 segundos).

Classes de Armazenamento

Nome da Classe de Armazenamento

Padrão: os comandos multiutil que utilizam a opção –sclass utilizam a classe de armazenamento cq_default para pacotes que não estão designados a nenhuma classe de armazenamento e para pacotes cuja classe de armazenamento não está configurada. A classe de armazenamento cq_default não é criada quando o MultiSite está instalado. Os comandos mkorder e shipping_server utilizam a classe de armazenamento –default para pacotes que não estão designados a nenhuma classe de armazenamento e para pacotes cuja classe de armazenamento não está configurada. Você pode criar classes de armazenamento adicionais para pacotes do Rational ClearQuest MultiSite, mas deve utilizar diferentes classes de armazenamento para pacotes do Rational ClearQuest MultiSite e do Rational ClearCase MultiSite.

Especifica o nome de uma classe de armazenamento. Para cada classe de armazenamento, você pode especificar valores para expiração do pacote, o compartimento de armazenamento, o compartimento de retorno e a rotina de tratamento de recebimento.

Nota: No máximo 64 classes de armazenamento poderão ser criadas e seus nomes farão distinção entre maiúsculas e minúsculas.

Expiração do Pacote

Padrão: Quando a caixa de opções Utilizar Expiração Padrão for marcada, a classe de armazenamento utilizará o valor de expiração do pacote associado com a classe –default. (Este valor não é mostrado no campo Expiração de Pacote. Você deverá exibir a classe –default para determinar o valor.) Quando o MultiSite é instalado pela primeira vez, o valor de Packet Expiration para a classe –default é configurado para 14 dias.

Especifica o período de expiração (em dias) para pedidos de remessa associados à classe de armazenamento especificada. Esse período começa no momento em que o pedido de remessa é gerado. Se um pacote não puder ser entregue para todos os destinos na quantidade de dias especificada, o pacote retornará ao host de envio original e uma mensagem será enviada ao endereço especificado no campo E-mail do Administrador. Se a notificação de e-mail não estiver ativada, uma mensagem será gravada no Visualizador de Eventos do Windows.

Um valor 0 (zero) especifica que nenhuma expiração e entrega será tentada novamente de modo ilimitado.

Essa configuração é substituída pela opção –pexpire para syncreplica ou mkreplica.

O programa shipping_server não tenta novamente a entrega de pacotes. A especificação de expiração do pacote será útil apenas se você configurar um host para tentar entregar periodicamente todos os pacotes que não foram entregues.

Caminho do Compartimento de Armazenamento

Padrão: os comandos multiutil que utilizam a opção –sclass utilizam a classe de armazenamento cq_default. Os comandos mkorder e shipping_server utilizam a classe de armazenamento –default. É necessário criar a classe de armazenamento cq_default. Se você utilizar o Rational ClearCase MultiSite e o Rational ClearQuest MultiSite, deverá utilizar compartimentos de armazenamento diferentes para pacotes de réplicas e pacotes de bancos de dados VOB.

Define o local do diretório que mantém os pacotes de atualização e os pedidos de remessa de saída e de entrada de uma classe de armazenamento específica.

Os pacotes colocados em um compartimento de armazenamento em um sistema de arquivo NTFS herdam a ACL do Windows no compartimento. Defina ACLs nos compartimentos de armazenamento para permitir a execução bem-sucedida de comandos do MultiSite para processar os pacotes e para proteger contra acesso não autorizado. Os pacotes armazenados em sistemas de arquivos FAT não possuem proteções.

Antes de utilizar o recurso de armazenamento e redirecionamento, verifique se a partição de disco em que o diretório ccase-home-dir\var\shipping foi criado possui espaço livre suficiente para os pacotes de criação e atualização de réplicas esperados. Para evitar possíveis danos ao banco de dados VOB, que podem ser causados pelo preenchimento da partição de disco que contém o banco de dados VOB, coloque o compartimento de armazenamento em uma partição de disco que não contenha diretórios de armazenamento VOB.

Nota: Quando você cria uma nova classe de armazenamento, o compartimento de armazenamento e o compartimento de retorno especificados são criados. Os diretórios incoming e outgoing nos compartimentos também são criados.

Caminho do Compartimento de Retorno

Padrão: os comandos multiutil que utilizam a opção –sclass utilizam a classe de armazenamento cq_default. Os comandos mkorder e shipping_server utilizam a classe de armazenamento –default. É necessário criar a classe de armazenamento cq_default. Se você utilizar o Rational ClearCase MultiSite e o Rational ClearQuest MultiSite, deverá utilizar compartimentos de retorno diferentes para os pacotes de réplicas e pacotes de bancos de dados VOB.

Define o local do diretório que armazena os pacotes de entrada e saída no processo de retorno às suas origens porque eles não puderam ser entregues a todos os destinos especificados.

Os pacotes colocados em um compartimento de retorno em um sistema de arquivo NTFS herdam a ACL do Windows no compartimento. Defina ACLs nos compartimentos de retorno para permitir a execução bem-sucedida de comandos do MultiSite para processar os pacotes e para proteger contra acesso não autorizado. Os pacotes armazenados em sistemas de arquivos FAT não possuem proteções.

Caminho da Rotina de Tratamento de Recebimento

Padrão: nenhum.

Especifica um programa ou arquivo em batch a ser executado pelo servidor de remessa quando um pacote é recebido para a classe de armazenamento. Por padrão, nenhum arquivo está especificado.

Para cada pacote recebido, shipping_server faz o seguinte:

  1. Lê as entradas no Painel de Controle MultiSite para localizar o valor apropriado de Manipulador de Recebimento para o pacote.
    • Se o pacote estiver associado a uma classe de armazenamento e houver um valor de Manipulador de Recebimento para essa classe de armazenamento, shipping_server utilizará o programa ou arquivo em lote especificado. Se nenhuma rotina de tratamento de recebimento for definida para a classe de armazenamento, mas houver uma rotina de tratamento de recebimento padrão definida, ela será chamada para esse pacote.
    • Se o pacote não estiver associado a uma classe de armazenamento e houver um valor de Manipulador de Recebimento para a classe de armazenamento –default, shipping_server utilizará esse valor.
  2. Chama a rotina de tratamento de recebimento, conforme a seguir:

    script-pname [ –d/ata packet-file-pname ] [ –a/ctual shipping-order-pname ]
    [ –s/class storage-class ] –o/rigin hostname

    em que

    script-pname
    Script especificado na entrada RECEIPT-HANDLER.
    –d/ata packet-file-pname
    Local do pacote. Esse parâmetro é utilizado apenas quando o pacote é destinado a esse host.
    –a/ctual shipping-order-pname
    Local do pedido de remessa. Esse parâmetro é utilizado apenas quando o pacote é destinado a um outro host.
    –s/class storage-class
    Classe de armazenamento associada ao pacote. Esse parâmetro será utilizado apenas se o pacote foi associado a uma classe de armazenamento quando ele foi criado.
    –o/rigin hostname
    Nome do host a partir do qual o pacote foi enviado pela primeira vez.
    Nota: Se um pacote for destinado ao host local e a um outro host, os parâmetros –data e –actual serão utilizados. O pacote é importado na réplica no host e redirecionado para seu próximo destino.

Informações de Roteamento

O campo Informações de Roteamento controla o roteamento de rede dos pacotes.

Próximo Salto de Rota

Padrão: nenhum.

Especifica o próximo destino para os pacotes cujo destino final é qualquer um dos nomes do host especificado na lista Nomes de Hosts de Destino. Esse host é responsável pela entrega do pacote para seus destinos. Você pode especificar um host utilizando o nome do host (que deve ser utilizável por hosts em diferentes domínios) ou o endereço IP numérico.

Nomes dos Hosts de Destino

Padrão: nenhum.

Pacotes destinados a cada host listado neste campo são enviados ao host especificado no campo Próximo Salto de Roteamento. Você pode especificar um host utilizando o nome do host (que deve ser utilizável por hosts em diferentes domínios) ou o endereço IP numérico. O valor –default como o Nome do Host de Destino acomoda todos os hosts não associados a um salto de rota.


Feedback