Usage Instructions

Introduction

Apache ActiveMQ Artemis is an open-source project that provides a high-performance, multi-protocol, embeddable, and clustered asynchronous messaging system. It serves as an example of Message-Oriented Middleware (MoM), facilitating communication between distributed applications. Artemis is designed to handle large-scale messaging needs with low latency and high throughput, supporting multiple messaging protocols.

Apache ActiveMQ Artemis is distributed under the Apache License, Version 2.0, a permissive free software license that allows for wide usage, including commercial applications. This license is compatible with other open-source licenses and is designed to be business-friendly.

Getting started

  1. Launch the product via 1-Click
  2. Use a web browser to access the management console at http://[ec2-ip]:8161/console, where [ec2-ip] is the public ip provided by Amazon for your instance
  3. Log in using the following credentials:
    • Username: admin
    • Password: The instance_id of the EC2 instance

You can also access your EC2 instance via SSH using the username and your Amazon private key.

The username depends on the operative system:

  • Amazon Linux: 'ec2-user'
  • Ubuntu: 'ubuntu'
  • Rocky Linux: 'rocky'
  • AlmaLinux: 'ec2-user'
  • CentOS Stream: 'ec2-user'

Installation details

ActiveMQ Artemis server is installed in /opt/java/apache-artemis-[version] directory, which is linked to /opt/java/apache-artemis.

Server service is configured with systemd.

View status server:

[centos@ip-172-31-9-232 etc]$ sudo systemctl status artemis

Stop server:

[centos@ip-172-31-9-232 etc]$ sudo systemctl stop artemis

Start server:

[centos@ip-172-31-9-232 etc]$ sudo systemctl start artemis

Other useful data

Location of sensitive information

All the information is saved in the folder is /var/lib/[name-of-your-broker]

Encryption configuration

There is no encrypted data.

Changing system credentials

To change the ActiveMQ credentials you can follow the instructions in the following link:

Instructions on how the user interacts with ActiveMQ to decrypt necessary data

You can use the ActiveMQ management console to view all necessary data.

How to assess and monitor the health and proper function of the application.

  1. Navigate to your Amazon EC2 console and verify that you're in the correct region.
  2. Choose Instance and select your launched instance.
  3. Select the server to display your metadata page and choose the Status checks tab at the bottom of the page to review if your status checks passed or failed.

List of AMIs provisioned by Neodoo

Apache ActiveMQ Artemis
Ubuntu Linux 22.04 LTS ✔ View
Ubuntu Linux 24.04 LTS ✔ View
Amazon Linux 2023 ✔ View

Additional resources

Following resources will help you with your first steps using Apache ActiveMQ Artemis: