更新 Azure Stack Hub 中的 MySQL 资源提供程序

当 Azure Stack Hub 发布新版本时，我们可以发布新的 MySQL 资源提供程序适配器。 虽然现有适配器可以继续使用，但我们建议尽快更新到最新版本。

更新 MySQL 服务器资源提供程序 V2

如果已部署 MySQL RP V2，并且想要检查更新，请检查 如何将更新应用到资源提供程序。

如果要从 MySQL RP V1 更新到 MySQL RP V2，请确保先更新到 MySQL RP V1.1.93.x，然后应用主要版本升级过程，以便从 MySQl RP V1 升级到 MySQL RP V2。

从 MySQL RP V1.1.93.x 更新到 MySQL RP V2.0.6.0

先决条件

1. 请确保将 MySQL RP V1 更新到最新的 1.1.93.x。 在 “默认提供程序订阅”下，找到 RP 资源组（命名格式：system.<region>.mysqladapter）。 确认资源组中的版本标记和 MySQL RP VM 名称。 如果仍处于旧版本，并且需要更新到 1.1.93.x，请打开支持案例以获取帮助。

2. 建立支持案例以获取 MajorVersionUpgrade 包，并将订阅添加到未来 V2 版本的 ASH 市场允许列表中。

3. 将 Microsoft AzureStack Add-On RP Windows Server 1.2009.0 下载到市场。

4. 确保 Azure Stack Hub 满足数据中心集成先决条件。

   先决条件	参考文献
   条件 DNS 转发已正确设置。	Azure Stack Hub 数据中心集成 - DNS
   资源提供程序的入站端口处于打开状态。	Azure Stack Hub 数据中心集成 - 端口和协议入站
   PKI 证书主题和 SAN 已正确设置。	Azure Stack Hub 部署必需的 PKI 先决条件 Azure Stack Hub 部署 PaaS 证书先决条件

5. （对于断开连接的环境）安装所需的 PowerShell 模块，类似于用于 部署 MySQL 资源提供程序的更新过程。

6. 准备好具有所需版本的 MySQL 连接器 URI。 有关详细信息，请参阅 部署 MySQL 资源提供程序。 例如，https://<storageAcountName>.blob.<region>.<FQDN>/<containerName>/mysql-connector-net-8.0.21.msi

触发 MajorVersionUpgrade

从提升的 PowerShell 控制台运行以下脚本以执行主版本升级。

# Check Operating System version
$osVersion = [environment]::OSVersion.Version
if ($osVersion.Build -lt 10240)
{
    Write-Host "OS version is too old: $osVersion."
    return
}

$osArch = (Get-WmiObject Win32_OperatingSystem).OSArchitecture
if ($osArch -ne "64-bit")
{
    Write-Host "OS Architecture is not 64 bit."
    return
}

# Check LongPathsEnabled registry key
$regPath = 'HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem'
$longPathsEnabled = 'LongPathsEnabled'
$property = Get-ItemProperty -Path $regPath -Name $longPathsEnabled -ErrorAction Stop
if ($property.LongPathsEnabled -eq 0)
{
    Write-Host "Detect LongPathsEnabled equals to 0, prepare to set the property."
    Set-ItemProperty -Path $regPath -Name $longPathsEnabled -Value 1 -ErrorAction Stop
    Write-Host "Set the long paths property, please restart the PowerShell."
    return
} 

