The MGN-Toolkit is a set of PowerShell scripts developed to run multiple checks for common MGN related tasks to help migrating to AWS.

PS C:\Users\Administrator\desktop\MGN-toolkit\Windows> Import-Module .\MGN-Toolkit.psd1;invoke-mgntoolkit -SpeedTestIP 107.22.91.96 -WriteOpsTimer 30
Checking prerequisites before executing the MGN Toolkit...
[2023-10-26T08:56:34.2798000-04:00] [INFO] Code is running as administrator...
[2023-10-26T08:56:34.2954000-04:00] [INFO] Server Version 6.1.7601 is compatible with this module...
[2023-10-26T08:56:34.3110000-04:00] [INFO] The PowerShell Version 3 is compatible with this module - Executing script
[2023-10-26T08:56:34.3110000-04:00] [INFO] Creating logs directory - C:\Users\Administrator\desktop\MGN-toolkit\Windows\logs\
[2023-10-26T08:56:34.3266000-04:00] [INFO] Logs available at C:\Users\Administrator\desktop\MGN-toolkit\Windows\logs\MGNToolkit_2023-10-26T08-56-34.log
[2023-10-26T08:56:34.3422000-04:00] [INFO] Outputs available at C:\Users\Administrator\desktop\MGN-toolkit\Windows\Outputs\MGNToolkit_2023-10-26T08-56-34.txt
Running all the tests can take a few minutes...
    __  ___ ______ _   __   ______               __ __    _  __
   /  |/  // ____// | / /  /_  __/____   ____   / // /__ (_)/ /_
  / /|_/ // / __ /  |/ /    / /  / __ \ / __ \ / // //_// // __/
 / /  / // /_/ // /|  /    / /  / /_/ // /_/ // // ,<  / // /_
/_/  /_/ \____//_/ |_/    /_/   \____/ \____//_//_/|_|/_/ \__/
Please follow the following documentation to create the Speed Test instance before proceeding with the Bandwidth Test: https://docs.aws.amazon.com/mgn/latest/ug/Replication-Related-FAQ.html#perform-connectivity-bandwidth-test

Check                         Value         Action
-----                         -----         ------
AD Domain Controller          [GREEN]         No action required. The Active directory role can not be found.
Antivirus                     [GREEN]         No action required. No antivirus can be found or enabled.
BitLocker                     [GREEN]         No action required. BitLocker is not available on this system.
Boot Mode                     [YELLOW]        The Boot Disk is Basic, and the Boot Mode is Legacy BIOS. Select the Legacy BIOS option for Boot Mode during Target Launch - https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-boot.html
Root Disk Free Space          [GREEN]         No action required. There is 102.278 GB free space on C drive.
Authentication method         [YELLOW]        This host is not part of a domain. If the current user is part of the Administrators group, you can use it to RDP to server after migration.
.NET Framework Version        [GREEN]         No action required. .NET Framework 4.8.03761 is installed
Free RAM                      [GREEN]         No action required. The system has 2166 MB of RAM free RAM
Trusted Root Certificates     [RED]           Please ensure the Certificates which are showing a status of 'False' are installed by following our documentation here - https://docs.aws.amazon.com/mgn/latest/ug/Troubleshooting-Agent-Issues.html#error-certificate-verify-failed
SC.exe and NET.exe            [GREEN]         No action required. Both sc.exe (service control executable) and net.exe (net command executable) exist in C:\Windows\System32.
WMI Service Status            [GREEN]         No action required. WMI Service is running.
Proxy Settings                [GREEN]         No action required. There is no Proxy settings configured can be found.
Endpoints Connectivity        [GREEN]         No action required. All endpoints are reachable.
Upload Bandwidth              [YELLOW]        The Bandwidth Upload speed was Upload rate:515.00 Mbps. Compare this Bandwidth result with the results from the Check-DiskActivity cmdlet during a time of high disk activity to ensure the bandwidth is sufficient.
Disk Write Activity Average   [YELLOW]        The average for Disk Write Activity was 0.1848 Mbps. Compare this result with the Upload results from the Check-Bandwidth function to ensure it is sufficient.
Disk Write Activity Maximum   [YELLOW]        The Max for Disk Write Activity was 1.1241 Mbps. Ensure your Staging Area disk settings will be sufficient if there are frequent maximum spikes of this value, to avoid Replication Backlog

• PowerShell 3.0 or above
• Local Administrator account
• Microsoft Windows Server 2008R2 and above

1. Clone the repo.

