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:
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:
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
- 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.
- Überprüfen Sie die Wartungsstufe des IBM MQ -Ressourcenadapters.
- Ö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.
- Starten Sie das Tool 'wsadmin', indem Sie wsadmin.bat -lang jythoneingeben. Wenn Sie dazu aufgefordert werden, geben Sie Ihren Benutzernamen und Ihr Kennwort ein.
- 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 .
- 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
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.