Deploying a new studio with StudioBuilder
This tutorial is for admin users. It guides you through the process of deploying Amazon Nimble Studio in your AWS account using the StudioBuilder app. In this step-by-step tutorial, you’ll learn how to configure your studio, including choosing your studio name, setting up AWS Directory Service for Microsoft Active Directory (AWS Managed Microsoft AD), creating shared storage, and selecting options for your render farm.
Contents
- Prerequisites
- Step 1: Enable AWS Single Sign-On (AWS SSO)
- Step 2: Access the StudioBuilder AMIs
- Step 3: Launch the StudioBuilder EC2 instance
- Step 4: Configure studio with StudioBuilder
- Step 5: Deploy studio with StudioBuilder
- Step 6: Link AWS Managed Microsoft AD as an AWS SSO identity source
- Step 7: Confirm subscription to burst alert emails
- Troubleshooting
- Related resources
Estimated time: 2 hours
Prerequisites
-
Before you begin this tutorial, follow the steps for Creating your first IAM admin user and user group.
-
We recommend that you check your quotas as described in the Setting up tutorial before you begin deployment. Quota increase requests can take up to 48 hours to be fulfilled.
Step 1: Enable AWS Single Sign-On (AWS SSO)
This first step will enable AWS Single Sign-On (AWS SSO) for your account. With AWS SSO, you can manage user permissions and access to your accounts and applications in one place. To enable AWS SSO, go to the Nimble Studio service page and follow the first step to set up your studio. After you enable AWS SSO, you’re ready to deploy your studio with StudioBuilder.
To deploy your studio and enable AWS SSO
-
Sign in to the AWS Management Console and open the Nimble Studio
console. -
In the AWS Region selector (top-right navigation bar), make sure that the Region for your studio is selected.
-
Choose Set up your cloud studio.
-
Select CNR: I have no existing resources, then choose Next.
-
While it's possible to use existing resources that you have, such as storage or a license service, this tutorial assumes that you're starting with no resources.
-
-
Choose Enable AWS SSO.
-
If you see a green confirmation that AWS SSO has already been enabled, skip to Step 2: Access the StudioBuilder AMIs.
-
-
In the Enable AWS SSO pop-up, choose Create AWS organization.
-
A success message confirms that AWS SSO has been enabled.
-
Step 2: Access the StudioBuilder AMIs
To run StudioBuilder and deploy your studio, you must launch an Amazon Elastic Compute Cloud (Amazon EC2) instance using the StudioBuilder Amazon Machine Image (AMI). This has all of the packages that you need for to deploy your studio.
The following steps show how to add the Linux, Windows, and StudioBuilder AMIs to your account. These steps are necessary before you can launch an instance with the StudioBuilder AMI.
To navigate to the StudioBuilder AMIs in the AWS Marketplace
-
Choose Access StudioBuilder AMIs.
-
The Access StudioBuilder AMIs window will open.
-
-
Choose Subscribe to Deadline Linux Farm AMI in Marketplace.
-
The Nimble Studio Deadline Linux farm worker page will open in the AWS Marketplace.
-
-
Choose Continue to Subscribe.
-
Read the terms and conditions and then choose Accept Terms.
-
Return to the Access StudioBuilder AMIs window and choose Subscribe to Deadline Windows Farm AMI in Marketplace.
-
Repeat the previous steps to accept the terms and conditions.
-
Return to the Access StudioBuilder AMIs window again and choose Subscribe to StudioBuilder AMI in Marketplace.
-
Repeat the same steps to accept the terms and conditions.
-
After the subscribe request has finished processing, choose Continue to Configuration.
-
In the Region dropdown menu, select the AWS Region that you want to deploy your studio to and choose Continue to Launch.
-
In the Choose Action dropdown menu, select Launch through EC2, and choose Launch.
-
The Amazon EC2 console will open to guide you through the rest of the launch process.
-
Since you have already chosen an AMI, the EC2 console will automatically skip Step 1: Choose an Amazon Machine Image (AMI) and proceed directly to Step 2: Choose an Instance Type.
-
Step 3: Launch the StudioBuilder EC2 instance
To start launching the StudioBuilder EC2 instance
-
For Name and tags, give the instance a name so that you can easily find it later, such as to
NimbleStudioBuilder
. -
For Instance Type, select t3.medium from the list.
-
For Key pair (login) choose Proceed without a key pair from the first dropdown.
-
A key pair, consisting of a private key and a public key, is a set of security credentials that you use to prove your identity when connecting to an instance. You will use EC2 Instance Connect so you don’t need a key pair.
-
-
On Network Settings, choose Edit.
-
Set Auto-assign Public IP to Enable to ensure that your instance receives a public IP address that you will use when connecting to it later.
-
In Advanced details, specify an an AWS Identity and Access Management (IAM) role.
-
The IAM role enables administrator access from your StudioBuilder instance.
-
If you have connected to StudioBuilder before, choose the StudioBuilder_Instance_Admin_Role role that you created previously and continue to Step 5.
-
If you haven't connected to StudioBuilder before, choose Create new IAM role to open a new tab with the Create role page in IAM.
-
Choose Create role.
-
Select AWS service.
-
Choose EC2.
-
Choose Next: Permissions.
-
Select AdministratorAccess.
-
Choose Next: Tags.
-
Choose Next: Review.
-
Enter the Role name. Example: StudioBuilder_Instance_Admin_Role.
-
Enter a Role description. Example: Gives administrative access to the StudioBuilder instance.
-
Choose Create role.
-
Close the tab and switch back to the Launch instance wizard tab.
-
-
To update the list of available IAM roles, choose the Refresh button next to Create new IAM role.
-
Select the new role you created from the list.
-
-
Choose Launch.
-
On the Launch Status page, choose View Instances at the bottom of the page.
-
Change the name of the instance so that you can easily find it later.
-
In the list of instances, under the Name column, hover over the empty name field for the instance.
-
Choose the edit icon that appears.
-
Change the name to
NimbleStudioBuilder
. -
Choose Save.
-
-
After the instance state of your instance changes from Initializing to Running, select it and choose Connect.
Step 4: Configure studio with StudioBuilder
Next, you’ll connect to your instance to run StudioBuilder. StudioBuilder helps you deploy a studio by asking a series of questions about how you want to configure your studio. Throughout the process, StudioBuilder builds your studio based on your answers.
Connect to the instance with EC2 Instance Connect
-
On the Connect to instance page, make sure EC2 Instance Connect is selected.
-
Change the user name to ec2-user. If you leave the user name as
root
, StudioBuilder might not run correctly. -
Choose Connect.
-
A connection to your instance is established.
-
A new window opens to the StudioBuilder Command Line Interface (CLI) so you can configure your studio.
-
If at any time during the configuration process you need to reconnect to your instance, follow the previous steps to reconnect with EC2 Instance Connect to continue where you left off.
-
-
Configure your studio
During deployment or deletion, Amazon Nimble Studio might collect generic user metrics, called telemetry, to inform us about StudioBuilder errors and configuration preferences. These metrics are for diagnosis purposes only, and aren't shared or transferred.
If StudioBuilder doesn’t automatically run, see the Troubleshooting section of this tutorial for instructions on how to run StudioBuilder manually.
StudioBuilder will run and ask you the following questions about how to configure your studio.
-
Welcome to StudioBuilder! What would you like to do?
-
Using the arrow keys, choose
Create a studio with StudioBuilder
and press the enter (or return) key.
-
-
Please confirm that you wish to deploy your studio to Region <current-region>.
-
In the line that precedes the question, check that the Region you want is listed, then choose
Deploy my studio in this Region
and press the enter (or return) key.
-
Set up studio
-
Enter a name for your studio.
-
Enter a name for your studio and press the enter (or return) key.
-
Your studio name must be between 3-64 characters and only include lowercase letters from a-z and numbers from 0-9.
-
-
Enter your studio name as you would like it displayed.
-
Enter the display name for your studio and press the enter (or return) entered previously. You can enter a more descriptive name here, using whatever characters you like.
-
Configure VPC settings
-
Specify a CIDR block for the virtual private cloud (VPC) resource, or leave at 10.0.0.0. Then, press your enter (or return) key.
-
You can specify a particular CIDR block, or just leave this at the default of
10.0.0.0
and press the enter (or return) key.
-
-
Select an Availability Zone for your studio, then press Enter.
-
We recommend leaving this at the default of
Please choose for me (Recommended)
, then pressing the enter (or return) key.
-
-
Select a Local Zone for your studio, then press Enter.
-
You can only choose a Local Zone if your studio is hosted in the us-west-2 Region and if you have opted in to using Local Zones from the console. For instructions on how to opt in, see the Availability Zones for Amazon Nimble Studio tutorial.
-
-
What domain name would you like to associate your studio and studio resources with?
-
By default, the domain name contains your studio ID.
-
-
Would you like to deploy VPC endpoints to privately connect to supported AWS services?
-
Your studio uses VPC endpoints to privately connect to supported AWS services without using public IP addresses. This is safer than using a public internet connection because traffic between your VPC and other services doesn’t leave the Amazon network.
-
The default selection here is
Yes, I’d like to use VPC Interface Endpoints
.
-
Choose your AWS Directory Service name
The command line interface (CLI) will ask you to:
-
Create your Admin password for AD using 3–64 lower and uppercase letters, numbers, and symbols.
-
Specify a password and press the enter (or return) key.
-
Confirm the password and press the enter (or return) key.
Note If you ever forget this password, you can retrieve it from the StudioBuilder-SecretForAD secret in AWS Secrets Manager
.
-
AWS Directory Service - POSIX file system support
-
Would you like to specify a POSIX GID and UID?
-
Nimble Studio will configure AWS Managed Microsoft AD to operate on POSIX file systems, such as Linux. That allows your users to work on both Windows and Linux workstations.
-
-
If you plan to bring an existing file system, we recommend that you specify a uid and gid to prevent collisions with permissions on pre-existing files or folders.
-
However, if you don’t plan to bring an existing file system, we recommend choosing
Please choose for me (Recommended)
and pressing the enter (or return) key.
Deletion protection
-
Deletion protection prevents you from accidentally deleting your studio and farm, which could cause you to lose data. Within the CLI interface, do one of the following:
-
(Recommended) Choose Enable deletion protection.
-
Press the enter (or return) key to continue without enabling deletion protection.
-
Render fleets
Follow these steps when the CLI prompt says: If you don’t have a render farm
in your studio, you can create one now. Render farm costs can vary. For pricing
estimates, see https://aws.amazon.com/nimble-studio/pricing
.
-
Use the arrow keys to choose if you would like to create a render farm or not, and then press the enter (or return) key.
-
If you choose
Yes, I want to create a render farm for my studio
:-
You will see Render fleet questions, as shown in the following section of this tutorial.
-
Follow the prompts in the CLI for configuring your render farm.
-
-
-
If you choose
No, I don’t want to create a render farm at this time
-
Skip all render farm questions and prompts. Later, you can create a render farm by following the steps in the Update to latest StudioBuilder version tutorial.
-
UBL Licensing
-
Do you want to enable UBL support for your studio?
-
Use the arrow keys to choose if you would like to enable UBL support for your studio or not, and then press the enter (or return) key.
-
If you choose
Yes, I want to enable UBL support for my studio
, see the Setting up Deadline Usage Based Licensing with Nimble Studio tutorial for more information about integrating UBL with your Nimble Studio cloud studio.
-
Storage
Use the arrow keys to choose the option that you want, then press the enter (or return) key.
Default storage (FSx for Windows)
-
Are you planning to use Window workstations? If so, we will deploy a default FSx for Windows for Roaming Profiles.
-
If you choose
Yes, I want a file system for Roaming Profiles
, the command line interface (CLI) will ask you to:-
Select the Availability Zone that you want to create this file system in.
Note If you chose to deploy to the LA Local Zone, we recommend that you also deploy your storage to the LA Local Zone.
-
Enter your desired SSD storage capacity in GB. The suggested minimum is 1G/user. We recommend that you start with 40.
-
Enter your desired throughput capacity in MB/s. We recommend that you start with 32.
-
-
If you choose
No, I don’t want a file system for Roaming Profiles
, you will receive the next prompt.
-
CloudWatch Alarms
Amazon CloudWatch alarms are notifications that are triggered based on metrics that are monitored for the AWS services that your studio uses.
-
Enter an email address for CloudWatch Alarms to send warnings to when the given filesystem’s burst credits are below four different thresholds.
-
Enter the email address that you would like to use to receive these alarms, and press the enter (or return) key.
-
CloudWatch Alarms will email you when the Amazon EFS file system that’s storing the Deadline Repository depletes burst credits.
Important You must confirm your subscription to the CloudWatch Alarm emails in order to receive notification messages when your burst credits are low. Failure to take appropriate action based on these emails could result in your render farm losing the ability to function.
-
-
When your deploy is complete, follow the instructions in Step 7: Confirm subscription to burst alert emails.
-
For more information about Amazon CloudWatch alarms, see Using Amazon CloudWatch Alarms - Amazon CloudWatch.
-
For more information about Amazon Elastic File System (Amazon EFS) performance, see Amazon EFS performance.
-
-
Linux home directory
-
Are you planning to use Linux Workstations? We will deploy an EFS filesystem for persistent home directories.
-
If you choose
Yes, I want persistent user home directories for Linux workstations
, Nimble Studio will deploy an Amazon EFS file system for your studio. You will then be prompted to choose an Availability Zone for where you want to deploy the Amazon EFS file system.Note If you chose to deploy to the LA Local Zone, we suggest that you also deploy your storage to the LA Local Zone.
-
If you choose
No, I don’t want persistent user home directories for Linux workstations
, Nimble Studio won't deploy and Amazon EFS file system.
-
Additional storage
-
Do you want to add additional storage?
-
If you choose
No
, you will receive the next prompt. -
If you choose
Yes
, you will be askedWhich storage type do you want to use?
Use the arrow keys to choose a type of storage and then press enter (or return).-
If you choose
FSx for Windows
, the command line interface will ask you to:, the command line interface will ask you to:-
Select the Availability Zone that you want to create this file system in.
Note If you chose to deploy to the LA Local Zone, we suggest that you also deploy your storage to the LA Local Zone.
-
Enter an ID name for this storage. We recommend the name
FSxWindows1
. -
Add a description for your storage.
-
Enter your desired SSD storage capacity in GB. We recommend 200.
-
Enter your desired throughput capacity in MB/s. We recommend 32.
-
Enter a Windows Drive letter. We recommend D.
-
Enter the Linux mount path. The path can be any valid folder, except the system folder. For example: /usr/bin, /usr/lib, /usr/lib64 or /usr/sbin. We recommend
/mnt/fsxwindows1
-
-
If you choose
FSx for Lustre
, the command line interface will ask you to:-
Select the Availability Zone that you want to create this file system in.
Note If you chose to deploy to the LA Local Zone, we suggest that you also deploy your storage to the LA Local Zone.
-
Enter an ID name for this storage. We recommend the name FSxLustre1.
-
Add a description for your storage.
-
Enter your desired FSx storage capacity in GiB. The smallest valid value is 1,200. Other valid values begin at 2,400 GiB and increase in 2,400 increments. We recommend 1,200.
-
Choose the amount of read and write throughput for each 1 TiB of storage, in MB/s/TiB.
-
Enter the Linux mount path. The path can be any valid folder, except the system folder. For example: /usr/bin, /usr/lib, /usr/lib64 or /usr/sbin. We recommend
/mnt/fsxlustre1
-
-
If you choose
EFS
, the command line interface will ask you to:-
Select the Availability Zone that you want to create this file system in.
Note If you chose to deploy to the LA Local Zone, we suggest that you also deploy your storage to the LA Local Zone.
-
Enter an ID name for this storage. We recommend the name
EFS1
. -
Add a description for your storage.
-
Enter the Linux mount path. The path can be any valid folder, except the system folder. For example: /usr/bin, /usr/lib, /usr/lib64 or /usr/sbin. We recommend
/mnt/efs1
-
-
-
-
Do you want to add additional storage?
-
If you choose
Yes
, you run through the above prompts again. -
If you choose
No
, you will receive the next prompt.
-
Render fleet questions
-
Which type of fleet would you like?
-
Use the arrow keys to choose the type of fleet that you would like to use for your render farm workers and press the enter (or return) key.
-
Choosing
Spot Instance
will use Spot instances for your render fleet, whileOn-Demand Instance
will use On-Demand instances. With On-Demand instances, you pay for the time that you use them, and while in-use they won't be interrupted. Spot instances are unused On-Demand instances that are available for up to a 90% discount off the On-Demand price, but they might be interrupted if demand for On-Demand instances becomes too high. -
We recommend choosing
Spot Instance
because of their potential cost savings from using Spot instances. While Spot instances can be subject to occasional interruption, the individual frames of a render job make them well suited to being automatically required with little impact. In addition, Spot instances are automatically launched when needed and automatically terminated when they aren’t, resulting in the maximum cost savings for you. -
For more information about Spot and On-Demand instances, see Instance purchasing options.
-
-
Enter a unique identifier for this fleet. This ID will also be used for your AWS Thinkbox Deadline Group.
-
This is the name of the group that your artists will choose when rendering with this fleet. Example:
farm-default
. -
You can only use alphanumeric, upper and lowercase letters and the hyphen(-) in your fleet name.
Important Remember the identifier because you will need it later when configuring Deadline.
-
-
Which Operating System will this fleet use?
-
Use the arrow keys to choose either
Linux
orWindows
and press the enter (or return) key. This will be the operating system that is used for your render farm workers. -
We recommend choosing
Linux
because of the cost savings over Windows.Note Some digital content creation applications, such as Adobe Creative Cloud and Autodesk 3ds Max, won't run on Linux. Consider this when choosing an OS for your render farm workers.
-
-
Enter the AMI ID for this Render Worker fleet.
-
Select the Amazon Machine Image (AMI) to be used for your render workers. The AMI contains the software configuration that will be used for your workers.
-
For new studios, we recommend leaving this at the
default value
specified by StudioBuilder, but you can enter your own custom worker AMI, if you like.
-
-
Enter the EC2 instance type to use for the render workers.
-
Use the arrow keys to choose the instance type that you would like to use for your render worker fleet and press the enter (or return) key. To start, we recommend choosing the default value of
m5.4xlarge
, which should be sufficient for testing purposes. You can change the instance type later, depending on your particular render needs. -
If you choose Other, you will be prompted to Enter the exact instance type (or types separated by spaces) that you would like to use. This way, you can create a render fleet consisting of multiple instance types.
Note If you chose to create a fleet with On-Demand instances, your fleet will only be created with the first instance type that you list.
-
For more information about the differences in Spot Instance pricing and specifications, see Amazon EC2 Spot Instances Pricing
.
-
-
Enter the Max number of render workers to have running.
-
Choose the maximum number of render workers that you want to have running on your farm and press the enter (or return) key. You can change this value later if you want a different number.
Note Make sure that the maximum number of render workers that you specify doesn’t exceed your quota value. For details, see Check your Spot Instance quota.
-
-
Would you like to add another fleet?
-
If you would like to add another fleet at this time, you can. However, you can always add another fleet later, so we recommend pressing
N
here.
-
Review
-
Would you like to generate a studio configuration with your selections?
-
If you're happy with all of the selections that you have made in the preceding steps, enter
Y
and press the enter (or return) key to proceed. If not, pressN
to go back and make changes.
-
Ready to deploy your studio build
-
Type BUILD MY STUDIO and then press enter (or return) to continue, or type QUIT and then press enter (or return) to exit.
-
Enter
BUILD MY STUDIO
and press the enter (or return) key to continue. -
After pressing the enter (or return) key, StudioBuilder will run the deploy to build all of the components for your studio.
-
Step 5: Deploy studio with StudioBuilder
StudioBuilder will continue to run in the terminal window until all of the components for your studio are built. This process will take approximately one hour.
If you get disconnected from your StudioBuilder instance, or if the deploy fails, consult the Troubleshooting section at the end of this tutorial.
As the StudioBuilder app runs, you will see various outputs. At times, the output screen might go completely blank. This is normal. You can scroll up in the window to see the current progress of your deploy.

Monitoring using CloudFormation
In addition to watching the output in the EC2InstanceConnect window, you can also monitor the deployment in the AWS Management Console.
Sign in to the AWS Management Console and open the AWS CloudFormation
console. -
As the deploy runs, it will create new AWS CloudFormation stacks and show you the status of each one. Over the course of the one-hour deploy time, it will create four stacks:
-
<your-studio-name>Network
-
<your-studio-name>Data
-
<your-studio-name>Service
-
<your-studio-name>Compute
-
Your deploy has finished once the status of the Compute
stack changes to
CREATE_COMPLETE
.
After your deploy is complete
After StudioBuilder is finished running, you will be asked what you want to do next. After that has happened, you can close the StudioBuilder browser tab and then terminate your StudioBuilder instance by using the following instructions.
-
Close the EC2 Instance Connect tab that was connected to StudioBuilder.
-
Sign in to the AWS Management Console and open the EC2
console. -
In the left navigation pane, choose Instances.
-
Select your NimbleStudioBuilder instance from the list of instances.
-
Open the context menu (right-click) for the instance and choose Terminate Instance.
Note When you're actively deploying a studio, modifying it, or terminating it, we recommend that you run a StudioBuilder instance only. This reduces costs and prevents others from accessing and impacting your studio.
Step 6: Link AWS Managed Microsoft AD as an AWS SSO identity source
During the StudioBuilder process, an AWS Managed Microsoft AD is automatically created. This will be the directory that stores your studio users. In this step, you will link that directory to AWS SSO so that you can assign roles, such as administrator, to each of your users in Nimble Studio.
To update AWS SSO to look at AWS Managed Microsoft AD
-
Sign in to the AWS Management Console and open the Nimble Studio
console. -
In the AWS Region selector (top-right navigation bar), make sure that the Region for your studio is selected.
-
Choose Go to Studio manager.
-
Under Studio setup, go to Step 5: Allow studio access and choose Allow.
-
This takes you to the Set up user access page. Step 1 should already be completed, with a green message saying Active Directory detected.
-
-
At the bottom of Step 2, select your studio’s Active Directory from the dropdown.
-
Open the AWS SSO console
in a new tab. -
Select Choose your identity source.
-
Select Change identity source.
-
Select Active Directory and choose Next.
-
Choose the desired Active Directory and choose Next.
-
Enter
ACCEPT
and select Change identity source. -
Wait until the identity source has been changed and the Settings page opens.
-
Select Enable sync.
-
Read the terms and conditions at the bottom of the page and if you agree, select the check box next to I have read the information above and confirm that I want to enable configurable AD sync.
-
-
Choose Users from the left navigation pane.
-
If you successfully enabled sync, you will see a green banner with Start guided setup.
-
-
Select Manage sync.
-
Select Add users and groups.
-
Choose the Users tab. Under User, enter the exact user name and choose Add.
-
When all of the users have been added, select Submit.
-
Wait for the users to appear in the AWS SSO user pool.
-
It can take 10–20 minutes for users to appear.
-
-
Return to the Nimble Studio tab. On the Select administrators page, you will choose which of your users have administrator access to Nimble Studio. Administrators are able to share launch profiles to your studio users later in the Creating launch profiles tutorial.
-
In the Search text field, enter Admin and choose Search.
-
-
Select Admin.
-
Make sure to select Admin (not Administrator). Admin is the administrator from your AWS Managed Microsoft AD, so that is what you want to choose here.
-
-
Scroll to the bottom of the page and choose Next.
-
On the Select users page, since you don’t have any users yet, scroll to the bottom of the page, and choose Next.
-
On the Review page, verify that your Selected admins is set to Admin. Then scroll down and choose Save.
Step 7: Confirm subscription to burst alert emails
During the deploy, a message will be sent to the email address that you provide. The message asks you to confirm a subscription to a Burst Alert email topic. You must confirm this subscription in order to receive important notification messages when the burst credits are low for the Amazon EFS file system that stores your render farm’s Deadline Repository. Failure to receive and take action based on these emails could result in your render farm being unable to function.
-
Check the inbox for the email address that you provided when you configured your studio with StudioBuilder.
-
Open the email message with the subject AWS Notification - Subscription Confirmation.
-
This email gets sent during the deploy process.
-
-
Choose the Confirm subscription link.
-
A new browser tab will open with a message confirming that you have successfully subscribed.
-
For more information about Amazon Elastic File System (Amazon EFS) performance, see Amazon EFS performance.
-
StudioBuilder deploys an Amazon EFS in bursting throughput mode for Deadline’s Repository file storage.
-
The baseline throughput of the Amazon EFS is 50 KiB/s per 1 GiB stored in the file system. StudioBuilder ensures there is at least 40 GiB of data in this file system during deployment, which provides 2 MiB/s of baseline throughput.
-
In bursting throughput mode, this file system can burst up to 100 MiB/s, with reads counting as 1/3 of their actual throughput for this purpose. Bursting consumes bursting credits from the file system, and those burst credits replenish when not bursting.
-
The alarms configured by StudioBuilder will alert you when your burst credits are on a downward trajectory so that you can take action to increase the baseline throughput of the Amazon EFS by adding additional data to it.
-
-
You have completed deploying Amazon Nimble Studio using StudioBuilder in your AWS account. Your new studio is now ready for you to customize. We recommend that you continue with the Adding studio users tutorial, next.
Troubleshooting
Restarting StudioBuilder
StudioBuilder failed to start or I exited StudioBuilder before completing my configuration.
-
Run the following commands to start StudioBuilder
cd /home/ec2-user
studio_builder/bin/studio_builder
-
Return to the Configure your studio section of this tutorial to continue your deploy.
Continuing deployment after disconnection
I accidentally got disconnected from my StudioBuilder’s EC2 Instance Connect session before completion.
-
If you were in the process of choosing options for your studio and have not yet entered
BUILD MY STUDIO
:-
Follow these instructions to reconnect to your StudioBuilder instance: Step 4: Configure studio with StudioBuilder.
-
After reconnecting, find the last configuration question that you answered to continue.
-
-
If you already entered
BUILD MY STUDIO
and your deploy is running, you don’t need to reconnect to your StudioBuilder instance in order for the deploy to complete. Instead, you can monitor your deploy progress from CloudFormation in the AWS Management Console. For more information, see Monitoring using CloudFormation.-
If you prefer to monitor progress using EC2 Instance Connect, you can reconnect to your StudioBuilder instance using the instructions in Connect to the instance with EC2 Instance Connect.
-
Rerunning a deployment after error and failure
My deploy failed with an error on creating the AWS Managed Microsoft AD.
If your deploy fails on a step related to AWS Managed Microsoft AD, follow the steps below to remove the affected services from your account, and rerun the deploy:
-
Wait for the deploy process to stop.
-
If you're still connected to your StudioBuilder instance, wait for the deploy to finish failing.
-
After it finishes, return either to the command line prompt or the StudioBuilder prompt that states
Welcome to StudioBuilder! What would you like to do?
-
-
If you're monitoring the deploy in CloudFormation, wait until the status of the
<name>Data
stack has changed toROLLBACK_FAILED
. The<name>
portion of the status refers to the name that you chose for your studio during the StudioBuilder configuration questions.
-
-
Go to Services and open Amazon DocumentDB
-
Select Clusters in the left navigation pane.
-
If there are no clusters listed, skip to the next step. If you see clusters listed, you must delete each one individually by following these steps:
-
Under Clusters, select the cluster’s name, which will take you to its details page.
-
On the cluster’s details page, choose Events & tags.
-
Scroll down to the Tags section.
-
If you see a tag key that contains StudioBuilder, return to the list of clusters by choosing Clusters in the left navigation pane. Follow the next steps to delete the cluster.
-
Select the cluster that you need to delete by choosing the check box next to its name.
-
You only need to select the entry with the role Cluster and it will automatically delete the entry with the role Primary.
-
-
Choose Actions and then choose Delete.
-
Select No in the section where you're asked to create a final cluster snapshot and select the check box below it to acknowledge your choice.
-
Enter delete entire cluster and then choose Delete.
-
Repeat this step (step 4, a – h) for any other clusters that have StudioBuilder tags.
-
-
After the clusters have been deleted, select Subnet groups in the left navigation pane.
-
If there are no subnet groups listed, skip to the next step. If you see subnets listed, you must delete each one individually by following these steps:
-
Under Subnet groups, select the subnet’s name, which will take you to its details page.
-
On the subnet’s details page, scroll down to the Tags section.
-
If you see a tag key that contains StudioBuilder, return to the list of subnet groups by choosing Subnet groups in the left navigation pane. Follow the next steps to delete the subnet group.
-
Select the subnet group that you need to delete from the list.
-
Choose Actions and then choose Delete.
-
Repeat for each subnet group that has a StudioBuilder tag.
-
-
Go to Services and open CloudFormation
. -
Select the
<name>Data
stack from the list of stacks, and then choose Delete.-
If you're asked to edit the termination protection, select Disabled, then choose Save and try the delete process again.
-
The status of the stack will change to DELETE_IN_PROGRESS. When the <name>Data stack disappears from the list of stacks, or its status changes to DELETE_COMPLETE, it has been deleted and you can rerun your deploy.
-
-
If you're no longer connected to your StudioBuilder instance, follow the instructions in Step 4: Connect to the instance with EC2 Instance Connect.
-
Return to Step 4: Configure studio with StudioBuilder and repeat the instructions to configure your studio.
Updating deployment with a new version of StudioBuilder
How do I update my studio deployment using a new version of StudioBuilder?
-
Go to Services and open AWS Marketplace Subscriptions
. -
Choose Manage for Nimble Studio StudioBuilder.
-
On the Nimble Studio StudioBuilder page, choose Launch new instance.
-
Select the latest version from the Software version dropdown menu.
-
Select the Region that your studio is deployed in from the Region dropdown menu.
-
Choose Continue to launch through EC2.
-
Return to Step 3: Step 3: Launch the StudioBuilder EC2 instance to finish launching and connect to your new StudioBuilder instance.
After connecting to your StudioBuilder instance, choose Update and/or edit your studio and follow the prompts to update your studio.