= Create Environment
:toc:
:icons:
:linkattrs:
:imagesdir: ../resources/images


== Summary

Build a new AWS environment for use during this tutorial. See *environment diagram* below. It will take approximately 40 minutes for the tutorial environment to be created.

== Environment Diagram

image::fsx-windows-tutorial-architecture.png[align="left", width=600]

== Step-by-step Guide

. Using the instructions below, create the tutorial environment using AWS CloudFormation. It will take approximately 40 minutes for the CloudFormation stack to be fully deployed.

=== CloudFormation

IMPORTANT: Read through all steps below and watch the quick video before *_clicking_* the *Deploy to AWS* button.

image::create-environment.gif[align="left", width=600]

. Click on the *Deploy to AWS* button and follow the CloudFormation prompts to begin.
+
Amazon FSx is currently available in 11 regions.
+
File system creation is currently not supported in the following Availability Zones:
+
[cols="1,1,2", options="header"]
|===
|Region | Availability Zone ID | Mapping
| *N. Virginia* (us-east-1)
| *use1-az3*
| Open the link:https://us-east-1.console.aws.amazon.com/vpc/home?region=us-east-1#subnets:[us-east-1 VPC] console for AZ mapping.

| *Oregon* (us-west-2)
| *usw2-az4*
| Open the link:https://us-west-2.console.aws.amazon.com/vpc/home?region=us-west-2#subnets:[us-west-2 VPC] console for AZ mapping.

| *Sydney* (ap-southeast-2)
| *apse2-az3*
| Open the link:https://ap-southeast-2.console.aws.amazon.com/vpc/home?region=ap-southeast-2#subnets:[ap-southeast-2 VPC] console for AZ mapping.

| *Tokyo* (ap-northeast-1)
| *apne1-az3*
| Open the link:https://ap-northeast-1.console.aws.amazon.com/vpc/home?region=ap-northeast-1#subnets:[ap-northeast-1 VPC] console for AZ mapping.

| *Frankfurt* (eu-central-1)
| *euc1-az1*
| Open the link:https://eu-central-1.console.aws.amazon.com/vpc/home?region=eu-central-1#subnets:[eu-central-1 VPC] console for AZ mapping.

|===
+
When selecting availability zones in the CloudFormation create stack wizard, take care not to select an availability zone mapped to one of the Availability Zone IDs listed above.
+
TIP: *_Context-click (right-click)_* the *Deploy to AWS* button and open the link in a new tab or window to make it easy to navigate between this github tutorial and the AWS Console.
+
|===
|Region | Launch template with a new VPC
| *N. Virginia* (us-east-1)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?stackName=fsxwfs-tutorial&templateURL=https://s3.amazonaws.com/amazon-fsx/tutorial/windows/templates/fsxw-tutorial.yaml]

| *Ohio* (us-east-2)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=us-east-2#/stacks/new?stackName=fsxwfs-tutorial&templateURL=https://s3.amazonaws.com/amazon-fsx/tutorial/windows/templates/fsxw-tutorial.yaml]

| *N. California* (us-west-1)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=us-west-1#/stacks/new?stackName=fsxwfs-tutorial&templateURL=https://s3.amazonaws.com/amazon-fsx/tutorial/windows/templates/fsxw-tutorial.yaml]

| *Oregon* (us-west-2)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=us-west-2#/stacks/new?stackName=fsxwfs-tutorial&templateURL=https://s3.amazonaws.com/amazon-fsx/tutorial/windows/templates/fsxw-tutorial.yaml]

| *Hong Kong* (ap-east-1)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=ap-east-1#/stacks/new?stackName=fsxwfs-tutorial&templateURL=https://s3.amazonaws.com/amazon-fsx/tutorial/windows/templates/fsxw-tutorial.yaml]

| *Mumbai* (ap-south-1)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=ap-south-1#/stacks/new?stackName=fsxwfs-tutorial&templateURL=https://s3.amazonaws.com/amazon-fsx/tutorial/windows/templates/fsxw-tutorial.yaml]

