WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Comando mqsiaddbrokerinstance - Sistemas Windows

Use o comando mqsiaddbrokerinstance para incluir um broker com diversas instâncias em sistemas Windows.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsiaddbrokerinstance--brokerName-- -e -- sharedWorkpath ---->

>--+------------------+-- -i -- serviceUserId ------------------>
   '- -w -- Workpath -'                          

>-- -a -- servicePassword -------------------------------------><

Parâmetros

brokerName
(Necessário) O nome da instância do broker que você está incluindo. É necessário especificar o nome como o primeiro parâmetro e o nome faz distinção entre maiúsculas e minúsculas. O nome da instância do broker deve corresponder àquela de um broker ativado por multi-instância criado anteriormente usando o comando mqsicreatebroker.

Para restrições do conjunto de caracteres que você pode utilizar, consulte Caracteres Permitidos em Comandos.

-e sharedWorkpath
(Necessário) O valor representa o diretório no qual arquivos de trabalho globalmente acessíveis para este broker estão localizados no armazenamento de rede compartilhado (NFS ou NAS).

Você deve assegurar que o broker tenha acesso a esta localização do armazenamento de rede antes de iniciar o broker e que o gerenciador de filas para o broker tenha sido configurado como um gerenciador de filas multi-instância do WebSphere MQ.

As informações armazenadas neste diretório compartilhado incluem:
  • O registro do broker
  • Diretórios de componentes
  • Tabelas e arquivos internos do broker para fluxos de mensagens implementados
  • Propriedades de serviço configurável.
-w Workpath
(Opcional) O diretório no qual arquivos de trabalho específicos desta instância do broker são armazenados localmente no servidor no qual a instância do broker será executada. Se você não especificar este parâmetro, os arquivos serão armazenados no caminho de Trabalho padrão, que é aquele que você especificou quando o produto foi instalado. Se esse parâmetro for especificado, você deverá criar esse diretório antes de iniciar o intermediário.

Esse diretório também é utilizado para registros de rastreio criados quando o rastreio está ativo. Esses registros são gravados em um subdiretório, log, que você deve criar antes de iniciar o broker.

Os logs de erros gravados pelo broker quando um processo é encerrado anormalmente são armazenados neste diretório.

O registro de erros é desvinculado e continua se expandindo. Verifique esse diretório periodicamente e limpe as informações de erro antigas.

Não é possível alterar esse parâmetro utilizando o comando mqsichangebroker. Para especificar ou alterar o caminho de trabalho, exclua e recrie o intermediário.

A especificação deste parâmetro cria um diretório de trabalho separado para o broker. Este diretório de trabalho é um subconjunto da estrutura de diretório de trabalho padrão que contém menos subdiretórios e nenhum subdiretório common\profiles.

-i serviceUserId
(Necessário) O ID do usuário sob o qual o intermediário é executado.

É possível especificar o serviceUserId em qualquer sintaxe de nome de usuário válida:

  • Como um nome local:

    username

    .\username

  • Como um Nome do Usuário Principal (UPN):

    username@domain

  • Como um estilo tradicional de nome de logon:

    domain\username

  • Como uma solicitação para um servidor específico:

    \\server\username

Se você utilizar o formato não qualificado para este ID do usuário (username), o sistema operacional pesquisará o ID do usuário em todo o seu domínio, começando com o sistema local. Essa pesquisa pode levar algum tempo para concluir.

O serviceUserId que você especifica deve ser um membro direto ou indireto do grupo local mqbrkrs. O serviceUserId também deve estar autorizado a acessar o diretório inicial (no qual o WebSphere Message Broker foi instalado) e o diretório de trabalho (se especificado pelo parâmetro -w).

Se você especificar que o intermediário deve ser executado como um aplicativo confiável do WebSphere MQ (parâmetro -t), também deverá incluir o ID do usuário do serviço no grupo mqm.

Os requisitos de segurança para o serviceUserId estão descritos em Requisitos de Segurança para Sistemas Windows.

-a servicePassword
(Necessário) A senha para o serviceUserId.

Para compatibilidade com os sistemas existentes, você pode especificar <password>. No entanto, se você não especificar uma senha com este parâmetro quando executar o comando, será solicitado que insira uma senha. É necessário inserir a senha uma segunda vez para verificar se ela foi inserida corretamente.

Exemplos

O exemplo a seguir inclui uma instância de broker no broker Mybroker no caminho de trabalho compartilhado MyNetworkSharedWorkpath:

mqsiaddbrokerinstance MyBroker –e /MyNetworkSharedWorkpath -i
Fred -a Test
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:31:33


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | bn13520_.dita