Versões comparadas

Versão antiga 1

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

Gravado em

comparado com

Nova versão 2

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

Gravado em

Chave

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

Índice:

1- Estrutura dos pacotes

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 Pacotes

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

  • Recebe apenas

    Pacote Essencial

    :

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

  • bugs.

  • Pacote Evolutivo - Novas funcionalidades (melhorias, implementações fiscais, customizações e projetos de montadoras) + correções de bugs.

Precisa de ajuda para escolher? Faça a seguinte reflexão:

Preciso de alguma nova funcionalidade liberada exclusivamente no Pacote Evolutivo?

  • Se não, recomendamos que escolha o Pacote Essencial.

  • Se sim, baixe o Pacote Evolutivo. 

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.

onde alternar pode ser útil:

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

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


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.





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

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


Escolha o tipo de ambiente que será atualizado:


Expandir
titleNormal (2 Camadas)

ÍNDICE

Índice



Atualização de versão

Nesta atualização é feita a mudança de versão do banco de dados.

Exemplo: Sistema está na 5.07 e precisa atualizar para a versão 5.08.

  1. Antes de iniciar a atualização, é necessário fazer um backup do banco de dados, caso ocorra algum erro no script, ele deve ser restaurado. Não poderá haver usuários usando o sistema durante a atualização.
  2. Para fazer a atualização de versão do sistema, é necessário acessar o DVI (imagem 1) através do link DVI - Liberações Linx DMS | DMS Automotivo e baixar o pacote de liberação da versão de acordo com a versão que o cliente precisa atualizar (imagem 2).



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

– Área de Download/Atualizações:

Image Added

Imagem 2 - Pacote de liberação da versão:

Image Added



Atualização

3. Copie o pacote Script0508.zip, DVI_Liberacao_Inicial_Apollo_V0508.zip*, e cole dentro da pasta Apollo/Bravos/LinxDMS Toyota (*Baixe o pacote correspondente a seu produto):

Image Added


4. O Pacote Inicial (Troca de versão), contém scriptVersao.exe, que deve ser colocado e executado dentro da pasta Apollo/Bravos/LinxDMS Toyota tendo acesso/comunicação com o Banco de dados:


Imagem 4: Script de atualização da versão:

Image Added

Image Added


5. Este script deve ser executado sem usuários ativos no sistema e apenas uma vez. 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 Apollo/Bravos/LinxDMS Toyota: LogExecucao_AnoMesDiaHoraMinuto.txt com o resultado do processo. Abaixo, temos um exemplo de log bem-sucedido.

Imagem 5: Log de execução bem-sucedido:

Image Added



6. Com o log de execução estando ok e sem erros, a atualização da versão 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.

Âncora
Automática
Automática


7. O processo de atualização (mudança da versão) está concluído, porém é necessário atualizar as máquinas dos usuários, isso pode ser feito de forma automática através do CnpUpd.exe ou manual:

7.1 Atualização manual

Basta colocar os pacotes de executáveis e dlls (descompactados) dentro da pasta Apollo/Bravos/LinxDMS Toyota nas máquinas dos usuários.


7.2 Como configurar o CnpUpd.exe para atualização automática:

7.2.1 O CnpUpd.exe é um executável que fica dentro da pasta Apollo e dentro do diretório de atualização (normalmente vem no pacote de implantação, se não houver, abra um chamado no suporte solicitando ele), que copia os arquivos do diretório de atualização para as pastas Apollo/Bravos dos usuários.

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


Imagem 7 – [DIRATUALIZACAO] nos arquivos de conexão

Image Added


Com isso, basta fazer a atualização do pacotes de executáveis e dlls (descompactados) no diretório de atualização ([DIRATUALIZACAO] definido no conexao.dat). Quando o usuário abrir o sistema, o CnpUpd.exe irá verificar o diretório e atualizar os executáveis automaticamente.



Atualização do Linx DMS Integrador


  1. É necessário verificar se houve atualização do Linx DMS Integrador no DVI:

Image Added


2. Se houver, é necessário baixar e fazer a atualização conforme a documentação do pacote. Este programa é responsável pelas integrações com as montadoras.

Obs.: Essa atualização pode ser feita com usuários ativos no sistema. 



Atualização do Linx DMS (WEB)


  • As atualizações do Linx DMS (web) deve ser realizada separadamente, ou seja, as alterações não estão contempladas na atualização de executáveis e dlls do Apollo/Bravos/LinxDMS Toyota.
  • 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.


