Az SQL típusú erőforrás-szolgáltató frissítése

Fontos

Az Azure Stack Hub 2108-ban készült buildjeitől kezdve az SQL- és MySQL-erőforrás-szolgáltatókat a hozzáféréssel rendelkező előfizetések számára kínáljuk fel. Ha el szeretné kezdeni a funkció használatát, vagy ha egy korábbi verzióról szeretne frissíteni, nyisson meg egy támogatási esetet , és támogatási mérnökeink végigvezetik önt az üzembe helyezési vagy frissítési folyamaton.

Fontos

Az erőforrás-szolgáltató frissítése előtt tekintse át a kibocsátási megjegyzéseket, és ismerje meg az üzembe helyezést esetlegesen befolyásoló új funkciókat, javításokat és ismert problémákat. A kibocsátási megjegyzések az erőforrás-szolgáltatóhoz szükséges minimális Azure Stack Hub-verziót is meghatározzák.

Fontos

Az erőforrás-szolgáltató frissítése NEM frissíti az üzemeltetési SQL Server.

Előfordulhat, hogy egy új SQL-erőforrás-szolgáltató jelenik meg, amikor az Azure Stack Hub új buildre frissül. Bár a meglévő erőforrás-szolgáltató továbbra is működik, javasoljuk, hogy a lehető leghamarabb frissítsen a legújabb buildre.

Az Azure Stack Hub támogatott verziója SQL RP-verzió Windows Server, amelyen az RP szolgáltatás fut
2108,2206 AZ SQL RP 2.0.6.x-es verziója Microsoft AzureStack Bővítmény RP Windows Server 1.2009.0
2108, 2102, 2008, 2005 SQL RP 1.1.93.5-ös verzió Microsoft AzureStack bővítmény RP Windows Server
2005, 2002, 1910 SQL RP 1.1.47.0-s verzió Windows Server 2016 Datacenter – Server Core
1908 AZ SQL RP 1.1.33.0-s verziója Windows Server 2016 Datacenter – Server Core

SQL Server erőforrás-szolgáltató V2 frissítése

Ha már üzembe helyezte az SQL RP V2-t, és frissítéseket szeretne keresni, tekintse meg a Frissítések alkalmazása az erőforrás-szolgáltatóra című témakört.

Ha az SQL RP V1-ről az SQL RP V2-re szeretne frissíteni, győződjön meg arról, hogy először frissített az SQL RP V1.1.93.x verzióra, majd alkalmazza a főverzió-frissítési folyamatot az SQl RP V1-ről az SQL RP V2-re való frissítéshez.

Frissítés AZ SQL RP V1.1.93.x-ről az SQL RP V2.0.6.0-ra

Előfeltételek

  1. Győződjön meg arról, hogy frissítette az SQL RP V1-et a legújabb 1.1.93.x verzióra. Az Alapértelmezett szolgáltatói előfizetés területen keresse meg az RP erőforráscsoportot (elnevezési formátum: system.<region>). sqladapter). Ellenőrizze a verziócímkét és az SQL RP virtuális gép nevét az erőforráscsoportban.

  2. nyisson meg egy támogatási esetet a MajorVersionUpgrade csomag beszerzéséhez, és adja hozzá az előfizetését az ASH marketplace engedélyezési listájához a jövőbeli V2-verzióhoz.

  3. Töltse le a Microsoft AzureStack Add-On Windows Server 1.2009.0 RP-t a piactérre.

  4. Győződjön meg arról, hogy az adatközpont-integráció előfeltételei teljesülnek.

Előfeltétel Referencia
A feltételes DNS-továbbítás helyesen van beállítva. Az Azure Stack Hub adatközpont-integrációja – DNS
Az erőforrás-szolgáltatók bejövő portjai nyitva vannak. Az Azure Stack Hub adatközpont-integrációja – Portok és protokollok bejövő
A PKI-tanúsítvány tárgya és a SAN megfelelően van beállítva. Az Azure Stack Hub üzembe helyezésének kötelező PKI-előfeltételei
Az Azure Stack Hub üzembe helyezésének PaaS-tanúsítvány előfeltételei
  1. (leválasztott környezet esetén) Telepítse a szükséges PowerShell-modulokat, hasonlóan az erőforrás-szolgáltató üzembe helyezéséhez használt frissítési folyamathoz.

Trigger MajorVersionUpgrade

Futtassa a következő szkriptet egy emelt szintű PowerShell-konzolról a főverzió-frissítés végrehajtásához.

Megjegyzés

