A MySQL-erőforrás-szolgáltató frissítése az Azure Stack Hubban

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 ö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 a mySQL-kiszolgálót.

Amikor az Azure Stack Hub új buildet ad ki, kiadhatunk egy új MySQL-erőforrás-szolgáltató adaptert. Bár a meglévő adapter 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	MySQL RP-verzió	Windows Server, amelyen az RP szolgáltatás fut
2206, 2301, 2306, 2311	MySQL RP 2.0.13.x-es verzió	Microsoft AzureStack Bővítmény RP Windows Server 1.2009.0
2108, 2206	MySQL RP 2.0.6.x-es verzió	Microsoft AzureStack Bővítmény RP Windows Server 1.2009.0

A MySQL Server 2- erőforrás-szolgáltató frissítése

Ha már üzembe helyezte a MySQL 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 a MySQL RP V1-ről a MySQL RP V2-re szeretne frissíteni, először frissítsen a MySQL RP V1.1.93.x verzióra, majd alkalmazza a főverzió-frissítési folyamatot a MySQl RP V1-ről a MySQL RP V2-re való frissítéshez.

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

Előfeltételek

Győződjön meg arról, hogy a MySQL RP V1-et a legújabb 1.1.93.x verzióra frissíti. Az Alapértelmezett szolgáltatói előfizetés területen keresse meg az RP erőforráscsoportot (elnevezési formátum: system.<region>). mysqladapter). Ellenőrizze a verziócímkét és a MySQL 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 Azure Stack Hub megfelel az adatközpont-integráció előfeltételeinek.

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 a MySQL-erőforrás-szolgáltató üzembe helyezéséhez használt frissítési folyamathoz.
Készítse elő a MySQL Connector URI-t a szükséges verzióval. Részletekért tekintse meg a MySQL-erőforrás-szolgáltató üzembe helyezését ismertető cikket. például https://< storageAcountName.blob>.<régióban>.<FQDN>/<containerName>/mysql-connector-net-8.0.21.msi

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-MySQLRP'
# 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\mysqlcert\SSL.pfx"
# Local blob uri where stores the required mysql connector
$MySQLConnector = "Provide the MySQL Connector Uri according to Prerequisites step."
# 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\MajorVersionUpgradeMySQLProvider.ps1 -AzureEnvironment $AzureEnvironment -AzCredential $AdminCreds -CloudAdminCredential $CloudAdminCreds -Privilegedendpoint $privilegedEndpoint -PfxPassword $PfxPass -PfxCert $PfxFilePath -MySQLConnector $MySQLConnector

Megjegyzés

A MySQL 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 MySQLRPVM1130-PublicIP erőforrást. Az "nslookup mysqlrp.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 a MySQL RP 2.0 telepítése sikeresen megtörtént.
A régi rendszer.<location.mysqladapter> 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ókot és a Key Vault egy ideig a mysqladapter 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 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 a MySQL RP V1 korábbi verziójáról a MySQL RP V1.1.93.x verzióra

A MySQL 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 UpdateMySQLProvider.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.

Az erőforrás-szolgáltató frissítéséhez használja a UpdateMySQLProvider.ps1 szkriptet. Használja a szolgáltatásfiókot helyi rendszergazdai jogosultságokkal, és az előfizetés tulajdonosa . Az erőforrás-szolgáltató letöltése tartalmazza a frissítési szkriptet.

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 DeployMySqlProvider.ps1 szkript, és meg kell adnia a tanúsítványadatokat.

Szkriptfolyamatok frissítése

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

Szkriptparaméterek frissítése

A UpdateMySQLProvider.ps1 PowerShell-szkript futtatásakor adja meg a következő paramétereket a parancssorból. 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	Description	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 használatával használt fiók többtényezős hitelesítést (MFA) igényel.	Kötelező
VMLocalCredential	A MySQL 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 tanúsítvány .pfx fájlját is ebbe a könyvtárba kell helyezni.	Nem kötelező (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	Távolítsa el az erőforrás-szolgáltatót és az összes társított erőforrást (lásd az alábbi megjegyzéseket).	No
DebugMode	Megakadályozza a hibák automatikus törlését.	No
AcceptLicense	Kihagyja a GPL-licenc elfogadására vonatkozó kérést. (https://www.gnu.org/licenses/old-licenses/gpl-2.0.html)

Példa a szkript frissítéséhez

Ha a MySQL 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 a MySQL-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 a MySQL-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óUpdateMySQLProvider.ps1szkriptet mutatja be. Ü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 could have been changed at install time.
$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 environment names are AzureCloud, AzureUSGovernment, or AzureChinaCloud. 
$AzureEnvironment = "<EnvironmentName>"

# Point to the directory where the resource provider installation files were extracted. 
$tempDir = 'C:\TEMP\MYSQLRP' 

# The service admin account (can be Azure Active Directory or Active Directory Federation Services).
$serviceAdmin = "admin@mydomain.onmicrosoft.com" 
$AdminPass = ConvertTo-SecureString 'P@ssw0rd1' -AsPlainText -Force 
$AdminCreds = New-Object System.Management.Automation.PSCredential ($serviceAdmin, $AdminPass) 
 
# Set credentials for the new resource provider VM.
$vmLocalAdminPass = ConvertTo-SecureString 'P@ssw0rd1' -AsPlainText -Force 
$vmLocalAdminCreds = New-Object System.Management.Automation.PSCredential ("mysqlrpadmin", $vmLocalAdminPass) 
 
# And 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\UpdateMySQLProvider.ps1 -AzCredential $AdminCreds -VMLocalCredential $vmLocalAdminCreds -CloudAdminCredential $cloudAdminCreds -PrivilegedEndpoint $privilegedEndpoint -AzureEnvironment $AzureEnvironment -DefaultSSLCertificatePassword $PfxPass -DependencyFilesLocalPath $tempDir\cert -AcceptLicense

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

MySQL-erőforrás-szolgáltató karbantartása

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

A MySQL-erőforrás-szolgáltató frissítése az Azure Stack Hubban

A MySQL Server 2- erőforrás-szolgáltató frissítése

Frissítés a MySQL RP 1.1.93.x-ről a MySQL 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 a MySQL RP V1 korábbi verziójáról a MySQL RP V1.1.93.x verzióra

Szkriptfolyamatok frissítése

Szkriptparaméterek frissítése

Példa a szkript frissítéséhez

Következő lépések

Visszajelzés

További források