Mettre à jour le fournisseur de ressources MySQL dans Azure Stack Hub

Quand Azure Stack Hub publie une nouvelle build, nous pouvons publier un nouvel adaptateur de fournisseur de ressources MySQL. Bien que l’adaptateur existant continue de fonctionner, nous vous recommandons de mettre à jour vers la dernière build dès que possible.

Mettre à jour le fournisseur de ressources MySQL Server V2

Si vous avez déjà déployé MySQL RP V2 et souhaitez rechercher les mises à jour, vérifiez comment appliquer des mises à jour au fournisseur de ressources.

Si vous souhaitez effectuer une mise à jour à partir de MySQL RP V1 vers MySQL RP V2, veillez à effectuer la première mise à jour vers MySQL RP V1.1.93.x, puis appliquez le processus de mise à niveau de version principale pour effectuer la mise à niveau de MySQl RP V1 vers MySQL RP V2.

Mise à jour de MySQL RP V1.1.93.x vers MySQL RP V2.0.6.0

Conditions préalables

1. Veillez à mettre à jour MySQL RP V1 vers la dernière version 1.1.93.x. Sous Abonnement fournisseur par défaut, recherchez le groupe de ressources RP (format de nommage : system.<region>. mysqladapter). Confirmez la balise de version et le nom de la machine virtuelle MySQL RP dans le groupe de ressources. Si vous êtes toujours sur une ancienne version et que vous devez effectuer une mise à jour vers la version 1.1.93.x, ouvrez un cas de support pour obtenir de l’aide.

2. Ouvrez un cas de support pour obtenir le package MajorVersionUpgrade et ajoutez votre abonnement à la liste d’autorisation de la Place de marché ASH pour la future version V2.

3. Téléchargez Microsoft AzureStack Add-On RP Windows Server 1.2009.0 sur la Place de marché.

4. Vérifiez que votre azure Stack Hub répond aux conditions préalables à l’intégration du centre de données.

   Prérequis	Référence
   Le transfert DNS conditionnel est défini correctement.	Intégration du centre de données Azure Stack Hub - DNS
   Les ports entrants pour les fournisseurs de ressources sont ouverts.	Intégration du centre de données Azure Stack Hub - Ports et protocoles entrants
   Le sujet du certificat PKI et san sont correctement définis.	Conditions préalables obligatoires pour le déploiement d’Azure Stack Hub à clé publique Prérequis du certificat PaaS de déploiement Azure Stack Hub

5. (pour l’environnement déconnecté) Installez les modules PowerShell requis, comme le processus de mise à jour utilisé pour déployer le fournisseur de ressources MySQL.

6. Préparez l’URI du connecteur MySQL avec la version requise. Pour plus d’informations, reportez-vous au fournisseur de ressources MySQL. par exemple, https://< storageAcountName.blob>.<région>.<FQDN>/<containerName>/mysql-connector-net-8.0.21.msi

Déclencher MajorVersionUpgrade

Exécutez le script suivant à partir d’une console PowerShell avec élévation de privilèges pour effectuer une mise à niveau de version majeure.

# 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

Valider la réussite de la mise à niveau

1. Le script MajorVersionUpgrade s’exécute sans erreur.
2. Vérifiez le fournisseur de ressources sur la Place de marché et vérifiez que MySQL RP 2.0 a été installé correctement.
3. L’ancien système.<groupe de ressources et système location.mysqladapter>.<le groupe de ressources location.dbadapter.dns> dans l’abonnement fournisseur par défaut ne sera pas automatiquement supprimé par le script.

• Nous vous recommandons de conserver le compte de stockage et le coffre de clés dans le groupe de ressources mysqladapter pendant un certain temps. Si, après la mise à niveau, un utilisateur client observe des métadonnées de base de données ou de connexion incohérentes, il est possible de prendre en charge la restauration des métadonnées à partir du groupe de ressources.
• Après avoir vérifié que la zone DNS dans le groupe de ressources dbadapter.dns est vide sans enregistrement DNS, il est sûr de supprimer le groupe de ressources dbadapter.dns.
• [IMPORTANT] N’utilisez pas le script de déploiement V1 pour désinstaller la version V1. Une fois la mise à niveau terminée et la confirmation que la mise à niveau a réussi, vous pouvez supprimer manuellement le groupe de ressources de l’abonnement fournisseur.

Mettre à jour à partir de MySQL RP V1 version antérieure vers MySQL RP V1.1.93.x

La mise à jour V1 du fournisseur de ressources MySQL est cumulative. Vous pouvez directement effectuer une mise à jour vers la version 1.1.93.x.

Pour mettre à jour le fournisseur de ressources vers la version 1.1.93.x, utilisez le script UpdateMySQLProvider.ps1 . Utilisez votre compte de service avec des droits d’administration locaux et est propriétaire de l’abonnement. Ce script de mise à jour est inclus dans le téléchargement du fournisseur de ressources.

Pour mettre à jour le fournisseur de ressources, vous utilisez le script UpdateMySQLProvider.ps1 . Utilisez votre compte de service avec des droits d’administration locaux et est propriétaire de l’abonnement. Le script de mise à jour est inclus dans le téléchargement du fournisseur de ressources.

Le processus de mise à jour est similaire au processus utilisé pour déployer le fournisseur de ressources. Le script de mise à jour utilise les mêmes arguments que le script DeployMySqlProvider.ps1, et vous devez fournir des informations de certificat.

Mettre à jour les processus de script

Le script UpdateMySQLProvider.ps1 crée une machine virtuelle avec la dernière image du système d’exploitation, déploie le code du fournisseur de ressources le plus récent et migre les paramètres de l’ancien fournisseur de ressources vers le nouveau fournisseur de ressources.

Une fois que le script UpdateMySQLProvider.ps1 a créé une machine virtuelle, le script migre les paramètres suivants à partir de l’ancienne machine virtuelle du fournisseur de ressources :

• informations sur la base de données
• informations sur le serveur d’hébergement
• enregistrement DNS requis

Mettre à jour les paramètres de script

Spécifiez les paramètres suivants à partir de la ligne de commande lorsque vous exécutez le script PowerShell UpdateMySQLProvider.ps1 . Si vous ne le faites pas ou si une validation de paramètre échoue, vous êtes invité à fournir les paramètres requis.

Exemple de script de mise à jour

Si vous mettez à jour la version du fournisseur de ressources MySQL vers la version 1.1.33.0 ou les versions précédentes, vous devez installer des versions spécifiques des modules AzureRm.BootStrapper et Azure Stack Hub dans PowerShell.

Si vous mettez à jour le fournisseur de ressources MySQL vers la version 1.1.47.0 ou ultérieure, vous pouvez ignorer cette étape. Le script de déploiement télécharge et installe automatiquement les modules PowerShell nécessaires pour que vous accédiez à 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

L’exemple suivant montre le script UpdateMySQLProvider.ps1 que vous pouvez exécuter à partir d’une console PowerShell avec élévation de privilèges. Veillez à modifier les informations de variable et les mots de passe en fonction des besoins :

# 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

Une fois le script de mise à jour du fournisseur de ressources terminé, fermez la session PowerShell actuelle.

Étapes suivantes

Gérer le fournisseur de ressources MySQL