De SQL Server Resource provider implementeren op Azure Stack hubDeploy the SQL Server resource provider on Azure Stack Hub

Gebruik de Azure Stack hub SQL Server Resource provider om SQL-data bases beschikbaar te stellen als een Azure Stack hub-service.Use the Azure Stack Hub SQL Server resource provider to expose SQL databases as an Azure Stack Hub service. De SQL-resource provider wordt uitgevoerd als een service op een virtuele machine met Windows Server 2016 Server Core (voor adapter versie <= 1.1.47.0>) of een speciale add-on RP Windows-Server (voor adapter versie >= 1.1.93.0).The SQL resource provider runs as a service on a Windows Server 2016 Server Core virtual machine (for adapter version <= 1.1.47.0>) or a special Add-on RP Windows Server (for adapter version >= 1.1.93.0).

Belangrijk

Alleen de resource provider moet items maken op servers die SQL of MySQL hosten.Only the resource provider should create items on servers that host SQL or MySQL. Items die zijn gemaakt op een hostserver die niet door de resource provider zijn gemaakt, worden niet ondersteund en kunnen leiden tot een onjuiste status.Items created on a host server that aren't created by the resource provider are unsupported, and may result in a mismatched state.

VereistenPrerequisites

Er zijn verschillende vereisten die moeten worden uitgevoerd voordat u de Azure Stack hub SQL-resource provider kunt implementeren:There are several prerequisites that need to be in place before you can deploy the Azure Stack Hub SQL resource provider:

  • U hebt een computer en account nodig die toegang hebben tot:You'll need a computer and account that can access:

    • de Azure stack hub-beheerder Portal.the Azure Stack Hub administrator portal.
    • het bevoegde eind punt.the privileged endpoint.
    • het eind punt van de Azure Resource Manager-beheerder, https://management.region.<fqdn> waar <fqdn> is uw Fully Qualified Domain Name (of https://management.local.azurestack.external Als u de ASDK gebruikt)the Azure Resource Manager admin endpoint, https://management.region.<fqdn>, where <fqdn> is your fully qualified domain name (or https://management.local.azurestack.external if using the ASDK)
    • het Internet, als uw Azure Stack hub is geïmplementeerd voor het gebruik van Azure Active Directory (AD) als uw ID-provider.the Internet, if your Azure Stack Hub was deployed to use Azure Active Directory (AD) as your identity provider.
  • Als u dat nog niet hebt gedaan, registreert u Azure stack hub met Azure zodat u Azure Marketplace-items kunt downloaden.If you haven't already, register Azure Stack Hub with Azure so you can download Azure Marketplace items.

  • Voeg de vereiste Windows Server-VM toe aan Azure Stack hub Marketplace.Add the required Windows Server VM to Azure Stack Hub Marketplace.

    • Down load de installatie kopie van Windows Server 2016 Data Center-Server Core voor SQL RP-versie <= 1.1.47.0.For SQL RP version <= 1.1.47.0, download the Windows Server 2016 Datacenter - Server Core image.
    • Down load de micro soft AzureStack Add-On RP Windows Server -installatie kopie voor SQL RP-versie >= 1.1.93.0.For SQL RP version >= 1.1.93.0, download the Microsoft AzureStack Add-On RP Windows Server image. Deze versie van Windows Server is gespecialiseerd in Azure Stack Add-On de RP-infra structuur en is niet zichtbaar voor de Tenant Marketplace.This Windows Server version is specialize for Azure Stack Add-On RP Infrastructure and it is not visible to the tenant marketplace.
  • Down load de ondersteunde versie van het binaire bestand van de SQL-resource provider op basis van de onderstaande tabel voor versie toewijzing.Download the supported version of SQL resource provider binary according to the version mapping table below. Voer de Self-Extractor uit om de gedownloade inhoud uit te pakken naar een tijdelijke map.Run the self-extractor to extract the downloaded contents to a temporary directory.

    Ondersteunde Azure Stack hub-versieSupported Azure Stack Hub version SQL RP-versieSQL RP version Windows Server waarop de RP-service wordt uitgevoerdWindows Server that RP service is running on
    2008, 20052008, 2005 SQL RP-versie 1.1.93.1SQL RP version 1.1.93.1 Micro soft AzureStack-invoeg toepassing RP Windows ServerMicrosoft AzureStack Add-on RP Windows Server
    2005, 2002, 19102005, 2002, 1910 SQL RP-versie 1.1.47.0SQL RP version 1.1.47.0 Windows Server 2016 Data Center-Server CoreWindows Server 2016 Datacenter - Server Core
    19081908 SQL RP-versie 1.1.33.0SQL RP version 1.1.33.0 Windows Server 2016 Data Center-Server CoreWindows Server 2016 Datacenter - Server Core
  • Zorg ervoor dat aan de vereisten voor Data Center-integratie wordt voldaan:Ensure datacenter integration prerequisites are met:

    VereistePrerequisite NaslaginformatieReference
    Het door sturen van voorwaardelijke DNS is correct ingesteld.Conditional DNS forwarding is set correctly. Integratie van Azure Stack hub-Data Center-DNSAzure Stack Hub datacenter integration - DNS
    Binnenkomende poorten voor resource providers zijn geopend.Inbound ports for resource providers are open. Azure Stack hub Data Center-integratie: poorten en protocollen binnenkomendAzure Stack Hub datacenter integration - Ports and protocols inbound
    Het onderwerp en het SAN van het PKI-certificaat zijn correct ingesteld.PKI certificate subject and SAN are set correctly. Verplichte PKI-vereisten voor de implementatie van Azure Stack-hubAzure Stack Hub deployment mandatory PKI prerequisites
    PaaS-certificaat vereisten voor de implementatie van Azure Stack hubAzure Stack Hub deployment PaaS certificate prerequisites

In een scenario waarbij de verbinding is verbroken, voert u de volgende stappen uit om de vereiste Power shell-modules te downloaden en de opslag plaats hand matig te registreren.In a disconnected scenario, complete the following steps to download the required PowerShell modules and register the repository manually.

  1. Meld u aan bij een computer met Internet verbinding en gebruik de volgende scripts om de Power shell-modules te downloaden.Sign in to a computer with internet connectivity and use the following scripts to download the PowerShell modules.
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"
  1. Voer een van de scripts uit, afhankelijk van de versie van de resource provider die u implementeert.Depending on the version of resource provider that you are deploying, run one of the scripts.
# 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
  1. Vervolgens kopieert u de gedownloade pakketten naar een USB-apparaat.Then you copy the downloaded packages to a USB device.

  2. Meld u aan bij het niet-verbonden werk station en kopieer de pakketten van het USB-apparaat naar een locatie op het werk station.Sign in to the disconnected workstation and copy the packages from the USB device to a location on the workstation.

  3. Registreer deze locatie als een lokale opslag plaats.Register this location as a local 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"

CertificatenCertificates

Alleen voor geïntegreerde systeem installaties.For integrated systems installations only. U moet het SQL PaaS PKI-certificaat opgeven dat wordt beschreven in de sectie optionele PaaS-certificaten van de PKI-vereisten voor de implementatie van Azure stack hub.You must provide the SQL PaaS PKI certificate described in the optional PaaS certificates section of Azure Stack Hub deployment PKI requirements. Plaats het pfx-bestand op de locatie die is opgegeven door de para meter DependencyFilesLocalPath .Place the .pfx file in the location specified by the DependencyFilesLocalPath parameter. Geef geen certificaat op voor ASDK-systemen.Don't provide a certificate for ASDK systems.

De SQL-resource provider implementerenDeploy the SQL resource provider

Nadat u alle vereiste onderdelen hebt voltooid, voert u het DeploySqlProvider.ps1 script uit vanaf een computer die toegang heeft tot zowel het Azure Stack hub Azure Resource Manager beheer eindpunt als het bevoegde eind punt om de SQL-resource provider te implementeren.After you've completed all of the prerequisites, run the DeploySqlProvider.ps1 script from a computer that can access both the Azure Stack Hub Azure Resource Manager admin endpoint and the privileged endpoint, to deploy the SQL resource provider. Het DeploySqlProvider.ps1 script wordt geëxtraheerd als onderdeel van het binaire bestand van de SQL-resource provider dat u hebt gedownload voor uw versie van Azure Stack hub.The DeploySqlProvider.ps1 script is extracted as part of the SQL resource provider binary that you downloaded for your version of Azure Stack Hub.

Belangrijk

Voordat u de resource provider implementeert, raadpleegt u de opmerkingen bij de release voor meer informatie over nieuwe functionaliteit, oplossingen en bekende problemen die van invloed kunnen zijn op uw implementatie.Before deploying the resource provider, review the release notes to learn about new functionality, fixes, and any known issues that could affect your deployment.

