Getting Started

Note (Windows users): The broker currently does not support spaces in path names. For this reason the broker should be placed in a directory with no spaces in it's absolute path.

Note (Windows users): Examples below use the shell script `artemis` for use with linux, Windows users should use the `artemis.cmd` script with the same parameters.

Creating a broker

To create a broker, navigate to the distribution 'bin/' directory and run:

$ ./artemis create $directory

Where $directory is the folder that you'd like the broker to be created. The create process will input for any required property not specified. Example:

--user: is mandatory with this configuration:
Please provide the default username:
admin

--password: is mandatory with this configuration:
Please provide the default password:


--allow-anonymous: is mandatory with this configuration:
Allow anonymous access? (Y/N):
y

For a full list of availble options for the create process you may use: $ ./artemis help create

NAME
        artemis create - creates a new broker instance

SYNOPSIS
        artemis create [--allow-anonymous]
                [--cluster-password ] [--cluster-user ]
    [--clustered] [--data ] [--encoding ] [--force]
        [--home ] [--host ] [--java-options ]
            [--password ] [--port-offset ] [--replicated]
                [--role ] [--shared-store] [--silent-input] [--user ] [--]
                    
     ...

Starting the Broker

Once the broker has been created, use the artemis (or artemis.cmd on windows) script of the under the bin directory of the newly created broker to manage the life cycle of the broker. To run the Apache ActiveMQ Artemis broker with the default configuration, run the command shown below from the "bin" directory of the created broker.

$ ./artemis run

To specify a broker configuration file:

$ ./artemis run --config scheme:location

e.g.

$ ./artemis run --config xml:/home/artemis/bootstrap.xml

The distribution ships with a number of example configurations that can be used to get started. You can find these under the "config" directory.

It is possible to configure run time paramters in the artemis.conf (artemis.conf.bat for windows) file under the "bin" directory of the broker directory.

Stopping the Broker

To stop the broker please use the artemis script from the broker's bin directory:

$ ./artemis stop

Documentation

The broker comes shipped with an in depth user manual and a bunch of examples to help you get started. The manual is accessible from the broker website. Start the broker then navigate to the Apache ActiveMQ Artemis.

The examples are shipped inside the distribution folder under "examples"

Release Notes - ActiveMQ Artemis 1.0.0

The ActiveMQ Artemis 1.0.0 release notes can be found in the Apache ActiveMQ Artemis project JIRA.