Versões comparadas

Versão antiga 2

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 pacotesPreparaçã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.

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

  • Pacote Essencial - Apenas correções de 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 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.

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
Painel
borderColor#FFFFF0
titleColor#FFFFFF
titleBGColor#3C0066
titleEstrutura dos Pacotes
Painel
borderColor#FFFFF0
titleColor#FFFFFF
titleBGColor#3C0066
titleProcedimentos Pré-Atualização
Preparação

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

3

2.

Atualize

Prepare seu ambiente de TESTE/TREINO:

  • Base de Dados = atualize 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.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

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

.







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 Removed

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 Removed

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


Painel
borderColor#FFFFF0
titleColor#FFFFFF
titleBGColor#3C0066
titleAtualização em Produção


Escolha o tipo de ambiente que será atualizado:
Aviso

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

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

ÍNDICE

Expandir
titleNormal (2 Camadas)
Í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.

  • 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.
    • Para fazer a atualização de versão do sistema, é necessário acessar o DVI (imagem 1) através do link
    visualizar


    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 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 – Área de Download/Atualizações:
    Image Removed

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

    Image Removed

    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 Removed

    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 Removed

    Image Removed

    5. Este script deve ser executado sem usuários ativos no sistema e apenas uma vez

    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

    Apollo/Bravos/LinxDMS Toyota:

    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.

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

    Image Removed

    6

    Image Added


    e. Com o log de execução estando ok

    e sem erros

    , conforme imagem acima, a atualização

    da versã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.

    Âncora
    AutomáticaAutomática




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


    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

    Apollo

    dos programas Desktop).

    Instalador/Atualizador Linx DMS Web:

    Image Removed

    2

    Image Added


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

    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

    opção <Instalar>. Clique nessa opção, assim ele fará toda a atualização e iniciará os serviços novamente após finalizar. 

    Image Modified

     

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

    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)

    PUB



    Informações

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

    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




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

    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),
  • 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 Removed

    Release Notes

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

    Image Removed
    Image Removed
    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 Removed

    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 Removed

    ServerApp.exe em execução

    Image RemovedServiço Redirecionador Datasnap
    Image Removed

    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 Removed

    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 Removed

    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 Removed

    Image Removed

    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 Removed

    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 Removed

    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 Removed

    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 Removed

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

    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 Removed

    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 (

    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

    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

    suporte solicitando ele.

    Para que ele funcione, é necessário ter o executável dentro da pasta

    Apollo/Bravos/LinxDMS, e ter os arquivos

    dos programas desktop do sistema e ter o arquivo conexão.dat

    e conexaoClient.dat

    Image Removed

    Dica

    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

    informado

    , tenha uma barra invertida (\).

     

    Image Added

    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

    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

    ,

    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 Removed

    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 Removed

    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 Removed

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


    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