Implementando um Arquivo Broker Archive

Após ter criado e prenchido um arquivo broker archive (BAR), a implementação do arquivo é necessária para que este p ossa fazer efeito no domínio do intermediário.

Antes de iniciar:

Você deve ter criado um arquivo BAR. Consulte o Criando um Broker Archive.

As seções neste tópico mostram como implementar um broker archive de três diferentes formas: Se você fizer alterações em um arquivo BAR e desejar propagá-las para um ou mais intermediários, poderá reimplementar o arquivo BAR atualizado utilizando um dos métodos de implementação descritos acima:

Se o grupo de execução no qual você deseja implementar estiver restrito por uma ACL, você deverá ter direitos de acesso apropriados para concluir essa tarefa.

Utilizando o Message Brokers Toolkit

Siga estas etapas para implementar um arquivo BAR utilizando o ambiente de trabalho:

  1. Alterne para o Perspectiva de Administração do Intermediário.
  2. Opcional. Normalmente, é desempenhada uma implementação incremental do arquivo BAR. Para desempenhar uma implementação completa do arquivo BAR, clique com o botão direito do mouse no grupo de execução de destino na visualização Domínios e selecione Remover Filhos Implementados. Aguarde a conclusão da operação antes de continuar.

    Não Remova Filhos Implementados se quiser apenas atualizar um ou mais processos-filhos com o conteúdo do arquivo BAR. Para obter uma explicação da diferença entre uma implementação de arquivo BAR completa e uma incremental, consulte Implementação de Aplicativo de Fluxo de Mensagens.

  3. Clique no arquivo BAR, mostrado na visualização do Navegador para realçá-lo.
  4. Implementa um arquivo BAR em um grupo de execução.
    • Arraste o arquivo para seu grupo de execução de destino mostrado na visualização Domínios.
    • Como alternativa, clique com o botão direito do mouse no arquivo BAR e clique em Implementar Arquivo. Uma janela mostra todos os domínios, bem como grupos de execução ao qual o ambiente de trabalho está conectado. Uma janela mostra os grupos de execução (em seus domínios) para os quais você pode implementar o arquivo BAR.

      Selecione um grupo de execução e clique em OK para implementar o arquivo BAR. ((Se você selecionar uma topologia de intermediário não conectada a um domínio, será feita uma tentativa de conectá-la. Se você clicar em Cancelar, a topologia do intermediário permanece desconectada de um domínio.

    Independentemente do método utilizado, você pode selecionar (e implementar em) somente um grupo de execução de cada vez.

  5. Se o arquivo BAR não tiver sido salvo desde sua última edição, será perguntado se você deseja salvá-lo antes da implementação. Se você clicar em Cancelar, o arquivo BAR não será salvo e a implementação não ocorrerá.
O arquivo BAR é transferido para o Configuration Manager, que implementa o conteúdo do arquivo (fluxos de mensagens e conjuntos de mensagens, por exemplo) no grupo de execução. Na visualização Domínios, os fluxos de mensagens designados e os conjuntos de mensagens são incluídos no grupo de execução apropriado.

Em seguida:

Continue verificando os resultados da implementação; consulte Verificando os Resultados da Implementação.

Utilizando o Comando mqsideploy

Siga estas etapas para implementar um arquivo BAR utilizando o comando mqsideploy.

  1. Abra uma janela de comandos configurada para seu ambiente.
  2. Utilizando os exemplos a seguir, digite o comando apropriado:
    Em plataformas distribuídas:
    mqsideploy -i ipAddress -p port -q qmgr -b broker -e exngp -a barfile

    O comando desempenha uma implementação incremental. Inclua o parâmetro –m para desempenhar uma implementação completa do arquivo BAR.

    Os parâmetros -i (endereço IP), -p (porta) e -q (gerenciador de fila) representam os detalhes de conexão do computador do gerenciador de fila.

    Também é necessário especificar os parâmetros -b (nome do intermediário), -e (nome do grupo de execução) e -a (nome do arquivo BAR).

    No z/OS:
    /f MQ01CMGR,dp b=broker e=exngp a=barfile

    O comando desempenha uma implementação incremental. Inclua o parâmetro m=yes para desempenhar uma implementação completa do arquivo BAR.

    Neste exemplo, MQ01CMGR é o nome do componente Configuration Manager. Você também deve especificar os nomes do intermediário, grupo de execução e arquivo BAR (os parâmetros b=, e=, w a=).

Em seguida:

Continue verificando os resultados da implementação; consulte Verificando os Resultados da Implementação.

Utilizando o Configuration Manager Proxy

Utilize o método deploy da classe ExecutionGroupProxy. Por padrão, o método implementação desempenha uma implementação incremental (delta). Para implementar a hierarquia completa, utilize uma variante do método que inclua o parâmetro Booleano isIncremental configurado como false. Configurar este parâmetro para true indica uma implementação incremental.

Para executar uma implementação incremental, por exemplo:
import com.ibm.broker.config.proxy.*;
import java.io.IOException;

public class DeployBar {
  public static void main(String[] args) {
    ConfigManagerConnectionParameters cmcp =
             new MQConfigManagerConnectionParameters("localhost", 1414, "QM1");
    try {
      ConfigManagerProxy cmp = ConfigManagerProxy.getInstance(cmcp);
      TopologyProxy t = cmp.getTopology();
      BrokerProxy b = t.getBrokerByName("BROKER1");
      ExecutionGroupProxy e = b.getExecutionGroupByName("default");
      e.deploy("deploy.bar");
    }
    catch (ConfigManagerProxyException cmpe) {
      cmpe.printStackTrace();
    }
    catch (IOException ioe) {
      ioe.printStackTrace();
    }
  }
} 
Por padrão, o método implementação desempenha uma implementação incremental. Para desempenhar uma implementação completa, utilize uma variante do método que inclua um valor falso para o parâmetro Boleano isIncremental. Por exemplo, e.deploy("deploy.bar",false,0). Configurar este parâmetro para true indica uma implementação incremental.

Em seguida:

Continue verificando os resultados da implementação; consulte Verificando os Resultados da Implementação.

Reimplementando um Arquivo Archive do Intermediário

Se você fizer alterações em um arquivo BAR e desejar propagar essas alterações para um ou mais intermediários, poderá reimplementar o arquivo BAR atualizado para um ou mais grupos de execução, utilizando qualquer um dos métodos de implementação descritos anteriormente. Os fluxos de mensagens implementados anteriormente não precisam ser parados; todos os recursos no grupo ou grupos de execução que estão no arquivo BAR reimplementado são substituídos e quaisquer novos recursos são aplicados.

Se as suas atualizações ao arquivo BAR incluírem a exclusão de recursos, uma reimplementação não resultará na exclusão desses recursos do intermediário. Por exemplo, suponha que o arquivo BAR contenha os fluxos de mensagens F1, F2 e F3. Você atualiza o arquivo removendo F2 e incluindo o fluxo de mensagens F4. e você reimplementar o arquivo BAR, todos os quatro fluxos estarão disponíveis no grupo de execução quando a reimplementação for concluída. F1 e F3 são substituídos pelo conteúdo do arquivo BAR reimplementado.

Se desejar limpar recursos do grupo de execução que você implementou anteriormente, antes da reimplementação, possivelmente porque está excluindo recursos, utilize um dos métodos descritos acima:
  • Utilizando o ambiente de trabalho, siga as instruções para uma implementação completa, certificano-se de selecionar Remover Filhos Implementados antes de implementar.
  • Utilizando o comandomqsideploy, siga as instruções, certificando-se de incluir o parâmetro –m para desempenhar uma implementação completa do arquivo BAR.
  • Utilizando o Configuration Manager Proxy, siga as instruções para uma implementação completa.

Se seus fluxos de mensagens não forem transacionais, pare estes fluxos de mensagens antes de reimplementar, para certificar-se de que todos os aplicativos foram concluídos corretamente e estão em um estado conhecido e consistente. É possível parar fluxos de mensagens individuais, grupos de execução ou intermediários.

Se os fluxos de mensagens forem transacionais, a lógica de processamento que manipula a confirmação ou recuperação assegurará que a integridade e a consistência dos recursos seja preservada.

Em seguida:

Continue verificando os resultados da reimplementação. Consulte o Verificando os Resultados da Implementação.

Informações relacionadas
API do Configuration Manager Proxy
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:12:32

af03890_