Aktualisieren des SQL-Ressourcenanbieters

Möglicherweise wird ein neuer SQL-Ressourcenanbieter veröffentlicht, wenn Azure Stack Hub auf einen neuen Build aktualisiert wird. Obwohl der vorhandene Ressourcenanbieter weiterhin funktioniert, empfehlen wir, so bald wie möglich auf den neuesten Build zu aktualisieren.

Aktualisieren des SQL Server-Ressourcenanbieters V2

Wenn Sie SQL RP V2 bereits bereitgestellt haben und nach Updates suchen möchten, überprüfen Sie, wie Updates auf den Ressourcenanbieter angewendet werden.

Wenn Sie von SQL RP V1 auf SQL RP V2 aktualisieren möchten, stellen Sie sicher, dass Sie zuerst auf SQL RP V1.1.93.x aktualisiert haben, und wenden Sie dann den Upgradeprozess der Hauptversion auf SQL RP V1 auf SQL RP V2 an.

Aktualisieren von SQL RP V1.1.93.x auf SQL RP V2.0.6.0

Voraussetzungen

1. Stellen Sie sicher, dass Sie SQL RP V1 auf die neueste Version 1.1.93.x aktualisiert haben. Suchen Sie unter "Standardanbieterabonnement" die RP-Ressourcengruppe (Benennungsformat: system.<region>). sqladapter). Bestätigen Sie den Versionstag und den NAMEN des virtuellen SQL RP-Computers in der Ressourcengruppe. Wenn Sie noch eine alte Version verwenden und auf 1.1.93.x aktualisieren müssen, öffnen Sie einen Supportfall, um Hilfe zu erhalten.

2. öffnen Sie einen Supportfall , um das MajorVersionUpgrade-Paket zu erhalten, und fügen Sie Ihr Abonnement zur ASH Marketplace-Zulassungsliste für die zukünftige V2-Version hinzu.

3. Laden Sie Microsoft AzureStack Add-On RP Windows Server 1.2009.0 auf marketplace herunter.

4. Stellen Sie sicher, dass die Voraussetzungen für die Rechenzentrumsintegration erfüllt sind.

5. (für getrennte Umgebung) Installieren Sie die erforderlichen PowerShell-Module, ähnlich dem Updateprozess, der zum Bereitstellen des Ressourcenanbieters verwendet wird.

Auslösen von MajorVersionUpgrade

Führen Sie das folgende Skript über eine PowerShell-Konsole mit erhöhten Rechten aus, um ein Upgrade der Hauptversion durchzuführen.

# 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

Überprüfen, ob das Upgrade erfolgreich ist

1. Das Skript "MajorVersionUpgrade" wurde ohne Fehler ausgeführt.
2. Überprüfen Sie den Ressourcenanbieter auf dem Marketplace, und stellen Sie sicher, dass SQL RP 2.0 erfolgreich installiert wurde.
3. Das alte System.<location.sqladapter-Ressourcengruppe> und -system.<location.dbadapter.dns-Ressourcengruppe> im Standardanbieterabonnement wird nicht automatisch vom Skript gelöscht.

• Es wird empfohlen, das Speicherkonto und den Key Vault für einige Zeit in der Sqladapter-Ressourcengruppe zu speichern. Wenn ein Mandantenbenutzer nach dem Upgrade inkonsistente Datenbank- oder Anmeldemetadaten beobachtet, ist es möglich, Unterstützung zum Wiederherstellen der Metadaten aus der Ressourcengruppe zu erhalten.
• Nachdem sichergestellt wurde, dass die DNS-Zone in der Ressourcengruppe "dbadapter.dns" ohne DNS-Eintrag leer ist, ist es sicher, die Dbadapter.dns-Ressourcengruppe zu löschen.
• [WICHTIG] Verwenden Sie das V1-Bereitstellungsskript nicht, um die V1-Version zu deinstallieren. Nachdem das Upgrade abgeschlossen und bestätigt wurde, dass das Upgrade erfolgreich war, können Sie die Ressourcengruppe manuell aus dem Anbieterabonnement löschen.

Aktualisieren von EINER früheren SQL RP V1-Version auf SQL RP V1.1.93.x

Das Update des SQL-Ressourcenanbieters V1 ist kumulativ. Sie können direkt auf die Version 1.1.93.x aktualisieren.

Um den Ressourcenanbieter auf 1.1.93.x zu aktualisieren, verwenden Sie das skript "UpdateSQLProvider.ps1 ". Verwenden Sie Ihr Dienstkonto mit lokalen Administratorrechten und ist Besitzer des Abonnements. Dieses Updateskript ist im Download des Ressourcenanbieters enthalten.

Der Aktualisierungsprozess ähnelt dem Prozess, der zum Bereitstellen des Ressourcenanbieters verwendet wird. Das Updateskript verwendet dieselben Argumente wie das DeploySqlProvider.ps1 Skript, und Sie müssen Zertifikatinformationen bereitstellen.

Aktualisieren von Skriptprozessen

Das skriptUpdateSQLProvider.ps1 erstellt einen neuen virtuellen Computer (VM) mit dem neuesten Betriebssystemimage, stellt den neuesten Ressourcenanbietercode bereit und migriert die Einstellungen vom alten Ressourcenanbieter zum neuen Ressourcenanbieter.

Nachdem das skriptUpdateSQLProvider.ps1 einen neuen virtuellen Computer erstellt hat, migriert das Skript die folgenden Einstellungen von der alten Ressourcenanbieter-VM:

• Datenbankinformationen
• Hostingserverinformationen
• Erforderlicher DNS-Eintrag

Aktualisieren von Skriptparametern

Sie können die folgenden Parameter über die Befehlszeile angeben, wenn Sie das UpdateSQLProvider.ps1 PowerShell-Skript ausführen. Wenn dies nicht der Fall ist oder eine Parameterüberprüfung fehlschlägt, werden Sie aufgefordert, die erforderlichen Parameter anzugeben.

PowerShell-Beispiel zum Aktualisieren des Skripts

Wenn Sie die SQL-Ressourcenanbieterversion auf 1.1.33.0 oder frühere Versionen aktualisieren, müssen Sie bestimmte Versionen von AzureRm.BootStrapper- und Azure Stack Hub-Modulen in PowerShell installieren.

Wenn Sie den SQL-Ressourcenanbieter auf Version 1.1.47.0 oder höher aktualisieren, können Sie diesen Schritt überspringen. Das Bereitstellungsskript lädt die erforderlichen PowerShell-Module automatisch herunter und installiert sie, um den Pfad "C:\Program Files\SqlMySqlPsh" zu speichern.

# 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

Im Folgenden finden Sie ein Beispiel für die Verwendung des skriptsUpdateSQLProvider.ps1 , das Sie über eine PowerShell-Konsole mit erhöhten Rechten ausführen können. Achten Sie darauf, die variablen Informationen und Kennwörter nach Bedarf zu ändern:

# 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

Wenn das Skript zum Aktualisieren des Ressourcenanbieters abgeschlossen ist, schließen Sie die aktuelle PowerShell-Sitzung.

Nächste Schritte

Verwalten des SQL-Ressourcenanbieters