Update the SQL resource provider (Atualizar o fornecedor de recursos do SQL)Update the SQL resource provider

Importante

Antes de atualizar o fornecedor de recursos, reveja as notas de lançamento para saber sobre novas funcionalidades, correções e quaisquer problemas conhecidos que possam afetar a sua implementação.Before updating the resource provider, review the release notes to learn about new functionality, fixes, and any known issues that could affect your deployment. As notas de lançamento também especificam a versão mínima Azure Stack Hub necessária para o fornecedor de recursos.The release notes also specify the minimum Azure Stack Hub version required for the resource provider.

Um novo fornecedor de recursos SQL poderá ser lançado quando o Azure Stack Hub for atualizado para uma nova construção.A new SQL resource provider might be released when Azure Stack Hub is updated to a new build. Embora o fornecedor de recursos existente continue a funcionar, recomendamos atualização para a construção mais recente o mais rapidamente possível.Although the existing resource provider continues to work, we recommend updating to the latest build as soon as possible.

Versão suportada do Azure Stack HubSupported Azure Stack Hub version Versão SQL RPSQL RP version Servidor do Windows que o serviço RP está em execuçãoWindows Server that RP service is running on
2008, 20052008, 2005 SQL RP versão 1.1.93.0SQL RP version 1.1.93.0 Microsoft AzureStack Add-on RP Windows Server INTERNAL APENASMicrosoft AzureStack Add-on RP Windows Server INTERNAL ONLY
2005, 2002, 19102005, 2002, 1910 SQL RP versão 1.1.47.0SQL RP version 1.1.47.0 Centro de dados do Windows Server 2016 - Núcleo do ServidorWindows Server 2016 Datacenter - Server Core
19081908 SQL RP versão 1.1.33.0SQL RP version 1.1.33.0 Centro de dados do Windows Server 2016 - Núcleo do ServidorWindows Server 2016 Datacenter - Server Core

A atualização do fornecedor de recursos SQL é cumulativa.SQL resource provider update is cumulative. Ao atualizar a partir de uma versão antiga, pode atualizar diretamente para a versão mais recente.When updating from an old version, you can directly update to the latest version.

Para atualizar o fornecedor de recursos, utilize o UpdateSQLProvider.ps1 script.To update the resource provider, use the UpdateSQLProvider.ps1 script. Utilize a sua conta de serviço com direitos administrativos locais e é proprietária da subscrição.Use your service account with local administrative rights and is an owner of the subscription. Este script de atualização está incluído com o download do fornecedor de recursos.This update script is included with the download of the resource provider.

O processo de atualização é semelhante ao processo utilizado para implementar o fornecedor de recursos.The update process is similar to the process used to Deploy the resource provider. O script de atualização usa os mesmos argumentos que o script DeploySqlProvider.ps1, e você precisará fornecer informações de certificado.The update script uses the same arguments as the DeploySqlProvider.ps1 script, and you'll need to provide certificate information.

Atualizar processos de scriptUpdate script processes

O scriptUpdateSQLProvider.ps1 cria uma nova máquina virtual (VM) com a mais recente imagem de SO, implementa o mais recente código do fornecedor de recursos e migra as definições do antigo fornecedor de recursos para o novo fornecedor de recursos.The UpdateSQLProvider.ps1 script creates a new virtual machine (VM) with the latest OS image, deploy the latest resource provider code, and migrates the settings from the old resource provider to the new resource provider.

Nota

Recomendamos que descarregue a mais recente imagem core do Windows Server 2016 ou a imagem do Microsoft AzureStack Add-on RP Windows Server da Marketplace Management.We recommend that you download the latest Windows Server 2016 Core image or Microsoft AzureStack Add-on RP Windows Server image from Marketplace Management. Se precisar de instalar uma atualização, pode colocar um único pacote MSU no caminho da dependência local.If you need to install an update, you can place a single MSU package in the local dependency path. O script falhará se houver mais de um ficheiro MSU neste local.The script will fail if there's more than one MSU file in this location.

Após o UpdateSQLProvider.ps1 script criar um novo VM, o script migra as seguintes definições do antigo provedor de recursos VM:After the UpdateSQLProvider.ps1 script creates a new VM, the script migrates the following settings from the old resource provider VM:

  • informações sobre bases de dadosdatabase information
  • hospedar informações do servidorhosting server information
  • registo DNS necessáriorequired DNS record

Atualizar parâmetros de scriptUpdate script parameters

Pode especificar os seguintes parâmetros da linha de comando quando executar o UpdateSQLProvider.ps1 script PowerShell.You can specify the following parameters from the command line when you run the UpdateSQLProvider.ps1 PowerShell script. Se não o fizer, ou se alguma validação de parâmetros falhar, é solicitado que forneça os parâmetros necessários.If you don't, or if any parameter validation fails, you're prompted to provide the required parameters.

Nome do parâmetroParameter name DescriçãoDescription Comentário ou valor predefinidoComment or default value
CloudAdminCredentialCloudAdminCredential A credencial para a administração da nuvem, necessária para aceder ao ponto final privilegiado.The credential for the cloud admin, necessary for accessing the privileged endpoint. ObrigatórioRequired
AzCredentialAzCredential As credenciais para a conta de administração do serviço Azure Stack Hub.The credentials for the Azure Stack Hub service admin account. Use as mesmas credenciais que usou para implantar o Azure Stack Hub.Use the same credentials that you used for deploying Azure Stack Hub. ObrigatórioRequired
VMLocalCredentialVMLocalCredential As credenciais para a conta de administração local do fornecedor de recursos SQL VM.The credentials for the local admin account of the SQL resource provider VM. ObrigatórioRequired
Ponto privilegiadoPrivilegedEndpoint O endereço IP ou o nome DNS do ponto final privilegiado.The IP address or DNS name of the privileged endpoint. ObrigatórioRequired
AzureEnvironmentAzureEnvironment O ambiente Azure da conta de administração de serviço que usou para implantar o Azure Stack Hub.The Azure environment of the service admin account which you used for deploying Azure Stack Hub. Requerido apenas para implementações AZure AD.Required only for Azure AD deployments. Os nomes ambientais suportados são AzureCloud, AzureUSGovernment, ou se usando um AD AZure China, AzureChinaCloud.Supported environment names are AzureCloud, AzureUSGovernment, or if using a China Azure AD, AzureChinaCloud. AzureCloudAzureCloud
DependênciaFilesLocalPathDependencyFilesLocalPath Deve também colocar o seu arquivo certificado .pfx neste diretório.You must also put your certificate .pfx file in this directory. Opcional para nó único, mas obrigatório para vários nósOptional for single node, but mandatory for multi-node
Palavra-passe defaultsslcertateDefaultSSLCertificatePassword A senha do certificado .pfx.The password for the .pfx certificate. ObrigatórioRequired
MaxRetryCountMaxRetryCount O número de vezes que quer repetir cada operação se houver uma falha.The number of times you want to retry each operation if there's a failure. 22
RetripduraçãoRetryDuration O intervalo de tempo entre as recauchutagens, em segundos.The timeout interval between retries, in seconds. 120120
DesinstalarUninstall Remove o fornecedor de recursos e todos os recursos associados.Removes the resource provider and all associated resources. NãoNo
DebugModeDebugMode Evita a limpeza automática em avarias.Prevents automatic cleanup on failure. NãoNo

Atualizar o exemplo PowerShellUpdate script PowerShell example

Se estiver a atualizar a versão do fornecedor de recursos SQL para versões 1.1.33.0 ou anteriores, tem de instalar versões específicas dos módulos AzureRm.BootStrapper e Azure Stack Hub no PowerShell.If you are updating the SQL resource provider version to 1.1.33.0 or previous versions, you need to install specific versions of AzureRm.BootStrapper and Azure Stack Hub modules in PowerShell.

Se estiver a atualizar o fornecedor de recursos SQL para a versão 1.1.47.0 ou mais tarde, pode saltar este passo.If you are updating the SQL resource provider to version 1.1.47.0 or later, you can skip this step. O script de implementação descarregará automaticamente e instalará os módulos PowerShell necessários para que possa seguir o caminho C:\Program Files\SqlMySqlPsh.The deployment script will automatically download and install the necessary PowerShell modules for you to path C:\Program Files\SqlMySqlPsh.

Nota

Se a pasta C:\Program Files\SqlMySqlPsh já existir com o módulo PowerShell descarregado, é aconselhável limpar esta pasta antes de executar o script de atualização.If folder C:\Program Files\SqlMySqlPsh already exists with PowerShell module downloaded, it is recommended to clean up this folder before running the update script. Isto é para garantir que a versão certa do módulo PowerShell é descarregada e usada.This is to make sure the right version of PowerShell module is downloaded and used.

# 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

Nota

Em cenário desconectado, é necessário descarregar os módulos PowerShell necessários e registar o repositório manualmente como pré-requisito.In disconnected scenario, you need to download the required PowerShell modules and register the repository manually as a prerequisite. Pode obter mais informações no Fornecedor de recursos Deploy SQLYou can get more information in Deploy SQL resource provider

Segue-se um exemplo de utilização do UpdateSQLProvider.ps1script que podes executar a partir de uma consola PowerShell elevada.The following is an example of using the UpdateSQLProvider.ps1 script that you can run from an elevated PowerShell console. Certifique-se de alterar as informações e senhas variáveis conforme necessário:Be sure to change the variable information and passwords as needed:

# 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

Quando o script de atualização do fornecedor de recursos terminar, feche a sessão atual do PowerShell.When the resource provider update script finishes, close the current PowerShell session.

Passos seguintesNext steps

Manter o fornecedor de recursos SQLMaintain the SQL resource provider