Bereitstellen des SQL Server-Ressourcenanbieters im Azure Stack Hub

Verwenden Sie den Azure Stack Hub SQL Server-Ressourcenanbieter, um SQL-Datenbanken als Azure Stack Hub-Dienst verfügbar zu machen.

Voraussetzungen

Wenn Sie bereits einen Ressourcenanbieter installiert haben, haben Sie wahrscheinlich die folgenden Voraussetzungen erfüllt und können diesen Abschnitt überspringen. Führen Sie andernfalls diese Schritte aus, bevor Sie fortfahren.

1. Registrieren Sie Ihre Azure Stack Hub-Instanz in Azure, wenn Sie dies noch nicht getan haben. Sie müssen Ihre Azure Stack Hub Instanz bei Azure registrieren, da Sie eine Verbindung mit Azure herstellen und Elemente vom Marketplace herunterladen.

2. Wenn Sie mit der Marketplaceverwaltung-Funktion des Azure Stack Hub-Administratorportals nicht vertraut sind, lesen Sie den Artikel Marketplace-Elemente aus Azure herunterladen und in Azure Stack Hub veröffentlichen. In dem Artikel werden Sie durch die Schritte geleitet, mit denen Elemente aus Azure in den Azure Stack Hub-Marketplace heruntergeladen werden. Dieser Artikel gilt sowohl für ein verbundenes als auch für ein nicht verbundenes Szenario. Wenn Ihre Azure Stack Hub Instanz getrennt oder teilweise verbunden ist, müssen Sie zusätzliche Voraussetzungen für die Installation abschließen.

3. Aktualisieren Sie Ihr Microsoft Entra-Startverzeichnis. Ab Build 1910 müssen Sie eine neue Anwendung in Ihrem Heimverzeichnismandanten registrieren. Diese App ermöglicht es Azure Stack Hub, neuere Ressourcenanbieter (z. B. Azure Event Hubs und andere) erfolgreich zu erstellen und bei Ihrem Microsoft Entra-Mandanten zu registrieren.

   Diese Aktion ist nach dem Upgrade auf Build 1910 oder höher erforderlich. Wenn Sie diesen Schritt nicht abschließen, schlagen die Installationen von Ressourcenanbietern aus dem Marketplace fehl.

4. Nachdem Sie ihre Azure Stack Hub Instanz erfolgreich auf 1910 oder höher aktualisiert haben, folgen Sie den Instruktionen zum Klonen/Herunterladen des Repositorys Azure Stack Hub Tools.

5. Folgen Sie den instructions zum Aktualisieren des Azure Stack Hub Microsoft Entra Home directory (nach der Installation von Updates oder neuen Ressourcenanbietern).

Voraussetzungen für SQL Server-Ressourcenanbieter

• Sie benötigen einen Computer und ein Konto, auf den Sie zugreifen können:

  • das Azure Stack Hub-Administratorportal.
  • der privilegierte Endpunkt (nur erforderlich, wenn Sie sql Server-Ressourcenanbieter V1 bereitstellen oder ein Upgrade von SQL Server-Ressourcenanbieter V1 auf SQL Server-Ressourcenanbieter V2 durchführen).
  • Den Azure Resource Manager-Administratorendpunkt https://adminmanagement.region.<fqdn>, wobei <fqdn> der vollqualifizierte Domänenname ist.
  • das Internet, wenn Ihr Azure Stack Hub so eingerichtet wurde, dass er Microsoft Entra ID als Ihren Identitätsanbieter verwendet.

• Laden Sie die unterstützte Version der SQL-Ressourcenanbieter-Binärdatei gemäß der unten aufgeführten Versionszuordnungstabelle herunter. Laden Sie für den V2 SQL-Ressourcenanbieter das Marketplace-Element auf Azure Stack Hub herunter.

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

• Stellen Sie sicher, dass die erforderliche Windows Server-VM auf den Azure Stack Hub Marketplace heruntergeladen wird. Laden Sie das Bild bei Bedarf manuell gemäß der oben aufgeführten Versionszuordnungstabelle herunter.

