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 |
---|---|---|
2206, 2301, 2306 | SQL RP 2.0.13.x-es verzió | 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 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
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 meg egy támogatási esetet segítségért.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.
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 megfelelően 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 helyesen 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 marketplace-en, é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 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 sikertelen lesz, 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 Microsoft Entra üzemelő példányokhoz szükséges. A támogatott környezetnevek az AzureCloud, az AzureUSGovernment vagy a China Microsoft Entra ID, azureChinaCloud használata esetén. | 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
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: