Ensuring that servers use the latest available IBM MQ resource adapter maintenance level

To ensure that the IBM MQ resource adapter (adaptador de recurso) is automatically updated to the latest available maintenance level when you apply WebSphere® Application Server fix packs, you can configure all servers in your environment to use the latest version of the resource adapter contained in the WebSphere Application Server fix pack that you have applied to the installation of each node.

Before you begin

Updates to the IBM MQ resource adapter (adaptador de recurso) that is installed with WebSphere Application Server are included in WebSphere Application Server Fix Packs. You must only update the IBM MQ resource adapter (adaptador de recurso) using the "Update resource adapter facility if you require a specific version of the resource adapter, instead of the most recent version. To install a specific version of the resource adapter, see Installing a specific maintenance level of the IBM MQ resource adapter.

You can use the following Jython and Jacl commands to determine the level of the IBM MQ resource adapter (adaptador de recurso) currently being used by WebSphere Application Server:
  • Jython:
    Note: You must press Return twice after entering this command in order to run it.
    wmqInfoMBeansUnsplit = AdminControl.queryNames("WebSphere:type=WMQInfo,*")
    wmqInfoMBeansSplit = AdminUtilities.convertToList(wmqInfoMBeansUnsplit)
    for wmqInfoMBean in wmqInfoMBeansSplit: print wmqInfoMBean; print AdminControl.invoke(wmqInfoMBean, 'getInfo', '')
  • Jacl:
    set wmqInfoMBeans [$AdminControl queryNames WebSphere:type=WMQInfo,*]
    foreach wmqInfoMBean $wmqInfoMBeans {
    puts $wmqInfoMBean;
    puts [$AdminControl invoke $wmqInfoMBean getInfo [] []]
    }

About this task

Use this task if any of the following circumstances apply to your configuration, and you want to configure all servers in your environment to use the latest version of the IBM MQ resource adapter (adaptador de recurso):
  • The JVM logs of any application server in your environment contain the following entry:
    WMSG1625E: It was not possible to detect
    the WebSphere MQ messaging provider code at the specified path <null>
  • One or more nodes has previously been manually updated to use a specific maintenance level of the IBM MQ resource adapter (adaptador de recurso) that is now superseded by the latest version of the resource adapter contained in the current WebSphere Application Server maintenance level.

When you have performed the following steps for all cells and single server installations in your environment, your servers will automatically receive maintenance to the IBM MQ resource adapter (adaptador de recurso) when a new WebSphere Application Server fix pack is applied.

Procedure

  1. Inicie o servidor de aplicativos. Se o perfil fizer parte de uma configuração de implementação de rede, inicie o gerenciador de implementação e todos os agentes de nó. Se o perfil contiver um agente administrativo, inicie o agente administrativo.
  2. Copie o script Jython a seguir em um arquivo chamado convertWMQRA.py, em seguida, salve-o no diretório profile_root/bin.
    ras = AdminUtilities.convertToList(AdminConfig.list('J2CResourceAdapter'))
    
    for ra in ras :
       desc = AdminConfig.showAttribute(ra, "description")
       if ((desc == "WAS 7.0 Built In WebSphere MQ Resource Adapter") or (desc == "WAS 7.0.0.1 Built In WebSphere MQ Resource Adapter") or (desc == "WAS Built In WebSphere MQ Resource Adapter")):
          print "Updating archivePath and classpath of " + ra
          AdminConfig.modify(ra, [['archivePath', "${WAS_INSTALL_ROOT}/installedConnectors/wmq.jmsra.rar"]])
          AdminConfig.unsetAttributes(ra, ['classpath'])
          AdminConfig.modify(ra, [['classpath', "${WAS_INSTALL_ROOT}/installedConnectors/wmq.jmsra.rar"]])
          AdminConfig.save()
       #end if
    #end for
  3. Utilize a ferramenta wsadmin para executar o script Jython recém criado.
    Abra um prompt de comandos e navegue para o diretório profile_root/bin e, em seguida, insira o seguinte comando:
    wsadmin -lang jython -f convertWMQRA.py
    Note: Se executar o script com relação a um perfil que fizer parte de uma configuração de implementação de rede, o script atualizará todos os perfis que precisarem de atualização nessa configuração. Uma ressincronização integral pode ser necessária se houver inconsistências preexistentes no arquivo de configuração.
  4. Se você estiver executando em uma configuração de implementação de rede, certifique-se de que os agentes de nó estejam ressincronizados completamente.

    Para obter informações adicionais, consulte Sincronizando Nós Usando a Ferramenta de Programação de Script Wsadmin ou Incluindo, Gerenciando e Removendo Nós.

  5. Pare todos os servidores no perfil. Se o perfil fizer parte de uma configuração de implementação de rede, pare também todos os membros de cluster e todos os agentes de nó na configuração e também o gerenciador de implementação. If the profile contains an administrative agent, stop the administrative agent.
  6. Execute o comando osgiCfgInit do diretório profile_root/bin. Se o perfil fizer parte de uma configuração de implementação de rede, execute o comando osgiCfgInit a partir do diretório profile_root/bin de cada perfil que fizer parte da configuração.
    Note: O comando osgiCfgInit reconfigura o cache de classe usado pelo ambiente de tempo de execução OSGi.
  7. Reinicie todos os servidores no perfil. Se o perfil fizer parte de uma configuração de implementação de rede, reinicie também todos os membros de cluster e todos os agentes de nó na configuração e também o gerenciador de implementação. If the profile contains an administrative agent, restart the administrative agent.

What to do next

If you continue to experience problems after performing the steps described in this topic, and you have previously used the Update resource adapter... button on the JMS Provider Settings panel in the administrative console to update the IBM MQ resource adapter (adaptador de recurso) on any nodes in your environment, it is possible that you are experiencing the issue described in APAR PM10308.

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: July 9, 2016 7:55
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tmj_wmqra_restoredefault
Nome do arquivo: tmj_wmqra_restoredefault.html