| At line 5 changed one line |
| __⚠️ Important__: Dependency jar files must be downloaded (unzip) and placed in your __CrushFTP Install Folder/plugins/ lib__. ⚠️ Restart is required to load the new JMS-related dependency jars. [ Download Link|jms_dependency.zip]\\ |
| __⚠️ Important__:\\ |
| • Dependency jar files must be downloaded (unzip) and placed in your __CrushFTP Install Folder/plugins/ lib__. ⚠️ Restart is required to load the new JMS-related dependency jars. [ Download Link|jms_dependency.zip]\\ |
| • CrushFTP’s JMSTask supports JMS providers that use the __AMQP 1.0__ protocol.\\ |
| At line 9 changed one line |
| !!1. Solace JMS AMQPS Integration\\ |
| !!1. Solace JMS Integration\\ |
| At line 13 changed one line |
| Get the __AMQPS URL__, __Username__, and __Password__ for JMSTask's __JNDI configuration__ from the __Solace Broker Management__.\\ |
| Get the __AMQPS URL__, __username__, and __password__ from your Solace broker for use in the JMSTask JNDI configuration.\\ |
| At line 17 changed one line |
| !!3. AMQPS with Apache Artemis\\ |
| !!2. Apache ActiveMQ Artemis and Amazon MQ Integration \\ |
| At line 19 changed one line |
| __⚠️ Important__: To connect JMSTask to __Apache Artemis (formerly ActiveMQ Artemis)__ over __AMQPS__, ensure your Artemis broker is configured to accept secure __AMQP__ connections.\\ |
| !2.1 Apache ActiveMQ Artemis\\ |
| \\ |
| More info: [ActiveMQ Artemis Documentation Link|https://activemq.apache.org/components/artemis/documentation/]\\ |
| __⚠️ Important__: To connect JMSTask to __Apache ActiveMQ Artemis__ over __AMQPS__, ensure your Artemis broker is configured to accept secure __AMQP__ connections.\\ |
| \\ |
| [JMS (Java Message Service)/apache_artemis.png]\\ |
| \\__JNDI connection related settings example:__\\ |
| At line 21 changed one line |
| !!2. JMSTask configuration:\\ |
| __a.)__\\ |
| {{{ |
| # Secured AMQP Host |
| connectionfactory.qpidConnectionfactory=amqps://192.168.0.10:5671?transport.trustAll=true&transport.verifyHost=false |
| }}}\\ |
| \\ |
| • __transport.trustAll=true__ -> Accepts all SSL certificates.\\ |
| • __transport.verifyHost=false__ -> Disables hostname verification in the TLS handshake.\\ |
| ---- |
| __b.)__\\ |
| \\ |
| {{{ |
| # Secured AMQP Host |
| connectionfactory.qpidConnectionfactory=amqps://my.artemis.com:5671 |
| }}}\\ |
| ---- |
| !2.2 Amazon MQ\\ |
| \\ |
| CrushFTP also supports integration with __Amazon MQ__, a managed message broker service compatible with ActiveMQ and Artemis. [Amazon MQ (official site) Link|https://aws.amazon.com/amazon-mq/] More info: [Amazon MQ – Managed Message Broker Service for ActiveMQ Link| https://aws.amazon.com/blogs/aws/amazon-mq-managed-message-broker-service-for-activemq/]\\ |
| \\ |
| Sign in to __AWS Console__ and Navigate to __Amazon MQ__ Select your Broker. Click on the name of your ActiveMQ or Artemis broker. Scroll down to the __Connections__ section.\\ |
| \\ |
| [JMS (Java Message Service)/amazon_amqps_url.png]\\ |
| {{{ |
| amqps://<broker-id>.mq.<region>.amazonaws.com:5671 |
| }}} |
| ---- |
| !!3 Azure Service Bus Integration:\\ |
| \\ |
| [Azure Service Bus Link|https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-overview]\\ |
| [AMQP 1.0 in Azure Service Bus and Event Hubs protocol guide Link|https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-overview]\\ |
| [JMS (Java Message Service)/azure_service_bus.png]\\ |
| \\ |
| To get __AMQPS URL__:\\ |
| __a.)__ Open your __Service Bus namespace__ in the __Azure Portal__\\ |
| __b.)__ Go to Settings → Shared access policies\\ |
| __c.)__ Select a policy (e.g., RootManageSharedAccessKey)\\ |
| __d.)__ Copy the namespace name (e.g., your-namespace.servicebus.windows.net)\\ |
| __e.)__ Combine as amqps://your-namespace.servicebus.windows.net:5671\\ |
| \\ |
| [JMS (Java Message Service)/azure_amqps_shared_access_key.png]\\ |
| \\ |
| {{{ |
| amqps://<namespace>.servicebus.windows.net:5671 |
| username = <SAS-key-name> |
| password = <SAS-key> |
| }}}\\ |
| \\ |
| ---- |
| !!4. JMSTask configuration:\\ |
| At line 23 changed one line |
| !2.1 JNDI config: Variable replacement is supported.\\ |
| !4.1 JNDI config: Variable replacement is supported.\\ |
| At line 46 changed one line |
| __connectionfactory.qpidConnectionfactory=amqps://mr-connection-XXXXd:56XX__: This is the secure address of the messaging server (uses AMQPS, which is encrypted). It tells the application where to connect to send and receive messages.\\ |
| \\ |
| __connectionfactory.qpidConnectionfactory=amqps://mr-connection-XXXXd:56XX__ or\\ |
| __connectionfactory.qpidConnectionfactory=amqps://mr-connection-XXXXd:56XX?transport.trustAll=true&transport.verifyHost=false__\\ |
| This is the secure address of the messaging server (uses AMQPS, which is encrypted). It tells the application where to connect to send and receive messages.\\ |
| \\ |
| __⚠️ Important__: JMSTask uses __sasl.enabled.mechanisms=PLAIN__ by default.\\ |
| At line 110 added one line |
| \\ |
| At line 51 changed one line |
| !2.2 Producer Mode:\\ |
| !4.2 Producer Mode:\\ |
| At line 69 changed one line |
| !2.3 Consumer Mode:\\ |
| !4.3 Consumer Mode:\\ |