Versões comparadas

Versão antiga 1

changes.mady.by.user Usuário desconhecido (lucas.scaglia)

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Leonir Zimmermann

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice:

1-

Estrutura dos pacotes

Preparação

2-

Procedimentos Pré-

Atualização

3- Atualização em Produção



Objetivo:

Este documento descreve os procedimentos, operacionais e de segurança, para atualização da versão do Linx DMS.

Painel
borderColor#FFFFF0
titleColor#FFFFFF
titleBGColor#3C0066
titleEstrutura dos PacotesPreparação

1.

Página de Download:

DVI - Liberações Linx DMS | DMS Automotivo - Automotivo - Linx Share

2. Pacotes específicos para cada versão:

  • Pacotes Normal, Client e Server (programas desktop)

  • Módulo Mobile Apk

  • Módulo eCommerce

3. Pacotes únicos para qualquer versão:

  • Linx DMS Web

  • Linx DMS Integrador

  • EFD Reinf

  • Hub Bancário

  • Integração Parcerias

4. Diferença entre pacote Essencial e Evolutivo (programas desktop):

  • Essencial: Recebe apenas correções de versões anteriores. Ideal para clientes que desejam estabilidade e não precisam de novos recursos.

  • Evolutivo: Recebe correções e novos recursos implementados na versão atual.

Dúvida frequente:

Posso alternar entre os pacotes Essencial e Evolutivo?

Sim! Ambos pacotes utilizam o mesmo script.

Exemplos:

Caso tenha optado inicialmente pelo Essencial, mas precisar utilizar uma nova funcionalidade, substitua pelo pacote Evolutivo.

Caso esteja utilizando o pacote Evolutivo a seja impactado por alguma funcionalidade nova, pode voltar para o Essencial enquanto é corrigido.

5. Scripts de atualização de versões

Acima do quadro principal de downloads, há um mergulho onde podemos visualizar e baixar os scripts de atualização de cada versão

Faça um backup atualizadoda base de produção.

2. Prepare seu ambiente de TESTE/TREINO:

  • Atualize a base de teste/treino com o backup atualizado da base de produção.

  • Atualize o script, o instalador web e os programas desktop no ambiente de treino seguindo os "Procedimentos de Atualização", descritos no próximo quadro.

3. Na Página do DVI, leia os Release Notes de atualizações:

Image Added

4. Defina e execute, junto aos usuários, as jornadas mais críticas pelos módulos do sistema.







1. Verifique em qual versão você está e faça o download dos pacotes necessários para atualizar para a última versão, observando o tópico anterior "Estrutura do Pacote".

Atenção! Caso você esteja saltando mais de uma versão, é necessário rodar os scripts das versões posteriores na ordem correta, disponibilizados na página do DVI, acima dos pacotes principais.

Exemplo: Se estou na versão 5.08 e quero ir direto para a versão 5.10, vou precisar baixar e executar o script da 5.09 antes do script da 5.10.

2.Faça um backup atualizadoda base de produção.

3. Atualize seu ambiente de TESTE/TREINO:

  • Base de Dados = atualize a base de teste/treino com o backup atualizado da base de produção, criado no item 2.

  • Programas = baixe e extraia pacotes baixados no item 1. no ambiente de teste/treino.

  • Linx DMS Web = atualize o último instalador no ambiente de teste/treino.

4. Defina e execute as jornadas mais críticas pelos módulos do sistema a fim de testar as novas funcionalidades e verificar impactos nas rotinas mais utilizadas, trazendo os usuários para analisar e sanar possíveis dúvidas.

Painel
borderColor#FFFFF0
titleColor#FFFFFF
titleBGColor#3C0066
titleProcedimentos Pré-Atualização
Painel
borderColor#FFFFF0
titleColor#FFFFFF
titleBGColor#3C0066
titleAtualização em Produção


Atenção! Recomendamos fortemente que, antes de prosseguir com a atualização em Produção, tenham sido feitos os procedimentos descritos no tópico anterior: "Procedimentos Pré-Atualização".

1.Sem usuários ativos no sistema, execute o(s) script(s) de atualização para a versão desejada. Acima do quadro principal de downloads da pagina do DI, há um mergulho onde podemos visualizar e baixar os scripts de atualização de cada versão.