Győződjön meg arról, hogy a szkriptet futtató ügyfélszámítógép operációs rendszer verziója nem régebbi, mint Windows 10 vagy Windows Server 2016, és az ügyfélszámítógép X64 operációsrendszer-architektúrával rendelkezik.

Fontos

Határozottan javasoljuk, hogy a Clear-AzureRmContext -Scope CurrentUser és a Clear-AzureRmContext -Scope folyamat használatával törölje a gyorsítótárat az üzembe helyezési vagy frissítési szkript futtatása előtt.

# 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-SQLRP'

# 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\sqlcert\SSL.pfx"

# 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\MajorVersionUpgradeSQLProvider.ps1 -AzureEnvironment $AzureEnvironment -AzCredential $AdminCreds -CloudAdminCredential $CloudAdminCreds -Privilegedendpoint $privilegedEndpoint -PfxPassword $PfxPass -PfxCert $PfxFilePath

Megjegyzés

Az SQL RP V2 DNS-címe és a hozzá tartozó IP-cím eltérő. Az új nyilvános IP-cím beszerzéséhez forduljon az ügyfélszolgálathoz, és kérjen drP-törésüveget, és keresse meg a SQLRPVM1130-PublicIP erőforrást. Az "nslookup sqlrp.dbadapter" parancsot is futtathatja.< fqdn>" egy olyan ügyfélszámítógépről, amely már teljesítette a végponttesztet a nyilvános IP-cím megkereséséhez.

A frissítés sikerességének ellenőrzése

  1. A MajorVersionUpgrade szkript hiba nélkül fut.
  2. Ellenőrizze az erőforrás-szolgáltatót a marketplace-en, és győződjön meg arról, hogy az SQL RP 2.0 telepítése sikeresen megtörtént.
  3. A régi rendszer.< location.sqladapter> erőforráscsoport és rendszer.< A location.dbadapter.dns> erőforráscsoportot az alapértelmezett szolgáltatói előfizetésben a szkript nem törli automatikusan.
  • Javasoljuk, hogy a Tárfiók és a Key Vault egy ideig maradjon az sqladapter erőforráscsoportban. Ha a frissítés után bármely bérlői felhasználó inkonzisztens adatbázis- vagy bejelentkezési metaadatokat észlel, támogatást kaphat a metaadatok erőforráscsoportból való visszaállításához.
  • Miután ellenőrizte, hogy a dbadapter.dns erőforráscsoport DNS-zónája üres-e DNS-rekord nélkül, biztonságosan törölheti a dbadapter.dns erőforráscsoportot.
  • [FONTOS] Ne használja a V1 üzembe helyezési szkriptet a V1 verzió eltávolításához. A frissítés befejezése és a frissítés sikerességének megerősítése után manuálisan törölheti az erőforráscsoportot a szolgáltatói előfizetésből.

Frissítés az SQL RP V1 korábbi verziójáról az SQL RP V1.1.93.x verzióra

Az SQL-erőforrás-szolgáltató V1 frissítése összegző. Közvetlenül frissíthet az 1.1.93.x verzióra.

Az erőforrás-szolgáltató 1.1.93.x-ra való frissítéséhez használja a UpdateSQLProvider.ps1 szkriptet. Használja a szolgáltatásfiókot helyi rendszergazdai jogosultságokkal, és az előfizetés tulajdonosa . Ez a frissítési szkript szerepel az erőforrás-szolgáltató letöltésében.

A frissítési folyamat hasonló az erőforrás-szolgáltató üzembe helyezéséhez használt folyamathoz. A frissítési szkript ugyanazokat az argumentumokat használja, mint a DeploySqlProvider.ps1 szkript, és meg kell adnia a tanúsítványadatokat.

Szkriptfolyamatok frissítése

A UpdateSQLProvider.ps1 szkript létrehoz egy új virtuális gépet (VM) a legújabb operációsrendszer-lemezképpel, üzembe helyezi a legújabb erőforrás-szolgáltatói kódot, és migrálja a beállításokat a régi erőforrás-szolgáltatóból az új erőforrás-szolgáltatóba.

Megjegyzés

Javasoljuk, hogy töltse le a Microsoft AzureStack Bővítmény RP Windows Server 1.2009.0 rendszerképét a Marketplace Managementből. Ha telepítenie kell egy frissítést, egyetlen MSU-csomagot helyezhet el a helyi függőségi útvonalon. A szkript sikertelen lesz, ha egynél több MSU-fájl található ezen a helyen.

