Guia de Atualização de Vinyl

Visão Geral

Este é o guia de instruções para atualizar uma instalação existente do Vinyl de 3.2+ para 3.3. Se você estiver instalando o Vinyl pela primeira vez, consulte as instruções de instalação da 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.2 e atualize para o Vinyl 3.2 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

1. Pré-requisitos do .NET:

   • .NET 6.0 é necessário para Vinyl 3.3+. Este pré-requisito deve ser verificado se você estiver atualizando do Vinyl 3.2 ou anterior.

   • Para verificar se o .NET 6.0 está instalado:

     • Abra um prompt de comando e execute: dotnet --list-runtimes

       

     • Se "dotnet" não for um comando reconhecido ou você não vir um tempo de execução começando com "6.0", baixe o pacote .NET 6 Runtime neste URL:
       https://dotnet.microsoft.com/en-us/download/dotnet/6.0

2. Pré-requisitos do Crystal Reports:

   • O Vinyl requer o tempo de execução do Crystal Reports instalado no servidor do aplicativo

   • Crystal Reports SP21 é o mínimo para Vinyl 3.3 e SP21-SP32 são suportados

Habilitar Crystal Reports

Em sistemas Windows, o Vinyl suporta Crystal Reports. O Crystal Reports é hospedado fora do processo em um servidor COM. Siga estas etapas para registrar o servidor Crystal Reports COM.

1. Inicie o * Windows PowerShell* como administrador.

2. Mude para o diretório * Scripts* abaixo do diretório de instalação do Vinyl.

3. Execute o RegisterCrystalReports.ps1 script.

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.3.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.3.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 do 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.

Nota

Uma atualização que leva 5 minutos é normal; atualizações maiores podem demorar mais e atualizações menores podem ser executadas mais rapidamente.