Als u de SQL-resource provider wilt implementeren, opent u een Nieuw Power shell-venster met verhoogde bevoegdheden (niet Power shell ISE) en gaat u naar de map waar u de binaire bestanden van de SQL-resource provider hebt uitgepakt.To deploy the SQL resource provider, open a new elevated PowerShell window (not PowerShell ISE) and change to the directory where you extracted the SQL resource provider binary files.

Belangrijk

We raden u ten zeerste aan het gebruik van een Clear-AzureRmContext-Scope voor het wissen van de cache te wissen voordat u het update script uitvoert.We strongly recommend using Clear-AzureRmContext -Scope CurrentUser and Clear-AzureRmContext -Scope Process to clear the cache before running the update script.

Voer het DeploySqlProvider.ps1 script uit, waarmee de volgende taken worden voltooid:Run the DeploySqlProvider.ps1 script, which completes the following tasks:

  • Hiermee worden de certificaten en andere artefacten geüpload naar een opslag account op Azure Stack hub.Uploads the certificates and other artifacts to a storage account on Azure Stack Hub.
  • Publiceert galerie pakketten zodat u SQL-data bases kunt implementeren met behulp van de galerie.Publishes gallery packages so you can deploy SQL databases using the gallery.
  • Publiceert een galerie pakket voor de implementatie van hosting servers.Publishes a gallery package for deploying hosting servers.
  • Hiermee wordt een virtuele machine geïmplementeerd met behulp van de installatie kopie van Windows Server 2016 core of de Windows Server-invoeg toepassing voor micro soft AzureStack die u hebt gedownload en wordt vervolgens de SQL-resource provider geïnstalleerd.Deploys a VM using the Windows Server 2016 core image or Microsoft AzureStack Add-on RP Windows Server image you downloaded, and then installs the SQL resource provider.
  • Hiermee wordt een lokale DNS-record geregistreerd die is toegewezen aan de VM van de resource provider.Registers a local DNS record that maps to your resource provider VM.
  • Registreert uw resource provider met de lokale Azure Resource Manager voor het operator account.Registers your resource provider with the local Azure Resource Manager for the operator account.

Notitie

Wanneer de implementatie van de SQL-resource provider wordt gestart, wordt de resource groep System. local. sqladapter gemaakt.When the SQL resource provider deployment starts, the system.local.sqladapter resource group is created. Het kan 75 minuten duren om de vereiste implementaties voor deze resource groep te volt ooien.It may take up to 75 minutes to finish the required deployments to this resource group. Plaats geen andere resources in de resource groep System. local. sqladapter .You should not place any other resources in the system.local.sqladapter resource group.

DeploySqlProvider.ps1 para metersDeploySqlProvider.ps1 parameters

U kunt de volgende para meters opgeven vanaf de opdracht regel.You can specify the following parameters from the command line. Als dat niet het geval is, of als een validatie van de para meter is mislukt, wordt u gevraagd om de vereiste para meters op te geven.If you don't, or if any parameter validation fails, you're prompted to provide the required parameters.

