Aktualisieren des MySQL-Ressourcenanbieters im Azure Stack Hub

Von Bedeutung

Die SQL- und MySQL-Ressourcenanbieter für Azure Stack Hub sind veraltet und für das Onboarding neuer Kunden nicht verfügbar. Stellen Sie stattdessen SQL oder MySQL direkt auf virtuellen Computern bereit und verwalten Sie sie mithilfe von Standardtools und Methoden. Vorhandene Bereitstellungen der Ressourcenanbieter werden weiterhin unterstützt, aber es ist keine neue Featureentwicklung oder Onboarding geplant.

Von Bedeutung

Bevor Sie den Ressourcenanbieter aktualisieren, lesen Sie die Versionshinweise, um mehr über neue Funktionen, Korrekturen und bekannte Probleme zu erfahren, die sich auf Ihre Bereitstellung auswirken könnten. Die Versionshinweise geben auch die mindeste Azure Stack Hub-Version an, die für den Ressourcenanbieter erforderlich ist.

Von Bedeutung

Durch das Aktualisieren des Ressourcenanbieters wird der Host mySQL Server nicht aktualisiert.

Wenn Azure Stack Hub einen neuen Build veröffentlicht, wird möglicherweise ein neuer MySQL-Ressourcenanbieteradapter freigegeben. Während der vorhandene Adapter weiterhin funktioniert, aktualisieren Sie so schnell wie möglich auf die neueste Version.

Unterstützte Azure Stack Hub-Version MySQL RP-Version Windows Server, auf dem der RP-Dienst ausgeführt wird
2206, 2301, 2306, 2311 MySQL RP Version 2.0.13.x Microsoft AzureStack-Add-On RP Windows Server 1.2009.0
2108, 2206 MySQL RP Version 2.0.6.x Microsoft AzureStack-Add-On RP Windows Server 1.2009.0

Aktualisieren des MySQL Server-Ressourcenanbieters V2

Wenn Sie MySQL RP V2 bereits bereitgestellt haben und nach Updates suchen möchten, lesen Sie , wie Updates auf den Ressourcenanbieter angewendet werden.

Um von MySQL RP V1 auf MySQL RP V2 zu aktualisieren, aktualisieren Sie zuerst auf MySQL RP V1.1.93.x, und wenden Sie dann den Upgradeprozess der Hauptversion auf MySQL RP V1 auf MySQL RP V2 an.

Update von MySQL RP V1.1.93.x auf MySQL RP V2.0.6.0

Voraussetzungen

  1. Stellen Sie sicher, dass Sie MySQL RP V1 auf die neueste Version 1.1.93.x aktualisieren. Suchen Sie unter "Standardanbieterabonnement" die RP-Ressourcengruppe (Benennungsformat: system.<region>.mysqladapter). Bestätigen Sie das Versionstag und den Namen der MySQL RP-VM 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. Eröffnen Sie einen Support-Fall , um das MajorVersionUpgrade-Paket zu erhalten, und fügen Sie Ihr Abonnement der ASH-Marktplatz-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 Ihr Azure Stack Hub die Voraussetzungen für die Integration des Rechenzentrums erfüllt.

    Voraussetzung Referenz
    Die bedingte DNS-Weiterleitung ist ordnungsgemäß festgelegt. Azure Stack Hub-Rechenzentrumsintegration – DNS
    Eingangsports für Ressourcenanbieter sind geöffnet. Azure Stack Hub Rechenzentrumsintegration - Eingehende Ports und Protokolle
    Der PKI-Zertifikatsbetreff und SAN sind ordnungsgemäß festgelegt. Obligatorische PKI-Voraussetzungen für die Azure Stack Hub-Bereitstellung
    Voraussetzungen für die Azure Stack Hub-Bereitstellung von PaaS-Zertifikaten
  5. (für getrennte Umgebung) Installieren Sie die erforderlichen PowerShell-Module, ähnlich dem Updateprozess, der zum Bereitstellen des MySQL-Ressourcenanbieters verwendet wird.

  6. Bereiten Sie die MySQL-Connector-URI mit der erforderlichen Version vor. Ausführliche Informationen finden Sie unter Bereitstellen des MySQL-Ressourcenanbieters. Beispiel: https://<storageAcountName>.blob.<region>.<FQDN>/<containerName>/mysql-connector-net-8.0.21.msi

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.

Hinweis

Stellen Sie sicher, dass der Clientcomputer, auf dem Sie das Skript ausführen, Windows 10 oder Windows Server 2016 oder höher verwendet, und der Clientcomputer verfügt über die X64-Betriebssystemarchitektur.

Von Bedeutung

Verwenden Und Clear-AzureRmContext -Scope Process löschen Sie Clear-AzureRmContext -Scope CurrentUser den Cache, bevor Sie das Bereitstellungs- oder Updateskript ausfü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-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

Hinweis

Die DNS-Adresse und die entsprechende IP-Adresse von MySQL RP V2 unterscheiden sich. Um die neue öffentliche IP-Adresse zu erhalten, können Sie sich an den Support wenden, um einen DRP-Notfall anzufordern und die Ressource „MySQLRPVM1130-PublicIP“ zu ermitteln. Sie können auch von einem Clientcomputer ausgeführt werden nslookup mysqlrp.dbadapter.<fqdn> , der den Endpunkttest bereits bestanden hat, um die öffentliche IP zu ermitteln.

Ü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 MySQL RP 2.0 erfolgreich installiert ist.
  3. Die alte system.<location>.mysqladapter-Ressourcengruppe und die system.<location>.dbadapter.dns-Ressourcengruppe im Standardanbieterabonnement werden nicht automatisch vom Skript gelöscht.

Behalten Sie das Speicherkonto und die Key Vault in der Mysqladapter-Ressourcengruppe für einige Zeit bei. Wenn ein Mandant 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.

Von Bedeutung

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.

Update von MySQL RP V1 früherer Version auf MySQL RP V1.1.93.x

Das Update des MySQL-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 "UpdateMySQLProvider.ps1 ". Verwenden Sie Ihr Dienstkonto mit lokalen Administratorrechten, das ein Besitzer des Abonnements ist. 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 DeployMySqlProvider.ps1 Skript, und Sie müssen Zertifikatinformationen bereitstellen.

Aktualisieren von Skriptprozessen

Das skriptUpdateMySQLProvider.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.

Hinweis

Laden Sie das Image Microsoft AzureStack-Add-On RP Windows Server 1.2009.0 aus Marketplace Management herunter. Wenn Sie ein Update installieren müssen, können Sie ein einzelnes MSU-Paket im lokalen Abhängigkeitspfad platzieren. Das Skript schlägt fehl, wenn an diesem Speicherort mehrere MSU-Dateien vorhanden sind.

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

  • Datenbankinformationen
  • Hostingserverinformationen
  • Erforderlicher DNS-Eintrag

Von Bedeutung

Verwenden Und Clear-AzureRmContext -Scope Process löschen Sie Clear-AzureRmContext -Scope CurrentUser den Cache, bevor Sie das Bereitstellungs- oder Updateskript ausführen.

Aktualisieren von Skriptparametern

Geben Sie die folgenden Parameter aus der Befehlszeile an, wenn Sie das UpdateMySQLProvider.ps1 PowerShell-Skript ausführen. Wenn Sie keine Parameter angeben oder wenn eine Parameterüberprüfung fehlschlägt, werden Sie vom Skript aufgefordert, die erforderlichen Parameter anzugeben.

Parametername BESCHREIBUNG Kommentar- oder Standardwert
CloudAdminCredential Die Anmeldeinformationen für den Cloudadministrator, die für den Zugriff auf den privilegierten Endpunkt erforderlich sind. Erforderlich
AzCredential Die Anmeldeinformationen für das Azure Stack Hub-Dienstadministratorkonto. Verwenden Sie die gleichen Anmeldeinformationen, die Sie für die Bereitstellung von Azure Stack Hub verwendet haben. Das Skript schlägt fehl, wenn für das Konto, das Sie mit AzCredential verwenden, eine mehrstufige Authentifizierung (MFA) erforderlich ist. Erforderlich
VMLocalCredential Die Anmeldeinformationen für das lokale Administratorkonto der VM des MySQL-Ressourcenanbieters. Erforderlich
PrivilegedEndpoint Die IP-Adresse oder der DNS-Name des privilegierten Endpunkts. Erforderlich
AzureEnvironment Die Azure-Umgebung des Dienstadministratorkontos, das für die Bereitstellung von Azure Stack Hub verwendet wird. Nur für Microsoft Entra-Bereitstellungen erforderlich. Unterstützte Umgebungsnamen sind AzureCloud, AzureUSGovernment oder bei Verwendung einer China Microsoft Entra ID, AzureChinaCloud. AzureCloud
DependencyFilesLocalPath Ihre PFX-Zertifikatdatei muss ebenfalls in diesem Verzeichnis abgelegt werden. Optional (obligatorisch für Multiknoten)
Standard-SSL-Zertifikat-Passwort Das Kennwort für das PFX-Zertifikat. Erforderlich
MaxRetryCount Die Anzahl der Wiederholungsversuche für jeden Vorgang, wenn ein Fehler auftritt. 2
RetryDuration Das Timeoutintervall zwischen Wiederholungen in Sekunden. 120
Deinstallieren Entfernen Sie den Ressourcenanbieter und alle zugehörigen Ressourcen (siehe die folgenden Hinweise). Nein
DebugMode Verhindert die automatische Bereinigung nach einem Fehler. Nein
AcceptLicense Überspringt die Aufforderung, die GPL-Lizenz zu akzeptieren. (https://www.gnu.org/licenses/old-licenses/gpl-2.0.html)

Beispiel für ein Updateskript

Um den MySQL-Ressourcenanbieter auf Version 1.1.33.0 oder früher zu aktualisieren, installieren Sie bestimmte Versionen der AzureRm.BootStrapper Module und Azure Stack Hub in PowerShell.

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

Hinweis

Wenn der Ordner C:\Program Files\SqlMySqlPsh bereits mit dem heruntergeladenen PowerShell-Modul vorhanden ist, bereinigen Sie diesen Ordner, bevor Sie das Updateskript ausführen. In diesem Schritt wird sichergestellt, dass die richtige Version des PowerShell-Moduls heruntergeladen und verwendet wird.

# 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

Hinweis

In einem getrennten Szenario müssen Sie die erforderlichen PowerShell-Module herunterladen und das Repository manuell als Voraussetzung registrieren. Weitere Informationen finden Sie unter Bereitstellen des MySQL-Ressourcenanbieters.

Das folgende Beispiel zeigt das UpdateMySQLProvider.ps1 Skript, 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 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

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

Nächste Schritte

Verwalten des MySQL-Ressourcenanbieters