01. INTRODUÇÃO

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

A DBAPI é a biblioteca de comunicação entre o e o .

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  precisa estar parado.

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

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




Nessa página:

03. PROCEDIMENTOS - Windows

A atualização da DBAPI consiste em substituí-la na(s) pasta(s) onde o  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 , 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 , abra-o com um duplo clique.

Para este processo de atualização da DBAPI, você deve baixar o pacote de atualização do da mesma arquitetura que o seu , 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  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 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 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  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 , 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/.

Para este processo de atualização da DBAPI, você deve baixar o pacote de atualização do da mesma arquitetura que o seu , 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  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 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 , 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  deve ser feita sempre que ocorrer a atualização do .

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

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

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 , pela DBAPI contida na pasta ..\client\debug do pacote de atualização do .

06. ASSUNTOS RELACIONADOS


<script>
AJS.toInit(function () {
  // 55 px is collapsed state
  if (AJS.$("div.ia-fixed-sidebar").width() != 55) {
    AJS.$("a.expand-collapse-trigger").click();
  }
});
</script>