# Use the NetBIOS name for the Azure Stack Hub domain. 
$domain = "YouDomain" 
# For integrated systems, use the IP address of one of the ERCS VMs
$privilegedEndpoint = "YouDomain-ERCS01"
# Provide the Azure environment used for deploying Azure Stack Hub. Required only for Azure AD deployments.
$AzureEnvironment = "AzureChinaCloud"
# Point to the directory where the resource provider installation files were extracted.
$tempDir = 'C:\extracted-folder\MajorVersionUpgrade-MySQLRP'
# The service admin account can be Azure Active Directory or Active Directory Federation Services.
$serviceAdmin = "admin@mydomain.partner.onmschina.cn"
$AdminPass = ConvertTo-SecureString 'xxxxxxxx' -AsPlainText -Force
$AdminCreds = New-Object System.Management.Automation.PSCredential ($serviceAdmin, $AdminPass)
# Add the cloudadmin credential that's required for privileged endpoint access.
$CloudAdminPass = ConvertTo-SecureString 'xxxxxxxx' -AsPlainText -Force
$CloudAdminCreds = New-Object System.Management.Automation.PSCredential ("$domain\cloudadmin", $CloudAdminPass)
# Change the following as appropriate.
$PfxPass = ConvertTo-SecureString 'xxxxxxx' -AsPlainText -Force
# Provide the pfx file path
$PfxFilePath = "C:\tools\mysqlcert\SSL.pfx"
# Local blob uri where stores the required mysql connector
$MySQLConnector = "Provide the MySQL Connector Uri according to Prerequisites step."
# PowerShell modules used by the RP MajorVersionUpgrade are placed in C:\Program Files\SqlMySqlPsh
# The deployment script adds this path to the system $env:PSModulePath to ensure correct modules are used.
$rpModulePath = Join-Path -Path $env:ProgramFiles -ChildPath 'SqlMySqlPsh'
$env:PSModulePath = $env:PSModulePath + ";" + $rpModulePath 
. $tempDir\MajorVersionUpgradeMySQLProvider.ps1 -AzureEnvironment $AzureEnvironment -AzCredential $AdminCreds -CloudAdminCredential $CloudAdminCreds -Privilegedendpoint $privilegedEndpoint -PfxPassword $PfxPass -PfxCert $PfxFilePath -MySQLConnector $MySQLConnector

验证升级是否成功

1. 执行 MajorVersionUpgrade 脚本时没有任何错误。
2. 检查市场中的资源提供程序，并确保已成功安装 MySQL RP 2.0。
3. 默认提供程序订阅中的旧 system.<location>.mysqladapter 资源组和 system.<location>.dbadapter.dns 资源组不会被脚本自动删除。

• 建议在 mysqladapter 资源组中保留存储帐户和 Key Vault 一段时间。 如果在升级后，任何用户观察到数据库或登录元数据不一致，可以获得支持来从资源组还原元数据。
• 验证 dbadapter.dns 资源组中的 DNS 区域是否为空且没有 DNS 记录后，可以安全地删除 dbadapter.dns 资源组。
• [重要提示]请勿使用 V1 部署脚本卸载 V1 版本。 升级完成后，确认升级成功，可以从提供程序订阅手动删除资源组。

从 MySQL RP V1 早期版本更新到 MySQL RP V1.1.93.x

MySQL 资源提供程序 V1 更新是累积型的。 可以直接更新到 1.1.93.x 版本。

若要将资源提供程序更新为 1.1.93.x，请使用 UpdateMySQLProvider.ps1 脚本。 使用具有本地管理权限且是订阅的所有者的服务帐户。 此更新脚本包含在资源提供程序下载中。

若要更新资源提供程序，请使用 UpdateMySQLProvider.ps1 脚本。 使用具有本地管理权限且是订阅的所有者的服务帐户。 更新脚本包含在资源提供程序下载中。

更新过程类似于用于 部署资源提供程序的过程。 更新脚本使用与 DeployMySqlProvider.ps1 脚本相同的参数，需要提供证书信息。

更新脚本进程

UpdateMySQLProvider.ps1 脚本使用最新的 OS 映像创建新的虚拟机（VM），部署最新的资源提供程序代码，并将设置从旧资源提供程序迁移到新的资源提供程序。

UpdateMySQLProvider.ps1 脚本创建新 VM 后，该脚本将从旧的资源提供程序 VM 迁移以下设置：

• 数据库信息
• 托管服务器信息
• 所需的 DNS 记录

更新脚本参数

