TOTVSTEC

Árvore de páginas

01. INTRODUÇÃO

Este documento apresenta os procedimentos de atualização da biblioteca client do TOTVS | DBAccess, a DBAPI, para ambientes com Sistema Operacional Windows e Linux.

A DBAPI é a biblioteca de comunicação entre o TOTVS | DBAccess e o TOTVS | Application Server.

02. REQUISITOS

• Para todo procedimento de atualização, adota-se como boa prática a criação de um backup "daquilo" que será atualizado.

• O ambiente que será atualizado precisa estar "offline", ou seja, o serviço do TOTVS | Application Server precisa estar parado.

• Baixar a última versão do TOTVS | DBAccess que está disponível no Portal de Suporte - seção de Downloads.

Lembre-se de baixar o pacote de atualização do TOTVS | DBAccess condizente com a mesma arquitetura (32 Bits ou 64 Bits) do TOTVS | Application Server.




Nessa página:

03. PROCEDIMENTOS - Windows

A atualização da DBAPI consiste em substituí-la na(s) pasta(s) onde o TOTVS | Application Server foi instalado, pelo arquivo contido no pacote (*.zip).

Em versões anteriores a 19.2.1.0, a DBAPI 64 Bits tem sua nomenclatura definida como "dbapi64.dll"

A partir da versão 19.2.1.0 do TOTVS | DBAccess, a DBAPI 64 Bits passa a ser disponibilizada na pasta client e sua nomenclatura muda de "dbapi64.dll" para apenas "dbapi.dll".



Após o download do pacote de atualização do TOTVS | DBAccess, abra-o com um duplo clique.

Lembre-se

Para este processo de atualização da DBAPI, você deve baixar o pacote de atualização do TOTVS | DBAccess da mesma arquitetura que o seu TOTVS | Application Server, para que você não tenha incompatibilidades.

Acesse a pasta client contida no pacote e faça uma cópia da dbapi.dll para a pasta onde o TOTVS | Application Server está instalado.

Caso seja exibida uma mensagem solicitando confirmar a sobreposição do arquivo, clique em sim.

Após concluir a atualização, inicie o serviço do TOTVS | Application Server e confirme se a versão da dbapi.dll em uso condiz com a versão liberada no Portal de Suporte.

Se quiser saber como checar a versão do TOTVS | DBAccess e/ou DBAPI, recomendamos a leitura do documento com os procedimentos de Como recuperar a build do DBAccess.


04. PROCEDIMENTOS - Linux

A atualização da DBAPI consiste em substituí-la na(s) pasta(s) onde o TOTVS | Application Server foi instalado, pelo arquivo contido no pacote (*.tar.gz).

Os procedimentos descritos a seguir consideram a execução através de um prompt de comando.



Após o download do pacote de atualização do TOTVS | DBAccess, faça a extração de seu conteúdo na pasta tmp do seu ambiente, por exemplo.

tec-sles12:~/Downloads # tar xzf YY-MM-DD-DBACCESS_LINUX_X64_BUILD-YYYYMMDD.TAR.GZ -C /tmp/dbaccess/.

Lembre-se

Para este processo de atualização da DBAPI, você deve baixar o pacote de atualização do TOTVS | DBAccess da mesma arquitetura que o seu TOTVS | Application Server, para que você não tenha incompatibilidades.

Acesse a pasta client contida no pacote e faça uma cópia da dbapi.so para a pasta onde o TOTVS | Application Server está instalado.

tec-sles12:/tmp/dbaccess/client # cp dbapi.so /opt/totvs/protheus/bin/appserver

Após concluir a atualização, inicie o serviço do TOTVS | Application Server e confirme se a versão da dbapi.so em uso condiz com a versão liberada no Portal de Suporte.

Se quiser saber como checar a versão do TOTVS | DBAccess, recomendamos a leitura do documento com os procedimentos de Como recuperar a build do DBAccess.

05. DEMAIS INFORMAÇÕES

A atualização da DBAPI na pasta de instalação do TOTVS | Application Server deve ser feita sempre que ocorrer a atualização do TOTVS | DBAccess.

A versão e data de geração da DBAPI na pasta do TOTVS | Application Server deve ser igual ou superior a versão e data de geração da DBAPI contida no pacote de atualização do TOTVS | DBAccess.

Em ambientes com Sistema Operacional Windows, o arquivo dbapi.dll (32 Bits) é necessário na pasta de instalação do TOTVS | DBAccess para a correta execução do TOTVS | DBMonitor.

Para utilização da DBAPI debug (apenas para fins de diagnóstico e devido a recomendação dos times de suporte e/ou desenvolvimento da TOTVSTEC) deve-se substituir o arquivo dbapi.dll ou dbapi.so na pasta de instalação do TOTVS | Application Server, pela DBAPI contida na pasta ..\client\debug do pacote de atualização do TOTVS | DBAccess.

06. ASSUNTOS RELACIONADOS