Atenção!

  • Caso você esteja saltando mais de uma versão, é necessário rodar os scripts das versões posteriores na ordem correta.

  • Analise do log: É de extrema importância que seja verificado o arquivo de "LogExecucao_AAAAMMDDHHmissccc.txt" e observado o seu conteúdo. Este arquivo deverá conter apenas uma linha, trazendo informações sobre a base de dados, a data e hora da execução e o caminho completo da pasta onde o script foi executado. Se este arquivo apresentar mais de uma linha, com qualquer outra informação, será imprescindível voltar o backup da base para restabelecer o funcionamento do sistema na versão anterior, e depois o envio do log de execução para a Linx, através de um contato com o Suporte Nacional para análise. 

2. Atualize os pacotes baixados no item 1. do tópico anterior "Procedimentos Pré-Atualização" no ambiente de produção. Caso utilize 3 Camadas, atualize o pacote Server no Servidor de Aplicação. Os pacotes Normal e Client são replicados para os usuários pela pasta Atualiza.

3. Atualize o Linx DMS Web (LinxDMS.exe) e aguarde cerca de 30 minutos para as verificações de Scripts que rodam em segundo plano.

4. Utilizando usuário ADMIN, faça login no sistema e atualize a Chave de Liberação.

5. Verifique se os usuários estão conseguindo utilizar o sistema normalmente.
Aviso

Atenção! Antes de atualizar em PRODUÇÃO, certifique-se de ter feito o backup do banco de dados e seguido os demais passos no quadro "Preparação" desta documentação. 



1. Atualização do Banco de Dados

Expandir
titlevisualizar


Aviso

Este passo é obrigatório apenas para atualizar para uma versão superior. Para atualizar os programas da versão em uso, pule este tem 1.

a. Acesse a página do DVI pelo link: DVI - Liberações Linx DMS | DMS Automotivo - Automotivo - Linx Share


b. Na sessão "Downloads", localize o quadro "Download dos scripts de atualização de versão" e clique em "Scripts" para visualizar os links de download. Baixe todos os scripts das versões posteriores ao seu banco de dados.

Image Added

c. Extraia o(s) script(s) da versão que deseja atualizar dentro da pasta que contém os programas desktop do Linx DMS. 

Image Added


b. Cada script deve ser executado apenas uma vez e sem usuários ativos no sistema. Após iniciado, não poderá ser parado/cancelado, sendo necessário aguardar a finalização de sua execução. Após finalizar, será gerado o log dentro da pasta no formato LogExecucao_AnoMesDiaHoraMinuto.txt com o resultado do processo. O resultado não pode conter mais de uma linha. Abaixo, temos um exemplo de log bem-sucedido.

Image Added


e. Com o log de execução estando ok, conforme imagem acima, a atualização do banco de dados estará concluída. Caso o log apresente erros, orientamos que seja restaurado o backup e aberto um chamado no suporte com o log anexado para análise.





2. Atualização do Linx DMS Web

Expandir
titlevisualizar


Aviso
  • A atualização do Linx DMS Web é obrigatória. Todas as telas do sistema já desenvolvidas em Web, quando acessadas pela aplicação Desktop, passarão a serem exibidas apenas na Web.
  • O Linx DMS (web) pode ser atualizado durante o expediente com usuários ativos no sistema, porém durante a atualização não será possível acessar o Linx DMS Web devido a reinicialização (stop e start) dos serviços envolvidos.


a. Acesse a página do DVI pelo link: DVI - Liberações Linx DMS | DMS Automotivo - Automotivo - Linx Share


b. Na sessão "Downloads", localize o quadro "Download dos produtos principais e módulos complementares" e clique no Produto Principal contratado para visualizar os links de download.

O link de download do pacote Linx DMS Web está destacado na imagem abaixo:

Image Added


c. A atualização é feita através do instalador/atualizador LinxDMS.exe, sendo necessário baixar, descompactar e executar como administrador no computador em que o serviço está instalado (não precisa estar na pasta dos programas Desktop).

Image Added


d. Ao executar, selecione a opção "Atualizar os pacotes", clique em <Avançar>. O executável irá parar os serviços necessários e aparecerá uma tela com a opção <Instalar>. Clique nessa opção, assim ele fará toda a atualização e iniciará os serviços novamente após finalizar. 

Image Added

e. Para garantir que a atualização foi realizada corretamente e que ela foi efetiva, verifique os tópicos da página a seguir: Atualização do Linx DMS (Web)



Informações

Para mais detalhes sobre o funcionamento/instalação, acesse a página a seguir: Manual de Instalação do Linx DMS




3. Atualização dos Programas Desktop

