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

Cikk
10/30/2024

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 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 új funkciókat, a javításokat és az üzembe helyezést esetlegesen befolyásoló 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 ú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.

Támogatott Azure Stack Hub-verzió	SQL RP-verzió	Windows Server, amelyen az RP szolgáltatás fut
2206, 2301, 2306, 2311	AZ SQL RP 2.0.13.x-es verziója	Microsoft AzureStack bővítmény RP Windows Server 1.2009.0
2108, 2206	AZ SQL RP 2.0.6.x-es verziója	Microsoft AzureStack bővítmény RP Windows Server 1.2009.0

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 az SQL RP V1.1.93.x verzióra frissített, 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 1.1.93.x-ről az SQL RP 2.0.6.0-s verziójára

Előfeltételek

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. Ha még egy régi verziót használ, és az 1.1.93.x verzióra kell frissítenie, nyisson támogatási esetet segítségért.
nyisson meg egy támogatási esetet a MajorVersionUpgrade csomag beszerzéséhez, és adja hozzá előfizetését az ASH Marketplace engedélyezési listájához a jövőbeli V2-verzióhoz.
Töltse le a Microsoft AzureStack Add-On Windows Server 1.2009.0 RP-t a piactérre.
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.	Azure Stack Hub-adatközpont-integráció – Bejövő portok és protokollok
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

(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

A MajorVersionUpgrade szkript hiba nélkül fut.
Ellenőrizze az erőforrás-szolgáltatót a piactéren, és győződjön meg arról, hogy az SQL RP 2.0 telepítése sikeresen megtörtént.
A régi rendszer.<location.sqladapter> erőforráscsoport és rendszer.<A szkript nem törli automatikusan a location.dbadapter.dns> erőforráscsoportot az alapértelmezett szolgáltatói előfizetésben.

Javasoljuk, hogy a tárfiókot és a Key Vault egy ideig az sqladapter erőforráscsoportban tárolja. 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 kérhet a metaadatok visszaállításához az erőforráscsoportból.
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 1.1.93.x verzióra

Az SQL erőforrás-szolgáltató 1-es verzió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 verzióra való frissítéséhez használja a UpdateSQLProvider.ps1 szkriptet. A szolgáltatásfiókot helyi rendszergazdai jogosultságokkal használhatja, és az előfizetés tulajdonosa . Ezt a frissítési szkriptet az erőforrás-szolgáltató letöltése tartalmazza.

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 áttelepíti a beállításokat a régi erőforrás-szolgáltatóról az új erőforrás-szolgáltatóra.

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 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-adatok
a kiszolgáló adatainak üzemeltetése
kötelező DNS-rekord

Fontos

Szkriptparaméterek frissítése

A parancssorból a következő paramétereket 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, hogy adja meg a szükséges paramétereket.

Paraméter neve	Leírás	Megjegyzés vagy alapértelmezett érték
CloudAdminCredential	A felhő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ás rendszergazdai 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 sikertelen lesz, ha az AzCredential használatával 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 Microsoft Entra üzemelő példányokhoz szükséges. A támogatott környezetnevek az AzureCloud, az AzureUSGovernment vagy a China Microsoft Entra ID 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ópontos esetén kötelező
DefaultSSLCertificatePassword	A .pfx tanúsítvány jelszava.	Kötelező
MaxRetryCount	Az egyes műveletek újrapróbálkozási kísérleteinek száma, ha hiba történik.	2
RetryDuration	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.	No
DebugMode	Megakadályozza a hibák automatikus törlését.	No

Példa a PowerShell-példaszkript frissítéséhez

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 úton.

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. Ennek célja, hogy a PowerShell-modul megfelelő verzióját letöltse és felhasználja.

# 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ót az SQL-erőforrás-szolgáltató üzembe helyezése című témakörben talál.

Az alábbi példa egy emelt szintű PowerShell-konzolról futtathatóUpdateSQLProvider.ps1szkript használatát szemlélteti. Ü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ődik, zárja be az aktuális PowerShell-munkamenetet.

Következő lépések

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

Megosztás a következőn keresztül:

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

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

Frissítés az SQL RP 1.1.93.x-ről az SQL RP 2.0.6.0-s verziójára

Előfeltételek

Trigger MajorVersionUpgrade

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

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

Szkriptfolyamatok frissítése

Szkriptparaméterek frissítése

Példa a PowerShell-példaszkript frissítéséhez

Következő lépések

Visszajelzés

További források