Skip to content

Commit

Permalink
Update to v2.0
Browse files Browse the repository at this point in the history
  • Loading branch information
Darryl Osborne committed May 8, 2019
1 parent ec04ac7 commit b92379c
Show file tree
Hide file tree
Showing 58 changed files with 2,820 additions and 63 deletions.
Binary file modified .DS_Store
Binary file not shown.
24 changes: 12 additions & 12 deletions LICENSE
@@ -1,14 +1,14 @@
Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
Copyright 2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.

Permission is hereby granted, free of charge, to any person obtaining a copy of this
software and associated documentation files (the "Software"), to deal in the Software
without restriction, including without limitation the rights to use, copy, modify,
merge, publish, distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so.
Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
the Software, and to permit persons to whom the Software is furnished to do so.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
51 changes: 0 additions & 51 deletions README.md

This file was deleted.

28 changes: 28 additions & 0 deletions readme.adoc
@@ -0,0 +1,28 @@
= Cloud File Storage the AWSome Way!
:icons:
:linkattrs:
:imagesdir: resources/images

image:fsx-aws-logos.png[alt="fsx and aws logos", align="left",width=420]

This is a set of workshop designed for architects and engineers who would like to learn more about Amazon Web Services (AWS) full-managed third party file system service - link:https://aws.amazon.com/fsx/[Amazon FSx].

Click the button below to access Amazon FSx workshops.


image::fsx-lustre-workshop-logo.png[link=lustre/, align="left",width=420]

image::fsx-windows-workshop-logo.png[link=windows/, align="left",width=420]



NOTE: You will incur charges as you go through these workshops as it will exceed the link:http://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/free-tier-limits.html[limits of AWS free tier].

=== Participation

We encourage participation; if you find anything, please submit an issue. However, if you want to help raise the bar, **submit a PR**!


=== License

This sample code is made available under a modified MIT license. See the LICENSE file.
Binary file added resources/.DS_Store
Binary file not shown.
Binary file added resources/images/.DS_Store
Binary file not shown.
Binary file added resources/images/01-create-environment.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/images/03-create-new-file-share.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/images/04-test-performance.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/images/05-monitor-performance.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/images/06-create-dfs-namespace.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/images/07-setup-dfs-replication.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/images/cloudformation-capabilities.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/images/create-environment.gif
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/images/create-high-throughput-alarm.gif
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/images/cw-monitoring-tutorial.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/images/delete-workshop-environment.gif
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/images/deploy-to-aws.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/images/fsx-aws-logos.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/images/fsx-cw-dashboard.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/images/fsx-lustre-workshop-logo.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/images/fsx-windows-aws-logos.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/images/fsx-windows-workshop-logo.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/images/fsx_aws_logos_old.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/images/fsx_windows_tutorial_logos.png
Binary file added resources/images/map-default-file-share.gif
Binary file added windows/.DS_Store
Binary file not shown.
92 changes: 92 additions & 0 deletions windows/01-create-workshop-environment/readme.adoc
@@ -0,0 +1,92 @@
= Create Workshop Environment
:toc:
:icons:
:linkattrs:
:imagesdir: ../../resources/images


== Summary

This section will create a new environment (see diagram below) that you will use for the workshop.

== Duration

NOTE: It will take approximately 45 minutes for CloudFormation to automatically create your workshop environment, after completing the *Step-by-step Guide* below.

== Diagram

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


== Step-by-step Guide

=== 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.
+
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 workshop and AWS Console.
+
NOTE: Amazon FSx is currently available in 6 regions.
+
|===
|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=fsx-windows-workshop&templateURL=https://s3.amazonaws.com/amazon-fsx/workshop/windows/templates/00-fsx-workshop.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=fsx-windows-workshop&templateURL=https://s3.amazonaws.com/amazon-fsx/workshop/windows/templates/00-fsx-workshop.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=fsx-windows-workshop&templateURL=https://s3.amazonaws.com/amazon-fsx/workshop/windows/templates/00-fsx-workshop.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=fsx-windows-workshop&templateURL=https://s3.amazonaws.com/amazon-fsx/workshop/windows/templates/00-fsx-workshop.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=fsx-windows-workshop&templateURL=https://s3.amazonaws.com/amazon-fsx/workshop/windows/templates/00-fsx-workshop.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=fsx-windows-workshop&templateURL=https://s3.amazonaws.com/amazon-fsx/workshop/windows/templates/00-fsx-workshop.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.

