activemq-artemis/examples/jms/proton-ruby
Martyn Taylor 2b4e7babb6 Prepare examples,tests for release 2015-03-06 15:28:08 +00:00
..
src/main add flag to broker plugin to skip starting. 2015-03-04 11:48:46 +00:00
pom.xml Prepare examples,tests for release 2015-03-06 15:28:08 +00:00
readme.html documentation updates 2015-02-23 09:50:08 +00:00

readme.html

<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements.  See the NOTICE file
distributed with this work for additional information
regarding copyright ownership.  The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License.  You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied.  See the License for the
specific language governing permissions and limitations
under the License.
-->

<html>
  <head>
    <title>ActiveMQ Proton Ruby Example</title>
    <link rel="stylesheet" type="text/css" href="../common/common.css" />
    <link rel="stylesheet" type="text/css" href="../common/prettify.css" />
    <script type="text/javascript" src="../common/prettify.js"></script>
  </head>
  <body onload="prettyPrint()">
     <h1>Proton Ruby Example</h1>

     <p>ActiveMQ can be configured to accept requests from any AMQP client that supports the 1.0 version of the protocol.
     This example shows a simply proton ruby client that sends and receives messages</p>
     <p>To run the example you will need the following packages installed, alsa-lib.i686 libXv.i686 libXScrnSaver.i686 qt.i686 qt-x11.i686 qtwebkit-2.2.2-2.fc18.i686, gcc, ruby</p>
     <p>On fedora you can install these via the <literal>yum install alsa-lib.i686 libXv.i686 libXScrnSaver.i686 qt.i686 qt-x11.i686 qtwebkit-2.2.2-2.fc18.i686, gcc, ruby</literal>
     command</p>
     <p>you will also need the qpid-proton libraries installed, again <literal>yum install qpid-proton</literal></p>
     <p>lastly you wull have to create the gems <literal>gem install qpid_proton</literal></p>

     <p>To configure ActiveMQ to accept AMQP client connections you need to add an Acceptor like so:</p>
     <pre class="prettyprint">
     <code>
     &lt;acceptor name="proton-acceptor"&gt;tcp://localhost:5672?protocols=AMQP&lt;/acceptor&gt;
     </code>
     </pre>
     <h2>Example step-by-step</h2>
     <p>Firstly start the server by running the command <literal>mvn verify</literal></p>
     <p>Then in a separate window you can run the send ruby script by running the command <literal>ruby src/main/scripts/send.rb</literal></p>
     <p>You can then receive the message via the receive ruby script by running <literal>ruby src/main/scripts/receive.rb</literal></p>

  </body>
</html>