Use o comando mqsicreatebroker para criar um broker em um sistema Windows.
>>-mqsicreatebroker--brokerName-- -i --+-serviceUserId-+--------> '-LocalSystem---' >-- -a --servicePassword-- -q --queueManagerName----------------> >--+----------------+--+------+--+------+-----------------------> '- -w --workPath-' '- -t -' '- -m -' >--+-------------------+----------------------------------------> '- -l --userLilPath-' >--+----------------------------------+-------------------------> '- -g --configurationChangeTimeout-' >--+------------------------------------+-----------------------> '- -k --internalConfigurationTimeout-' >--+------------------------+-----------------------------------> '- -P --httpListenerPort-' >--+-------------------------------+----------------------------> '- -v --statisticsMajorInterval-' >--+------------------------------------------+-----------------> '- -y--ldapPrincipal-- -z--ldapCredentials-' >--+------------------------+--+--------------------+-----------> '- -c --icuConverterPath-' '- -x --userExitPath-' >--+---------------------+--+--------------------+--------------> '- -o --operationMode-' '- -s --+-active---+-' '-inactive-' >--+----------------------+--+---------------------+------------> '- -e --sharedWorkPath-' '- -d --+-defined---+-' '-undefined-' >--+-------------------+--+----------------------+------------->< '- -b --cachePolicy-' '- -r --cachePortRange-'
Para restrições do conjunto de caracteres que você pode utilizar, consulte Caracteres Permitidos em Comandos.
É possível especificar o serviceUserId em qualquer sintaxe de nome de usuário válida:
Não utilize um nome de domínio como parte do parâmetro serviceUserId.
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.
Se você especificar LocalSystem, ainda deverá usar o parâmetro servicePassword; entretanto, o valor do parâmetro servicePassword é ignorado.
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.
O comportamento padrão é criar um gerenciador de filas que usando o caminho mqm padrão, se o gerenciador de filas ainda não existir no mesmo servidor.
crtmqm –md /<broker sharedWorkPath>/mqm/qmdata
-ld //<broker sharedWorkPath>/mqm/qmlog queueManagerName
Se esse caminho do gerenciador de filas compartilhado não for adequado, crie o gerenciador de filas de várias instâncias no servidor antes de executar esse comando.
O atributo do gerenciador de filas MAXMSGLEN (o comprimento máximo de mensagens que podem ser colocadas em filas) é atualizado para 100 MB. Esse é atributo é atualizado independentemente de o gerenciador de filas ter sido criado por esse comando.
Para restrições do conjunto de caracteres que você pode utilizar, consulte Caracteres Permitidos em Comandos.
Quando um broker tiver sido ativado para o modo multi-instância usando o sinalizador –e, o broker workPath será dividido entre os dados que são específicos para esta instância do broker e eles serão compartilhados entre este broker e qualquer uma de suas instâncias criadas usando o comando mqsiaddbrokerinstance. Os dados específicos para o broker ativado por multi-instância serão armazenados no diretório workPath no servidor local, enquanto que os dados compartilhados são mantidos em um diretório no armazenamento de rede no local especificado usando o sinalizador –e.
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.
Se você especificar este parâmetro, inclua o serviceUserId (identificado pelo parâmetro -i) no grupo mqm.
Para obter mais detalhes sobre como usar aplicativos confiáveis do WebSphere MQ, consulte a seção Intercomunicação do Centro de Informações Online do WebSphere MQ Versão 7.
Não inclua variáveis de ambiente no caminho; elas são ignoradas pelo broker.
Crie seu próprio diretório para armazenar seus arquivos .lil ou .jar. Não salve-os no diretório de instalação do WebSphere Message Broker.
Se você especificar mais de um diretório, separe os diretórios usando um ponto e vírgula (;).
Um fluxo de mensagens não pode responder a uma alteração na configuração enquanto está processando uma mensagem do aplicativo. Um grupo de execução retornará uma resposta negativa para a mensagem de configuração implementada se algum de seus fluxos de mensagens não concluir o processamento de uma mensagem do aplicativo e aplicar a alteração na configuração dentro deste tempo limite.
Especifique o valor em segundos, no intervalo de 10 - 3600. O padrão é 300.
Para obter informações sobre como configurar o valor para este tempo limite, consulte Configurando Valores de Tempo Limite de Configuração.
O tempo de resposta de cada grupo de execução se difere, de acordo com o carregamento do sistema e do carregamento de seus próprios processos. O valor deve refletir o tempo de resposta mais longo gasto por qualquer grupo de execução para responder. Se o valor for muito baixo, o broker retornará uma resposta negativa e poderá emitir mensagens de erro no log de erros local.
Especifique o valor em segundos, no intervalo de 10 - 3600. O padrão é 60.
Para obter informações sobre como configurar o valor para este tempo limite, consulte Configurando Valores de Tempo Limite de Configuração.
O broker inicia este listener quando um fluxo de mensagens que inclui nós HTTP ou o suporte a serviços da Web é iniciado; o padrão é 7080.
Verifique se a porta especificada não foi especificada para nenhuma outra finalidade.
Se você especificar -s active, a segurança administrativa será ativada. Apenas os IDs do usuário que você autorizar terão permissão para concluir ações no broker. As autoridades read, write e execute são sempre concedidas na fila de segurança SYSTEM.BROKER.AUTH a todos os IDs do usuário que pertencem ao grupo de segurança mqbrkrs. Quando o broker tiver sido criado, será possível incluir autorizações de ID do usuário adicionais nesta fila.
Ao criar um grupo de execução em um broker para o qual a segurança administrativa está ativada, a fila SYSTEM.BROKER,AUTH.egroup_name é criada. Preencha a fila com a autorização do usuário apropriada.
Se você especificar -s inactive, ou omitir este parâmetro, a segurança do broker não será ativada. Todos os usuários podem concluir todas as ações no broker e em todos os grupos de execução.
Esta opção é uma alternativa para iniciar um broker com múltiplas instâncias no modo de espera usando o comando mqsistart.
Se especificar -d defined, o serviço do WebSphere MQ será definido no gerenciador de filas e o broker iniciará e parará quando o gerenciador de filas iniciar e parar.
Se você especificar -d undefined, o serviço do WebSphere MQ não será definido no gerenciador de filas e o broker não iniciará e executará quando o gerenciador de filas iniciar e parar. Essa é a definição padrão.
-b cachePolicy
(Opcional) A política a ser usada
para o gerenciador de cache. Configure este parâmetro como padrão, desativado, nenhum ou o nome completo de um arquivo
de políticas XML.
-r cachePortRange
(Opcional) O intervalo de portas
a serem usadas pelo gerenciador de cache. Configure esse parâmetro para generate ou
para um intervalo específico de portas.
mqsicreatebroker
MB8BROKER -i wbrkuid -a
wbrkpw -q MB8QMGR -t
mqsicreatebroker MB8BROKER -i wbrkuid -a wbrkpw
-q MB8QMGR -x /opt/3rdparty/wmbexits
mqsicreatebrokerMB8BROKER
-q MB8QMGR -s active