Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Before being able to install and set up Sparkplug SiteWise IoT Bridge you must have an Amazon Web Services (AWS) account. If you do not already have one you can create one here.

...

This process covers installing the Sparkplug SiteWise Bridge AMI into an AWS account as an EC2 instance. For reference, the Sparkplug SiteWise Bridge Cloud Formation Template used to build the AWS infrastructure is here - ssb.yaml. Note this yaml file does not need to be used for anything. It is here purely for reference to show exactly what is done during the cloud formation deployment.

...

IoT Bridge Installation

Before deploying Sparkplug SiteWise IoT Bridge 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 Sparkplug SiteWise IoT Bridge into.

Sparkplug SiteWise IoT Bridge is installed using the AWS Marketplace 1-click procedure. Begin by browsing to this site: https://aws.amazon.com/marketplace. Log in using your AWS account credentials. After doing so, you will see something similar to what is shown below.

...

In the search bar, type in 'Sparkplug IoT Bridge for SiteWise Bridge' and hit enter. This should show the following.

Then click on Sparkplug SiteWise IoT Bridge by Cirrus Link. After doing so, you should see the following.

...

In the 'Delivery Method' field, select 'CloudFormation Template' as shown below. This will set up the defaults including the 'Cirrus Link Sparkplug SiteWise IoT Bridge Template' field, the version, and the region. Select your preference for the region as shown below.

...

Finally, click the 'Launch' button shown in the screenshot above. This will bring up the CloudFormation stack creation page shown below. Note the template associated with the Sparkplug SiteWise IoT Bridge is automatically populated for you. This is also shown below.

...

Double check the configuration and finally click 'Create ttack' in the bottom right corner of the screen. Note you also must accept the IAM changes that the Sparkplug SiteWise IoT Bridge Cloud Formation deployment makes to your AWS account. If you agree to this, click the checkbox shown below and then click the 'Create stack' button.

...

After the AWS Infrastructure has been deployed via the AWS Marketplace 1-click procedure, the application must be configured. In order to configure the application you must be able to access the EC2 instance via SSH. Information on accessing the EC2 instance via SSH can be found here. Additional details on the filesystem layout of this EC2 instance can be found here.

...

IoT Bridge Configuration

For configuration details, please see: https://docs.chariot.io/display/CLD80/SSB%3AIB%3A+Configuration

Reference Documentation

The Sparkplug SiteWise IoT Bridge Quickstart Guide covers end to end setup of Sparkplug SiteWise IoT Bridge including Edge setup, SSB IB setup, and seeing data in AWS SiteWise.

The Sparkplug SiteWise IoT Bridge Configuration Reference covers configuration options for the Sparkplug SiteWise IoT Bridge EC2 instance.