Actualización del proveedor de recursos MySQL en Azure Stack Hub

Cuando Azure Stack Hub publica una nueva compilación, es posible que publiquemos un nuevo adaptador del proveedor de recursos MySQL. Aunque el adaptador existente sigue funcionando, se recomienda actualizar a la compilación más reciente lo antes posible.

Actualización del proveedor de recursos de MySQL Server V2

Si ya ha implementado MySQL RP V2 y desea comprobar si hay actualizaciones, consulte Cómo aplicar actualizaciones al proveedor de recursos.

Si desea actualizar de MySQL RP V1 a MySQL RP V2, asegúrese de actualizar primero a MySQL RP V1.1.93.x, aplique el proceso de actualización de la versión principal para actualizar de MySQl RP V1 a MySQL RP V2.

Actualización de MySQL RP V1.1.93.x a MySQL RP V2.0.6.0

Prerrequisitos

1. Asegúrese de actualizar MySQL RP V1 a la versión 1.1.93.x más reciente. En Suscripción de proveedor predeterminada, busque el grupo de recursos RP (formato de nomenclatura: system.<region>). mysqladapter). Confirme la etiqueta de versión y el nombre de máquina virtual de MySQL RP en el grupo de recursos. Si todavía está en una versión anterior y necesita actualizar a 1.1.93.x, abra un caso de soporte técnico para obtener ayuda.

2. Abra un caso de soporte técnico para obtener el paquete MajorVersionUpgrade y agregue la suscripción a la lista de permitidos de ASH Marketplace para la versión V2 futura.

3. Descargue Microsoft AzureStack Add-On RP Windows Server 1.2009.0 en Marketplace.

4. Asegúrese de que Azure Stack Hub cumple los requisitos previos de integración del centro de datos.

   Prerrequisito	Referencia
   El reenvío DNS condicional se ha establecido correctamente.	Integración del centro de datos de Azure Stack Hub: DNS
   Los puertos de entrada para los proveedores de recursos están abiertos.	Integración del centro de datos de Azure Stack Hub: puertos y protocolos entrantes
   El firmante del certificado PKI y SAN se establecen correctamente.	Requisitos previos de PKI obligatorios de implementación de Azure Stack Hub Requisitos previos del certificado PaaS de implementación de Azure Stack Hub

5. (para entornos desconectados) Instale los módulos de PowerShell necesarios, similar al proceso de actualización que se usa para implementar el proveedor de recursos mySQL.

6. Prepare el URI del conector mySQL con la versión necesaria. Para más información, consulte Implementación del proveedor de recursos MySQL. Por ejemplo, https://< storageAcountName.blob>.<región>.<FQDN>/<containerName>/mysql-connector-net-8.0.21.msi

Desencadenar MajorVersionUpgrade

Ejecute el siguiente script desde una consola de PowerShell con privilegios elevados para realizar la actualización de la versión principal.

# 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. Supported values for the <environment name> parameter are AzureCloud, AzureChinaCloud, or AzureUSGovernment depending which Azure subscription you're using.
$AzureEnvironment = "AzureCloud"
# 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.onmicrosoft.com"
$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

Validar que la actualización se ha realizado correctamente

1. El script MajorVersionUpgrade se ejecutó sin errores.
2. Compruebe el proveedor de recursos en Marketplace y asegúrese de que MySQL RP 2.0 se ha instalado correctamente.
3. El antiguo sistema.<location.mysqladapter> resource group and system.<el script no eliminará automáticamente el grupo de recursos location.dbadapter.dns> de la suscripción de proveedor predeterminada.

• Se recomienda mantener la cuenta de almacenamiento y el almacén de claves en el grupo de recursos mysqladapter durante algún tiempo. Si después de la actualización, cualquier usuario de inquilino observa metadatos de inicio de sesión o base de datos incoherentes, es posible obtener soporte técnico para restaurar los metadatos del grupo de recursos.
• Después de comprobar que la zona DNS del grupo de recursos dbadapter.dns está vacía sin registro DNS, es seguro eliminar el grupo de recursos dbadapter.dns.
• [IMPORTANTE] No use el script de implementación V1 para desinstalar la versión V1. Después de completar la actualización y confirmar que la actualización se realizó correctamente, puede eliminar manualmente el grupo de recursos de la suscripción del proveedor.

Actualización de MySQL RP V1 versión anterior a MySQL RP V1.1.93.x

La actualización del proveedor de recursos de MySQL V1 es acumulativa. Puede actualizar directamente a la versión 1.1.93.x.

Para actualizar el proveedor de recursos a 1.1.93.x, use el script deUpdateMySQLProvider.ps1 . Use su cuenta de servicio con derechos administrativos locales y sea propietario de la suscripción. Este script de actualización se incluye con la descarga del proveedor de recursos.

Para actualizar el proveedor de recursos, use el script UpdateMySQLProvider.ps1 . Use su cuenta de servicio con derechos administrativos locales y sea propietario de la suscripción. El script de actualización se incluye con la descarga del proveedor de recursos.

El proceso de actualización es similar al proceso usado para implementar el proveedor de recursos. El script de actualización usa los mismos argumentos que el script de DeployMySqlProvider.ps1 y deberá proporcionar información de certificado.

Actualizar procesos de script

El script deUpdateMySQLProvider.ps1 crea una nueva máquina virtual con la imagen más reciente del sistema operativo, implementa el código de proveedor de recursos más reciente y migra la configuración del proveedor de recursos antiguo al nuevo proveedor de recursos.

Después de que el script deUpdateMySQLProvider.ps1 cree una nueva máquina virtual, el script migra la siguiente configuración de la máquina virtual del proveedor de recursos anterior:

• información de base de datos
• hospedaje de información del servidor
• registro DNS requerido

Actualizar parámetros de script

Especifique los parámetros siguientes desde la línea de comandos al ejecutar el script de PowerShell UpdateMySQLProvider.ps1 . Si no lo hace o si se produce un error en la validación de parámetros, se le pedirá que proporcione los parámetros necesarios.

Ejemplo de script de actualización

Si va a actualizar la versión del proveedor de recursos mySQL a la versión 1.1.33.0 o versiones anteriores, debe instalar versiones específicas de los módulos AzureRm.BootStrapper y Azure Stack Hub en PowerShell.

Si va a actualizar el proveedor de recursos de MySQL a la versión 1.1.47.0 o posterior, puede omitir este paso. El script de implementación descargará e instalará automáticamente los módulos de PowerShell necesarios para la ruta de acceso C:\Archivos de programa\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

En el ejemplo siguiente se muestra el script deUpdateMySQLProvider.ps1 que puede ejecutar desde una consola de PowerShell con privilegios elevados. Asegúrese de cambiar la información de variable y las contraseñas según sea necesario:

# 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 names are AzureCloud, AzureUSGovernment, or 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.onmicrosoft.com" 
$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

Cuando finalice el script de actualización del proveedor de recursos, cierre la sesión actual de PowerShell.

Pasos siguientes

Mantenimiento del proveedor de recursos mySQL