ThingLogix Foundry Set Up Instructions

These instructions cover the setup of ThingLogix Foundry in your AWS Account. To set up a Foundry subscription, please visit the AWS Marketplace.

STEP 1: Installation

Download the ThingLogix Foundry Cloud Formation Template

ThingLogix Foundry is deployed as resources into your AWS Account. To accomplish this, you will need to upload and install the ThingLogix Foundry CloudFormation Template. You should have received this template file when your account was created through the marketplace. If you did not receive the file or are having trouble locating it, please contact support at support@thinglogix.com.

Follow the steps below to deploy the Foundry Resource Stack in your AWS Account.

Select Template
  1. Login to your AWS Account and open the CloudFormation Service Console.
  2. Download the ThingLogix Foundry CloudFormation Template. For more information on Amazon’s Cloud Formation service, click here.
  3. Choose to “Create a New Stack”
  4. Select and Upload the Cloud Formation Template
  5. Click “Next”

Specify Details

  1. Stack Name = ThingLogixFoundry
  2. Allow Unauthenticated Identities = False
  3. Developer Provider Name = com.thinglogix
  4. Identity Pool Name = foundry
  5. Read Capacity Units = 5
  6. S3 Bucket Name = foundrystack (you will need to create this bucket in S3)
  7. Write Capacity Units = 5
  8. Click “Next”

Options

Nothing is required in this section. Fill in any desired values and click “Next”

Review

  1. Confirm the details of the stack
  2. Check the Acknowledge box
  3. Click “Create”

Once CloudFormation completes the creation of the Foundry stack, you will be able to login to your version of Foundry at https://foundry.thinglogix.com.

STEP 2: Tying Foundry To Your AWS Account

 

Once CloudFormation completes, the Foundry resources are deployed and configured in your AWS account. The next step is to give Foundry the permission to utilize those resources. Follow these steps to grant Foundry access through Cognito.

  1. In a new browser tab, login to https://login.thinglogix.com using the account you just created through the AWS MarketPlace sign up and activated via email.
  2. Navigate to the Credentials page in Foundry and click “Add Credentials”
  3. Click on the Outputs tab of AWS CloudFormation. You will see a RootURL, CognitoDeveloperProviderName, and CognitoIdentityPoolId.
  4. Copy each of these values into the corresponding fields on the Foundry Credentials Page. The RootURL value should be pasted into the “API Gateway Endpoint” field.
  5. In Foundry, set the newly created credentials to “Default”.

AWS Supported Regions

ThingLogix Foundry is currently supported in the following regions:

  • us-east-1
  • us-west-2
  • eu-west-1

Note: Region must be the same as the Cognito Identity Pool and API Gateway Endpoint.