| *Seoul* (ap-northeast-2)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=ap-northeast-2#/stacks/new?stackName=fsxwfs-tutorial&templateURL=https://s3.amazonaws.com/amazon-fsx/tutorial/windows/templates/fsxw-tutorial.yaml]

| *Singapore* (ap-southeast-1)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=ap-southeast-1#/stacks/new?stackName=fsxwfs-tutorial&templateURL=https://s3.amazonaws.com/amazon-fsx/tutorial/windows/templates/fsxw-tutorial.yaml]

| *Sydney* (ap-southeast-2)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=ap-southeast-2#/stacks/new?stackName=fsxwfs-tutorial&templateURL=https://s3.amazonaws.com/amazon-fsx/tutorial/windows/templates/fsxw-tutorial.yaml]

| *Tokyo* (ap-northeast-1)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=ap-northeast-1#/stacks/new?stackName=fsxwfs-tutorial&templateURL=https://s3.amazonaws.com/amazon-fsx/tutorial/windows/templates/fsxw-tutorial.yaml]

| *Canada* (ca-central-1)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=ca-central-1#/stacks/new?stackName=fsxwfs-tutorial&templateURL=https://s3.amazonaws.com/amazon-fsx/tutorial/windows/templates/fsxw-tutorial.yaml]

| *Frankfurt* (eu-central-1)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=eu-central-1#/stacks/new?stackName=fsxwfs-tutorial&templateURL=https://s3.amazonaws.com/amazon-fsx/tutorial/windows/templates/fsxw-tutorial.yaml]

| *Ireland* (eu-west-1)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=eu-west-1#/stacks/new?stackName=fsxwfs-tutorial&templateURL=https://s3.amazonaws.com/amazon-fsx/tutorial/windows/templates/fsxw-tutorial.yaml]

| *London* (eu-west-2)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=eu-west-2#/stacks/new?stackName=fsxwfs-tutorial&templateURL=https://s3.amazonaws.com/amazon-fsx/tutorial/windows/templates/fsxw-tutorial.yaml]

| *Paris* (eu-west-3)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=eu-west-3#/stacks/new?stackName=fsxwfs-tutorial&templateURL=https://s3.amazonaws.com/amazon-fsx/tutorial/windows/templates/fsxw-tutorial.yaml]

| *Stockholm* (eu-north-1)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=eu-north-1#/stacks/new?stackName=fsxwfs-tutorial&templateURL=https://s3.amazonaws.com/amazon-fsx/tutorial/windows/templates/fsxw-tutorial.yaml]

| *São Paulo* (sa-east-1)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=sa-east-1#/stacks/new?stackName=fsxwfs-tutorial&templateURL=https://s3.amazonaws.com/amazon-fsx/tutorial/windows/templates/fsxw-tutorial.yaml]

|===
+
. Accept the defaults on the *Prerequisite - Prepare template* page and *_click_* *Next*.
+
. Accept the default stack name and *_click_* *Next*. *_Enter_* values for all parameters.
+
[cols="3,10"]
|===
| *VPC CIDR*
a| Select a CIDR that will be used for the VPC.

| *Availability Zones*
a| Select two (2) availability zones for your VPC.

|===
+
. After you have entered values for all parameters, *_click_* *Next*.
. *_Accept_* the default values of the *Configure stack options* and *Advanced options* sections and *_click_* *Next*.
. *_Review_* the CloudFormation stack settings.
. *_Click_* both checkboxes in the blue *Capabilities* box at the bottom of the page.
+
image::cloudformation-capabilities.png[align="left", width=420]
+
. *_Click_* *Create stack*.

The tutorial environment will be available in approximately 40 minutes.


== Next section

Click one of the buttons below to create an SSD or HDD storage type multi-AZ file system.

image::02a-create-maz-ssd-file-system.png[link=../02a-create-maz-ssd-file-system/, align="right",width=420]




image::02b-create-maz-hdd-file-system.png[link=../02b-create-maz-hdd-file-system/, align="right",width=420]
