WebSphere Application Server für die Verwendung der neuesten Wartungsstufe des Ressourcenadapters konfigurieren

Um sicherzustellen, dass der ' IBM® MQ automatisch auf die neueste verfügbare Wartungsstufe aktualisiert wird, wenn Sie ' WebSphere® Application Server -Fixpacks anwenden, können Sie alle Server in Ihrer Umgebung so konfigurieren, dass sie die neueste Version des Ressourcenadapters verwenden, die in dem ' WebSphere Application Server -Fixpack enthalten ist, das Sie auf die Installation jedes Knotens angewendet haben.

Vorbereitungen

Wichtig:
  • [Jakarta Messaging 3.0 ] WebSphere Application Server unterstützt derzeit nicht Jakarta EE. Siehe IBM MQ Resource Adapter Statement of Support.
  • Wenn Sie WebSphere Application Server 8.5 oder früher auf einer beliebigen Plattform verwenden, installieren Sie den Ressourcenadapter von IBM MQ 8.0 oder höher nicht im Anwendungsserver. Der Ressourcenadapter von IBM MQ 8.0 oder höher kann nur in einem Anwendungsserver implementiert werden, der JMS 2.0unterstützt. WebSphere Application Server 8.5 oder früher unterstützt jedoch nur JMS 1.1.

Informationen zu dieser Task

Verwenden Sie diese Task, wenn eine der folgenden Bedingungen für Ihre Konfiguration zutrifft und Sie alle Server in Ihrer Umgebung für die Verwendung der neuesten Version des IBM MQ -Ressourcenadapters konfigurieren möchten:
  • Die JVM-Protokolle aller Anwendungsserver in Ihrer Umgebung zeigen die folgenden Informationen zur Version des IBM MQ -Ressourcenadapters an, nachdem WebSphere Application Server 7.0.0 Fix Pack 1 oder höher angewendet wurde:
    WMSG1703I:RAR implementation Version 7.0.0.0-k700-L080820
    
  • Die JVM-Protokolle eines beliebigen Anwendungsservers in Ihrer Umgebung enthalten den folgenden Eintrag:
    WMSG1625E: It was not possible to detect
    der Code des IBM MQ -Messaging-Providers im angegebenen Pfad < null>
    
  • Mindestens ein Knoten wurde zuvor manuell für die Verwendung einer bestimmten Wartungsstufe des IBM MQ -Ressourcenadapters aktualisiert, die jetzt durch die neueste Version des in der aktuellen WebSphere Application Server -Wartungsstufe enthaltenen Ressourcenadapters ersetzt wird.

Das Verzeichnis profile_root , auf das sich die Beispiele beziehen, ist das Ausgangsverzeichnis für das WebSphere Application Server -Profil, z. B. C:\Program Files\IBM\WebSphere\AppServer1.

Wenn Sie die folgenden Schritte für alle Zellen und Einzelserverinstallationen in Ihrer Umgebung ausgeführt haben, erhalten Ihre Server automatisch Wartungspakete für den IBM MQ -Ressourcenadapter, wenn ein neues WebSphere Application Server -Fixpack angewendet wird.