• Sicherstellen, dass die Voraussetzungen für die Rechenzentrumsintegration erfüllt sind:

  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

• Bereiten Sie das Zertifikat vor. (Nur für integrierte Anlagen.)

  • Sie müssen das SQL PaaS-PKI-Zertifikat angeben, das im optionalen Abschnitt "PaaS-Zertifikate" der PKI-Anforderungen für die Azure Stack Hub-Bereitstellung beschrieben ist. Der alternative Antragstellername (Subject Alternative Name, SAN) muss dem folgenden Benennungsmuster entsprechen: CN=*.dbadapter.<region>.<fqdn>, mit Kennwortschutz.
  • Platzieren Sie beim Bereitstellen des SQL Server-Ressourcenanbieters V1 die PFX-Datei an dem speicherort, der durch den Parameter DependencyFilesLocalPath angegeben wird. Stellen Sie kein Zertifikat für ASDK-Systeme bereit.
  • Bereiten Sie beim Bereitstellen des SQL Server-Ressourcenanbieters V2 das Zertifikat für die folgenden Installationsschritte vor.

Nicht verbundenes Szenario

Wenn Sie den SQL Server-Ressourcenanbieter V2 in einem nicht verbundenen Szenario bereitstellen, folgen Sie der Anleitung zum Herunterladen von Marketplace-Elementen in Azure Stack Hub, um das SQL Server-Ressourcenanbieterelement und das Add-On RP Windows Server-Element in Ihre Azure Stack Hub-Umgebung herunterzuladen.

Führen Sie beim Bereitstellen des SQL Server-Ressourcenanbieters V1 in einem getrennten Szenario die folgenden Schritte aus, um die erforderlichen PowerShell-Module herunterzuladen und das Repository manuell zu registrieren.

1. Melden Sie sich bei einem Computer mit Internetverbindung an, und verwenden Sie die folgenden Skripts, um die PowerShell-Module herunterzuladen.

   Import-Module -Name PowerShellGet -ErrorAction Stop
   Import-Module -Name PackageManagement -ErrorAction Stop
   
   # path to save the packages, c:\temp\azs1.6.0 as an example here
   $Path = "c:\temp\azs1.6.0"
   

2. Führen Sie je nach bereitgestellter Version des Ressourcenanbieters eines der Skripts aus.

   # for resource provider version >= 1.1.93.0
   Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureRM -Path $Path -Force -RequiredVersion 2.5.0
   Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureStack -Path $Path -Force -RequiredVersion 1.8.2
   

   # for resource provider version <= 1.1.47.0
   Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureRM -Path $Path -Force -RequiredVersion 2.3.0
   Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureStack -Path $Path -Force -RequiredVersion 1.6.0
   

3. Anschließend kopieren Sie die heruntergeladenen Pakete auf ein USB-Gerät.

4. Melden Sie sich bei der getrennten Arbeitsstation an, und kopieren Sie die Pakete vom USB-Gerät an einen Speicherort auf der Arbeitsstation.

5. Registrieren Sie diesen Speicherort als lokales Repository.

   # requires -Version 5
   # requires -RunAsAdministrator
   # requires -Module PowerShellGet
   # requires -Module PackageManagement
   
   $SourceLocation = "C:\temp\azs1.6.0"
   $RepoName = "azs1.6.0"
   
   Register-PSRepository -Name $RepoName -SourceLocation $SourceLocation -InstallationPolicy Trusted
   
   New-Item -Path $env:ProgramFiles -name "SqlMySqlPsh" -ItemType "Directory"
   

Bereitstellen des SQL-Ressourcenanbieters V2

Wenn Sie ein Upgrade von einer V1-Version durchführen, lesen Sie das Dokument "Aktualisieren des SQL Server-Ressourcenanbieters".

Starten der Installation

1. Wenn dies noch nicht geschehen ist, melden Sie am Azure Stack Hub-Administratorportal an, wählen Sie auf der linken Seite Marketplace-Verwaltung aus, und wählen Sie Ressourcenanbieter aus.

