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.1+. 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.8 ou superior é necessário para o Vinyl 3.1 ou superior. 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

Você também deve garantir que o ASP.NET Core Runtime Hosting Bundle para 2.1 esteja instalado. Baixe o pacote de hospedagem.

Mudanças da Versão Anterior¶

• É necessário .NET Framework 4.8 (veja acima)

• O pacote de hospedagem ASP.NET Core Runtime é necessário (veja acima)

Mudanças na Estrutura do Diretório¶

Existem mudanças na estrutura do caminho de diretório no Vinyl 3.1 em relação às versões anteriores do Vinyl. É importante observar isso ao atualizar e pode afetar os caminhos de fontes de dados existentes configurados anteriormente. O caminho exato do diretório usado dependerá de onde o Vinyl foi instalado em seu ambiente e pode ser diferente desta documentação.

Após a atualização, revise quaisquer caminhos de fonte de dados configurados que dependam de uma diretiva de caminho de diretório e faça as atualizações necessárias para refletir as alterações da versão 3.1. Por exemplo: Sistema de arquivos local

• Os registros estão agora em {Vinyl Install Path}\Vinyl\logs vs. {Vinyl Install Path}\Vinyl\App_Data

  • Para o Elastic Beanstalk o caminho recomendado é: C:\inetpub\AspNetCoreWebApps\Vinyl\logs

• Para todos os outros ambientes o caminho recomendado é: C:\inetpub\wwwroot\Vinyl\logs

• O diretório de dados está agora em {Vinyl Install Path}\Vinyl\data vs. {Vinyl Install Path}\Vinyl\App_Data

  • Para o Elastic Beanstalk o caminho recomendado é: C:\inetpub\AspNetCoreWebApps\Vinyl\data

• Para todos os outros ambientes o caminho recomendado é: C:\inetpub\wwwroot\Vinyl\data

• As chaves de criptografia no disco estão agora em {Vinyl Install Path}\Vinyl\keys vs. {Vinyl Install Path}\Vinyl\App_Data\keys

  • Para o Elastic Beanstalk o caminho recomendado é: C:\inetpub\AspNetCoreWebApps\Vinyl\keys

• Para todos os outros ambientes o caminho recomendado é: C:\inetpub\wwwroot\Vinyl\keys

• A configuração agora está em appsettings.json versus configuração em web.config, bem como no diretório Config. O Vinyl vem com appsettings.default.json – renomeie para appsettings.json se você ainda não tiver um arquivo chamado appsettings.json.

• Você copiará o conteúdo do diretório temporário diretamente para o C:\inetpub\wwwroot\Vinyl pasta ou para C:\inetpub\AspNetCoreWebApps\Vinyl se você estiver no Elastic Beanstalk

Alterações no AWS Elastic Beanstalk¶

Algumas das propriedades de ambiente no Elastic Beanstalk foram alteradas. Aqui estão as capturas de tela mostrando a versão antiga e a nova:

Inalterado¶

• Informações de conexão

Renomeado¶

(Valor antigo → Novo para 3.1 e valor recomendado)

• DataEncryptionKeyStorage → DataEncryption:KeyStorage
• DataEncryptionKeyS3BucketEndpoint → DataEncryption:S3BucketEndpoint
• DataEncryptionKeyS3KeyPrefix → DataEncryption:S3KeyPrefix
• ForwardedClientIpHeader → ReverseProxy:ForwardedClientIpHeader
• ForwardedPortHeader → ReverseProxy:ForwardedPortHeader
• ForwardedSchemeHeader → ReverseProxy:ForwardedSchemeHeader
• SharedStateProvider → SharedState:Provider
• RedisConnectionString → SharedState:RedisConnectionString
• RedisPrefix → SharedState:RedisPrefix

A plataforma mais recente é recomendada (Windows Server 2019/2.6.2):

Se estiver usando o Elastic Beanstalk e ainda não estiver executando o Windows Server 2019/2.6.2, você precisará reconstruir sua imagem AMI e/ou usar a imagem base mais recente do Jitterbit.

Alterações na Configuração Local¶

Todas as definições de configuração agora podem ser definidas dentro C:\inetpub\wwwroot\Vinyl\appsettings.json

O Vinyl 3.1 ainda lerá o arquivo connection.xml para propriedades de conexão se ele estiver localizado aqui: C:\inetpub\wwwroot\Vinyl\connection.xml

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.1.xxxxx.zip).

   • Para obter o arquivo .ZIP correto, se seu ambiente for Elastic Beanstalk, Linux ou se você tiver incluído plug-ins adicionais de terceiros, envie email para vinylinfo@jitterbit.com. Caso contrário, o arquivo .ZIP está disponível no Vinyl Community Forum em Vinyl Releases.

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.1.xxxxx)

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

   Nota

   Você copiará o conteúdo do diretório temporário diretamente para o C:\inetpub\wwwroot\Vinyl pasta. Isso é diferente dos lançamentos anteriores do Vinyl.

6. Atualizando C:\inetpub\wwwroot\appsettings.json arquivo com informações de conexão OU Copie o arquivo Connection.xml do diretório de backup para o diretório raiz do Vinyl. (C:\inetpub\wwrwroot\Vinyl – isso é diferente dos lançamentos anteriores do Vinyl).

7. Se você tiver alguma customização no diretório Config, você fará essas alterações em appsettings.json. Entre em contato com o suporte se tiver alguma dúvida.

8. 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 keys e logs também.

    Nota

    Esta etapa é crítica para ser concluída para uma atualização bem-sucedida.

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.