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, effectuez une mise à jour vers la dernière build dès que possible.

Mettre à jour le fournisseur de ressources SQL Server V2

Pour rechercher les mises à jour de SQL RP V2, consultez Comment appliquer des mises à jour au fournisseur de ressources.

Pour effectuer une mise à jour de SQL RP V1 vers SQL RP V2, commencez par effectuer une mise à jour vers SQL RP V1.1.93.x. Ensuite, 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. Veillez à mettre à 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 une demande de support pour incident pour obtenir le package MajorVersionUpgrade, puis ajoutez votre abonnement à la liste d’autorisation de la marketplace ASH pour la version v2 à venir.

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.

   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 le 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 un 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 n’est pas automatiquement supprimé par le script.

Conservez le compte de stockage et le Key Vault 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.

Mettre à jour la version antérieure de SQL RP V1 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 UpdateSQLProvider.ps1 script. Vous devez utiliser votre compte de service avec des droits d’administrateur local et être 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 UpdateSQLProvider.ps1 script 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 UpdateSQLProvider.ps1 script 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 UpdateSQLProvider.ps1 script PowerShell. Si vous ne spécifiez pas de paramètres ou si une validation de paramètre échoue, le script vous invite à fournir les paramètres requis.

Exemple de mise à jour du script PowerShell

Pour mettre à jour le fournisseur de ressources SQL vers la version 1.1.33.0 ou antérieure, installez des versions spécifiques des modules et Azure Stack Hub des AzureRm.BootStrapper modules dans les modules 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 vous permettre de chemin d’accès 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 comment utiliser le UpdateSQLProvider.ps1 script. Exécutez le script à 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