Miután a UpdateSQLProvider.ps1 szkript létrehozott egy új virtuális gépet, a szkript a következő beállításokat migrálja a régi erőforrás-szolgáltató virtuális gépről:

  • adatbázis adatai
  • kiszolgáló adatainak üzemeltetése
  • kötelező DNS-rekord

Fontos

Határozottan javasoljuk, hogy a Clear-AzureRmContext -Scope CurrentUser és a Clear-AzureRmContext -Scope folyamat használatával törölje a gyorsítótárat az üzembe helyezési vagy frissítési szkript futtatása előtt.

Szkriptparaméterek frissítése

A következő paramétereket a parancssorból adhatja meg a UpdateSQLProvider.ps1 PowerShell-szkript futtatásakor. Ha nem, vagy ha valamelyik paraméter érvényesítése sikertelen, a rendszer kérni fogja a szükséges paraméterek megadását.

Paraméter neve Leírás Megjegyzés vagy alapértelmezett érték
CloudAdminCredential A felhőalapú rendszergazda hitelesítő adatai, amely a kiemelt végpont eléréséhez szükséges. Kötelező
AzCredential Az Azure Stack Hub szolgáltatásadminisztrátori fiókjának hitelesítő adatai. Használja ugyanazokat a hitelesítő adatokat, amelyeket az Azure Stack Hub üzembe helyezéséhez használt. A szkript meghiúsul, ha az AzCredential-hoz használt fiók többtényezős hitelesítést (MFA) igényel. Kötelező
VMLocalCredential Az SQL-erőforrás-szolgáltató virtuális gép helyi rendszergazdai fiókjának hitelesítő adatai. Kötelező
PrivilegedEndpoint A kiemelt végpont IP-címe vagy DNS-neve. Kötelező
AzureEnvironment Az Azure Stack Hub üzembe helyezéséhez használt szolgáltatás-rendszergazdai fiók Azure-környezete. Csak Azure AD üzemelő példányokhoz szükséges. A támogatott környezetnevek az AzureCloud, az AzureUSGovernment vagy a Kínai Azure AD használata esetén az AzureChinaCloud. AzureCloud
DependencyFilesLocalPath A .pfx tanúsítványfájlt is ebbe a könyvtárba kell helyeznie. Nem kötelező egyetlen csomóponthoz, de többcsomópontoshoz kötelező
DefaultSSLCertificatePassword A .pfx-tanúsítvány jelszava. Kötelező
MaxRetryCount Az egyes műveletek újrapróbálkozásának száma, ha hiba történik. 2
Újrapróbálkozás Az újrapróbálkozások közötti időtúllépési időköz másodpercben. 120
Eltávolítás Eltávolítja az erőforrás-szolgáltatót és az összes társított erőforrást. Nem
DebugMode Megakadályozza a hibák automatikus törlését. Nem

Példaszkript frissítése PowerShell-lel

Ha az SQL-erőforrás-szolgáltató verzióját az 1.1.33.0-s vagy korábbi verzióra frissíti, telepítenie kell az AzureRm.BootStrapper és az Azure Stack Hub modulok adott verzióit a PowerShellben.

Ha az SQL-erőforrás-szolgáltatót az 1.1.47.0-s vagy újabb verzióra frissíti, kihagyhatja ezt a lépést. Az üzembehelyezési szkript automatikusan letölti és telepíti a szükséges PowerShell-modulokat a C:\Program Files\SqlMySqlPsh elérési úthoz.

Megjegyzés

Ha a C:\Program Files\SqlMySqlPsh mappa már létezik a letöltött PowerShell-modullal, javasoljuk, hogy a frissítési szkript futtatása előtt törölje a mappát. Ezzel meggyőződhet arról, hogy a PowerShell-modul megfelelő verziója le van töltve és használatban van.

# 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

Megjegyzés

Leválasztott forgatókönyv esetén le kell töltenie a szükséges PowerShell-modulokat, és előfeltételként manuálisan kell regisztrálnia az adattárat. További információkért tekintse meg az SQL-erőforrás-szolgáltató üzembe helyezését ismertető témakört.

Az alábbiakban egy példa látható az emelt szintű PowerShell-konzolon futtathatóUpdateSQLProvider.ps1szkript használatára. Ügyeljen arra, hogy szükség szerint módosítsa a változó adatait és jelszavát:

# 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

Amikor az erőforrás-szolgáltató frissítési szkriptje befejeződött, zárja be az aktuális PowerShell-munkamenetet.

Következő lépések

Az SQL-erőforrás-szolgáltató karbantartása