Índice:

1- Preparação

2- Atualização

Objetivo:

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


Preparação

1. Faça um backup atualizado da 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:

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





Atualização

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

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.

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

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.

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

  • 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:


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


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. 

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)


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

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

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

O 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 (\).

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.



  • É 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.

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

(seleção) Dica:

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

stop-process -name *serverapp* -force

d.  Pare os serviços:

(seleção) Dica:

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

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


O 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 (\).

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:

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




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