ParameternaamParameter name BeschrijvingDescription Opmerking of standaard waardeComment or default value
CloudAdminCredentialCloudAdminCredential De referentie voor de Cloud beheerder die nodig is om toegang te krijgen tot het bevoegde eind punt.The credential for the cloud admin, necessary for accessing the privileged endpoint. VereistRequired
AzCredentialAzCredential De referenties voor het beheerders account van de Azure Stack hub-service.The credentials for the Azure Stack Hub service admin account. Gebruik dezelfde referenties die u hebt gebruikt voor het implementeren van Azure Stack hub.Use the same credentials that you used for deploying Azure Stack Hub. Het script mislukt als het account dat u gebruikt met AzCredential multi-factor Authentication (MFA) vereist.The script will fail if the account you use with AzCredential requires multi-factor authentication (MFA). VereistRequired
VMLocalCredentialVMLocalCredential De referenties voor het lokale beheerders account van de virtuele machine van de SQL-resource provider.The credentials for the local admin account of the SQL resource provider VM. VereistRequired
PrivilegedEndpointPrivilegedEndpoint Het IP-adres of de DNS-naam van het bevoegde eind punt.The IP address or DNS name of the privileged endpoint. VereistRequired
AzureEnvironmentAzureEnvironment De Azure-omgeving van het service beheerders account dat wordt gebruikt voor de implementatie van Azure Stack hub.The Azure environment of the service admin account used for deploying Azure Stack Hub. Alleen vereist voor Azure AD-implementaties.Required only for Azure AD deployments. Ondersteunde omgevings namen zijn Cloud, AzureUSGovernment, of als u gebruikmaakt van een China Azure AD, AzureChinaCloud.Supported environment names are AzureCloud, AzureUSGovernment, or if using a China Azure AD, AzureChinaCloud. AzureCloudAzureCloud
DependencyFilesLocalPathDependencyFilesLocalPath Alleen voor geïntegreerde systemen moet het pfx-bestand van het certificaat in deze map worden geplaatst.For integrated systems only, your certificate .pfx file must be placed in this directory. U kunt eventueel één Windows Update MSU-pakket kopiëren.You can optionally copy one Windows Update MSU package here. Optioneel (verplicht voor geïntegreerde systemen)Optional (mandatory for integrated systems)
DefaultSSLCertificatePasswordDefaultSSLCertificatePassword Het wacht woord voor het pfx-certificaat.The password for the .pfx certificate. VereistRequired
MaxRetryCountMaxRetryCount Het aantal keren dat u elke bewerking opnieuw wilt proberen als er een fout optreedt.The number of times you want to retry each operation if there's a failure. 22
RetryDurationRetryDuration Het time-outinterval tussen nieuwe pogingen, in seconden.The timeout interval between retries, in seconds. 120120
VerwijderenUninstall Hiermee verwijdert u de resource provider en alle bijbehorende resources (Zie de volgende opmerkingen).Removes the resource provider and all associated resources (see the following notes). NeeNo
DebugModeDebugMode Hiermee wordt het automatisch opschonen van fouten voor komen.Prevents automatic cleanup on failure. NeeNo

De SQL-resource provider implementeren met behulp van een aangepast scriptDeploy the SQL resource provider using a custom script

Als u de 1.1.33.0 of vorige versies van de SQL-resource provider implementeert, moet u specifieke versies van AzureRm. Boots Trapper en Azure Stack hub-modules in Power Shell installeren.If you're deploying the SQL resource provider version 1.1.33.0 or previous versions, you need to install specific versions of AzureRm.BootStrapper and Azure Stack Hub modules in PowerShell. Als u de versie van de SQL-resource provider 1.1.47.0 of hoger implementeert, wordt door het implementatie script automatisch de benodigde Power shell-modules gedownload en geïnstalleerd op het pad C:\Program Files\SqlMySqlPsh.If you're deploying the SQL resource provider version 1.1.47.0 or later, the deployment script will automatically download and install the necessary PowerShell modules for you to path 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

Notitie

In het geval van een niet-verbonden scenario moet u de vereiste Power shell-modules downloaden en de opslag plaats hand matig registreren als een vereiste.In disconnected scenario, you need to download the required PowerShell modules and register the repository manually as a prerequisite.

U kunt het volgende script aanpassen om hand matige configuratie te elimineren bij het implementeren van de resource provider.To eliminate any manual configuration when deploying the resource provider, you can customize the following script. Wijzig de standaard accountgegevens en-wacht woorden als dat nodig is voor de implementatie van de Azure Stack hub.Change the default account information and passwords as needed for your Azure Stack Hub deployment.

# 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

Wanneer het installatie script van de bron provider is voltooid, vernieuwt u de browser om er zeker van te zijn dat u de meest recente updates kunt zien en de huidige Power shell-sessie sluit.When the resource provider installation script finishes, refresh your browser to make sure you can see the latest updates and close the current PowerShell session.

De implementatie controleren met behulp van de Azure Stack hub-PortalVerify the deployment using the Azure Stack Hub portal

  1. Meld u aan bij de beheerders portal als service beheerder.Sign in to the administrator portal as the service admin.
  2. Selecteer Resourcegroepen.Select Resource Groups.
  3. Selecteer de optie System. <location> .. sqladapter -resource groep.Select the system.<location>.sqladapter resource group.
  4. Op de overzichts pagina voor overzicht van de resource groep mogen er geen mislukte implementaties zijn.On the summary page for Resource group Overview, there should be no failed deployments.
  5. Selecteer tot slot virtuele machines in de beheer Portal om te controleren of de virtuele machine van de SQL-resource provider is gemaakt en wordt uitgevoerd.Finally, select Virtual machines in the administrator portal to verify that the SQL resource provider VM was successfully created and is running.

Volgende stappenNext steps

Hosting servers toevoegenAdd hosting servers