Install Turbot Guardrails Enterprise (TE)

In this guide, you will:

  • Use AWS Service Catalog to install Turbot Guardrails Enterprise (TE).
  • Monitor and troubleshoot the installation process.

Turbot Guardrails Enterprise (TE) is an AWS Service Catalog product that provides automated configuration and management of the infrastructure needed to run the enterprise version of Turbot Guardrails in your AWS account.

TE is application layer of a Turbot Guardrails Enterprise deployment. Relies on the Turbot Guardrails Enterprise Database (TED) and Turbot Guardrails Enterprise Foundation (TEF) products. TE deploys a new version of the Turbot software -- Every Turbot release requires a new TE version.

Prerequisites

  • Access to the Guardrails AWS account with Administrator Privileges.
  • Familiarity with AWS Console, Service Catalog, and CloudFormation services.

Step 1: Access AWS Console

Open the AWS Console and navigate to the Service Catalog service in the region to deploy TE.

AWS Console Home Page

Step 2: Navigate to Products

Select the Products section from the left navigation menu.

Product Selection

Select Turbot Guardrails Enterprise from the products list, select Launch Product.

Launch Product

Step 3: Find Version

Sort the Product versions section by Created time (descending) to see the latest available version.

Find Version

Step 4: Name Provisioned Product

Select the desired TE version under Product Versions., then name the provisioned product.

Note

When selecting a name for the provisioned product, it is common practice to start with “te” and include the version number (e.g., te-5-45-1).

Provisioned Product Naming

Step 5: Verify Parameters

The parameters for the TE product are derived from settings chosen earlier during the TEF install, so it is rare that any of the existing parameter values need to be modified. Unless directed to by Turbot support you may safely scroll to the bottom of the parameter list.

Parameters Verification

Step 6: Launch Product

Select Launch product.

Launch Product

Step 7: Monitor Installation

You have initiated the installation of the new TE version. This triggers an update of several nested CloudFormation stacks.

Select the TE Provisioned Product, click the Outputs tab, and use the CloudFormationStackARN Value link to navigate to CloudFormation and monitor the install progress.

Navigate to CloudFormation

The TE CloudFormation stack status should would be CREATE_IN_PROGRESS indicating the install process is in progress.

Install Progress

Step 8: Review

  • The TE CloudFormation stack status should change to CREATE_COMPLETE indicating the installation completed successfully.

CFN Create Complete

  • The TE Provisioned product status should change to Available.

Installation Complete Verification

Next Steps

Please see the following resources to learn more about Turbot Guardrails Enterprise:

Troubleshooting

IssueDescriptionGuide
Permission IssuesIf the current logged-in user lacks permission to modify, update, or create resources in the stack, or if IAM roles or SCPs have changed, preventing built-in roles from accessing needed configuration settings.Troubleshoot Permission Issues
Further AssistanceIf you continue to encounter issues, please open a ticket with us and attach the relevant information to assist you more efficiently.Open Support Ticket