Verfahren

  1. Starten Sie den Anwendungsserver. Wenn das Profil Teil einer Network Deployment-Konfiguration ist, starten Sie den Deployment Manager und alle Knotenagenten. Wenn das Profil einen Verwaltungsagenten enthält, starten Sie den Verwaltungsagenten.
  2. Überprüfen Sie die Wartungsstufe des IBM MQ -Ressourcenadapters.
    1. Öffnen Sie ein Fenster mit Eingabeaufforderung und wechseln Sie in das Verzeichnis profile_root\bin .
      Geben Sie beispielsweise cd C:\Program Files\IBM\WebSphere\AppServer1\bin ein.
    2. Starten Sie das Tool 'wsadmin', indem Sie wsadmin.bat -lang jythoneingeben. Wenn Sie dazu aufgefordert werden, geben Sie Ihren Benutzernamen und Ihr Kennwort ein.
    3. Geben Sie den folgenden Befehl ein, und drücken Sie zweimal die Eingabetaste:
      wmqInfoMBeansUnsplit = AdminControl.queryNames("WebSphere:type=WMQInfo,*")
      wmqInfoMBeansSplit = AdminUtilities.convertToList(wmqInfoMBeansUnsplit)
      for wmqInfoMBean in wmqInfoMBeansSplit: print wmqInfoMBean; print AdminControl.invoke(wmqInfoMBean, 'getInfo', '')
      
      Sie können diesen Befehl auch in Jacl ausführen. Weitere Informationen hierzu finden Sie unter Sicherstellen, dass Server die neueste verfügbare Wartungsstufe des IBM MQ -Ressourcenadapters verwenden in der Produktdokumentation zu WebSphere Application Server .
    4. Einzelheiten zuWMSG1703Iin der angezeigten Ausgabe des Befehls und überprüfen Sie die Ressourcenadapterebene.
      Für WebSphere Application Server 7.0.1 Fix Pack 5sollte die Nachricht beispielsweise wie folgt lauten:
      WMSG1703I: RAR implementation Version 7.0.1.3-k701-103-100812
      
      Diese Nachricht zeigt, dass die Version 7.0.1.3-k701-103-100812 ist. Dies ist die korrekte Ressourcenadapterebene für dieses Fixpack. Wenn stattdessen die folgende Nachricht angezeigt wird, bedeutet dies jedoch, dass Sie den Ressourcenadapter an die richtige Wartungsstufe für WebSphere Application Server 7.0.1 Fix Pack 5anpassen müssen.
      WMSG1703I: RAR implementation Version 7.0.0.0-k700-L080820
      
  3. Kopieren Sie das folgende Jython-Script in eine Datei mit dem Namen convertWMQRA.pyund speichern Sie sie im Profilstammverzeichnis, z. B. C:\Program Files\IBM\WebSphere\AppServer1\bin.
    ras = AdminUtilities.convertToList(AdminConfig.list('J2CResourceAdapter'))
    
    for ra in ras :
      desc = AdminConfig.showAttribute(ra, "description")
      if (desc == "WAS 7.0 Built In MQ Resource Adapter") or (desc == "WAS 7.0.0.1 Built In 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
    
    Tipp: Stellen Sie sicher, dass die Datei beim Speichern als Python-Datei und nicht als Textdatei gespeichert wird.
  4. Verwenden Sie das WebSphere Application Server -Tool wsadmin, um das soeben erstellte Jython-Script auszuführen.
    Öffnen Sie eine Eingabeaufforderung und navigieren Sie zum Verzeichnis \bin im Ausgangsverzeichnis für das WebSphere Application Server, z. B. C:\Program Files\IBM\WebSphere\AppServer1\bin. Geben Sie dann den folgenden Befehl ein und drücken Sie die Eingabetaste:
    wsadmin -lang jython -f convertWMQRA.py
    
    Wenn Sie dazu aufgefordert werden, geben Sie Ihren Benutzernamen und Ihr Kennwort ein.
    Hinweis: Wenn Sie das Script für ein Profil ausführen, das Teil einer Network Deployment-Konfiguration ist, aktualisiert das Script alle Profile, die in dieser Konfiguration aktualisiert werden müssen. Es kann eine vollständige Resynchronisation erforderlich sein, wenn Sie bereits vorhandene Konfigurationsdateiinkonsistenzen haben.
  5. Wenn Sie in einer Network Deployment-Konfiguration ausgeführt werden, stellen Sie sicher, dass die Knotenagenten vollständig neu synchronisiert sind. Weitere Informationen finden Sie unter Synchronisieren von Knoten mit dem Scripting-Tool wsadmin oder Hinzufügen, Verwalten und Entfernen von Knoten.
  6. Stoppen Sie alle Server im Profil. Wenn das Profil Teil einer Network Deployment-Konfiguration ist, stoppen Sie auch alle Cluster-Member in der Konfiguration, stoppen Sie alle Knotenagenten in der Konfiguration und stoppen Sie den Deployment Manager. Wenn das Profil einen Verwaltungsagenten enthält, stoppen Sie den Verwaltungsagenten.
  7. Führen Sie den Befehl osgiCfgInit im Verzeichnis profile_root/bin aus.
    Mit dem Befehl osgiCfgInit wird der Klassencache, der von der OSGi-Laufzeitumgebung verwendet wird, neu festgelegt. Wenn das Profil Teil einer Network Deployment-Konfiguration ist, führen Sie den osgiCfgInit -Befehl im Verzeichnis profile_root/bin jedes Profils aus, das Teil der Konfiguration ist.
  8. Starten Sie alle Server im Profil erneut. Wenn das Profil Teil einer Netzimplementierungskonfiguration ist, starten Sie auch alle Cluster-Member in der Konfiguration erneut, starten Sie alle Knotenagenten in der Konfiguration erneut, und starten Sie den Deployment Manager erneut. Wenn das Profil einen Verwaltungsagenten enthält, starten Sie den Verwaltungsagenten erneut.
  9. Wiederholen Sie Schritt 2, um zu überprüfen, ob der Ressourcenadapter jetzt die richtige Stufe aufweist.

Nächste Schritte

Wenn Sie nach der Durchführung der in diesem Thema beschriebenen Schritte weiterhin Probleme haben und Sie zuvor die Schaltfläche Ressourcenadapter aktualisieren auf dem Panel JMS Provider-Einstellungen in der WebSphere Application Server Verwaltungskonsole verwendet haben, um den IBM MQ Ressourcenadapter auf allen Knoten in Ihrer Umgebung zu aktualisieren, ist es möglich, dass das in APAR PM10308 beschriebene Problem auftritt.