| *Email address*
a| Enter the email address that will receive notifications for low free storage capacity CloudWatch alarms. Important! An AWS Notification Subscription Confirmation email will be sent to this email address when the CloudFormation stack is created. You must take the action described in that email to confirm the SNS topic subscription before the email address can start receiving alarm notifications.
|===
+
. 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*.

In approximately 45 minutes an email will be sent to the email address entered above (see sample below). Open the email message and *_click_* the *Confirm subscription* link. This will allow Amazon SNS to send CloudWatch alarm notifications to this email address during the workshop.

image::aws-notification-subscription-email.png[align="left",width=420]

== Next section

Click the button below to go to the next section.

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

86 changes: 86 additions & 0 deletions windows/02-create-file-system-from-backup/readme.adoc
@@ -0,0 +1,86 @@
= Create file system from backup
:toc:
:icons:
:linkattrs:
:imagesdir: ../../resources/images


== Summary

This section will create a new file system from a backup.

You can use an available backup to create a new file system, effectively restoring a point-in-time snapshot of another file system.


== Duration

NOTE: It will take approximately 5 minutes to complete this section.


== Diagram

image::create-file-system-from-backup.png[align="left", width=600]


== Step-by-step Guide

IMPORTANT: Read through all steps below and watch the quick video before continuing.

image::create-file-system-from-backup.gif[align="left", width=600]

. Open the link:https://console.aws.amazon.com/fsx/[Amazon FSx] console.
+
TIP: *_Context-click (right-click)_* the link above and open the link in a new tab or window to make it easy to navigate between this github workshop and Amazon FSx console.
+
. Make sure you are in the same *AWS Region* where you *_created_* your workshop environment.
. *_Select_* the *File system name* or the *File system ID* of file system created by the CloudFormation template. The file system name is "*Amazon FSx for Windows File Server 0*".
. From the *Details* view and the *Overview* tab, make a note of the *Availability Zone*.
. *_Select_* the *Backups* tab.
. *_Click_* the check box next to the *Automatic* backup taken of the file system after it was created.
. *_Select_* the *Restore backup* button.
. *_Complete_* the *Create file system from backup...* wizard with the following settings:
+
[cols="3,10"]
|===
| *File system name*
a| Amazon FSx for Windows File Server 1
| *Storage capacity*
a| Immutable when restoring a backup
| *Throughput capacity*
a| 64 MB/s
| *Virtual private cloud (VPC)*
a| Accept the default - *VPC \| fsx-windows-workshop-Vpc...*
| *Availability Zone*
a| Remember the availability zone you noted above? From the dropdown menu *_select_* the other availability zone.
| *Subnet*
a| Accept the default - *Private Subnet 1 \| fsx-windows-workshop-Vpc...*
| *VPC Security Groups*
a| *_Click_* the *X* to remove the default security group. From the dropdown menu *_select_* the *File system security group...*
| *Microsoft Active Directory ID*
a| From the dropdown menu *_select_* the *example.com (d-...)* directory
| *Encryption key*
a| Accept the default - *(default)aws/fsx*
| *Daily automatic backup window*
a| *_Select_* *No preferences*
| *Automatic backup retention period*
a| *_Enter_* *0* days
| *Weekly maintenance window*
a| *_Select_* *No preferences*
|===
+
. *_Select_* *Next*

. *_Review_* the file system summary and *_select_* *Create file system*.

NOTE: It will take approximately 15 minutes to restore a backup as a new file system. Continue with the next section while the new file system is created in the background.


== Next section

Click the button below to go to the next section.

image::03-create-new-file-share.png[link=../03-create-new-file-share/, align="left",width=420]




0 comments on commit b92379c

Please sign in to comment.