Aktualizowanie dostawcy zasobów SQLUpdate the SQL resource provider

Ważne

Przed aktualizacją dostawcy zasobów zapoznaj się z informacjami o wersji, aby dowiedzieć się więcej o nowych funkcjach, poprawkach i znanych problemach, które mogą mieć wpływ na wdrożenie.Before updating the resource provider, review the release notes to learn about new functionality, fixes, and any known issues that could affect your deployment. Informacje o wersji określają również minimalną wersję centrum Azure Stack wymaganą dla dostawcy zasobów.The release notes also specify the minimum Azure Stack Hub version required for the resource provider.

Nowy dostawca zasobów SQL może zostać wydzierżawiony, gdy Azure Stack centrum zostanie zaktualizowane do nowej kompilacji.A new SQL resource provider might be released when Azure Stack Hub is updated to a new build. Mimo że istniejący dostawca zasobów nadal działa, zalecamy aktualizację do najnowszej kompilacji najszybciej, jak to możliwe.Although the existing resource provider continues to work, we recommend updating to the latest build as soon as possible.

Obsługiwana wersja centrum Azure StackSupported Azure Stack Hub version Wersja RP SQLSQL RP version System Windows Server, na którym jest uruchomiona usługa RPWindows Server that RP service is running on
2008, 20052008, 2005 1.1.93.1 wersji SQL RPSQL RP version 1.1.93.1 Microsoft AzureStack — serwer RP systemu Windows ServerMicrosoft AzureStack Add-on RP Windows Server
2005, 2002, 19102005, 2002, 1910 1.1.47.0 wersji SQL RPSQL RP version 1.1.47.0 Windows Server 2016 Datacenter — Server CoreWindows Server 2016 Datacenter - Server Core
19081908 1.1.33.0 wersji SQL RPSQL RP version 1.1.33.0 Windows Server 2016 Datacenter — Server CoreWindows Server 2016 Datacenter - Server Core

Aktualizacja dostawcy zasobów SQL jest zbiorcza.SQL resource provider update is cumulative. W przypadku aktualizowania ze starej wersji można bezpośrednio przeprowadzić aktualizację do najnowszej wersji.When updating from an old version, you can directly update to the latest version.

Aby zaktualizować dostawcę zasobów, Użyj skryptu UpdateSQLProvider.ps1 .To update the resource provider, use the UpdateSQLProvider.ps1 script. Użyj konta usługi z lokalnymi prawami administracyjnymi i jest właścicielem subskrypcji.Use your service account with local administrative rights and is an owner of the subscription. Ten skrypt aktualizacji jest dołączony do pobrania dostawcy zasobów.This update script is included with the download of the resource provider.

Proces aktualizacji jest podobny do procesu użytego do wdrożenia dostawcy zasobów.The update process is similar to the process used to Deploy the resource provider. Skrypt aktualizacji używa tych samych argumentów co skrypt DeploySqlProvider.ps1 i należy podać informacje o certyfikacie.The update script uses the same arguments as the DeploySqlProvider.ps1 script, and you'll need to provide certificate information.

Aktualizowanie procesów skryptuUpdate script processes

Skrypt UpdateSQLProvider.ps1 tworzy nową maszynę wirtualną z najnowszym obrazem systemu operacyjnego, wdraża najnowszy kod dostawcy zasobów i migruje ustawienia ze starego dostawcy zasobów do nowego dostawcy zasobów.The UpdateSQLProvider.ps1 script creates a new virtual machine (VM) with the latest OS image, deploy the latest resource provider code, and migrates the settings from the old resource provider to the new resource provider.

Uwaga

Zalecamy pobranie najnowszego obrazu systemu Windows Server 2016 Core lub systemu Windows Server, który został dodany do programu Microsoft AzureStacke z zarządzania w portalu Marketplace.We recommend that you download the latest Windows Server 2016 Core image or Microsoft AzureStack Add-on RP Windows Server image from Marketplace Management. Jeśli musisz zainstalować aktualizację, możesz umieścić pojedynczy pakiet msu w ścieżce zależności lokalnej.If you need to install an update, you can place a single MSU package in the local dependency path. Skrypt zakończy się niepowodzeniem, jeśli w tej lokalizacji znajduje się więcej niż jeden plik MSU.The script will fail if there's more than one MSU file in this location.

Po utworzeniu nowej maszyny wirtualnej przez skrypt UpdateSQLProvider.ps1 skrypt migruje następujące ustawienia ze starej maszyny wirtualnej dostawcy zasobów:After the UpdateSQLProvider.ps1 script creates a new VM, the script migrates the following settings from the old resource provider VM:

  • Informacje o bazie danychdatabase information
  • Informacje o serwerze hostinguhosting server information
  • wymagany rekord DNSrequired DNS record

Aktualizuj parametry skryptuUpdate script parameters

Następujące parametry można określić w wierszu polecenia podczas uruchamiania skryptu programu UpdateSQLProvider.ps1 PowerShell.You can specify the following parameters from the command line when you run the UpdateSQLProvider.ps1 PowerShell script. Jeśli nie, lub jeśli sprawdzanie poprawności parametrów nie powiedzie się, zostanie wyświetlony monit o podanie wymaganych parametrów.If you don't, or if any parameter validation fails, you're prompted to provide the required parameters.