Dica
titleDica:

As alterações/correções são liberadas com frequência no DVI, verifique diariamente e mantenha sempre atualizado.



Download do LinxDMS (web):

Image Added


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

Instalador/Atualizador Linx DMS Web:

Image Added

2. Ao executar, aparecerá as opções:

    • Instalar todos os pacotes e configurar o IIS;
    • Atualizar os pacotes;
    • Configurar o IIS. 

No caso de atualização, basta selecionar a opção Atualizar os pacotes e clicar em Avançar>, que 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 

3.  Como garantir que a atualização foi efetiva?

  • 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)PUB


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

LISHED


Atualização de executáveis


Nesta atualização é liberado correções/alterações evolutivas (observar Novo Formato das Liberações de Versões (pós versão 5.08)).

  1. Para atualização de executáveis apenas, sem mudança de versão, não há necessidade de fazer backup do banco de dados. Basta acessar o DVI - Liberações Linx DMS | DMS Automotivo, e baixar somente o pacote de atualização de executáveis, eventualmente, terão outros pacotes. Exemplo: pacote do Linx DMS Integrador, esse pacote contém um manual com instruções para atualização (necessário fazer a atualização se houver um pacote disponível),
  2. Após baixar os pacotes, colocar dentro da pasta Apollo/Bravos/LinxDMS Toyota nas máquinas dos usuários (pode ser utilizado a atualização manual ou automática via CnpUpd.exe).


Pacote de atualização de executáveis:

Image Added

Release Notes


As últimas atualizações e correções, podem ser consultadas clicando em Ler notas de alterações:

Image Added

Image Added



Expandir
title3 Camadas

ÍNDICE

Índice



1 - Atualização de versão

Nesta atualização é feita a mudança de versão, exemplo: Cliente está na 5.09 e precisa atualizar para a versão 5.10.

Antes de iniciar a atualização, é necessário fazer um backup do banco de dados, caso ocorra algum erro no script, ele deve ser restaurado e não poderá haver usuários usando o sistema durante a atualização.


Acesse o DVI - Liberações Linx DMS | DMS Automotivo, e baixe o pacote de liberação da versão de acordo com a versão que o cliente precisa atualizar:

Image Added


Após baixar o pacote de atualização de executáveis, é importante que Client e Server utilizem o mesmo pacote de atualização e sejam atualizados simultaneamente, caso contrário, podem ocorrer erros durante a utilização do sistema.

1.1 - Atualização do servidor

Para atualizar o servidor de aplicação, é necessário parar todos os executáveis e os ServerApp.exe que estiverem em execução. E também parar os serviços: Redirecionador Datasnap e Verifica Server 3 Camadas:Image Added

ServerApp.exe em execução


Image Added

Serviço Redirecionador Datasnap


Image Added

Serviço Verifica Server 3 Camadas



No servidor de aplicação, normalmente, existem 2 pastas: 3Camadas (onde ficam os ServerApp.exe) e ApolloClient (onde ficam os executáveis do client).

Para atualizar a pasta 3 Camadas, é necessário fazer a atualização manualmente dos executáveis, sem utilizar o CnpUpd.exe.

No DVI, acesse a área para download dos pacotes sobre troca de versão:

Image Added

Copie todo o conteúdo baixado do link "DVI_Liberacao_Inicial_Apollo_v5.10_3Camadas_Server.zip", extraia e cole os executáveis dentro da pasta 3Camadas no servidor de aplicação:

Image Added

Em seguida, atualize o conteúdo com a os arquivos baixados na área de download das atualizações dos pacotes/correções, logo abaixo da área dos pacotes de troca de versão:

Image Added

Image Added

Após concluir a atualização dos arquivos da pasta C:\3Camadas no servidor de aplicação, contendo os Serverapp e bpl's, vamos atualizar a pasta C:\ApolloClient, para isto, baixe o pacote inicial DVI_Liberacao_Inicial_Apollo_v5.10_3Camadas_Client.zip na área de Baixar o Pacote Inicial (Troca de versão), extraia e atualize os executáveis na pasta:

Image Added


Na área de download dos pacotes de liberação da versão, contém o Script de atualização da versão, que deve ser colocado e executado dentro da pasta servidora: 3Camadas:

Image Added


Aviso
titleAtenção!

Este script deve ser executado sem usuários no sistema, após iniciado, não poderá ser parado/cancelado, sendo necessário a finalização de sua execução.


