Konfigurieren des JMS Providers

Die JMS-Unterstützung für Apache ActiveMQ ist in FME Flow vorkonfiguriert. Es ist keine zusätzliche Konfiguration erforderlich. Für eine vollständige Referenz siehe JNDI-Unterstützung. (JMS nutzt das Java Naming und Directory Interface (JNDI), um benannte Objekte dynamisch aus dem Nachrichtenbroker abzurufen.)

Bei der Verwendung von Apache ActiveMQ mit JMS ist Folgendes zu beachten:

• FME Flow stellt über den in der XML-Konfigurationsdatei des Nachrichtenbrokers angegebenen Transport-Connector eine Verbindung zu ActiveMQ her. Standardmäßig ist die URL tcp://hostname:61616.

• FME Flow verbindet sich als JMS-Client über ein nach einer Verbindungsfactory benanntes Objekt mit ActiveMQ und referenziert ActiveMQ-Themen oder -Warteschlangen über ein Zielnamen-Objekt. Die benannten Objekte werden typischerweise über die JNDI-Konfigurationsdatei jndi.properties spezifiziert. Für weitere Informationen, siehe JNDI-Unterstützung.

• In der einfachsten Konfiguration ist die Datei jndi.properties nicht erforderlich. Standardmäßig ist der Name der Connection Factory auch ConnectionFactory. ActiveMQ bietet auch Möglichkeiten zur dynamischen Verbindung zu Warteschlangen und Themen über die speziellen Zielnamen dynamicQueues/<queue> und dynamicTopics/<topic>.

Für IBM WebSphere 7 muss ein Satz von JMS Administered Objects erstellt werden, um eine Verbindung mit JMS herzustellen. Der einfachste Weg hierfür ist die Verwendung von MQ Explorer.

1. Installieren und starten Sie MQ Explorer auf dem Computer mit der Installation von FME Flow.
2. Fügen Sie eine Verbindung zum gewünschten Warteschlangenmanager hinzu.

1. Klicken Sie in der Navigation auf der linken Seite mit der rechten Maustaste auf "Queue Managers" und wählen Sie "Add Remote Queue Manager".
2. Geben Sie im Assistenten folgende Parameter an:

Name des Warteschlangenmanagers	qm (beispielsweise)
Verbindungsmethode	Direkte Verbindung
Hostname oder IP-Adresse	server (beispielsweise)
Port-Nummer	1414
Serververbindungskanal	SYSTEM.ADMIN.SVRCONN (beispielsweise)

3. Stellen Sie sicher, dass sowohl der angegebene Server-Verbindungskanal (voreingestellt: SYSTEM.ADMIN.SVRCONN) und ein Listener für den angegebenen TCP-Port (voreingestellt: LISTENER.TCP) beide aktiviert sind.
4. Klicken Sie auf "Finish", um den Assistenten zu verlassen. Eine neue Verbindung zu einem entfernten Warteschlangenmanager sollte erscheinen.

3. Erstellen Sie einen JMS-Anfangskontext.

1. Klicken Sie in der Navigation auf der linken Seite mit der rechten Maustaste auf "JMS Administered Objects" und wählen Sie "Initial Context hinzufügen".
2. Geben Sie im Assistenten folgende Parameter an:

Speicherort des JNDI-Namensraums	Dateisystem
Verzeichnis	c:\jndi (beispielsweise)
Provider-URL	file:/C:/jndi/ (beispielsweise)

3. Wählen Sie "Finish", um den Assistenten abzuschließen. Ein neuer Anfangskontext sollte erscheinen.

4. Erstellen Sie eine JMS Connection Factory.

1. Klicken Sie unter dem neu erstellten Anfangskontext mit der rechten Maustaste auf "Connection Factories" und wählen Sie "New / Connection Factory".
2. Geben Sie im Assistenten folgende Parameter an:

Name	cf1 (beispielsweise)
Nacrichten-Provider	WebSphere MQ
Typ	ConnectionFactory
Transport	MQ Client
Verbindung/Basis-Warteschlangenmanager	qm (beispielsweise)
Verbindung​​/Verbindung-Liste	server (1414) (beispielsweise)
Kanal/Kanal	c1 (beispielsweise)

3. Stellen Sie sicher, dass der Warteschlangenmanager und die Verbindungsparameter mit denen des oben angegebenen Warteschlangenmanagers übereinstimmen.
4. Klicken Sie auf "Finish", um den Assistenten zu verlassen. Die neue Connection Factory erscheint.

5. Erstellen Sie ein JMS-Ziel für jede gewünschte Warteschlange oder für ein Thema.

1. Wählen Sie "Queues" oder "Topics" unter dem Warteschlangenmanager aus, um die aktuelle Liste der Warteschlangen oder Themen aufzurufen.
2. Klicken Sie mit der rechten Maustaste auf die gewünschte Warteschlange oder das gewünschte Thema und wählen Sie "Create JMS Queue" or "Create JMS Topic".
3. Geben Sie im Assistenten das JMS-Objekt mit einem Namen an (Beispiel: q1oder t1).
4. Klicken Sie auf "Finish", um den Assistenten zu verlassen. Das neue Ziel wird unter Ziele für den initialen JMS-Kontext angezeigt.

6. Nehmen Sie nach Bedarf Sicherheitskonfigurationen mit Hilfe des Tools setmqaut vor. Um beispielsweise den Zugriff auf einen Warteschlangenmanager zu aktivieren, führen Sie den folgenden Befehl aus:

setmqaut -m qm -t qmgr -g Users +inq +connect

Um einer bestimmten Benutzergruppe "Users" den Zugriff auf eine Warteschlange oder ein Thema zu ermöglichen, führen Sie den folgenden Befehl aus:

setmqaut -m qm -t queue -n q1 -g Users +get +inq +browse

setmqaut -m qm -t topic -n t1 -g Users +sub

Um dem Produzenten Zugriff auf eine Warteschlange oder auf ein Thema einer bestimmten Benutzergruppe "Users" zu ermöglichen, führen Sie den folgenden Befehl aus:

setmqaut -m qm -t queue -n q1 -g Users +put

setmqaut -m qm -t topic -n q1 -g Users +pub

1. Erstellen Sie eine JMS-Warteschlange im Weblogic Server mit Hilfe des Beispiels unter https://blogs.oracle.com/soaproactive/entry/how_to_create_a_simple.
2. Suchen Sie in Ihrer Weblogic-Installation die Datei wlthint3client.jar und kopieren Sie sie in den Ordner <FMEFlowDir>/Server/lib/jms/.