Distribuera SQL Server resursprovidern på Azure Stack Hub

Använd Azure Stack Hub SQL Server resursprovider för att exponera SQL-databaser som en Azure Stack Hub-tjänst.

Förutsättningar

Om du redan har installerat en resursprovider har du förmodligen slutfört följande krav och kan hoppa över det här avsnittet. Annars utför du de här stegen innan du fortsätter:

1. Registrera din Azure Stack Hub-instans med Azure om du inte har gjort det. Det här steget krävs eftersom du ansluter till och laddar ned objekt till Marketplace från Azure.

2. Om du inte är bekant med marketplace-hanteringsfunktionen i Azure Stack Hub-administratörsportalen kan du läsa Ladda ned marketplace-objekt från Azure och publicera till Azure Stack Hub. Artikeln beskriver steg för steg hur du laddar ned objekt från Azure till Azure Stack Hub Marketplace. Den omfattar både anslutna och frånkopplade scenarier. Om din Azure Stack Hub-instans är frånkopplad eller delvis ansluten finns det ytterligare förutsättningar att slutföra inför installationen.

3. Uppdatera din Microsoft Entra hemkatalog. Från och med version 1910 måste ett nytt program registreras i din klientorganisation för hemkatalogen. Den här appen gör det möjligt för Azure Stack Hub att skapa och registrera nyare resursprovidrar (till exempel Event Hubs och andra) med din Microsoft Entra klientorganisation. Det här är en engångsåtgärd som måste utföras efter uppgraderingen till version 1910 eller senare. Om det här steget inte har slutförts misslyckas installationer av Marketplace-resursprovidern.

   • När du har uppdaterat Azure Stack Hub-instansen till 1910 eller senare följer du anvisningarna för att klona/ladda ned Azure Stack Hub Tools-lagringsplatsen.
   • Följ sedan anvisningarna för Att uppdatera Azure Stack Hub Microsoft Entra Home Directory (när du har installerat uppdateringar eller nya resursproviders).

krav för SQL Server resursprovider

• Du behöver en dator och ett konto som kan komma åt:

  • Administratörsportalen för Azure Stack Hub.
  • den privilegierade slutpunkten (behövs bara när du distribuerar SQL Server resursprovider V1 eller uppgraderar från SQL Server resursprovider V1 till SQL Server resursprovider V2).
  • Azure Resource Manager admin-slutpunkt, https://adminmanagement.region.<fqdn>, där <fqdn> är ditt fullständigt kvalificerade domännamn.
  • Internet, om din Azure Stack Hub har distribuerats för att använda Microsoft Entra ID som identitetsprovider.

• Ladda ned den version av SQL-resursprovidern som stöds binär enligt tabellen för versionsmappning nedan. För V2 SQL-resursprovider laddar du ned marketplace-objektet till Azure Stack Hub.

  Azure Stack Hub-version som stöds	SQL RP-version	Windows Server som RP-tjänsten körs på
  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

• Kontrollera att den nödvändiga virtuella Windows Server-datorn har laddats ned till Azure Stack Hub Marketplace. Ladda ned avbildningen manuellt enligt versionsmappningstabellen ovan om det behövs.

• Se till att kraven för datacenterintegrering uppfylls:

  Förutsättning	Referens
  Villkorlig DNS-vidarebefordring har angetts korrekt.	Datacenterintegrering i Azure Stack Hub – DNS
  Inkommande portar för resursprovidrar är öppna.	Integrering av Azure Stack Hub-datacenter – inkommande portar och protokoll
  PKI-certifikatets ämne och SAN har angetts korrekt.	Obligatoriska PKI-krav för Azure Stack Hub-distribution Krav för PaaS-certifikat för Azure Stack Hub-distribution

• Förbered certifikatet. (Endast för integrerade systeminstallationer.)

  • Du måste ange SQL PaaS PKI-certifikatet som beskrivs i avsnittet valfria PaaS-certifikat i PKI-krav för Azure Stack Hub-distribution. Alternativt namn för certifikatmottagare (SAN) måste följa följande namngivningsmönster: CN=*.dbadapter.<region>.<fqdn>, med lösenordsskyddat.
  • När du distribuerar SQL Server resursprovider V1 placerar du .pfx-filen på den plats som anges av parametern DependencyFilesLocalPath. Ange inte något certifikat för ASDK-system.
  • När du distribuerar SQL Server resursprovider V2 förbereder du certifikatet för följande installationssteg.

Frånkopplat scenario

När du distribuerar SQL Server resursprovider V2 i ett frånkopplat scenario följer du anvisningarna för att ladda ned Marketplace-objekt till Azure Stack Hub för att ladda ned SQL Server resursproviderobjektet och Windows Server-objektet add-on till din Azure Stack Hub-miljö.

När du distribuerar SQL Server resursprovider V1 i ett frånkopplat scenario utför du följande steg för att ladda ned nödvändiga PowerShell-moduler och registrera lagringsplatsen manuellt.

1. Logga in på en dator med Internetanslutning och använd följande skript för att ladda ned PowerShell-modulerna.

   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. Beroende på vilken version av resursprovidern du distribuerar kör du ett av skripten.

   # 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. Sedan kopierar du de nedladdade paketen till en USB-enhet.

4. Logga in på den frånkopplade arbetsstationen och kopiera paketen från USB-enheten till en plats på arbetsstationen.

5. Registrera den här platsen som en lokal lagringsplats.

   # 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"
   