运行 UpdateMySQLProvider.ps1 PowerShell 脚本时，请从命令行指定以下参数。 如果没有，或者任何参数验证失败，系统会提示你提供所需的参数。

更新脚本示例

如果要将 MySQL 资源提供程序版本更新为 1.1.33.0 或以前的版本，则需要在 PowerShell 中安装特定版本的 AzureRm.BootStrapper 和 Azure Stack Hub 模块。

如果要将 MySQL 资源提供程序更新到版本 1.1.47.0 或更高版本，则可以跳过此步骤。 部署脚本将自动下载并安装所需的 PowerShell 模块，并设置路径为 C:\Program Files\SqlMySqlPsh。

# Run the following scripts when updating to version 1.1.33.0 only.
# Install the AzureRM.Bootstrapper module, set the profile and install the AzureStack module.
# Note that this might not be the most currently available version of Azure Stack Hub PowerShell.
Install-Module -Name AzureRm.BootStrapper -Force
Use-AzureRmProfile -Profile 2018-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.6.0

以下示例演示可以通过权限提升的 PowerShell 控制台运行的 UpdateMySQLProvider.ps1 脚本。 根据需要务必更改可变信息和密码。

# Use the NetBIOS name for the Azure Stack Hub domain. On the Azure Stack Hub SDK, the default is AzureStack but could have been changed at install time.
$domain = "AzureStack" 

# For integrated systems, use the IP address of one of the ERCS VMs.
$privilegedEndpoint = "AzS-ERCS01" 

# Provide the Azure environment used for deploying Azure Stack Hub. Required only for Azure AD deployments. Supported environment name is  AzureChinaCloud. 
$AzureEnvironment = "<EnvironmentName>"

# Point to the directory where the resource provider installation files were extracted. 
$tempDir = 'C:\TEMP\MYSQLRP' 

# The service admin account (can be Azure Active Directory or Active Directory Federation Services).
$serviceAdmin = "admin@mydomain.partner.onmschina.cn" 
$AdminPass = ConvertTo-SecureString 'P@ssw0rd1' -AsPlainText -Force 
$AdminCreds = New-Object System.Management.Automation.PSCredential ($serviceAdmin, $AdminPass) 
 
# Set credentials for the new resource provider VM.
$vmLocalAdminPass = ConvertTo-SecureString 'P@ssw0rd1' -AsPlainText -Force 
$vmLocalAdminCreds = New-Object System.Management.Automation.PSCredential ("mysqlrpadmin", $vmLocalAdminPass) 
 
# And the cloudadmin credential required for privileged endpoint access.
$CloudAdminPass = ConvertTo-SecureString 'P@ssw0rd1' -AsPlainText -Force 
$CloudAdminCreds = New-Object System.Management.Automation.PSCredential ("$domain\cloudadmin", $CloudAdminPass) 

# Change the following as appropriate.
$PfxPass = ConvertTo-SecureString 'P@ssw0rd1' -AsPlainText -Force 

# For version 1.1.47.0 or later, the PowerShell modules used by the RP deployment are placed in C:\Program Files\SqlMySqlPsh
# The deployment script adds this path to the system $env:PSModulePath to ensure correct modules are used.
$rpModulePath = Join-Path -Path $env:ProgramFiles -ChildPath 'SqlMySqlPsh'
$env:PSModulePath = $env:PSModulePath + ";" + $rpModulePath 

# Change directory to the folder where you extracted the installation files.
# Then adjust the endpoints.
.$tempDir\UpdateMySQLProvider.ps1 -AzCredential $AdminCreds -VMLocalCredential $vmLocalAdminCreds -CloudAdminCredential $cloudAdminCreds -PrivilegedEndpoint $privilegedEndpoint -AzureEnvironment $AzureEnvironment -DefaultSSLCertificatePassword $PfxPass -DependencyFilesLocalPath $tempDir\cert -AcceptLicense

资源提供程序更新脚本完成后，关闭当前的 PowerShell 会话。

后续步骤

维护 MySQL 资源提供程序