Guia de Atualização de Vinyl¶

Introdução¶

Este é o guia de instruções para atualizar uma instalação existente do Vinyl para a versão 3.0+. Se você estiver instalando pela primeira vez, consulte as instruções de instalação para sua versão do Vinyl e sistema de servidor.

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.7.2 ou superior é necessário para o Vinyl 3.0 ou superior. Versões anteriores do .NET Framework não são suportadas pelo Vinyl 3.0 ou superior. Este pré-requisito deve ser verificado se você estiver atualizando do Vinyl 2.6 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\" | Get-ItemPropertyValue -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.0.xxxxx.zip).

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

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

4. Copie o conteúdo do diretório do site para o diretório raiz do aplicativo Vinyl (por exemplo, C:\inetpub\wwwroot\Vinyl).

   Nota

   Nesta etapa, certifique-se de detalhar a estrutura da pasta até ver o conteúdo do site.

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

6. Se você tiver alguma customização no diretório Config, copie-a para o novo diretório Config.

7. 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 App_Data e escolha a opção Editar permissões....

4. Selecione a aba Segurança.

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

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

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

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