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

Configurando a Coordenação Global com o Oracle

Configure seu ambiente do broker para coordenar globalmente transações do fluxo de mensagem com atualizações nos bancos de dados Oracle sob controle de um gerenciador de filas do WebSphere MQ.

Antes de começar:
Configure o seu ambiente do broker para coordenação global usando um gerenciador de filas de 64 bits como o gerenciador de transações com drivers DataDirect:
  1. Linux platformUNIX platformNo Linux e UNIX, execute o comando mqsimanagexalinks.
  2. Windows platformNo Windows 64 bits, para a versão de 64 bits do WebSphere Message Broker, execute o comando mqsimanagexalinks e inclua o diretório especificado como o ExitsDefaultPath do gerenciador de filas no PATH do sistema.
  3. Configure o gerenciador de filas do broker com informações do gerenciador de recursos XA de cada banco de dados que estiver envolvido na transação que o gerenciador de filas coordenará globalmente.

    Linux platformUNIX platformNo Linux e no UNIX:

    1. Abra o arquivo qm.ini dos gerenciadores de filas em um editor de texto. O arquivo qm.ini está localizado em /var/mqm/qmgrs/queue_manager_name/qm.ini. Em que queue_manager_name é o nome do broker que está associado ao gerenciador de filas.
    2. Inclua a sub-rotina a seguir no final do arquivoqm.ini: Início da mudança
      XAResourceManager:
      Name=OracleXA
      SwitchFile=UKoradtc24.so
      XAOpenString=ORACLE_XA
         +HostName=MyHostName
         +PortNumber=MyPortNumber
         +ServiceName=MyServiceName
         +ACC=P/MyUserId/MyPassword
         +sestm=100+threads=TRUE
         +DataSource=MyDataSourceName
         +K=2+
      XACloseString=
      ThreadOfControl=THREAD
      Fim da mudança
    3. Na linha XAOpenString, substitua os seguintes valores pelos valores apropriados à sua configuração:
      • MyHostName é o nome do host TCP/IP que hospeda o listener do banco de dados Oracle. Quando você estiver usando o Oracle Real Application Clusters com diversos listeners para o Nome de Serviço fornecido, se o listener do Oracle identificado pelos valores para MyHostName e MyPortNumber na XAOpenString estiver indisponível, os listeners alternativos do Oracle que podem ter sido definidos na lista AlternateServers no arquivo odbc.ini também serão tentados.
      • MyPortNumber é a porta TCP/IP na qual o listener do banco de dados Oracle está atendendo.
      • MyUserId deve ser o nome de usuário que o broker usa para se conectar ao banco de dados.
        É possível definir o nome do usuário que o broker usa de uma série de maneiras; certifique-se de especificar o nome correto nesse arquivo. O broker determina o nome de usuário verificando as seguintes condições na ordem listada:
        1. Um nome de usuário e senha específicos para este nome da origem de dados (DSN), que você definiu executando o comando mqsisetdbparms.
        2. Um nome de usuário e senha padrão para todos os DSNs, que você definiu executando o comando mqsisetdbparms.
        3. Um nome de usuário e senha padrão para todos os DSNs, que você definiu especificando o parâmetro -u no comando mqsicreatebroker.

          Este parâmetro é válido somente para brokers que você migrou a partir de releases anteriores.

        4. O nome de usuário de serviço do broker, que você define com o parâmetro -i no comando mqsicreatebroker
      • MyPassword é a senha associada ao nome de usuário.
      • MyDataSourceName é o nome da origem de dados ODBC do banco de dados, conforme definido no arquivo odbc.ini.
      • MyServiceName é o valor configurado para o Nome do Serviço na sub-rotina para MyDataSourceName no arquivo odbc.ini.
    4. Aceite os valores padrão para todas as demais linhas na sub-rotina. Por exemplo:
      • No AIX:Início da mudança
        XAResourceManager:
        Name=OracleXA
        SwitchFile=UKoradtc24.so
        XAOpenString=ORACLE_XA
           +HostName=diaz.hursley.ibm.com
           +PortNumber=1521
           +ServiceName=accounts_service
           +ACC=P/wbrkuid/wbrkpw
           +sestm=100+threads=TRUE
           +DataSource=MYDB+K=2+
        XACloseString=
        ThreadOfControl=THREAD
        Fim da mudança
    5. Se estiver usando coordenação Global para o Oracle:
      • Configure a variável de ambiente ODBCINI para ficar visível no ambiente do qual o gerenciador de filas é iniciado. A variável ODBCINI deve fazer referência ao mesmo arquivo que está sendo usado pelo broker.
      • Uma propriedade adicional opcional, CTO=Value, está disponível para a XAOpenString. CTO é o valor configurado para um Tempo Limite de Conexão, indicando o número de segundos que o arquivo de comutação aguardará por uma resposta do banco de dados Oracle para uma solicitação XA. Por exemplo, o tempo limite pode ser usado para evitar longos atrasos no failover do broker sobre um nó alternativo do Oracle Real Application Clusters, quando a instância ativa do Oracle falhar abruptamente, interrompendo as conexões do soquete. O Value deve ser configurado como um valor maior do que o valor sestm de tempo limite da sessão Oracle configurada na XAOpenString. Se essa propriedade não for usada, ou estiver configurada como zero, não haverá tempo limite (esse é o comportamento padrão).

    Windows platformNo Windows 32 bits e Windows 64 bits

    1. No menu Iniciar, abra o WebSphere MQ Explorer.
    2. Abra a caixa de diálogo Propriedades do gerenciador de filas e, em seguida, abra gerenciadores de recursos XA.
    3. No campo SwitchFile, insira o nome do arquivo de troca, conforme mostrado no exemplo a seguir, em que install_dir é o local em que o broker está instalado: Início da mudança
      • Se você estiver usando a versão de 32 bits do WebSphere Message Broker:
        install_dir\bin\UKora24.dll
      • Se você estiver usando a versão de 64 bits do WebSphere Message Broker:
        UKora24.dll
      Fim da mudança
    4. No campo XAOpenString, cole a seguinte cadeia:
      ORACLE_XA+
         +HostName=MyHostName
         +PortNumber=MyPortNumber
         +ServiceName=MyServiceName
         +ACC=P/MyUserId/MyPassword
         +sestm=100+threads=TRUE
         +DataSource=MyDataSourceName
         +K=2+
    5. No campo XAOpenString, substitua os valores por valores que sejam apropriados para sua configuração:
      • MyHostName é o nome do host TCP/IP que hospeda o listener do banco de dados Oracle. Quando você estiver usando o Oracle Real Application Clusters com diversos listeners para o Nome de Serviço fornecido, se o listener do Oracle identificado pelos valores para MyHostName e MyPortNumber na XAOpenString estiver indisponível, os listeners alternativos do Oracle que podem ter sido definidos na lista AlternateServers no arquivo odbc.ini também serão tentados.
      • MyPortNumber é a porta TCP/IP na qual o listener do banco de dados Oracle está atendendo.
      • MyUserId deve ser o nome de usuário que o broker usa para se conectar ao banco de dados.
        É possível definir o nome do usuário que o broker usa de uma série de maneiras; certifique-se de especificar o nome correto nesse arquivo. O broker determina o nome de usuário verificando as seguintes condições na ordem listada:
        1. Um nome de usuário e senha específicos para este nome da origem de dados (DSN), que você definiu executando o comando mqsisetdbparms.
        2. Um nome de usuário e senha padrão para todos os DSNs, que você definiu executando o comando mqsisetdbparms.
        3. Um nome de usuário e senha padrão para todos os DSNs, que você definiu especificando o parâmetro -u no comando mqsicreatebroker.

          Este parâmetro é válido somente para brokers que você migrou a partir de releases anteriores.

        4. O nome de usuário de serviço do broker, que você define com o parâmetro -i no comando mqsicreatebroker
      • MyPassword é a senha associada ao nome de usuário.
      • MyDataSourceName é o nome da origem de dados ODBC do banco de dados, conforme definido no arquivo odbc.ini.
      • MyServiceName é o valor configurado para o Nome do Serviço na definição ODBC da origem de dados MyDataSourceName.
      Por Exemplo:
      ORACLE_XA+
         +HostName=diaz.hursley.ibm.com
         +PortNumber=1521
         +ServiceName=accounts_service
         +ACC=P/wbrkuid/wbrkpw
         +sestm=100+threads=TRUE
         +DataSource=MYDB+K=2+
    6. Aceite os valores padrão para todos os demais campos da página.
  4. AIX platformNo AIX, se você desejar ativar origens de dados Oracle para usar na coordenação global a partir de um gerenciador de filas e broker para executar o registro de XA dinâmico, configure a seguinte variável de ambiente: DDTEK_XA_DYNAMIC_REGISTRATION=1
  5. Linux platformUNIX platformPare, em seguida, reinicie o gerenciador de filas para aplicar as alterações, porque qm.ini é somente leitura durante a execução do gerenciador de filas.
    Para parar e reiniciar o gerenciador de filas, insira os seguintes comandos, em que queue_manager_name é o nome do gerenciador de filas:
    endmqm queue_manager_name
    strmqm queue_manager_name

    Quando o gerenciador de filas reiniciar, verifique o log do gerenciador de filas para todos os avisos que estejam associados com o reinício. Os arquivos de log estão localizados em /var/mqm/qmgrs/queue_manager_name/errors, em que queue_manager_name é o nome do gerenciador de filas reiniciado.

    Quando o gerenciador de filas for reiniciado com êxito, as alterações feitas em qm.ini serão aplicadas.
  6. Windows platformPare e, em seguida, reinicie o gerenciador de filas para aplicar as alterações.
    Para parar e reiniciar o gerenciador de filas, insira os seguintes comandos, em que queue_manager_name é o nome do gerenciador de filas:
    endmqm queue_manager_name
    strmqm -si queue_manager_name

    Quando o gerenciador de filas reiniciar, verifique o log do gerenciador de filas para todos os avisos que estejam associados com o reinício. Os arquivos de log estão localizados em /var/mqm/qmgrs/queue_manager_name/errors, em que queue_manager_name é o nome do gerenciador de filas reiniciado.

    Quando o gerenciador de filas reinicia com êxito, as alterações feitas são aplicadas.
O Oracle agora está configurado para coordenação global com o gerenciador de filas do broker que coordena transações.
Em seguida: é possível implementar fluxos de mensagens coordenados globalmente no broker.
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:25


Tópico de TarefaTópico de Tarefa | Versão 8.0.0.5 | bh26085_