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

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

  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 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
  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 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

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