Guia de Atualização de Vinyl¶

Introdução¶

Este é o guia de instruções para atualizar uma instalação existente do Vinyl de 3.1+ para 3.2. Se você estiver instalando pela primeira vez, consulte as instruções de instalação para sua versão do Vinyl e sistema de servidor. Se você estiver atualizando de uma versão anterior do Vinyl, há instruções de atualização significativas. Consulte o guia de atualização do Vinyl 3.1 e atualize para o Vinyl 3.1 primeiro.

Este guia assume que o diretório raiz da versão atualmente instalada do Vinyl é C:\inetpub\wwwroot\Vinyl e que o sistema já possui o software e a estrutura pré-requisitos instalados e configurados.

Pré-requisitos¶

O Microsoft .NET Framework 4.8 é necessário para o Vinyl 3.1+. Versões anteriores do .NET Framework não são suportadas pelo Vinyl 3.1 ou superior. Este pré-requisito deve ser verificado se você estiver atualizando do Vinyl 3.0 ou inferior e confirmado antes de atualizar para a versão atual do Vinyl.

Para verificar a versão .NET atualmente instalada:

• Comando Powershell para verificar a versão .NET:

  Get-ChildItem "HKLM:SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\" | GetItemPropertyValue -Name Release | ForEach-Object
  

• Se o comando Powershell não funcionar, siga o artigo da Microsoft para verificar e determinar a versão:

  https://docs.microsoft.com/en-us/dotnet/framework/migration-guide/how-to-determine-what-versions-are-installed

Instruções de Atualização¶

Preparando-se para Atualização¶

1. Anote a versão atual do Vinyl que você está executando, caso precise restaurar para esta versão.

2. Pare o IIS. Você pode fazer isso entrando no Gerenciador do IIS, selecionando o servidor Web apropriado e clicando no botão Parar no canto superior direito do painel Ações.

3. Faça backup de seus bancos de dados caso precise recuperá-los posteriormente.

Implantando Novo Software¶

1. Baixe o arquivo (Vinyl-3.2.xxxxx.zip).

2. Após mover o arquivo para o servidor web, certifique-se de que a "marca da web" (MOTW) seja removida do arquivo zip, clicando com o botão direito no arquivo e verificando as propriedades e selecionando "Desbloquear" se necessário.

   

3. Mova o conteúdo do diretório raiz anterior do Vinyl para uma pasta de backup.

4. Extraia o novo arquivo para um diretório temporário (por exemplo, C:\Vinyl-3.2.xxxxx)

5. Copie todo o conteúdo do diretório temporário para o diretório raiz do aplicativo Vinyl (por exemplo, C:\inetpub\wwwroot\Vinyl).

6. Copie o arquivo Connection.xml do diretório de backup para o diretório Vinyl.

7. Se você tiver alguma personalização no arquivo appsettings.json, copie-a da pasta de backup para o diretório Vinyl.

8. Copie o diretório Keys do seu backup para a nova pasta também.

9. Exclua o diretório temporário que você criou.

Configuração¶

1. Abra o Gerenciador IIS

2. Expanda a pasta Vinyl.

3. Clique com o botão direito na pasta data e escolha a opção Edit Permissions....

4. Selecione a aba Segurança.

5. Clique no botão Editar para abrir a caixa de diálogo Permissões para dados.

6. Clique no botão Adicionar... para abrir a caixa de diálogo Selecionar usuários ou grupos.

7. Forneça o nome IIS AppPool\Vinyl no campo inferior.

8. Marque Permitir controle total no campo Permissões e clique no botão OK para fechar a caixa de diálogo Permissões para dados.

9. Clique no botão OK para fechar a caixa de diálogo Propriedades dos dados.

10. Repita as etapas 3 a 9 para os diretórios logs e keys também

11. Reinicie o IIS selecionando o servidor e clicando no botão Iniciar no painel Ações.

Sequência de Teste Sugerida¶

1. Inicie seu navegador.

2. Navegue até http://localhost/Vinyl/.

3. O Vinyl atualizará automaticamente o(s) banco(s) de dados. O sistema começará a responder normalmente assim que a atualização for concluída.