Nazwa parametruParameter name OpisDescription Komentarz lub wartość domyślnaComment or default value
CloudAdminCredentialCloudAdminCredential Poświadczenie administratora chmury niezbędne do uzyskania dostępu do uprzywilejowanego punktu końcowego.The credential for the cloud admin, necessary for accessing the privileged endpoint. WymaganeRequired
AzCredentialAzCredential Poświadczenia konta administratora usługi Azure Stack Hub.The credentials for the Azure Stack Hub service admin account. Użyj tych samych poświadczeń, które zostały użyte do wdrożenia centrum Azure Stack.Use the same credentials that you used for deploying Azure Stack Hub. Skrypt zakończy się niepowodzeniem, jeśli konto używane z usługą AzCredential wymaga uwierzytelniania wieloskładnikowego (MFA).The script will fail if the account you use with AzCredential requires multi-factor authentication (MFA). WymaganeRequired
VMLocalCredentialVMLocalCredential Poświadczenia dla konta administratora lokalnego na maszynie wirtualnej dostawcy zasobów SQL.The credentials for the local admin account of the SQL resource provider VM. WymaganeRequired
PrivilegedEndpointPrivilegedEndpoint Adres IP lub nazwa DNS uprzywilejowanego punktu końcowego.The IP address or DNS name of the privileged endpoint. WymaganeRequired
AzureEnvironmentAzureEnvironment Środowisko platformy Azure konta administratora usługi, które zostało użyte do wdrożenia centrum Azure Stack.The Azure environment of the service admin account which you used for deploying Azure Stack Hub. Wymagane tylko w przypadku wdrożeń usługi Azure AD.Required only for Azure AD deployments. Obsługiwane nazwy środowisk to AzureCloud, AzureUSGovernment lub w przypadku korzystania z usługi Azure AD, AzureChinaCloud.Supported environment names are AzureCloud, AzureUSGovernment, or if using a China Azure AD, AzureChinaCloud. AzureCloudAzureCloud
DependencyFilesLocalPathDependencyFilesLocalPath Musisz również umieścić plik PFX certyfikatu w tym katalogu.You must also put your certificate .pfx file in this directory. Opcjonalne dla pojedynczego węzła, ale obowiązkowe dla wielowęzłowegoOptional for single node, but mandatory for multi-node
DefaultSSLCertificatePasswordDefaultSSLCertificatePassword Hasło certyfikatu PFX.The password for the .pfx certificate. WymaganeRequired
MaxRetryCountMaxRetryCount Ile razy chcesz ponowić każdą operację w przypadku wystąpienia błędu.The number of times you want to retry each operation if there's a failure. 22
RetryDurationRetryDuration Interwał limitu czasu między ponownymi próbami (w sekundach).The timeout interval between retries, in seconds. 120120
OdinstalowywanieUninstall Usuwa dostawcę zasobów i wszystkie powiązane zasoby.Removes the resource provider and all associated resources. NieNo
DebugujmodeDebugMode Uniemożliwia automatyczne czyszczenie w przypadku niepowodzenia.Prevents automatic cleanup on failure. NieNo

Przykład aktualizacji skryptu programu PowerShellUpdate script PowerShell example

Jeśli aktualizujesz wersję dostawcy zasobów SQL do 1.1.33.0 lub poprzednich wersji, musisz zainstalować określone wersje programu AzureRm. Bootstrap i Azure Stack modułów centrum w programie PowerShell.If you are updating the SQL resource provider version to 1.1.33.0 or previous versions, you need to install specific versions of AzureRm.BootStrapper and Azure Stack Hub modules in PowerShell.

Jeśli aktualizujesz dostawcę zasobów SQL do wersji 1.1.47.0 lub nowszej, możesz pominąć ten krok.If you are updating the SQL resource provider to version 1.1.47.0 or later, you can skip this step. Skrypt wdrożenia automatycznie pobierze i zainstaluje niezbędne moduły programu PowerShell do ścieżki C:\Program Files\SqlMySqlPsh.The deployment script will automatically download and install the necessary PowerShell modules for you to path C:\Program Files\SqlMySqlPsh.

Uwaga

Jeśli folder C:\Program Files\SqlMySqlPsh już istnieje w ramach pobranego modułu programu PowerShell, zaleca się oczyszczenie tego folderu przed uruchomieniem skryptu aktualizacji.If folder C:\Program Files\SqlMySqlPsh already exists with PowerShell module downloaded, it is recommended to clean up this folder before running the update script. Jest to konieczne, aby upewnić się, że odpowiednia wersja modułu programu PowerShell została pobrana i użyta.This is to make sure the right version of PowerShell module is downloaded and used.

# 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

Uwaga

W przypadku scenariusza rozłączenia należy pobrać wymagane moduły programu PowerShell i zarejestrować repozytorium ręcznie jako warunek wstępny.In disconnected scenario, you need to download the required PowerShell modules and register the repository manually as a prerequisite. Więcej informacji można znaleźć w temacie wdrażanie dostawcy zasobów SQLYou can get more information in Deploy SQL resource provider

Poniżej przedstawiono przykład użycia skryptu UpdateSQLProvider.ps1 , który można uruchomić z poziomu konsoli programu PowerShell z podwyższonym poziomem uprawnień.The following is an example of using the UpdateSQLProvider.ps1 script that you can run from an elevated PowerShell console. Pamiętaj, aby zmienić informacje o zmiennej i hasła w razie potrzeby:Be sure to change the variable information and passwords as needed:

# 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

Po zakończeniu działania skryptu aktualizacji dostawcy zasobów zamknij bieżącą sesję programu PowerShell.When the resource provider update script finishes, close the current PowerShell session.

Następne krokiNext steps

Obsługa dostawcy zasobów SQLMaintain the SQL resource provider