| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| <!-- |
| 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> |
| <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"> |
| <title>Getting Started</title> |
| |
| </head> |
| <body> |
| <h1>Getting Started<br> |
| </h1> |
| |
| <p> |
| Welcome to Apache ActiveMQ Classic. This document gives you a quick overview of how to get started trying out Apache ActiveMQ Classic. |
| </p> |
| |
| <h2>Running the broker</h2> |
| |
| <p> |
| From the binary distribution you can run the Apache ActiveMQ server via the bin/activemq command. |
| If you're using Windows, just type |
| </p> |
| <pre> |
| cd bin |
| activemq.bat start |
| </pre> |
| <p> |
| On Unix-like systems, type |
| </p> |
| <pre> |
| ./bin/activemq console |
| </pre> |
| <p>to start the broker in foreground.</p> |
| <p> |
| The Apache ActiveMQ broker should now have started |
| </p> |
| <p> |
| Tip: If you run the bin/activemq command without any arguments it will output usage. |
| </p> |
| |
| To stop the broker you can press ctrl + c to stop the process. |
| |
| <h2>Running the broker in the background</h2> |
| |
| <p> |
| The broker can be started as a background process via the bin/activemq command |
| on Unix-like systems, type |
| </p> |
| <pre> |
| ./bin/activemq start |
| </pre> |
| <p>to start the broker in background. The broker will write to its log in the data/activemq.log file.</p> |
| |
| <h2>Stopping the broker</h2> |
| |
| <p> |
| The broker can be stopped via the bin/activemq command |
| If you're using Windows, just type |
| </p> |
| <pre> |
| cd bin |
| activemq.bat stop |
| </pre> |
| <p> |
| On Unix-like systems, type |
| </p> |
| <pre> |
| ./bin/activemq stop |
| </pre> |
| <p>to stop the broker. |
| |
| |
| <h2>Access the web console</h2> |
| |
| In a web browser you can access the url <a href="http://0.0.0.0:8161/admin">http://0.0.0.0:8161/admin</a> to access the ActiveMQ web console. |
| <br/> |
| The broker may ask for credentials to login the web console the first time. |
| The default username and password is admin/admin. You can configure this in the conf/user.properties file. |
| |
| <h2>Access the web demos</h2> |
| |
| You would need to start the broker with the demos included, which you do as follows: |
| If you're using Windows, just type |
| </p> |
| <pre> |
| copy .\conf\jetty.xml .\examples\conf\ |
| cd bin |
| activemq.bat start xbean:../examples/conf/activemq-demo.xml |
| </pre> |
| <p> |
| On Unix-like systems, type |
| </p> |
| <pre> |
| cp ./conf/jetty.xml ./examples/conf/ |
| ./bin/activemq console xbean:examples/conf/activemq-demo.xml |
| </pre> |
| |
| In a web browser you can access the url <a href="http://0.0.0.0:8161/demo">http://0.0.0.0:8161/demo</a> to access the ActiveMQ web demos. |
| <br/> |
| The broker may ask for credentials to login the web console the first time. |
| The default username and password is admin/admin. You can configure this in the conf/user.properties file. |
| |
| |
| <h2>Example programs</h2> |
| |
| <p>Several runnable examples are in the examples directory, each with its own readme.md file containing instructions on how to run the example.</p> |
| <p>Configuration examples are located in example/conf directory.</p> |
| |
| <h2>Further Readings</h2> |
| |
| You can find more details about Apache ActiveMQ at its website <a href="http://activemq.apache.org">http://activemq.apache.org</a>, |
| as well the guide <a href="http://activemq.apache.org/version-5-getting-started.html">getting started</a> guide. |
| |
| </body> |
| </html> |
| |
| |