2. Depending on the use-case, run the one of the following as an Administrator in PowerShell.

   Run all checks

   Switches

   • Region : Optional. Used to specify the desired region. By default the module will run in us-east-1.
   • SpeedTestIP : Optional. The Ipaddress of the speed test server. By default Get-Bandwidth is not invoked.
   • WriteOpsTimer : Optional. The number of seconds to calculate IOPS. By default WriteOpsTimer is 20 seconds.
   • MgnVpceId: Optional. If you are using a VPC Endpoint for MGN, you can specify the Endpoint ID + Suffix for the Endpoint connectivity test. Please enter the VPC Endpoint Id and suffix from the DNS names.
   • S3VpceId: Optional. If you are using a VPC Endpoint for S3, you can specify the Endpoint ID + Suffix for the Endpoint connectivity test. Please enter the VPC Endpoint Id and suffix from the DNS names.
   • List: Optional. The output will be generated using the Format-List method. By default the module will use Format-Table.
   • GridView : Optional. The output will be generated using the Out-GridView method. By default the module will use Format-Table.

   Examples with switches added

   Import-Module .\MGN-Toolkit.psm1;Invoke-MGNToolkit -region <region>
   Import-Module .\MGN-Toolkit.psm1;Invoke-MGNToolkit -region <region> -MgnVpceId <vpce-id>-<suffix> -S3VpceId <vpce-id>-<suffix>
   Import-Module .\MGN-Toolkit.psm1;Invoke-MGNToolkit -region <region> -SpeedTestIP <IP-Address> -List
   Import-Module .\MGN-Toolkit.psm1;Invoke-MGNToolkit -region <region> -WriteOpsTimer <Seconds> -GridView
   Import-Module .\MGN-Toolkit.psm1;Invoke-MGNToolkit -region <region> -SpeedTestIP <IP-Address> -WriteOpsTimer <Seconds>
   

   All checks in us-east-2 region

   Import-Module .\MGN-Toolkit.psm1;Invoke-MGNToolkit -SpeedTestIP 1.1.1.1 -WriteOpsTimer 20 -region us-east-2
   Import-Module .\MGN-Toolkit.psm1;Invoke-MGNToolkit -SpeedTestIP 1.1.1.1 -WriteOpsTimer 20 -region us-east-2 -List
   Import-Module .\MGN-Toolkit.psm1;Invoke-MGNToolkit -SpeedTestIP 1.1.1.1 -WriteOpsTimer 20 -region us-east-2 -GridView
   Import-Module .\MGN-Toolkit.psm1;Invoke-MGNToolkit -SpeedTestIP 1.1.1.1 -WriteOpsTimer 20 -region us-east-2 -MgnVpceId vpce-12345678910111213-abcd1234 -S3VpceId vpce-12345678910111213-abcd1234

   Run specific check

   To learn more about each check please reference the check table below.

   AD Domain Controller or Authentication method

   Import-Module .\MGN-Toolkit.psm1
   $Output = New-Object -TypeName "System.Collections.ArrayList"
   $productType = (Get-CimInstance -ClassName Win32_OperatingSystem).ProductType
   Get-DomainControllerStatus -product $productType
   $Output | ForEach { [PSCustomObject]$_ } | Format-Table -Wrap

   Upload Bandwidth

   Import-Module .\MGN-Toolkit.psm1
   $Output = New-Object -TypeName "System.Collections.ArrayList"
   Get-Bandwidth -SpeedTestIP 1.1.1.1
   $Output | ForEach { [PSCustomObject]$_ } | Format-Table -Wrap

   Disk Write Activity Average and Maximum

   Import-Module .\MGN-Toolkit.psm1
   $Output = New-Object -TypeName "System.Collections.ArrayList"
   Get-DiskActivity -Seconds 30
   $Output | ForEach { [PSCustomObject]$_ } | Format-Table -Wrap

   Test endpoints reachability

   Import-Module .\MGN-Toolkit.psm1
   $Output = New-Object -TypeName "System.Collections.ArrayList"
   $Region = "us-east-1"
   $MgnVpceId = ""
   $S3VpceId = ""
   (Test-EndpointsNetworkAccess -region $Region -mgnVpceId $MgnVpceId -s3VpceId $S3VpceId) | Out-Null
   $Output | ForEach { [PSCustomObject]$_ } | Format-Table -Wrap

   For all other functions use the method below with the appropriate function name

   Import-Module .\MGN-Toolkit.psm1
   $Output = New-Object -TypeName "System.Collections.ArrayList"
   <function name>
   $Output | ForEach { [PSCustomObject]$_ } | Format-Table -Wrap

1. Run the following sample code as an Administrator in PowerShell to download the ZIP file included in this package, extract and execute the toolkit.

   • Adjust the last line as needed with the desired parameters mentioned here

   #MGN-Toolkit
   $uri = 'https://github.com/awslabs/aws-support-tools/archive/refs/heads/master.zip'
   $destination = (Get-Location).Path
   if ((Test-Path -Path "$destination\aws-support-tools-master.zip" -PathType Leaf) -or (Test-Path -Path "$destination\aws-support-tools-master")) {
       write-host "File $destination\aws-support-tools-master.zip or folder $destination\aws-support-tools-master found, exiting"
   }else {
       Write-host "Enable TLS 1.2 for this PowerShell session only."
       [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
       $webClient = New-Object System.Net.WebClient
       Write-host "Downloading aws-support-tools-master.zip"
       $webClient.DownloadFile($uri, "$destination\aws-support-tools-master.zip")
       Write-host "aws-support-tools-master.zip download successfully"
       Add-Type -Assembly "system.io.compression.filesystem"
       [System.IO.Compression.ZipFile]::ExtractToDirectory("$destination\aws-support-tools-master.zip","$destination\aws-support-tools-master")
       Write-host "Extracting aws-support-tools-master.zip complete successfully"
       Import-Module "$destination\aws-support-tools-master\aws-support-tools-master\MGN\Windows\MGN-Toolkit.psm1"; Invoke-MGNToolkit
   }

PowerShell 3.0

• Thanks to Imthian Ramgobin for helping.

• Ali Alzand
• Tim Hall