Page History

Prerequisites

Before being able to install and set up the Chariot MQTT Server you must have an Amazon Web Services (AWS) account. If you do not already have one you can create one here.

Summary

This process covers installing the Chariot MQTT Server into an AWS account as an EC2 instance. For reference, the Chariot MQTT Server Cloud Formation Template used to build the AWS infrastructure is here - chariot.yaml. Note this yaml file is here purely for reference to show exactly what is done during the cloud formation deployment. You do not need to manually deploy using the chariot.yaml file as this happens automatically when you deploy Chariot via the AWS Marketplace.

Chariot Installation on AWS via Marketplace

Before deploying Chariot you must create create an AWS EC2 key pair which will ultimately allow you to SSH into the EC2 instance that gets created as part of the process. Information on how to create the key pair can be found here. The key pair must be created in the AWS Region that you intend to deploy Chariot into.

...

This will begin the stack deployment. You can check on the progress by clicking both the Events and Resources tab as shown below. Deployment takes a few minutes to complete. When it completes, you should see something similar to what is shown below with all of the resources showing 'CREATE_COMPLETE' for the status.

<INSERT MARKETPLACE IMAGE>Image Added

Deployments can fail for multiple reasons, including AWS account resource limitations. By clicking the 'Events' page, you can see more information about what failed during deployment.

If this happens during deployment, note the 'Status reason' column on the right side of the events tab. Typically, the following steps are necessary to resolve the issue.

...

Information on accessing the EC2 instance via SSH can be found here. 

Chariot Configuration

For configuration details, please see: Chariot MQTT Server: Configuration

Reference Documentation

• Chariot MQTT Server Tutorials and How-Tos
• FAQ: Chariot MQTT Server