A MySQL-erőforrás-szolgáltató frissítése az Azure Stack Hubban
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
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 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
Visszajelzés
Hamarosan elérhető: 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ó: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: