Atualização "Manual" do Sistema

Atualização "Manual" do Sistema

Objetivo: Atualizar release do sistema APP Ceasa.
Pré requisito: Empresa disponibilizar uma pessoa para acompanhar e testar as rotinas básicas após a atualização.
Importante: Colocar no ticket e avisar a quem ficar responsável pela atualização sobre o contato do cliente, colocar o nome e telefone da pessoa responsável para testes e caso seja feito contato com essa pessoa antes de iniciar a atualização e não consiga, abortar a atualização e devolver o ticket para realizar um novo agendamento, se necessário falar com o responsável pela empresa e orientar do porque não foi realizado o procedimento.
Tempo estimado: 2 horas, na qual 1 hora para realização do procedimento e mais 1 hora para acompanhar os testes nas rotinas básicas no sistema.
      Obs: Esse tempo varia de acordo com o tamanho do banco de dados e a capacidade de processamento do servidor do cliente bem como a versão atual do cliente e a versão a ser instalada. Aconselha-se orientar o cliente de que este é o tempo estimado e que pode ser menor ou maior o procedimento devido a estas variáveis.
Estrutura de Pastas:
●    Em  “\APP\Atualizações\” deve conter uma pasta com o nome da versão e release a ser instalada, ficando "\APP\Atualizações\17.02\Salva dd-mm-aaaa", por exemplo, sendo 17.02 a versão a ser instalada no cliente, caso haja pastas antigas deve ser excluída.
Antes de atualizar:
●      Levantar quais os motivos da atualização de release (ajustes e recursos novos) e estudar estas rotinas a fim de possuir um conhecimento mínimo sobre seu funcionamento.
●      Orientar o cliente por telefone e\ou e-mail sobre as correções que estão sendo liberadas, caso de dúvida verificar com a gerência ou com quem abriu a ocorrência no portal.
●      Enviar “Setup.exe” da versão a ser instalada, este deve ser salvo na pasta “\APP\Atualizações\Versão - release\”.
●      Agendar com o cliente o melhor dia e horário para ser feito o procedimento. Aconselha-se agendar de 3h a 16h e que uma pessoa ou um técnico de TI permaneça na empresa durante todo o procedimento para acompanhar e testar acesso ao força de vendas e emissão de pedido e nota, se utilizar, além de trocar o apk nos dispositivos após a atualização.
 
Atualização:
●      No horário agendado, manter contato com o cliente e solicitar que todos fechem o sistema.
●      Verificar se possui algum arquivo parado na pasta de Envio, Recebimento, Autorizados, Armazenados ou Importador, conforme imagem do local configurado : 
●      Caso seja o servidor Gerencial, retirar o compartilhamento da pasta somente (NÃO APAGAR ARQUIVOS), caso seja o servidor Fiscal, verificar a causa dos xmls estarem parados nas pastas, caso estejam parados na pasta de armazenamento (NÃO APAGAR ARQUIVOS), renomear a pasta Arquivosx.xxx dentro da pasta APPMonitorNFe para Arquivosx.xxxx-ddmmaaaa, não esquecer de após a atualização renomear a pasta para Arquivosx.xxx, onde x.xxx é código da empresa\filial.
●      Caso o empreendimento utilize o módulo Força de Vendas, Força de Compras ou Confirmação de Pedido deve-se parar o serviço do IIS, através do Iniciar > Executar > inetmgr. No caso de dúvidas, procure a gerência.
●      Fechar o APP Guardião (caso esteja instalado no Servidor).
●      Fechar o APP Ceasa Monitor, APP Danfe (se houver), APP Impressor (se houver), APP NF-e e "APPMonitorDispMovel".
●      Colocar o banco de dados em “Shutdown”.
●      Parar o serviço do “FireBird”.
●      Fazer uma cópia do banco de dados. O arquivo deve ser salvo em “\APP\Atualizações\Versão - release\Salva DD-MM-AA\”.
●      Recortar as pastas “Exe”, “Relatórios” e “Scripts” do sistema que estão dentro da pasta “Recursos”. As pastas devem ser salvas em “\APP\Atualizações\Versão - release\Salva DD-MM-AA\”.
As pastas podem estar sendo usadas para compartilhamento na rede, se for o caso devem ser fechados os arquivos abertos relacionados aos executáveis do sistema pelo Gerenciador de Servidor e Gerenciador de Tarefas..
●      Executar o “Setup” da release.
●      Apagar as pastas “Contexto” e “Particulares” geradas pelo Setup, pois devem ser utilizadas a pasta que foi salva anteriormente.
●      Copiar as pastas: “Contexto” e “Particulares” salvas e colá-las na nova “\Recursos\Relatórios\” criada na instalação e substituir todos os arquivos já existentes. Caso necessitem de um relatório padrão do sistema, há uma pasta “Contexto.zip” dentro da pasta “Relatórios” do sistema em que estão todos os relatórios originais do setup.

●      Iniciar o serviço do Firebird.
●      Acessar o banco via “IbExpert” e verificar a existência de view, triggers e procedures específicas do cliente (nomes iniciados com “USER”). Na existência de view, triggers e procedures do cliente, estas devem ter a sua DDL (estrutura de criação) salva em um arquivo SQL (isto pode ser feito utilizando a opção "extract metadata" no IBExpert), e depois devem ser “dropadas” (deletadas) do banco.
  • Caso haja erro para dropar as USERS, acionar a gerência.
  • Caso haja USERS inativas ou que não deve ser mais utilizadas, verificar com a gerência se pode dropar.

IMPORTANTE: Antes de executar a atualização da versão é necessário confirmar já ter copiado a pasta Particulares da Salva para a pasta Padrão, pois se executar a atualização sem os rtm’s na pasta, os Usuários perderão acesso ao relatórios particulares.


●      Clientes que estão em release inferior a 17.02 do dia 29-12-2017 deve ser feito o procedimento abaixo:
  • Acessar a pasta Recursos\Scripts\
  • Renomear o arquivo APPDataBase.sql para APPDataBase_versao.sql
  • Renomear o arquivo APPDataBase 17.02.00-29-12-2017-002.sql para APPDataBase.sql
  • Executar APP Ceasa e rodar a atualização. Caso ocorra erro para criar as triggers e procedures ignorar, pois irá rodar novamente no outro script.
  • Após finalizar, renomear o arquivo APPDataBase.sql para 17.02.00-29-12-2017-002.sql.
  • Renomear o arquivo APPDataBase_versao.sql para APPDataBase.sql.
   
●      Executar APP Ceasa e rodar a atualização. Neste momento não pode haver erro para criação das triggers e procedures, se houver acionar a gerência ou desenvolvimento.
●      Criar as views, triggers e procedures users do cliente deletadas anteriormente do banco de dados, utilizando a opção "Script Executive" para buscar o arquivo salvo e executá-los. Após criação das triggers e procedures é necessário executar o comando “configusuarios=” para liberação dos acessos às novas estruturas criadas no banco de dados.  
IMPORTANTE: Não esquecer de realizar este procedimento, pois poderá haver erros na emissão de pedido, lançamento de documentos, etc. Caso haja erro para criação das Users no banco de dados, acionar a supervisão.
●      Ativar novamente o compartilhamento das pastas de configuração dos xmls (com a pessoa 'todos'), presentes no esquema da empresa ou renomear a pasta Arquivosx.xxx dentro de APPMonitorNFe para Arquivosx.xxx.
●      Colocar o banco de dados “Online” pelo IBExpert.
●      Abrir o “APP Ceasa Monitor”, “APP Ceasa”, APP Danfe (se houver), APP Impressor (se houver), APP NF-e (se houver) e "APPMonitorDispMovel".
Até versão 20.00
●      Caso o cliente utilize Força de Vendas, deve ser enviado o APK para que o cliente atualize o mesmo em seus Tablets, este arquivo por padrão fica na pasta “\Recursos\Exe\Tablet\APK”, e é disponibilizado na execução do setup.
●      O caminho físico do tablet configurado no IIS deve ser “\APP\Plus\Recursos\Exe\Tablet”, caso não esteja assim deve ser ajustado para que mantenha este padrão.
●      Após ajustar o caminho, os arquivos “APP.Mobile.APPSettings.config”  e “APP.Mobile.ConnectionString .config” da pasta “Exe” devem ser reconfigurados, o primeiro informando corretamente o caminho dos relatórios e no segundo o caminho e senha do banco de dados. Caso tenha dúvidas, pode ser verificada a informação nos arquivos salvos da atualização, mas os novos arquivos não devem ser substituídos.
●      Caso a empresa utilize Força de Compras e\ou Confirmação de Pedidos deve ser copiado a pasta ForcadeCompras e\ou ConfirmaPedido da pasta "\APP\Atualizações\Versão - release\Salva DD-MM-AA\Exe\" para a pasta "\Recursos\Exe".
●      Iniciar o serviço do IIS através do Iniciar > Executar > inetmgr.
●      Testar a comunicação do site do IIS através do método VerificarServicoComunicacaoForca e VerificarVersaoForca e a utilização do tablet, após liberação do sistema.
●      Acessar o IIS, iniciar > executar > inetmgr e Testar a comunicação com o API, que normalmente está como ForcadeCompraAPI, ao testar a comunicação vai abrir o internet explorer,
exemplo http://localhost:90/ copiar este endereço e adicionar "values" ou "empresa". Aconselha-se testar pelo Google Chrome.
●      Liberar o sistema para uso do cliente.
A partir da versão 22.00
  • Acessar a pasta \app\plus\recursos\Exe\Tablet\MercatusMobile
  • Alterar o arquivo appsettings.json
  • Colocar o caminho do campo e a senha do campo, conforme abaixo (caso o IIS e o banco de dados esteja na mesma máquina, não deve ser colocado o IP Externo ou IP do servidor, deve ser o localhost:

  • Iniciar o serviço do IIS.
  • Abrir no navegador Chrome ou algum outro como Opera, o caminho http://127.0.0.1:81/api, na qual o :81, poderá mudar, pois é a portar do serviço instalado no IIS (que no caso deverá ser o MercatusMobile), se der certo deverá mostrar a informação abaixo

  • Após isso, enviar o apk ao cliente responsável pelo teste e solicitar a troca, ou orientar baixar o aplicativo pelo Apple Store ou Play Store (caso já tenha sido disponibilizado).
  • Verificar se o cliente conseguiu acessar pelo menos um dispositivo.

●      Orientar a pessoa na empresa que ficou responsável por testar o sistema a realizar teste de acesso ao força de vendas, se utilizar de emissão de pedido pelo Força de vendas, se utilizar, emissão de nota fiscal, se utilizar e acesso aos terminais locais, caso tenha terminais configurados localmente deve ser alterado para realizar o acesso na rede.

Finalização:
●      Caso existam procedimentos adicionais a serem executados na atualização, os mesmos devem ser realizados nesta etapa, salvo casos onde existe no atendimento orientação sobre o assunto.
  • Pode haver parâmetros a serem configurados para que o recurso liberado funcione por exemplo, nesse caso deve ser ler o DEV liberado e verificar para orientar o cliente.
●      Verificar na pasta “Exe” salva da atualização se existem outros arquivos a serem copiados para a nova pasta “Exe” criada na instalação da versão.
  • Caso a empresa utilize Cupom Fiscal deve voltar os arquivos: DadosECF.APPConfigECF e DadosSWH.APPConfigECF.

●      Apos realizar todos os testes, verificar pastas antigas dentro da pasta “Atualizações” e deixar somente a mais atual.