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

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. As notas de lançamento também especificam a versão mínima Azure Stack Hub necessária para o fornecedor de recursos.

Importante

A atualização do fornecedor de recursos NÃO atualizará o SQL Server de hospedagem.

Um novo fornecedor de recursos SQL poderá ser lançado quando o Azure Stack Hub for atualizado para uma nova construção. Embora o fornecedor de recursos existente continue a funcionar, recomendamos atualização para a construção mais recente o mais rapidamente possível.

Versão suportada do Azure Stack Hub versão RP SQL Windows Servidor que o serviço RP está em execução
2102, 2008, 2005 SQL versão RP 1.1.93.5 Microsoft AzureStack Add-on RP Windows Server
2005, 2002, 1910 SQL versão RP 1.1.47.0 datacenter Windows Server 2016 - Núcleo do Servidor
1908 SQL versão RP 1.1.33.0 datacenter Windows Server 2016 - Núcleo do Servidor

SQL atualização do fornecedor de recursos é cumulativa. Ao atualizar a partir de uma versão antiga, pode atualizar diretamente para a versão mais recente.

Para atualizar o fornecedor de recursos, utilize o UpdateSQLProvider.ps1 script. Utilize a sua conta de serviço com direitos administrativos locais e é proprietária da subscrição. Este script de atualização está incluído com o download do fornecedor de recursos.

O processo de atualização é semelhante ao processo utilizado para implementar o fornecedor de recursos. O script de atualização usa os mesmos argumentos que o script DeploySqlProvider.ps1, e você precisará fornecer informações de certificado.

Atualizar processos de script

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.

Nota

Recomendamos que descarregue a mais recente imagem Windows Server 2016 Core ou a imagem do Microsoft AzureStack Add-on RP Windows Server da Marketplace Management. Se precisar de instalar uma atualização, pode colocar um único pacote MSU no caminho da dependência local. O script falhará se houver mais de um ficheiro MSU neste local.

Após o UpdateSQLProvider.ps1 script criar um novo VM, o script migra as seguintes definições do antigo provedor de recursos VM:

  • informações sobre bases de dados
  • hospedar informações do servidor
  • registo DNS necessário

Importante

Recomendamos vivamente a utilização de Clear-AzureRmContext -Scope CurrentUser e Clear-AzureRmContext -Scope Process para limpar a cache antes de executar o script de implementação ou atualização.

Atualizar parâmetros de script

Pode especificar os seguintes parâmetros da linha de comando quando executar o UpdateSQLProvider.ps1 script PowerShell. Se não o fizer, ou se alguma validação de parâmetros falhar, é solicitado que forneça os parâmetros necessários.

Nome do parâmetro Descrição Comentário ou valor predefinido
CloudAdminCredential A credencial para a administração da nuvem, necessária para aceder ao ponto final privilegiado. Obrigatório
AzCredential As credenciais para a conta de administração do Azure Stack Hub. Use as mesmas credenciais que usou para implantar o Azure Stack Hub. O script falhará se a conta que utilizar com o AzCredential necessitar de autenticação multi-factor (MFA). Obrigatório
VMLocalCredential As credenciais para a conta de administração local do SQL fornecedor de recursos VM. Obrigatório
Ponto privilegiado O endereço IP ou o nome DNS do ponto final privilegiado. Obrigatório
AzureEnvironment O ambiente Azure da conta de administração de serviço que usou para implantar o Azure Stack Hub. Requerido apenas para implementações AZure AD. Os nomes do ambiente suportados são AzureCloud, AzureUSGovernment,ou se usando um AD AZure China, AzureChinaCloud. AzureCloud
DependênciaFilesLocalPath Deve também colocar o seu arquivo certificado .pfx neste diretório. Opcional para nó único, mas obrigatório para vários nós
Palavra-passe defaultsslcertificatePassword A senha do certificado .pfx. Obrigatório
MaxRetryCount O número de vezes que pretende voltar a tentar cada operação se houver uma falha. 2
Retripduração O intervalo de tempo entre as recauchutagens, em segundos. 120
Desinstalar Remove o fornecedor de recursos e todos os recursos associados. No
DebugMode Evita a limpeza automática em avarias. No

Atualizar o exemplo PowerShell

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.

Se estiver a atualizar o fornecedor de recursos SQL para a versão 1.1.47.0 ou posterior, pode saltar este passo. O script de implementação irá descarregar e instalar automaticamente os módulos PowerShell necessários para que possa seguir o caminho 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. Isto é para garantir que a versão certa do módulo PowerShell é descarregada e usada.

# 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. Pode obter mais informações no Fornecedor de recursos implementar SQL

Segue-se um exemplo de utilização do UpdateSQLProvider.ps1script que podes executar a partir de uma consola PowerShell elevada. Certifique-se de alterar as informações e senhas variáveis conforme necessário:

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

Passos seguintes

Manter o fornecedor de recursos SQL