Expandir
titlevisualizar - Normal


Aviso
  • O procedimento a seguir deve ser executado no ambiente do Servidor de Aplicação.


a. Acesse a página do DVI pelo link: DVI - Liberações Linx DMS | DMS Automotivo - Automotivo - Linx Share


b. Na sessão "Downloads", localize o quadro "Download dos produtos principais e módulos complementares" e clique no Produto Principal contratado para visualizar os links de download.

O link de download do pacote Desktop Normal está destacado na imagem abaixo. Neste exemplo, estamos atualizando para a versão 5.11 Essencial.

Image Added


c. A atualização destes programas podem ser feitas de 2 formas:

  • Manual - Extraindo o pacote diretamente na pasta onde ficam os programas desktop do sistema de todos os usuários.
  • Automática - Utilizando o CnpUpd.exe


Informações
titleO que é o CnpUpd.exe?

É um executável que fica dentro da pasta dos programas desktop e dentro do diretório de atualização, que copia os arquivos do diretório de atualização para as pastas dos usuários.

Ele normalmente vem no pacote de implantação, se não houver, abra um chamado no suporte solicitando ele.

Para que ele funcione, é necessário ter o executável dentro da pasta dos programas desktop do sistema e ter o arquivo conexão.dat com a linha [DIRATUALIZACAO] (imagem abaixo) configurada com um diretório acessível por todas as máquinas. É importante que, no final do diretório, tenha uma barra invertida (\).

Image Added

Com isso, basta extrai todo o conteúdo do pacote Normal baixado para dentro do diretório configurado.

Quando o usuário abrir o sistema, o CnpUpd.exe irá verificar o diretório e atualizar os executáveis automaticamente.





Expandir
titlevisualizar - 3 Camadas


Aviso
  • É importante que os pacotes Client e Server sejam baixados e atualizados simultaneamente. Misturar atualizações de dias diferentes pode causar erros durante a utilização do sistema.
  • O procedimento a seguir deve ser executado no ambiente do Servidor de Aplicação.


a. Acesse a página do DVI pelo link: DVI - Liberações Linx DMS | DMS Automotivo - Automotivo - Linx Share


b. Na sessão "Downloads", localize o quadro "Download dos produtos principais e módulos complementares" e clique no Produto Principal contratado para visualizar os links de download.

O link de download dos pacotes Desktop Client e Server está destacado na imagem abaixo. Neste exemplo, estamos atualizando para a versão 5.11 Essencial.

Image Added


c.  Finalize as tarefas de todos os "*ServerApp.exe" abertos:

Image Added

Informações

(seleção) Dica:

Você pode fazer isso de uma só vez abrindo o Powershell e digitando o seguinte comando:

stop-process -name *serverapp* -force

Image Added


d.  Pare os serviços:

Image Added

Image Added

Informações

(seleção) Dica:

Para localizar os serviços, digite as teclas windows + R e digite services.msc

Image Added


e.  Extraia o conteúdo do pacote Server na pasta C:\3Camadas (este é o nome padrão que é utilizado na implantação).


f. A atualização do pacote Client pode ser feitas de 2 formas:

  • Manual - Extraindo o pacote diretamente na pasta "Client" onde ficam os programas desktop do sistema de todos os usuários.
  • Automática - Utilizando o CnpUpd.exe


Informações
titleO que é o CnpUpd.exe?

É um executável que fica dentro da pasta dos programas desktop e dentro do diretório de atualização, que copia os arquivos do diretório de atualização para as pastas dos usuários.

Ele normalmente vem no pacote de implantação, se não houver, abra um chamado no suporte solicitando ele.

Para que ele funcione, é necessário ter o executável dentro da pasta dos programas desktop do sistema e ter o arquivo conexão.dat com a linha [DIRATUALIZACAO] (imagem abaixo) configurada com um diretório acessível por todas as máquinas. É importante que, no final do diretório, tenha uma barra invertida (\).

Image Added

Com isso, basta extrair todo o conteúdo do pacote Client baixado para dentro do diretório configurado.

Quando o usuário abrir o sistema, o CnpUpd.exe irá verificar o diretório e atualizar os executáveis automaticamente.


g.  Inicie novamente os serviços:

Image Added

Image Added

Em alguns minutos, os ServersApp.exe começarão a subir automaticamente.





4. Atualização das Aplicações Mobile


Expandir
titlevisualizar

Siga a documentação:

Linx DMS Mobile | Linx DMS | Manual de Instalação