Após finalizar a execução do script da versão, será gerado o log na pasta onde foi executado, no formato: LogExecucao_AnoMesDiaHoraMinuto.txt com o resultado do processo.

Na imagem abaixo, temos um exemplo de log bem-sucedido, sem erros:Image Added


Com o log de execução estando ok, sem erros, basta ativar os serviços parados e ServerApps.exe, que a atualização do servidor 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.

1.2 - Atualização do Client

Copie todo o conteúdo baixado do link "DVI_Liberacao_Inicial_Apollo_v5.10_3Camadas_Client.zip" e cole dentro da pasta do diretório de atualização se estiver configurado para atualização automática:
Image Added


Caso não esteja parametrizado/configurado para atualizar automaticamente, faça o processo manualmente;

Copie o conteúdo baixado para as pastas ApolloClient/BravosClient/LinxDMS das máquinas, em seguida, atualize o conteúdo com os arquivos baixados para atualização dos executáveis da versão:

Image Added

Dica

Observação: Caso tenha, remova os arquivos BPLS e ServerApp.exe do client (ApolloClient/BravosClient/LinxDMS), pois esses devem estar somente na pasta servidora: 3Camadas.


1.3 - Observação

É necessário verificar se houve a liberação do pacote Linx DMS Integrador, se houver, é necessário baixar e fazer a atualização conforme a documentação do pacote. Essa atualização pode ser feita com usuários no sistema.

Este programa é responsável pelas integrações com as fábricas.

Image Added


2 - Atualização de executáveis

Nesta atualização é liberado correções/alterações emergenciais das versões.

Para atualização apenas de executáveis, sem que haja mudança de versão, não há necessidade de fazer backup do banco de dados. Basta acessar o DVI, na área de download do sistema, e baixar somente o pacote de atualização de executáveis:

Image Added


Aviso
titleAtenção!

Para que não ocorram erros durante a utilização do sistema, é necessário que ao efetuar uma atualização, sejam realizadas nos Client e Server simultaneamente.


3 - Como configurar o CnpUpd.exe para atualização automática

O CnpUpd.exe é um executável que fica dentro da pasta do sistema e dentro do diretório de atualização (normalmente vem no pacote de implantação, se não houver, abra um chamado no RC solicitando ele), que copia os arquivos do diretório de atualização para as pastas Apollo/Bravos/LinxDMS dos usuários, pode ser usado somente para atualização do Client, não pode ser usado na atualização do Server.

Para que ele funcione, é necessário ter o executável dentro da pasta Apollo/Bravos/LinxDMS, e ter os arquivos conexão.dat e conexaoClient.dat com a linha [DIRATUALIZACAO] configurada com um diretório acessível por todas as máquinas.

Image Added

Dica

É importante que, no final do diretório informado, tenha uma barra invertida (\). 


Com isso, basta copiar os arquivos de atualização baixados no DVI para o diretório de atualização informado acima, e quando o usuário foi abrir o sistema o CnpUpd.exe, irá verificar o diretório e atualizar os executáveis automaticamente.


4 - Atualização do Linx DMS (Web)

O Linx DMS Web é o Apollo/Bravos Web, as atualizações do Linx DMS não acompanham as atualizações do Apollo e devem ser efetuadas separadamente.

As alterações/correções são liberadas com frequência no DVI - Liberações Linx DMS | DMS Automotivo.

Image Added


Aviso

A atualização do Linx DMS Web é de extrema importância, pois parte do sistema é acessado somente através dele. 


O Linx DMS Web pode ser atualizado durante o expediente, com usuários no sistema. A atualização é feita através deste instalador/atualizador, sendo necessário baixar, descompactar e executar ele como Administrador (não precisa estar na pasta Apollo).

Ao executar, irá aparecer as opções:

  • Instalar todos os pacotes e configurar o IIS;
  • Atualizar os pacotes;
  • Configurar o IIS. 


Image Added 


No caso de atualização, basta selecionar Atualizar os pacotes e clicar em <Avançar>, que 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. 



5 - Release Notes (Alterações das versões)

No DVI - Liberações Linx DMS | DMS Automotivo, podemos visualizar as alterações recentes e correções do sistema através das notas de alterações:

Image Added


Sempre se guie pela coluna da versão, onde 5.09+ por exemplo, quer dizer que está disponível pra versão e posteriores, ou seja, 5.09 e 5.10:

Image Added