Mettre à jour le fournisseur de ressources SQL

Un nouveau fournisseur de ressources SQL peut être publié lorsque Azure Stack Hub est mis à jour vers une nouvelle build. Bien que le fournisseur de ressources 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 SQL Server V2

Si vous avez déjà déployé SQL 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 de SQL RP V1 vers SQL RP V2, vérifiez que vous avez d’abord mis à jour vers SQL RP V1.1.93.x, puis appliquez le processus de mise à niveau de version majeure pour effectuer une mise à niveau de SQL RP V1 vers SQL RP V2.

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

Conditions préalables

1. Vérifiez que vous avez mis à jour SQL 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>. sqladapter). Confirmez la balise de version et le nom de la machine virtuelle SQL 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 les conditions préalables à l’intégration du centre de données sont remplies.

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.

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-SQLRP'

# 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\sqlcert\SSL.pfx"

# 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\MajorVersionUpgradeSQLProvider.ps1 -AzureEnvironment $AzureEnvironment -AzCredential $AdminCreds -CloudAdminCredential $CloudAdminCreds -Privilegedendpoint $privilegedEndpoint -PfxPassword $PfxPass -PfxCert $PfxFilePath

Valider la réussite de la mise à niveau

1. Le script MajorVersionUpgrade s’exécute sans erreur.
2. Vérifiez le fournisseur de ressources dans la Place de marché et vérifiez que SQL RP 2.0 a été installé correctement.
3. L’ancien système.<groupe de ressources et système location.sqladapter>.<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 sqladapter 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 SQL RP V1 version antérieure vers SQL RP V1.1.93.x

La mise à jour V1 du fournisseur de ressources SQL 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 UpdateSQLProvider.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.

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 DeploySqlProvider.ps1, et vous devez fournir des informations de certificat.

Mettre à jour les processus de script

Le script UpdateSQLProvider.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 UpdateSQLProvider.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

Vous pouvez spécifier les paramètres suivants à partir de la ligne de commande lorsque vous exécutez le script PowerShell UpdateSQLProvider.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 mise à jour du script PowerShell

Si vous mettez à jour la version du fournisseur de ressources SQL 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 SQL 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

Voici un exemple d’utilisation du script UpdateSQLProvider.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 this might have been changed at installation.
$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 values for the <environment name> parameter are AzureCloud, AzureChinaCloud, or AzureUSGovernment depending which Azure subscription you're using.
$AzureEnvironment = "<EnvironmentName>"

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

# The service admin account (this can be Azure AD or AD FS).
$serviceAdmin = "admin@mydomain.onmicrosoft.com"
$AdminPass = ConvertTo-SecureString 'P@ssw0rd1' -AsPlainText -Force
$AdminCreds = New-Object System.Management.Automation.PSCredential ($serviceAdmin, $AdminPass)

# Set the credentials for the new resource provider VM.
$vmLocalAdminPass = ConvertTo-SecureString 'P@ssw0rd1' -AsPlainText -Force
$vmLocalAdminCreds = New-Object System.Management.Automation.PSCredential ("sqlrpadmin", $vmLocalAdminPass)

# Add 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\UpdateSQLProvider.ps1 -AzCredential $AdminCreds -VMLocalCredential $vmLocalAdminCreds -CloudAdminCredential $cloudAdminCreds -PrivilegedEndpoint $privilegedEndpoint -AzureEnvironment $AzureEnvironment -DefaultSSLCertificatePassword $PfxPass -DependencyFilesLocalPath $tempDir\cert

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 SQL