RiverMeadow.Release.Migrate

1.0.116.287

Common/Common.psm1

using module './Result'
Import-Module -Name @(Join-Path $PSScriptRoot Wrappers | Join-Path -ChildPath Wrappers)
Import-Module -Name @(Join-Path $PSScriptRoot .. | Join-Path -ChildPath Util | Join-Path -ChildPath Util)
Import-Module -Name @(Join-Path $PSScriptRoot .. | Join-Path -ChildPath Util | Join-Path -ChildPath MigrationUtil)
Import-Module -Name @(Join-Path $PSScriptRoot .. | Join-Path -ChildPath RiverMeadow.Release.Source | Join-Path -ChildPath SourceUtil | Join-Path -ChildPath SourceUtil)
function Confirm-RMCommonParameter {
    param (
        [hashtable] $UserParameter
    )
    $Errors = @()
    $Warnings = @()
    $IsSourceAndTargetCloudPresent = $true
    if (!$UserParameter.ContainsKey("TargetCloud") -or [string]::IsNullOrEmpty($UserParameter["TargetCloud"])) {
        $Errors += "TargetCloud is required"
        $IsSourceAndTargetCloudPresent = $false
    }
    if (!$UserParameter.ContainsKey("SourceIP") -or [string]::IsNullOrEmpty($UserParameter["SourceIP"])) {
        $Errors += "SourceIP is required"
        $IsSourceAndTargetCloudPresent = $false
    } else {
        $IsValidIPAddress = Confirm-RMIPAddress -IPAddress $UserParameter.SourceIP
        if (!$IsValidIPAddress) {
            $Errors += "Invalid Source IP address."
            $IsSourceAndTargetCloudPresent = $false
        }
    }

    if (!$UserParameter.ContainsKey("TargetVMName") -or [string]::IsNullOrEmpty($UserParameter["TargetVMName"])) {
        $Warnings += "TargetVMName has not been provided, source hostname will be used as the target VM name"
    }

    $Errors += Confirm-RMSchedule -UserParameter $UserParameter
    return $Errors, $Warnings, $IsSourceAndTargetCloudPresent
}

function Confirm-RMVMBasedCommonParameter {
    param (
        [hashtable] $UserParameter
    )
    $Errors = @()
    $Warnings = @()
    $IsSourcePresent = $true
    if (!$UserParameter.ContainsKey("SourceVMName") -or [string]::IsNullOrEmpty($UserParameter["SourceVMName"])) {
        $Errors += "SourceVMName is required"
        $IsSourcePresent = $false
    } elseif (!$UserParameter.ContainsKey("TargetVMName") -or [string]::IsNullOrEmpty($UserParameter["TargetVMName"])) {
        $Warnings += "TargetVMName has not been provided, source hostname will be used as the target VM name"
    }

    if (!$UserParameter.ContainsKey("TargetCloud") -or [string]::IsNullOrEmpty($UserParameter["TargetCloud"])) {
        $Errors += "TargetCloud is required"
        $IsSourcePresent = $false
    }

    $Errors += Confirm-RMSchedule -UserParameter $UserParameter
    return $Errors, $Warnings, $IsSourcePresent
}

function Confirm-RMVMBasedDMCommonParameter {
    param(
        [hashtable] $UserParameter
    )
    $Errors = @()
    $IsValidMigrationId = $true
    if (!$UserParameter.ContainsKey("MigrationId") -or [string]::IsNullOrWhiteSpace($UserParameter["MigrationId"])) {
        $Errors += "MigrationId is required"
        $IsValidMigrationId = $false
    }

    if ($UserParameter.ContainsKey("RunContinuous") `
            -and $UserParameter.ContainsKey("ScheduledAt") `
            -and ![string]::IsNullOrWhiteSpace($UserParameter["ScheduledAt"])) {
        $Errors += "Parameters 'RunContinuous' and 'ScheduledAt' cannot be used at the same time."
    }
    
    $Errors += Confirm-RMSchedule -UserParameter $UserParameter
    return $Errors, $IsValidMigrationId
}

function Confirm-RMSchedule {
    param(
        [hashtable] $UserParameter
    )
    $Errors = @()
    if ($UserParameter.ContainsKey("ScheduledAt") -or ![string]::IsNullOrEmpty($UserParameter["ScheduledAt"])) {
        $IsValidDateTime = Confirm-RMDateFormat -InputDate $UserParameter["ScheduledAt"] -DateFormat "MM/dd/yyyy HH:mm"
        if ($IsValidDateTime) {
            if (!(Confirm-RMAfterCurrentDateTime -InputDateTime $UserParameter["ScheduledAt"])) {
                $Errors += "ScheduledAt date and time should be greater than the current date and time"
            }
        } else {
            $Errors += "ScheduledAt should have the date and time in the format 'MM/dd/yyyy HH:mm' with valid values for date and time"
        }
    }

    return $Errors
}

function Confirm-RMCommonParameterWithSource {
    param (
        [hashtable] $UserParameter,
        [System.Object] $Source,
        [System.Object] $SourceSQLServerMapping
    )
    $Errors = @()
    if ($UserParameter.ContainsKey("MountPoints") -and $UserParameter["MountPoints"].Count -gt 0) {
        $SourceMountPoints = Get-MountPoint -Source $Source
        $Errors += Compare-RMMountPoint -Source $Source -SourceMountPoints $SourceMountPoints.Values `
            -UserInputMountPoints $UserParameter["MountPoints"] -ParameterName "MountPoints"

        $NonExistsMountPoints = Test-RMNonExistentMountPoints -SourceMountPoints $SourceMountPoints.Values -UserInputMountPoints $UserParameter["MountPoints"]
        if ($NonExistsMountPoints.Count -gt 0) {
            $NonExistsMountPointsAsString =  $NonExistsMountPoints -join ", "
            $Errors += "'$NonExistsMountPointsAsString' does not exist on the source."
        }
    }

    if ($UserParameter.ContainsKey("UpgradeOSVersion") -and ![string]::IsNullOrEmpty($UserParameter["UpgradeOSVersion"])) {
        $UpgradeOSVersion = $UserParameter["UpgradeOSVersion"]
        $SourceOSMMapping = Get-RMOSMMappingBySource -Source $Source
        if ($SourceOSMMapping.Keys.Count -eq 0) {
            $Errors += "No OS upgrade options are available for the given source OS"
            return $Errors
        }
        $OSMLabels = $SourceOSMMapping.keys -join ", "
        $UpgradeOSVersion = $UpgradeOSVersion.Trim('"')
        $UpgradeOSVersion = $UpgradeOSVersion.Trim("'")
        if ($SourceOSMMapping.keys -notcontains $UpgradeOSVersion) {
            $Errors += "UpgradeOSVersion should be one of '$OSMLabels'"
        }
    }

    if ($UserParameter.ContainsKey("UpgradeSQLServer") -and ![string]::IsNullOrWhiteSpace($UserParameter["UpgradeSQLServer"])) {
        if ($SourceSQLServerMapping.Count -eq 0) {
            $Errors += "No SQL upgrade options are available for the given source OS"
        }

        $UpgradeSQLServer = $UserParameter["UpgradeSQLServer"]
        $UpgradeSQLServer.InstanceName | Group-Object | ForEach-Object { if ($_.Count -gt 1) {
            $Errors += "In the 'UpgradeSQLServer' object, 'InstanceName' should be unique."
        }}

        if ($UpgradeSQLServer.InstanceName.Count -gt $UpgradeSQLServer.UpgradeVersion.Count) {
            $Errors += "In the 'UpgradeSQLServer' object 'UpgradeVersion' is required for each SQL instance."
        } elseif ($UpgradeSQLServer.InstanceName.Count -ne $UpgradeSQLServer.UpgradeVersion.Count) {
            $Errors += "In the 'UpgradeSQLServer' object 'InstanceName' is required for each 'UpgradeVersion'."
        }

        foreach($Upgrade in $UpgradeSQLServer) {
            if ($SourceSQLServerMapping.instance_name -notcontains $Upgrade.InstanceName) {
                $InstanceName = $Upgrade.InstanceName
                $Errors += "Instance '$InstanceName' does not exist."
            } else {
                foreach($SQLServerObject in $SourceSQLServerMapping) {
                    if ($Upgrade.InstanceName -ieq $SQLServerObject.instance_name -and
                            $SQLServerObject.upgrade_options -notcontains $Upgrade.UpgradeVersion) {
                        $UpgradeVersion = $Upgrade.UpgradeVersion
                        $Errors += "Upgrade Version '$UpgradeVersion' does not exist."
                    }
                }
            }
        }
    }

    return $Errors
}

function Out-RMUserParameterResult {
    param (
        [string[]] $ErrorMessage,
        [string[]] $WarningMessage
    )

    foreach ($Warning in $WarningMessage) {
        Write-Warning -Message $Warning
    }

    if ($ErrorMessage.Count -eq 0) {
        return
    }

    foreach ($Error in $ErrorMessage) {
        Write-RMError -Message $Error
    }
}

function Update-RMMigrationReturnAsSuccess {
    param(
        [System.Object] $MigrationResponse,
        [bool] $IsScheduledMigration,
        [string] $ReturnMessage,
        [RMMigrationReturn] $RMMigrationReturn
    )
    if ($IsScheduledMigration) {
        Write-Output "Migration scheduled successfully" | Out-Host
        $RMMigrationReturn.SetReturnCode([RMReturn]::SUCCESS)
        return $RMMigrationReturn
    }
   
    $MigrationId = Get-RMMigrationIdFromResponse -Response $MigrationResponse
    Write-Output "$ReturnMessage : $MigrationId" | Out-Host
    $RMMigrationReturn.SetMigrationId($MigrationId)
    $RMMigrationReturn.SetReturnCode([RMReturn]::SUCCESS)
    return $RMMigrationReturn
}

function Update-RMMigrationReturnAsError {
    param(
        [string] $Message,
        [RMMigrationReturn] $RMMigrationReturn
    )
    Write-RMError -Message $Message
    $RMReturn = [RMReturn]::new([RMReturn]::ERROR, [RMError]::new($Message), $null, $null)
    $RMMigrationReturn.SetRMReturn($RMReturn)
    return $RMMigrationReturn
}