AWS Marketplace

{{toc}}

# Usage Instructions

## Getting started

1. Launch the product via 1-Click

2. Use a web browser to access the **Administration** console at: http://[ec2-ip]:8161/admin, where [ec2_ip] is the public ip provided by Amazon for your instance.

3. Log in using the following credentials:

   * Username: admin or user

   * Password: the instance_id of the instance

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

The **username** depends on the operative system:

* Centos 9 Stream: 'ec2-user'

* Other Centos: 'centos'

* Ubuntu: 'ubuntu'

* Rocky Linux: 'rocky'

## Installation details

To change the default username and password, edit the $ACTIVEMQ_HOME/conf/jetty-realm.properties file.

ActiveMQ server is installed in /usr/java/apache-activemq-[version] directory, which is linked to /usr/java/apache-activemq.

Server service is configured with systemd.

View status server:

``` shell

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

```

Stop server:

``` shell

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

```

Start server:

``` shell

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

```

## Other useful data

**Location of sensitive information**

All the information is saved in the folder is /var/lib/<Your broker instance>

**Encryption configuration**

There is no encrypted data.

**Changing system credentials**

To change the ActiveMQ credentials you have to modify the file "/usr/java/activemq/conf/jetty.xml" 

For more information: https://activemq.apache.org/web-console

**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.

## Additional resources

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

* https://activemq.apache.org/getting-started