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.
Supondo que o seu TOTVS | Application Server é 64 Bits, 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 o seu TOTVS | Application Server seja 32 Bits, você poderá fazer uma cópia da dbapi.dll que está na "raíz" do pacote de atualização, 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/.
Supondo que o seu TOTVS | Application Server é 64 Bits, 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
Caso o seu TOTVS | Application Server seja 32 Bits, você deverá baixar o pacote de atualização do TOTVS | DBAccess 32 Bits e posteriormente executar os procedimentos de extração e cópia citados nos passos 1 e 2.
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, recomendamos a leitura do documento com os procedimentos de Como recuperar a build do DBAccess.
05. DEMAIS INFORMAÇÕES
Diante de alguns cenários, como em ocorrências de parada abrupta do serviço do TOTVS | DBAccess, pode ser necessário utilizar um build debug.
Para utilização da versão debug (apenas para fins de diagnóstico de cenários como o citado acima) deve-se substituir o arquivo dbaccess (para versões 32 Bits) ou dbaccess64 (para versões 64 Bits) contido na pasta de instalação, pelos arquivos que estão na pasta debug do pacote de atualização do TOTVS | DBAccess.
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.
06. ASSUNTOS RELACIONADOS
- Como atualizar o DBAccess
- DBAccess - Como recuperar a build?
- Portal de Suporte, área de Downloads