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

Fontos

A Azure Stack Hub 2108-as buildtől kezdődően a SQL- és MySQL-erőforrásszolgáltatók olyan előfizetések számára állnak rendelkezésre, amelyek hozzáférést kaptak. Ha el szeretné kezdeni használni ezt a funkciót, vagy ha egy korábbi verzióról szeretne frissíteni, nyisson meg egy támogatási esetet, és a támogatási szakembereink 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 az új funkciókkal, javításokkal és az üzembe helyezést esetlegesen érintő ismert problémákkal kapcsolatban. A kibocsátási megjegyzések az erőforrás-szolgáltatóhoz Azure Stack Hub minimálisan szükséges verziót is megszabadják.

Fontos

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

Egy új SQL erőforrás-szolgáltató akkor szabadulhat fel, Azure Stack Hub új buildre frissítik. 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ója SQL RP verziója Windows az a kiszolgáló, amelyen az RP szolgáltatás fut
2108 SQL RP 2.0.6.x verziója Microsoft AzureStack add-on RP Windows Server 1.2009.0
2108, 2102, 2008, 2005 SQL RP 1.1.93.5-ös verziója Microsoft AzureStack add-on RP Windows Server
2005, 2002, 1910 SQL RP 1.1.47.0-s verziója Windows Server 2016 Datacenter – Server Core
1908 SQL RP 1.1.33.0-s verziója Windows Server 2016 Datacenter – Server Core

Frissítés SQL Server V2 erőforrás-szolgáltatóhoz

Ha már telepítette SQL RP V2-t, és szeretné ellenőrizni a frissítéseket, tekintse meg a frissítések erőforrás-szolgáltatóra való alkalmazásával kapcsolatos jelölőnégyzetet.

Ha az SQL RP V1-ről az SQL RP V2-re szeretne frissíteni, először frissítsen az SQL RP V1.1.93.x verzióra, majd alkalmazza a főverzió frissítési folyamatát az SQl RP V1-ről az SQL RP V2-re való frissítéshez.

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

Előfeltételek

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

  2. nyisson egy támogatási esetet a MajorVersionUpgrade csomag lekértjéhez, és adja hozzá az előfizetését az MARKETPLACE engedélyezési listához a későbbi V2 verzióhoz.

  3. Töltse le a Microsoft AzureStack Add-On RP Windows Server 1.2009.0-s verziójáról a Marketplace-re.

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

Előfeltétel Referencia
A feltételes DNS-továbbítás megfelelően van beállítva. 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ója – Bejövő portok és protokollok
A PKI-tanúsítvány tárgya és a SAN megfelelően van beállítva. Azure Stack Hub telepítés kötelező PKI-előfeltételei
Azure Stack Hub PaaS-tanúsítvány előfeltételei
  1. (leválasztott környezetben) Telepítse a szükséges PowerShell-modulokat az erőforrás-szolgáltató üzembe helyezéséhez használt frissítési folyamathoz hasonlóan.

Főverzió kiváltásaUpgrade

Futtassa a következő szkriptet a főverzió frissítésének végrehajtásához.

Ha a parancsfájlt az operációs rendszer Windows 10 vagy Windows Server 2016 verziójánál régebbi verziójú ügyfélszámítógépen futtatja, vagy ha az ügyfélszámítógép nem rendelkezik X64 operációsrendszer-architektúrával, a parancsfájlt az Operator Access Workstation (OAW)munkaállomáson kell futtatnia.

  1. [Ha az OAW-on futtatja a szkriptet] Tiltsa le a FIPS-t az alábbi szkript futtatásával. Ezután indítsa újra a PowerShellt.
Set-ItemProperty -Path HKLM:\System\CurrentControlSet\Control\Lsa\FIPSAlgorithmPolicy -Name Enabled -Value 0 -ErrorAction Stop 
  1. Futtassa a következő szkriptet egy emelt szintű PowerShell-konzolról.
# Check Operating System version
$osVersion = [environment]::OSVersion.Version
if ($osVersion.Build -lt 10240)
{
    Write-Host "OS version is too old: $osVersion. Please consider using OAW and disable FIPS to perform the major upgrade."
    return
}