2. Sobald der SQL-Ressourcenanbieter und andere erforderliche Software heruntergeladen wurden, zeigt Marketplace Management die Pakete "SQL Server-Ressourcenanbieter" mit dem Status "Nicht installiert" an. Möglicherweise gibt es andere Pakete, die mit dem Status „Heruntergeladen“ angezeigt werden.

3. Wählen Sie die Zeile aus, die Sie installieren möchten. Auf der Installationspaketseite des SQL Server-Ressourcenanbieters wird oben ein blaues Banner angezeigt. Wählen Sie das Banner aus, um die Installation zu starten.

Installieren der erforderlichen Komponenten

1. Als nächstes gelangen Sie zur Installationsseite. Wählen Sie Voraussetzungen installieren aus, um den Installationsvorgang zu starten.

2. Warten Sie, bis die Installation der Voraussetzungen erfolgreich abgeschlossen ist. Ein grünes Häkchen sollte neben Voraussetzungen installieren angezeigt werden, bevor Sie zum nächsten Schritt wechseln.

Geheime Schlüssel vorbereiten

1. Unter dem Schritt 2. Geheimnisse vorbereiten wählen Sie Zertifikat hinzufügen aus, und der Bereich Zertifikat hinzufügen wird angezeigt.

2. Wählen Sie die Schaltfläche für Durchsuchen unter Zertifikat hinzufügen aus, die sich direkt rechts neben dem Feld mit dem Dateinamen des Zertifikats befindet. Wählen Sie die .pfx-Zertifikatsdatei aus, die Sie beim Erfüllen der Voraussetzungen bezogen haben.

3. Geben Sie das kennwort ein, das Sie zum Erstellen einer sicheren Zeichenfolge für das SSL-Zertifikat des SQL Server-Ressourcenanbieters angegeben haben. Wählen Sie dann Hinzufügen aus.

Ressourcenanbieter installieren

1. Wenn das Zertifikat erfolgreich installiert wurde, sollte ein grünes Häkchen neben Geheimnisse vorbereiten angezeigt werden. Ist dies der Fall, wechseln Sie zum nächsten Schritt. Wählen Sie nun die Schaltfläche Installierenneben 3. Ressourcenanbieter installieren aus.

2. Als Nächstes wird die folgende Seite angezeigt, die angibt, dass der SQL-Ressourcenanbieter installiert wird.

3. Warten Sie, bis die Benachrichtigung angezeigt wird, dass die Installation abgeschlossen ist. Dieser Vorgang dauert in der Regel eine oder mehrere Stunden, je nach Ihrem Azure Stack Hub-Typ.

4. Stellen Sie sicher, dass die Installation des SQL Server-Ressourcenanbieters erfolgreich war, indem Sie zur Seite Marketplace-Verwaltung, Ressourcenanbieter , zurückkehren. Der Status des SQL Server-Ressourcenanbieters sollte "Installiert" anzeigen.

Bereitstellen des SQL-Ressourcenanbieters V1

Nachdem Sie alle Voraussetzungen abgeschlossen haben, führen Sie den Selbstextrahierer aus, um das heruntergeladene Installationspaket in ein temporäres Verzeichnis zu extrahieren. führen Sie das DeploySqlProvider.ps1 Skript von einem Computer aus aus, der sowohl auf den Azure Stack Hub Azure Resource Manager-Administratorendpunkt als auch auf den privilegierten Endpunkt zugreifen kann, um den SQL-Ressourcenanbieter bereitzustellen. Das DeploySqlProvider.ps1 Skript wird als Teil der SQL-Ressourcenanbieter-Binärdatei extrahiert, die Sie für Ihre Version von Azure Stack Hub heruntergeladen haben.

Um den SQL-Ressourcenanbieter bereitzustellen, öffnen Sie ein neues PowerShell-Fenster mit erhöhten Rechten (nicht PowerShell ISE), und wechseln Sie in das Verzeichnis, in dem Sie die BINÄRDATEIEN des SQL-Ressourcenanbieters extrahiert haben.

Führen Sie das skript DeploySqlProvider.ps1 aus, das die folgenden Aufgaben ausführt:

• Lädt die Zertifikate und andere Artefakte in ein Speicherkonto auf Azure Stack Hub hoch.
• Veröffentlicht Katalogpakete, damit Sie SQL-Datenbanken mithilfe des Katalogs bereitstellen können.
• Veröffentlicht ein Katalogpaket für die Bereitstellung von Hostingservern.
• Stellt einen virtuellen Computer mithilfe des Windows Server 2016-Kernimages oder des Microsoft AzureStack-Add-On RP Windows Server-Images bereit, das Sie heruntergeladen haben, und installiert dann den SQL-Ressourcenanbieter.
• Registriert einen lokalen DNS-Eintrag, der Ihrem ressourcenanbieter-virtuellen Computer zugeordnet ist.
• Registriert Ihren Ressourcenanbieter beim lokalen Azure Resource Manager für das Operatorkonto.

Parameter „DeploySqlProvider.ps1“

Sie können die folgenden Parameter über die Befehlszeile angeben. Wenn dies nicht der Fall ist oder eine Parameterüberprüfung fehlschlägt, werden Sie aufgefordert, die erforderlichen Parameter anzugeben.

Bereitstellen des SQL-Ressourcenanbieters mithilfe eines benutzerdefinierten Skripts

Wenn Sie die SQL-Ressourcenanbieterversion 1.1.47.0 oder höher bereitstellen, lädt das Bereitstellungsskript automatisch die erforderlichen PowerShell-Module herunter und installiert sie im Pfad "C:\Program Files\SqlMySqlPsh".

# 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 -RequiredVersion 0.5.0 -Force
Use-AzureRmProfile -Profile 2018-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.6.0

Um eine manuelle Konfiguration beim Bereitstellen des Ressourcenanbieters zu vermeiden, können Sie das folgende Skript anpassen. Ändern Sie die Standardkontoinformationen und Kennwörter nach Bedarf für Ihre Azure Stack Hub-Bereitstellung.

# 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 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 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 local admin account.
$vmLocalAdminPass = ConvertTo-SecureString 'P@ssw0rd1' -AsPlainText -Force
$vmLocalAdminCreds = New-Object System.Management.Automation.PSCredential ("sqlrpadmin", $vmLocalAdminPass)

# Add the cloudadmin credential that's 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 to the directory folder where you extracted the installation files. Don't provide a certificate on ASDK!
. $tempDir\DeploySQLProvider.ps1 `
    -AzCredential $AdminCreds `
    -VMLocalCredential $vmLocalAdminCreds `
    -CloudAdminCredential $cloudAdminCreds `
    -PrivilegedEndpoint $privilegedEndpoint `
    -AzureEnvironment $AzureEnvironment `
    -DefaultSSLCertificatePassword $PfxPass `
    -DependencyFilesLocalPath $tempDir\cert

Wenn das Installationsskript des Ressourcenanbieters abgeschlossen ist, aktualisieren Sie Ihren Browser, um sicherzustellen, dass Sie die neuesten Updates sehen und die aktuelle PowerShell-Sitzung schließen können.

Überprüfen der V1-Bereitstellung mithilfe des Azure Stack Hub-Portals

1. Melden Sie sich beim Administratorportal als Dienstadministrator an.
2. Wählen Sie Ressourcengruppen aus.
3. Wählen Sie die Ressourcengruppe system.<location>.sqladapter aus.
4. Auf der Zusammenfassungsseite für die Ressourcengruppenübersicht sollten keine fehlgeschlagenen Bereitstellungen vorhanden sein.
5. Wählen Sie schließlich virtuelle Computer im Administratorportal aus, um zu überprüfen, ob die VM des SQL-Ressourcenanbieters erfolgreich erstellt und ausgeführt wurde.

Wichtige Konfiguration für die Microsoft Entra ID

Wenn Ihr Azure Stack Hub Microsoft Entra-ID als Identitätsanbieter verwendet, stellen Sie sicher, dass der virtuelle Computer, der SQL Server-Ressourcenanbieter installiert hat, über eine ausgehende Internetverbindung verfügt.

Nächste Schritte

Hinzufügen von Hostingservern