Distribuera SQL-resursprovidern V2

Om du uppgraderar från en V1-version läser du dokumentet Uppdatera SQL Server resursprovider.

Starta installationen

1. Om du inte redan har gjort det loggar du in på Azure Stack Hub-administratörsportalen, väljer Marketplace-hantering till vänster och väljer Resursprovidrar.

2. När SQL-resursprovidern och annan nödvändig programvara har laddats ned visar Marketplace Management paketen "SQL Server resursprovider" med statusen "Inte installerad". Det kan finnas andra paket som visar statusen "Nedladdad".

3. Välj den rad som du vill installera. Sidan SQL Server-resursproviderns installationspaket visar en blå banderoll överst. Välj banderollen för att starta installationen.

Installationskrav

1. Sedan överförs du till installationssidan. Välj Installera förutsättningar för att påbörja installationsprocessen.

2. Vänta tills installationen av förutsättningarna har slutförts. Du bör se en grön bock bredvid Installera förutsättningar innan du fortsätter till nästa steg.

Förbereda hemligheter

1. Under 2na. Förbered hemlighetssteget , välj Lägg till certifikat så visas panelen Lägg till ett certifikat .

2. Välj bläddra-knappen i Lägg till ett certifikat, precis till höger om fältet certifikatfilnamn. Välj den .pfx-certifikatfil som du köpte när du slutförde förutsättningarna.

3. Ange det lösenord som du angav för att skapa en säker sträng för SQL Server resursproviderns SSL-certifikat. Välj Lägg till.

Installera resursprovider

1. När installationen av certifikatet lyckas bör du se en grön bock bredvid Förbered hemligheter innan du fortsätter till nästa steg. Välj nu knappen Installera bredvid 3 Installera resursprovider.

2. Härnäst visas följande sida, som anger att SQL-resursprovidern installeras.

3. Vänta tills installationen har slutförts. Den här processen tar vanligtvis en eller flera timmar, beroende på typen av Azure Stack Hub.

4. Kontrollera att installationen av SQL Server resursprovidern har slutförts genom att gå tillbaka till sidan Marketplace-hantering, resursproviders. Statusen för SQL Server resursprovider ska visa "Installerad".

Distribuera SQL-resursprovidern V1

När du har slutfört alla krav kör du självextraktorn för att extrahera det nedladdade installationspaketet till en tillfällig katalog. kör skriptetDeploySqlProvider.ps1 från en dator som kan komma åt både Azure Stack Hub Azure Resource Manager-administratörsslutpunkten och den privilegierade slutpunkten för att distribuera SQL-resursprovidern. Skriptet DeploySqlProvider.ps1 extraheras som en del av binärfilen för SQL-resursprovidern som du laddade ned för din version av Azure Stack Hub.

Om du vill distribuera SQL-resursprovidern öppnar du ett nytt upphöjt PowerShell-fönster (inte PowerShell ISE) och ändrar till katalogen där du extraherade binära SQL-resursproviderfiler.

Kör skriptet DeploySqlProvider.ps1 som slutför följande uppgifter:

• Laddar upp certifikaten och andra artefakter till ett lagringskonto på Azure Stack Hub.
• Publicerar galleripaket så att du kan distribuera SQL-databaser med hjälp av galleriet.
• Publicerar ett galleripaket för distribution av värdservrar.
• Distribuerar en virtuell dator med hjälp av Windows Server 2016 kärnavbildning eller Microsoft AzureStack Add-on RP Windows Server-avbildning som du laddade ned och installerar sedan SQL-resursprovidern.
• Registrerar en lokal DNS-post som mappar till den virtuella resursproviderns virtuella dator.
• Registrerar din resursprovider med den lokala Azure-Resource Manager för operatörskontot.

DeploySqlProvider.ps1 parametrar

Du kan ange följande parametrar från kommandoraden. Om du inte gör det, eller om någon parameterverifiering misslyckas, uppmanas du att ange de obligatoriska parametrarna.

Distribuera SQL-resursprovidern med ett anpassat skript

Om du distribuerar SQL-resursprovidern version 1.1.47.0 eller senare laddar distributionsskriptet automatiskt ned och installerar nödvändiga PowerShell-moduler så att du kan söka efter 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

Om du vill eliminera manuell konfiguration när du distribuerar resursprovidern kan du anpassa följande skript. Ändra standardkontoinformationen och lösenorden efter behov för din Azure Stack Hub-distribution.

# 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

När installationsskriptet för resursprovidern har slutförts uppdaterar du webbläsaren så att du kan se de senaste uppdateringarna och stänga den aktuella PowerShell-sessionen.

Verifiera V1-distributionen med hjälp av Azure Stack Hub-portalen

1. Logga in på administratörsportalen som tjänstadministratör.
2. Välj Resursgrupper.
3. Välj systemet.<resursgrupp för location.sqladapter>.
4. På sammanfattningssidan för Översikt över resursgrupper bör det inte finnas några misslyckade distributioner.
5. Välj slutligen Virtuella datorer i administratörsportalen för att kontrollera att den virtuella sql-resursproviderns virtuella dator har skapats och körs.

Viktig konfiguration för Microsoft Entra ID

Om din Azure Stack Hub använder Microsoft Entra ID som identitetsprovider kontrollerar du att den virtuella dator som har installerat SQL Server resursprovider har utgående Internetanslutning.

Nästa steg

Lägga till värdservrar