ATUALIZAÇÃO DO ÁBACOS BACKOFFICE
COM TROCA DE SERVIÇOS
ÁREA DE SUPORTE
© Copyright 2001-2016, KPL® , Todos os direitos reservados.
Versão: 1.0
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
www.kpl.com.br
Página 2 de 38
Versão: 1.0
INTRODUÇÃO
Este documento tem como objetivo instruir da melhor forma a realizar a atualização do
Ábacos Backoffice, com instruções também sobre a troca do serviços, como Ábacos Service,
Schemas e pacotes dos Web Services.
www.kpl.com.br Página 3 de 38
Versão: 1.0
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
www.kpl.com.br Página 4 de 38
Versão: 1.0
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çosque 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.
www.kpl.com.br Página 5 de 38
Versão: 1.0
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 NFe WebService
www.kpl.com.br Página 6 de 38
Versão: 1.0
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.
www.kpl.com.br Página 7 de 38
Versão: 1.0
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.
www.kpl.com.br Página 8 de 38
Versão: 1.0
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.
www.kpl.com.br Página 10 de 38
Versão: 1.0
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.
www.kpl.com.br Página 11 de 38
Versão: 1.0
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.
www.kpl.com.br Página 12 de 38
Versão: 1.0
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.
www.kpl.com.br Página 13 de 38
Versão: 1.0
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.
www.kpl.com.br Página 14 de 38
Versão: 1.0
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.
www.kpl.com.br Página 15 de 38
Versão: 1.0
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).
www.kpl.com.br Página 16 de 38
Versão: 1.0
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.
www.kpl.com.br Página 17 de 38
Versão: 1.0
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.
www.kpl.com.br Página 18 de 38
Versão: 1.0
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.
www.kpl.com.br Página 19 de 38
Versão: 1.0
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.
www.kpl.com.br Página 20 de 38
Versão: 1.0
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.
www.kpl.com.br Página 21 de 38
Versão: 1.0
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
www.kpl.com.br Página 22 de 38
Versão: 1.0
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.
www.kpl.com.br Página 23 de 38
Versão: 1.0
Agora, cole-os sobre os atuais arquivos da pasta qual foi gravada inicialmente
www.kpl.com.br Página 24 de 38
Versão: 1.0
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:
www.kpl.com.br Página 25 de 38
Versão: 1.0
Agora, acesse o diretório citado inicialmente e cole substituindo os atuais
www.kpl.com.br Página 27 de 38
Versão: 1.0
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:
www.kpl.com.br Página 28 de 38
Versão: 1.0
E cole sobre os arquivos da pasta citada inicialmente, com os arquivos atuais
www.kpl.com.br Página 30 de 38
Versão: 1.0
*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”.
www.kpl.com.br Página 31 de 38
Versão: 1.0
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).
www.kpl.com.br Página 32 de 38
Versão: 1.0
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.
www.kpl.com.br Página 34 de 38
Versão: 1.0
6 PÓS-ATUALIZAÇÃO - REINÍCIO DOS SERVIÇOS
Com êxito na atualização do backoffice 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
www.kpl.com.br Página 35 de 38
Versão: 1.0
6.2 REINICIAR O ÁBACOS SERVICE
Abra novamente os Services, selecione o Ábacos Service e clique em Iniciar
www.kpl.com.br Página 36 de 38
Versão: 1.0
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.
www.kpl.com.br Página 37 de 38
Versão: 1.0
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.
www.kpl.com.br Página 38 de 38
Top Related