microsoft/mcw-lift-and-shift-azure-resource-manager

MCW Lift and shift/Azure Resource Manager

mcw-lift-and-shift-azure-resource-manager's Issues

Workshop HOL does not match the workshop name

This workshop's hands on lab should not be called Lift & Shift. It would be more appropriate to call it Azure Resource Manager template deployment, or ARM templates and DSC.

Our recommended Lift & Shift / cloud migration tool is Azure Site Recovery (ASR). While the whiteboarding session covers ASR as one of the options, the lab doesn't even mention it. This means that people hoping to learn more about Lift & Shift with ASR will not get the expected content.

It would be more appropriate to use the HOL from the business continuity workshop as a Lift & Shift HOL https://github.com/Microsoft/MCW-Business-Continuity-and-Disaster-Recovery

HOL step-by-step

Document uses the following coding:
NOTE: …
Note: …

Note: …
NOTE: ...
Please pick one style and make it consistent throughout the document.

WDS - trainer & presenter guides

Abstracts do not match what is on the ReadMe page.

WDS - trainer presentation (PPT)

Please rename file - should be WDS trainer presentation - Lift and shift
Slide 2 - Abstract should be the WDS abstract and match what is on the ReadMe page please.
Slide 4 - English-language has an extra space after the hyphen
Slide 5 - periods at the end of the sentence in the 2nd & 3rd bullets - need to be removed
Slide 7 - remove period at the end of sentence in 1st bullet
Slides 8 & 9 - Trainer guide has 10 customer needs, PPT only has 9
Slide 9 - 3rd bullet - Secure and performant (typo?)
Slides 9 & 10 - customer has 5 objections, later in the PPT, you answer 6 questions
Slide 19 - Internet isn't a noun...lower case i
Slide 21 - remove period on first bullet
Slide 22 - Specifc (typo)
Slide 23 - Remove period on first bullet
Slide 25 - Add periods to Option 2 & 3 (they aren't bulleted so they need punctuation)
Slides 26 & 27 - The rest of the PPT uses standard bullets - these two slides use numbers. Are those steps students need to follow in order (then the numbers would make sense)? If not, can they be dots to be consistent with the rest of the PPT?
Slide 28 - remove punctuation
Slide 30 - add colon after See list at:
Slide 31 - add period after etc.
Slide 32 - add punctuation (not bulleted items)
Slide 36 - same as above

all issues resolved - ready for whatever is next..

introduce managed instances DBs

I would suggest introducing managed instances DBs als alternative to IaaS SQL Servers as one of the possible solution scenarios.

Archive previous docs

@paulopsgility @Jeff-Opsgility
Please create an Archive folder inside the Hands-on-lab folder and move the supplemental docs and the unguided lab into that folder.
Thanks,
Dawnmarie

Broken links

WDS Student guide: Lines 139 (https://procurement) & 178 (https://AskHR) - present as links, but don't take students anywhere.

WDS Trainer guide: Lines 259, 209, 838, 914 & 1220 - same as above.

My guess is those are intentionally fake links for the WDS but, is there a way to format them to be typed in, not as a hyperlink that looks broken?

Code is missing in Exercise 5 -> Task 1 -> Step 1 & 2

In Exercise 5 > Task 1 > Step 1, while adding the variables to the end of the variables section we need to add one more variable i.e:
"StorageAccountPrefix": [
"a",
"g",
"m",
"s",
"y"
]
In Exercise 5 > Task 1 > Step 2, while adding the parameters to the end of the parameters section we need to add one more parameter i.e:
"newStorageAccountSuffix": {
"type": "string",
"metadata": {
"description": "prefix for storage account"
}
}

Before the HOL

Updated document with title, headers & license information. Need to add the TOC to be complete

DSC Scripts

The DSC scripts in the final scripts archive are mostly commented out and will not achieve the desired result in the HOL. Also, there are references to CloudShopSQL.ps1 and CloudShopWeb.ps1 and those files do not exist in the project.

timeslot in bootcamp agenda

Not related to the content but I did notice that the WDS happens in the bootcamp agenda before the technical intro session about ASR / backup / migrate. Reshaping the agenda will allow for a more efficient WDS.

HOL - unguided

Image not showing - Line 334 in the .md code does not show up in the document

UEFI now supported on physical machines

See https://azure.microsoft.com/en-gb/blog/new-azure-migrate-and-azure-site-recovery-enhancements-for-cloud-migration/

UEFI boot now supported by ASR on physical machines. Need to update the WDS to reflect this change.

Note: At the time of this writing, the Azure Database Assistant service is in preview and does not support targeting SQL Server, just SQL Database.

It is now GA:
https://blogs.msdn.microsoft.com/datamigration/2018/05/07/announcing-general-availability-of-the-azure-database-migration-service/

WDS - trainer & presenter guides

Objections handling section - asks 5 questions - answers 6 questions in the trainer portion. Those should match.

update server generation

personally I would put the VM on ds2v3 and not ds2v2 for a better performance ratio.

target SQL Server version

Target SQL-Server version should be SQL2017 not 2016.

WDS - trainer guide

Need to correct numbering please. In md, all of the lines start with 1. ….

I've corrected down to line 699 but, there's some inconsistency underneath that I'm not sure how to correct.
Migration - Procurement - you answer questions 1, then the following are standard bullets, after 2., it changes to a. b. c. Later in the document, it goes back to the standard bullets. Documents need to be consistent.

Correct punctuation from line 699 down as well please. Bulleted items do not get ending periods unless there is more than one sentence or a ? or a :

capacity guidance

document includes
" The hardware is not running at capacity when measured by CPU or memory" in intro.
I would replace this with
"The hardware utilization is unknown at this point in time"
to motivate introduction of Azure migrate for this use case even stronger

Content update scheduled

This workshop is scheduled for an update. Please review the contents of this repo and comment on this issue with suggested updates. All suggestions must be added to this issue by EOD 11/9/2018.

Supplimental Documents

Apologies, I did not see the supplemental docs on my first QC pass, please review/correct the following:

Scale to send region with AppGW Supplemental Doc-
TOC is formatted incorrectly (add WS title) and does not match document. The doc has 2 exercises and several tasks that the TOC does not include. Ex 1, Task 4 does not have a title.

Azure Backup Supplemental Doc -
Task 1 does not have a title

The VMs in the HOL should use managed disk

The VMs in the lab should use managed disk instead of VHDs in storage accounts. Managed disk has been GA for over a year and is the best practice for deploying compute resources.

https://docs.microsoft.com/en-us/azure/virtual-machines/windows/using-managed-disks-template-deployments#managed-disks-template-formatting

HOL - unguided

Whichever format you chose in the step-by-step lab for the "Note: … " please continue that formatting in the unguided lab.

WDS - trainer & student guide

I'm curious why, in .md, some of the text goes all the way across the screen, others wrap half way through. When I'm looking at the documents in GitHub, the wraps aren't unusual but I'm concerned how that will affect the HTML documents. Do those short wraps need to be removed?

HOL step-by-step & unguided

Help references table - First line is not correct. The link is in the box below the description instead of next to it.

HOL Step-by-step (step 13)

Step 13 - The image is not correct. We already eliminated the name and vhd reference for osDisk in step 12, also, datadisks definition in the image is showing a different code than instructed.

WDS - Trainer & student guide

Objection # 5 starts with: The sun never sets on Lucerne Publishing. I'm not sure how/if that phrase will translate to other regions/languages. It should be removed.