ATUALIZAÇ ÃO DO ÁBACO S BACK O F F I CE COM T RO CA DE …public.kpl.com.br/atualizacao.kpl.pdf · ATUALIZAÇ ÃO DO ÁBACO S BACK O F F I CE COM T RO ... acesse o caminho Integração

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



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.


http://public.kpl.com.br/

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


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.


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.


Versão: 1.0


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.


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.


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.


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.


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.


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.


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


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.


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.


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.


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.


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.


Versão: 1.0


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


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.


Versão: 1.0

Agora, cole-os sobre os atuais arquivos da pasta qual foi gravada inicialmente


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:


Versão: 1.0


Versão: 1.0

Agora, acesse o diretório citado inicialmente e cole substituindo os atuais


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:


Versão: 1.0


Versão: 1.0

E cole sobre os arquivos da pasta citada inicialmente, com os arquivos atuais


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


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


Versão: 1.0


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.


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


Versão: 1.0

6.2 REINICIAR O ÁBACOS SERVICE

Abra novamente os Services, selecione o Ábacos Service e clique em Iniciar


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.


Versão: 1.0


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.


Documents

ATUALIZAÇ ÃO DO ÁBACO S BACK O F F I CE COM T RO CA DE …public.kpl.com.br/atualizacao.kpl.pdf · ATUALIZAÇ ÃO DO ÁBACO S BACK O F F I CE COM T RO ... acesse o caminho Integração