ATUALIZAÇÃO DO ÁBACOS BACK OFFICE COM TROCA DE SERVIÇOS ÁREA DE SUPORTE Copyright 2001-2016, KPL, Todos os direitos reservados.
HISTÓRICO DE ALTERAÇÕES Data Versão Descrição Autor 23/03/2016 1.0 Criação do Documento Abinadabi de Melo 31/04/2016 2.0 Maiores detalhamentos Abinadabi de Melo 01/04/2016 3.0 Inclusão de link do FTP Abinadabi de Melo 25/10/2016 4.0 Revisão de procedimento Marcela Alexandre Página 2 de 38
INTRODUÇÃO Este documento tem como objetivo instruir da melhor forma a realizar a atualização do Ábacos Back office, com instruções também sobre a troca do serviços, como Ábacos Service, Schemas e pacotes dos Web Services. Página 3 de 38
SUMÁRIO 1 PRÉ-REQUISITOS 2 PRÉ-ATUALIZAÇÃO 2.1 DIRETÓRIO DA PASTA SCHEMAS 2.2.1 FUNÇÕES DO ATUALIZADOR 2.2.2 BOTÃO ATUALIZAR ÁBACOS 2.2.3 BOTÃO OUTRAS FUNÇÕES 2.3 COLOCANDO O SISTEMA EM PAUSA 2.4 VERIFICANDO USUÁRIOS CONECTADOS 3 PARANDO SERVIÇOS 3.1 PARAR O SERVIÇO DE INTEGRAÇÃO NO IIS 3.1 PARAR O ABACOS SERVICE 3.2.1 PARAR DEMAIS SERVIÇOS EM SERVICES.MSC 4 ATUALIZAÇÃO DO SERVIÇOS 4.1 PONTOS DE ATENÇÃO 4.2 ATUALIZANDO A PASTA SCHEMAS 4.3 ATUALIZANDO O ÁBACOS SERVICE 4.4 ATUALIZAÇÃO DAS PASTAS WEBSERVICES 5 ATUALIZAÇÃO DO ÁBACOS BACKOFFICE 5.1 INICIANDO A ATUALIZAÇÃO 6 PÓS- ATUALIZAÇÃO - REINÍCIO DOS SERVIÇOS 6.1 REINICIAR O IIS 6.2 REINICIAR O ÁBACOS SERVICE 6.2.1 REINICIAR DEMAIS SERVIÇOS EM SERVICES.MSC 7 ATUALIZAÇÃO DO SERVIÇOS Página 4 de 38
1 PRÉ-REQUISITOS Para a atualização, é necessário que se tenha sob domínio o pacote com os novos arquivos da versão que o sistema será atualizado. São eles: AbacosUpd, pacotes de atualização com a extensão.zip e arquivos de serviços que podem ter a necessidade de atualização ou não, variando de acordo com o que houver de novo na build ou revisão. Referente a versão do serviços, estes estão disponíveis para download no link abaixo Link: public.kpl.com.br Realize o download do pacote da sessão Última Versão. Como os pacotes estão compactados, assim que realizar o download, faça a extração dos arquivos com seus respectivos nomes. Atente- se também que o usuário que irá realizar a atualização do sistema tenha privilégio administrador no servidor e tenha o usuário administrador no sistema. Página 5 de 38
2 PRÉ-ATUALIZAÇÃO 2.1 DIRETÓRIO DA PASTA SCHEMAS Uma das informações que precisamos ter antes de iniciarmos a atualização, por conta da necessidade de se conectar ao Ábacos para obtê- la, é qual o caminho da pasta Schemas. Esta é responsável pela construção dos XMLs e emissão das NFe à Sefaz. Então iremos encontrar primeiramente qual o seu atual diretório para quando forma atualizar o sistema. Para isto, no Ábacos, acesse o caminho Integração > Replicação de dados > Configurações de interfaces Nesta tela, encontre a interface de Nota fiscal eletronica e expanda o grupo NF e WebService Página 6 de 38
Encontre a linha Pasta dos schemas XML e salve este em um bloco de notas para utilizarmos ele em passos posteriores. Tendo esta informação, feche a aplicação. Página 7 de 38
Agora, dando continuidade, todos os usuários devem estar desconectados do sistema. Então, deve ser alinhado internamente com todos os colaboradores que se desconectem do sistema. Para monitorar quais operadores possam estar eventualmente conectados, já vamos entrar no primeiro passo da atualização efetivamente. Feito isto, com duplo clique abra o AbacosUpd e conecte-se com seu usuário administrador do sistema. Página 8 de 38
Página 9 de 38
2.2.1 FUNÇÕES DO ATUALIZADOR Abaixo apenas a explicação sobre cada função do atualizador, não são instruções a serem realizadas para a atualização em si. São para conhecimento e entendimento. 2.2.2 BOTÃO ATUALIZAR ÁBACOS Observe que nesta função existem alguns recursos relacionados à atualização do sistema. Automático Baixar e atualizar automaticamente Consiste em realizar o donwload do pacote de atualização disponível no FTP do sistema e realizar a atualização instantaneamente. Manual Escolher pacote de atualização existente no computador Consiste em realizar a atualização a partir de pacotes que podem ser alocados em determinado diretório no computador e realizar a busca e atualização por estes. Baixar o pacote de atualização Através deste recurso é possível realizar o download de novos pacotes de atualização que possam existem no FTP para utilizá- los para realizar a atualização manual. Página 10 de 38
2.2.3 BOTÃO OUTRAS FUNÇÕES Em outras funções, existem alguns recursos que podem ser utilizados também têm relação a atualização e seus derivados e dependente. Colocar em pausa Função para colocar o sistema em pausa, de modo que nenhum usuário consiga se conectar após ativada. É necessário para poder iniciar a atualização. Cancelar pausa Caso eventualmente necessário liberar o sistema novamente após a pausa acionada, este botão tem esta função. Escolher um log de execução para visualizar Recurso interno para visualizar registro de log de atualizações anteriores. Gerar arquivo texto com log de execução Recurso interno para gerar o log de execuções anteriores em formato de arquivo.txt. Trocar de localização do backup do aplicativo Com este recurso é possível determinar em qual diretório será salvo os backups do aplicativo (.exe) quando a atualização foi iniciada; É valido, antes da atualização, clicar neste recurso e confirmar se o diretório determinado é válido no seu ambiente. Página 11 de 38
Na sequência, retomaremos os pontos relacionados aos estágios atualização. 2.3 COLOCANDO O SISTEMA EM PAUSA Para colocar o sistema em pausa, basta clicar no botão Outras funções e na opção Colocar em pausa Observe que o status do sistema passou de Em produção para Pausa para atualização. Desta forma, nenhum usuário conseguirá se conectar. Contudo, usuários que já estavam conectados ainda conseguem operar com o sistema. Então, deve ser solicitado que desconectem para poder dar seguimento com a atualização. Página 12 de 38
2.4 VERIFICANDO USUÁRIOS CONECTADOS Para identificar quais outros usuários estão conectados no sistema, basta acessar a aba Usuários conectados no Ábacos. Veja que é possível visualizar a sua atual conexão, a qual fica destacada com a cor vermelha na linha, e conexão de outros usuários conectados, destacados com a cor amarela. Caso ainda existirem usuários conectados, solicite que desconectem- se. E para monitorar se saíram, é possível verificar isso clicando no botão Atualizar. Quando liberados de conexões distintas da sua conexão atual, como atualizador do sistema, seguiremos para o estágio de pausa dos serviços. Página 13 de 38
3 PARANDO SERVIÇOS 3.1 PARAR O SERVIÇO DE INTEGRAÇÃO NO IIS Para isso, abra o Executar do Windows pesquise por InetMgr.exe Abrindo- o, verifique quais serviços de integração há configurado nesta ferramenta. Exemplo: Plataforma, WMS, ERP, outros. Página 14 de 38
Identificando os serviços de integração existentes, pare a execução dos mesmos através do site, selecionando -o com o mouse e, ao lado direito da tela, clique em Parar. Caso haja mais de um site configurado, para cada um deles da mesma forma. Página 15 de 38
Ainda com a tela do IIS aberta, com o site de integrações do Ábacos selecionado, clique com o botão direito do mouse em Explorar Observe que ele abrirá instantaneamente a pasta a qual estão alocados os arquivos do(s) webservice(s). Página 16 de 38
Apenas grave (copie em um bloco de notas) o diretório desta pasta pois iremos utilizá- lo posteriormente, quando entrarmos na atualização dos serviços. Página 17 de 38
3.1 PARAR O ABACOS SERVICE Para isso, abra novamente o Executar do Windows pesquise por Services.msc Abrindo- o, procure, inicialmente, pelo serviço KPL Soluções - Abacos Service e pare -o. Página 18 de 38
Semelhante ao procedimento citado acima, iremos encontrar qual o caminho o qual estão os arquivos do Ábacos Service através desta própria tela. Então, para tal, clique com o botão direito do mouse na linha referente ao Ábacos Service e abra as propriedades. Página 19 de 38
Abrindo- a, observe que é possível identificar o caminho o qual o arquivo está alocado. Anote -o em um bloco de notas também para resgatarmos ele na parte de atualização deste serviço. Página 20 de 38
3.2.1 PARAR DEMAIS SERVIÇOS EM SERVICES.MSC Verifique se há outros serviços relacionados a integração nessa mesma tela, como por exemplo: Rakuten e Shopping Rakuten, Vertis, CiaShop, Fastcommerce, Braspag, e caso o serviço de impressão fique no servidor, também haverá o serviço nesta tela. Todos iniciarão o nome do serviço com KPL Soluções. Então, caso haja outros integradores, ficarão próximos ao serviço de Ábacos Service. Com todos os serviços parados, entraremos no passo da atualização propriamente dita. Para estes, não há a necessidade de encontrar diretório pois não são atualizados como os demais. Página 21 de 38
4 ATUALIZAÇÃO DO SERVIÇOS Este estágio pode ser feito paralelamente a atualização do sistema. Ou seja, enquanto a atualização estiver em andamento, pode ser feito as trocas do serviços. Mas neste guia iremos tratá -lo como um estágio separado. 4.1 PONTOS DE ATENÇÃO A troca de serviços ocorrerá apenas em alguns builds ou revisões. Então, verifique se na pasta com o novo pacote que lhe for enviado tenha serviços novos. Ou seja, pasta schemas, serviços (do Ábacos Service) e arquivos de WebServices. Não necessariamente terão pacotes novos para cada serviço, mas caso tenha, deve atualizá- los. Para TODAS as atualizações, as quais iremos passar as instruções de como realizá- los, Atente -se a anteriormente SEMPRE criar pasta de backup para os arquivos atuais Página 22 de 38
4.2 ATUALIZANDO A PASTA SCHEMAS Como citado no tópico 2.1, precisaremos saber onde estão alocados os arquivos da pasta schemas. Então, acesse este diretório através do caminho que foi gravado inicialmente Sabendo qual o diretório, selecione todos os arquivos da pasta schemas do pacote que lhe foi enviado copie -os. Página 23 de 38
Agora, cole-o s sobre os atuais arquivos da pasta qual foi gravada inicialmente Página 24 de 38
4.3 ATUALIZANDO O ÁBACOS SERVICE Da mesma forma como a pasta schemas, busque o caminho o qual foi gravado referente a pasta do Ábacos Service, citado no tópico 3.2. Agora, acesse a pasta a qual foi realizado o download conforme instruído no tópico 1 (pré atualização), selecione todos os arquivos e copie -os A pasta de que foi baixada com o pacote possui duas versões de Dlls.NET 4.0 e.net 4.5, para atualizar verifique qual é a versão do DotNet Framework presente no Servidor e atualize com as Dlls compatíveis. Print exemplo abaixo: Página 25 de 38
Página 26 de 38
Agora, acesse o diretório citado inicialmente e cole substituindo os atuais Página 27 de 38
4.4 ATUALIZAÇÃO DAS PASTAS WEBSERVICES Quanto às pastas dos WebService, abra o diretório que foi gravado, de acordo com as instruções do tópico 3.1 e verifique quais os WebServices que tem operando. Podem ser WsPlataforma, ERP, WMS, entre outros. Veja se no pacote o qual já deve ter sido salvo em seu computador, conforme instruções do tópico 1 (pré- atualização) existem pastas com o mesmo nome. Existindo, copie os respectivos arquivos, da pasta do pacote de atualização OBS: Antes de substituir é necessário verificar qual a linguagem do asmx presente em seu ambiente para que seja atualizado correspondente ao existente, para isso selecione o asmx em seguida abra-o utilizando o bloco de notas. Se a extensão for.cs = DotNet se for.pas= Delphi na pasta do pacotes estão disponíveis as duas versões de WebServices. (Caso você não possua Webservices dos tipos ERP, WMS, WSPlataforma desconsidere este passo). Abaixo exemplo: Página 28 de 38
Página 29 de 38
E cole sobre os arquivos da pasta citada inicialmente, com os arquivos atuais Página 30 de 38
*Nas imagens acima, colocamos apenas o exemplo da atualização do WS Plataforma. Deve- se realizar a atualização de todos os arquivos que JÁ EXISTAM no seu ambiente pelos que lhe foram enviados. Observe que todos são enviados em pastas separadas. Então, por exemplo, no caso de vir que há o WS ERP nas pastas mas não no seu atual diretório, não há a necessidade de transferir estes arquivos. Atente- se a substituir tanto os arquivos.asmx como a pasta bin. Página 31 de 38
5 ATUALIZAÇÃO DO ÁBACOS BACKOFFICE 5.1 INICIANDO A ATUALIZAÇÃO Voltando ao atualizador (AbacosUpd.exe) que deve estar aberto e pausado sem nenhum usuário conectado clique em Manual - Escolher pacote de atualização existente no computador, e encontre a pasta onde está o pacote de atualização, o qual foi baixado no servidor, de acordo com instruções do tópico 1 (Pré-requisitos). Página 32 de 38
Página 33 de 38
Em alguns minutos e este tempo pode variar de acordo com a versão anterior e outros eventuais agravantes, a atualização será concluída. *Assim que concluída a atualização, o sistema sairá automaticamente da pausa colocada no início. Logo, não há a necessidade de ação quanto a isto. Caso eventualmente ocorra algum erro durante a atualização, entre em contato imediatamente com o suporte para que lhe passe as devidas instruções. Página 34 de 38
6 PÓS- ATUALIZAÇÃO - REINÍCIO DOS SERVIÇOS Com êxito na atualização do back office através do atualizador e a atualização de todos os serviços que foram parados na sessão do tópico 3. 6.1 REINICIAR O IIS Abra novamente o IIS, selecione o(s) site(s) de integração e clique em Iniciar Página 35 de 38
6.2 REINICIAR O ÁBACOS SERVICE Abra novamente os Services, selecione o Ábacos Service e clique em Iniciar Página 36 de 38
6.2.1 REINICIAR DEMAIS SERVIÇOS EM SERVICES.MSC Bem como no tópico 3.2.1, verifique se existem mais serviços referente a operações do Ábacos no acesso ao Services.msc. Havendo, reinicie -os. Página 37 de 38
7 ATUALIZAÇÃO DO SERVIÇOS Concluído a atualização e reinicialização dos serviços, é importante realizar as validações das funções do sistema. Então, sugerimos as verificações dos principais processos no sistema. Caso note qualquer inconformidade, entre em contato com o suporte. Página 38 de 38