Contents
Cirrus Link Resources
Cirrus Link Website
Contact Us (Sales/Support)
Forum
Cirrus Link Modules Docs for Ignition 7.9.x
Inductive Resources
Ignition User Manual
Knowledge Base Articles
Inductive University
Forum
Page History
IoT Bridge for Snowflake is not quite ready but will be released in early Q2 of 2023.
Prerequisites
Before being able to install and set up 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 IoT Bridge for Snowflake AMI into an AWS account as an EC2 instance. For reference, the IoT Bridge for Snowflake Cloud Formation Template used to build the AWS infrastructure is here - ibasibsnow.yaml. Note this yaml file does not need to be used for anything (and cannot because the AMI references don't exist). It is here purely for reference to show exactly what is done during the cloud formation deployment.
...
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.
<TODO>Add Image</TODO>
In the search bar, type in 'IoT Bridge for SiteWiseSnowflake' and hit enter. This should show the following.
Then click on IoT Bridge by Cirrus Link. After doing so, you should see the following.
Click the yellow 'Continue to Subscribe' button near the top of the screen. This will bring up the following page:
Now click the orange 'Accept Terms' button if you agree to the terms. This will bring up the following screen.
It will take some time and within a few minutes the effective date and expiration date should get set. Once this is done, click the orange Now click the blue 'Continue to Configuration' button near in the top upper right section of the screen. Note by doing so you are agreeing to the EULA and associated terms. This will bring up you to the following screen.
In the 'Delivery MethodFulfillment option' field, select 'CloudFormation Template' as shown below. This will set up the defaults including the 'Cirrus Link IoT Bridge for AWS Snowflake Template' field, the version, and the region. Select your preference for the region also as shown below. Note your region should usually match the region Snowflake runs in.
Now click the blue orange 'Continue to Launch' button in the upper right corner. This will bring up the following screen.
Finally, click the orange 'Launch' button shown in the screenshot above. This will bring up the CloudFormation stack creation page shown below. Note the template associated with the IoT Bridge is automatically populated for you. This is also shown below.
Click 'Next' in the lower right in the screen capture above. This will bring up the stack configuration page shown below.
Set the following properties for the stack:
...
After setting the properties, click the 'Next' button in the lower right of the Window. This will bring up the following screen.
Configure anything else that may be required here. Generally, nothing must be set here given that the user you are logged in as has the permissions to create everything that will created as part of the Cloud Formation deployment. Also, the 'Roll back all stack resources' should be selected in case there is a failure in deployment. This will ensure no resources get created and left in place should the any portion of the stack creation fail. After setting any additional configuration here, click the 'Next' button in the lower right corner. This will bring up the review screen as shown below.
Double check the configuration and finally click 'Create stackSubmit' in the bottom right corner of the screen . Note you also must accept the IAM changes that the 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.to kick off the stack creation. You should now see the 'CREATE_IN_PROGRESS' status as shown below.
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.
Deployments Note deployments can fail for multiple reasons included , including AWS account resource limitations. Below is an example of a failed deployment's resources page. Note the 'DELETE_COMPLETE' state for a subset of all of the resources that should've been created.
By clicking the 'Events' page we , you can see more information about what failed as shown below.
during deployment.
If this happens during deployment, note Note the 'Status reason' column on the right . This deployment failed because the AWS account under which it was deployed has reached its limit of Internet Gateways. To resolve the issue for this case, follow these steps:side of the events tab. Typically the following steps are necessary to resolve the issue.
- Delete the stack using the 'Delete' button at the top of the stack's page
- Resolve the limit issue - either free up an Internet Gateway or request additional resources issue resulting in the failure. Often these are AWS account resource limits. If so, request an AWS resource limit increase via an AWS support ticket.
- Repeat this procedure to deploy the stack.
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 file system layout of this EC2 instance can be found here.
IoT Bridge Configuration
For configuration details, please see: Iot Bridge for AWS SiteWise Snowflake - Configuration
Reference Documentation
The IoT Bridge Quickstart Guide covers end to end setup of IoT Bridge including Edge setup, IB setup, and seeing data in AWS SiteWiseSnowflake.
The IoT Bridge Configuration Reference covers configuration options for the IoT Bridge EC2 instance.
Overview
Content Tools