Merge pull request #10 from stevenmatthew/storage-mover

Storage mover
changeworld · Aug 15, 2022 · 78f4285 · 78f4285
2 parents 0eb7cd1 + 4604bc2
commit 78f4285
Show file tree

Hide file tree

Showing 50 changed files with 437 additions and 266 deletions.
diff --git a/articles/storage-mover/TOC.yml b/articles/storage-mover/TOC.yml
@@ -4,7 +4,7 @@ items:
 - name: Overview
   items:
   - name: What is Azure Storage Mover?
-    href: overview.md
+    href: service-overview.md
   expanded: true
 - name: Concepts
   items: 
@@ -65,7 +65,7 @@ items:
   - name: Release notes
     href: release-notes.md
   - name: Samples
-    href: https://review.docs.microsoft.com/en-us/samples/browse/?branch=main&expanded=azure
+    href: /samples/browse/?branch=main&expanded=azure
   - name: Azure Storage Mover release notes
     href: release-notes.md
 

diff --git a/articles/storage-mover/_sample-concept.md b/articles/storage-mover/_sample-concept.md
@@ -81,6 +81,6 @@ We must provide at least one next step, but should provide no more than three. T
 
 ## Next steps
 <!-- Add a context sentence for the following links -->
-- [Concept: Selecting a breakfast food](overview.md)
-- [How-to: cook a waffle](overview.md)
-- [How-to: cook a pancake](overview.md)
+- [Concept: Selecting a breakfast food](service-overview.md)
+- [How-to: cook a waffle](service-overview.md)
+- [How-to: cook a pancake](service-overview.md)
diff --git a/articles/storage-mover/_sample-how-to.md b/articles/storage-mover/_sample-how-to.md
@@ -96,4 +96,4 @@ A single link in the blue box format. Point to the next logical tutorial or how-
 
 Advance to the next article to learn how to create...
 > [!div class="nextstepaction"]
-> [Prepare Haushaltswaffeln for Fabian and Stephen](overview.md)
+> [Prepare Haushaltswaffeln for Fabian and Stephen](service-overview.md)
diff --git a/articles/storage-mover/_sample-quickstart.md b/articles/storage-mover/_sample-quickstart.md
@@ -128,4 +128,4 @@ A single link in the blue box format. Point to the next logical quickstart or tu
 
 Advance to the next article to learn how to create...
 > [!div class="nextstepaction"]
-> [Next steps button](overview.md)
+> [Next steps button](service-overview.md)
diff --git a/articles/storage-mover/_sample-tutorial.md b/articles/storage-mover/_sample-tutorial.md
@@ -117,4 +117,4 @@ A single link in the blue box format. Point to the next logical tutorial or how-
 
 Advance to the next article to learn how to create...
 > [!div class="nextstepaction"]
-> [Next steps button](overview.md)
+> [Next steps button](service-overview.md)
diff --git a/articles/storage-mover/agent-deploy.md b/articles/storage-mover/agent-deploy.md
@@ -5,7 +5,7 @@ author: stevenmatthew
 ms.author: shaas
 ms.service: storage-mover
 ms.topic: how-to
-ms.date: 06/21/2022
+ms.date: 07/27/2022
 ms.custom: template-how-to
 ---
 
@@ -41,59 +41,78 @@ This article guides you through the construction of Oma's waffles. After complet
 
 ## Prerequisites
 
-- 250 g (8.81 oz) of melted butter
-- 250 g (8.81 oz) of sugar
-- 500 g (17.63 oz) of all purpose flour
-- 6 eggs, XL
-- 500 ml (16.9 oz) of milk
-- 1 ½ teaspoons of baking powder
-- grated lemon peel of 1 lemon
-- 2 pouches of vanilla sugar
-- 1 teaspoon of vanilla extract
+- An Azure account. If you don't yet have an account, you can [create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
+- An active Azure subscription enabled for the Storage Mover preview.
 
 <!-- 
 4. H2s (Docs Required)
 
 Prescriptively direct the customer through the procedure end-to-end. Don't link to other content (until 'next steps'), but include whatever the customer needs to complete the scenario in the article. -->
 
-## Prepare the batter
+## Download agent VM
 
-The first step to making Haushaltswaffeln is the preparation of the batter. To prepare the batter, complete the steps listed below. 
+You'll need to download the agent's VHD and attach it to a new VM to facilitate the migration of your files.
 
-1. Separate the eggs with an egg separator.
-1. Using a handheld mixer beat the egg whites until stiff.
-1. In a separate bowl add the egg yolks, sugar, grated lemon peel and vanilla sugar or vanilla extract and mix until creamy.
-1. Slowly add the butter to the egg mixture and beat until smooth.
-1. Mix the flour with baking powder and sift it into a bowl.
-1. Alternate between flour and lukewarm milk and add these ingredients into the egg mixture.
-1. Fold in the beaten egg whites using a pastry blender.
+You can access the VHD file from [\\xstoreself.corp.microsoft.com\scratch\XDataMove\Public Preview](\\xstoreself.corp.microsoft.com\scratch\XDataMove\Public Preview).
 