$osArch = (Get-WmiObject Win32_OperatingSystem).OSArchitecture
if ($osArch -ne "64-bit")
{
    Write-Host "OS Architecture is not 64 bit. Please consider using OAW and disable FIPS to perform the major upgrade."
    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
  1. [Ha az OAW-on futtatja a szkriptet] Engedélyezze újra a FIPS-t az alábbi szkript futtatásával.
Set-ItemProperty -Path HKLM:\System\CurrentControlSet\Control\Lsa\FIPSAlgorithmPolicy -Name Enabled -Value 1 -ErrorAction Stop 

A frissítés sikeres voltának ellenőrzése

  1. A MajorVersionUpgrade szkript hiba nélkül végre van hajtva.
  2. Ellenőrizze a piactéren az erőforrás-szolgáltatót, és győződjön meg arról, SQL RP 2.0 telepítése sikeresen megtörtént.
  3. A régi rendszer. A szkript nem törli automatikusan a location > .sqladapter erőforráscsoportot az alapértelmezett szolgáltatói előfizetésben. Miután ellenőrizze, hogy a frissítés sikeres volt-e, és hogy nincs-e más erőforrás az erőforráscsoportban, manuálisan törölheti az erőforráscsoportot.

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

SQL erőforrás-szolgáltató V1 frissítése kumulatív. 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. Használja a szolgáltatásfiókot helyi rendszergazdai jogosultságokkal, és az előfizetés tulajdonosa. Ez a frissítési szkript az erőforrás-szolgáltató letöltéséhez tartozik.

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

Szkriptfolyamatok frissítése

Az UpdateSQLProvider.ps1-szkript létrehoz egy új virtuális gépet (VM) a legújabb operációsrendszer-rendszerképpel, üzembe helyezheti 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 add-on RP Windows Server 1.2009.0 rendszerképet a Marketplace Management webhelyről. Ha frissítést kell telepítenie, egyetlen MSU-csomagot is telepíthet 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 létrehozott egy új virtuális gépet, a szkript a következő beállításokat migrálta a régi erőforrás-szolgáltató virtuális gépről:

  • adatbázis-információk
  • kiszolgáló információinak üzemeltetése
  • szükséges DNS-rekord

Fontos

Határozottan javasoljuk a Clear-AzureRmContext -Scope CurrentUser és a Clear-AzureRmContext -Scope folyamat használatát a gyorsítótár kiürítése érdekében az üzembe helyezési vagy frissítési szkript futtatása előtt.

Szkriptparaméterek frissítése

Az alábbi paramétereket adhatja meg a parancssorból a PowerShell-UpdateSQLProvider.ps1 futtatásakor. Ha nem, vagy ha valamelyik paraméter érvényesítése sikertelen, a rendszer a szükséges paramétereket kéri.

Paraméter neve Leírás Megjegyzés vagy alapértelmezett érték
CloudAdminCredential A felhőbeli rendszergazda hitelesítő adatai, amelyek a kiemelt végpont eléréséhez szükségesek. Kötelező
AzCredential Az Azure Stack Hub szolgáltatás rendszergazdai fiókjának hitelesítő adatai. Használja ugyanazt a hitelesítő adatokat, mint a Azure Stack Hub. A szkript sikertelen lesz, ha az AzCredential-hez használt fiók többtényezős hitelesítést (MFA) igényel. Kötelező
VMLocalCredential Az erőforrás-szolgáltató virtuális gép helyi rendszergazdai fiókjának SQL hitelesítő adatai. Kötelező
PrivilegedEndpoint A kiemelt végpont IP-címe vagy DNS-neve. Kötelező
AzureKörnyezet A szolgáltatás üzembe helyezéséhez használt szolgáltatás-rendszergazdai fiók Azure-Azure Stack Hub. Csak Azure AD-környezetek esetén szükséges. A támogatott környezetnevek: AzureCloud,AzureUSGovernment, vagy china Azure AD, AzureChinaCloud. AzureCloud
DependencyFilesLocalPath A tanúsítvány .pfx fájlját is ebbe a könyvtárba kell tenni. Nem kötelező egyetlen csomóponthoz, de több csomópontosak esetén kötelező
DefaultSSLCertificatePassword A .pfx tanúsítvány jelszava. Kötelező
MaxRetryCount Az egyes műveletek újrapróbálkozási száma hiba esetén. 2
RetryDuration (Újrapróbálkozás) Az újraküldetés közötti időkorlát 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
Hibakeresési mód Megakadályozza a sikertelen automatikus tisztítást. Nem

Példa PowerShell-szkript frissítésére

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

Ha a SQL 1.1.47.0-s vagy újabb verzióra frissíti, kihagyhatja ezt a lépést. Az üzembe helyezé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 takarítsa meg ezt a mappát. Ezzel győződhet meg arról, hogy a PowerShell-modul megfelelő verziója van letöltve és használva.

# 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 regisztrálnia kell az adattárat. További információt a Deploy SQL resource provider (Erőforrás-szolgáltató SQL) oldalon talál.

Az alábbi példa egy rendszergazda jogú PowerShell-konzolról futtathatóUpdateSQLProvider.ps1 szkriptet. Szükség szerint módosítsa a változók adatait és jelszavait:

# 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 szkripte befejeződik, zárja be az aktuális PowerShell-munkamenetet.

Következő lépések

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