-After the batter is prepared, you can begin baking the batter into the tasty Haushaltswaffeln.
+## Create the agent
 
-## Cook the batter
+Providing sufficient resources like RAM and compute cores to your agent is important.
 
-In this section, you will cook the batter prepared in the previous section, resulting in a batch of warm and delicious Haushaltswaffeln.
+1. Unpack the agent VHD to a local folder.
+  :::image type="content" source="media/agent-deploy/agent-disk-extract-sml.png" alt-text="Image of a compressed file being extracted to the local file system." lightbox="media/agent-deploy/agent-disk-extract-lrg.png":::
+1. Create a new VM to host the agent. Open **Hyper-V Manager**. In the **Actions** pane, select **New** and **Virtual Machine...** to launch the **New Virtual Machine Wizard**.
+  :::image type="content" source="media/agent-deploy/agent-vm-create-sml.png" alt-text="Image showing how to launch the New Virtual Machine Wizard from within the Hyper-V Manager." lightbox="media/agent-deploy/agent-vm-create-lrg.png":::
+1. Within the **Specify Name and Location** pane, specify values for the agent VM's **Name** and **Location** fields. The location should match the folder where the VHD is stored, if possible. Select **Next**.
+  :::image type="content" source="media/agent-deploy/agent-name-select-sml.png" alt-text="Image showing the location of the Name and Location fields within the New Virtual Machine Wizard." lightbox="media/agent-deploy/agent-name-select-lrg.png":::
+1. Within the **Specify Generation** pane, select the **Generation 1** option. Only **Generation 1** VM generation is supported during the Azure Storage Mover public preview.
+  :::image type="content" source="media/agent-deploy/agent-vm-generation-select-sml.png" lightbox="media/agent-deploy/agent-vm-generation-select-lrg.png"  alt-text="Image showing the location of the VM Generation options within the New Virtual Machine Wizard.":::
+1. Within the **Assign Memory** pane, enter the amount of memory you will allocate to the agent VM. 3072 MB dynamic RAM is being provided in our example. For information on allocation recommendations, see the article on [Performance Targets](performance-targets.md).
+  :::image type="content" source="media/agent-deploy/agent-memory-allocate-sml.png" lightbox="media/agent-deploy/agent-memory-allocate-lrg.png"  alt-text="Image showing the location of the Startup Memory field within the New Virtual Machine Wizard.":::
+1. Within the **Configure Networking** pane, select the **Connection** drop-down and choose the virtual switch which will provide the agent with internet connectivity. Select **Next**.
+  :::image type="content" source="media/agent-deploy/agent-networking-configure-sml.png" lightbox="media/agent-deploy/agent-networking-configure-lrg.png"  alt-text="Image showing the location of the network Connection field within the New Virtual Machine Wizard.":::
+1. Within the **Connect Virtual Hard Disk** pane, select the **Use an existing Virtual Hard Disk** option. In the **Location** field, select **Browse** and navigate to the VHD file that was extracted in the previous steps. Select **Next**.
+  :::image type="content" source="media/agent-deploy/agent-disk-connect-sml.png" lightbox="media/agent-deploy/agent-disk-connect-lrg.png"  alt-text="Image showing the location of the Virtual Hard Disk Connection fields within the New Virtual Machine Wizard.":::
+1. Within the **Summary** pane, select **Finish** to create the agent VM.
+  :::image type="content" source="media/agent-deploy/agent-configuration-details-sml.png"  lightbox="media/agent-deploy/agent-configuration-details-lrg.png" alt-text="Image showing the user-assigned values in the Summary pane of the New Virtual Machine Wizard.":::
+1. After the new agent is successfully created, it will appear in the **Virtual Machines** pane within the **Hyper-V Manager**.
+     :::image type="content" source="media/agent-deploy/agent-created-sml.png" lightbox="media/agent-deploy/agent-created-lrg.png" alt-text="Image showing the agent VM deployed within the New Virtual Machine Wizard.":::
 
-Use the steps below to create your first batch.
+## Register the agent
 
-1. Heat up a waffle maker.
-1. Fill about ½ cup of batter in the waffle maker.
-1. Close the waffle maker and bake the waffles until golden and crisp.
+Once your agent VM is running, you'll need to create trust to use it for migrations.
 
-After the Haushaltswaffeln are cooked to perfection, it's time to serve your guests. This process is described in the next section.
+# [Hyper-V](#tab/hyper-v)
 
-## Serve the Haushaltswaffeln
+1. Open **Hyper-V Manager**. In the **Virtual Machines** pane and select your agent. Start your agent by select **Start** within the **Actions** pane.
+  :::image type="content" source="media/agent-deploy/agent-vm-start-sml.png" lightbox="media/agent-deploy/agent-vm-start-lrg.png"  alt-text="Image illustrating the steps involved with starting a VM within Hyper-V Manager.":::
+1. After starting, the agent VM's **State**, **CPU Usage**, and other metrics are displayed in the **Virtual Machines** pane. Additionally, a checkpoint is automatically created. Connect to the agent VM by selecting **Connect...** from the agent's section within the **Actions** pane as shown.
+  :::image type="content" source="media/agent-deploy/agent-vm-connect-sml.png" lightbox="media/agent-deploy/agent-vm-connect-lrg.png"  alt-text="Image illustrating the location of the Connect icon within Hyper-V Manager.":::
+1. In the **Virtual Machine Connection** window, login to the agent VM using the default credentials. At the **login** prompt, enter **admin** and press the **Enter** key. Enter **admin** again at the **Password** prompt and press the **Enter** key. Enter **n** when prompted to change the default password and press the **Enter** key.
+  :::image type="content" source="media/agent-deploy/agent-vm-login-sml.png" lightbox="media/agent-deploy/agent-vm-login-lrg.png"  alt-text="Image illustrating the authentication prompts for the agent VM using Hyper-V Manager.":::
 
-Although you can dress Haushaltswaffeln up with a sprinkling of powdered sugar, they really need no embellishment. The flavour is rich and buttery, and they are nicely sweetened. You can give your callers the option to sprinkle some powdered sugar over the Haushaltswaffeln, or add whipped cream and fruit.
+# [PowerShell](#tab/powershell)
 
-<!-- 
+Create the agent using the following sample code.
+
+```azurepowershell
+New-AzStorageMoverAgent -ResourceGroupName $ResourceGroupName -StorageMoverName $StorageMoverName -Name $agentName -ArcResourceId $arcId -Description "Agent description" -ArcVMUuid $guid #-Debug 
+```
+
+Validate agent creation using the following sample code.
 
-5. Next steps (Docs required)
+```azurepowershell
+Get-AzStorageMoverAgent -ResourceGroupName $ResourceGroupName -StorageMoverName $StorageMoverName -Name $agentName 
+```
 
-A single link in the blue box format. Point to the next logical tutorial or how-to in a series, or, if there are no other tutorials or how-tos, to some other cool thing the customer can do. -->
+# [CLI](#tab/cli)
+
+Content for CLI.
+
+---
 
 ## Next steps
 
 Advance to the next article to learn how to create...
 > [!div class="nextstepaction"]
-> [Prepare Haushaltswaffeln for Fabian and Stephen](overview.md)
+> [Prepare Haushaltswaffeln for Fabian and Stephen](service-overview.md)
diff --git a/articles/storage-mover/agent-manage.md b/articles/storage-mover/agent-manage.md
@@ -96,4 +96,4 @@ A single link in the blue box format. Point to the next logical tutorial or how-
 
 Advance to the next article to learn how to create...
 > [!div class="nextstepaction"]
-> [Prepare Haushaltswaffeln for Fabian and Stephen](overview.md)
+> [Prepare Haushaltswaffeln for Fabian and Stephen](service-overview.md)
diff --git a/articles/storage-mover/billing.md b/articles/storage-mover/billing.md
@@ -37,6 +37,7 @@ How these charges apply depends on the billing model in effect for each Azure St
 There are two distinct billing models in Azure Storage: *provisioned* billing and *pay-as-you-go* billing.
 
 **Pay-as-you-go billing**
+
 * Transactions caused by the Storage Mover service will be billed. Review your specific storage product's pricing pages for details on transactions. It is very difficult to estimate the impact on your bill. The section [estimating storage transaction charges](#estimating-storage-transaction-charges) in this article illustrates the reasons.
 * Capacity charges progressively apply as files move into the cloud and occupy more and more storage capacity.
 
@@ -65,5 +66,5 @@ The cost of your upload bandwidth from the location of your Azure Storage Mover
 
 ## Next steps
 <!-- Add a context sentence for the following links -->
-- [Step 1](overview.md)
-- [Step 2](overview.md)
+- [Step 1](service-overview.md)
+- [Step 2](service-overview.md)
diff --git a/articles/storage-mover/copy-errors.md b/articles/storage-mover/copy-errors.md
@@ -96,4 +96,4 @@ A single link in the blue box format. Point to the next logical tutorial or how-
 
 Advance to the next article to learn how to create...
 > [!div class="nextstepaction"]
-> [Prepare Haushaltswaffeln for Fabian and Stephen](overview.md)
+> [Prepare Haushaltswaffeln for Fabian and Stephen](service-overview.md)
diff --git a/articles/storage-mover/data-security.md b/articles/storage-mover/data-security.md
@@ -75,5 +75,5 @@ We must provide at least one next step, but should provide no more than three. T
 
 ## Next steps
 <!-- Add a context sentence for the following links -->
-- [Step 1](overview.md)
-- [Step 2](overview.md)
+- [Step 1](service-overview.md)
+- [Step 2](service-overview.md)
diff --git a/articles/storage-mover/deployment-planning.md b/articles/storage-mover/deployment-planning.md
@@ -63,5 +63,5 @@ We must provide at least one next step, but should provide no more than three. T
 
 ## Next steps
 <!-- Add a context sentence for the following links -->
-- [Step 1](overview.md)
-- [Step 2](overview.md)
+- [Step 1](service-overview.md)
+- [Step 2](service-overview.md)