Consultor Eletrônico

Este documento listará os requisitos para utilização de bancos de dados Progress OpenEdge em instalações do TAF.

1 - Versão do Progress OpenEdge:

Para utilizar o TAF com banco de dados Progress OpenEdge, deverá ser utilizado o OpenEdge 11.7.2 ou superior.


2 - Storage Areas:

Será necessário criar Storage Areas separadas para dados e índices. Estas Storage Areas devem ser obrigatoriamente do tipo II. Mais informações sobre o funcionamento e configuração de uma Storage Area tipo II podem ser obtidas neste link: https://cat.totvs.com.br/eConsultor/Pesquisa/kbase_Det.aspx?kbid=61729

Abaixo um exemplo de arquivo de estruturas do banco de dados (.st) com a configuração citada:

#
b d:\totvs\taf\banco\taf.b1
#
d "Schema Area":6,64;1 d:\totvs\taf\banco\taf.d1
#
d "TAF Dados":7,64;64 d:\totvs\taf\banco\taf_7.d1
#
d "TAF Indices":8,1;64 d:\totvs\taf\banco\taf_8.d1

Neste exemplo, criamos um banco de dados chamado "TAF", com as Storage Areas "TAF Dados" e "TAF Indices", as quais serão utilizadas para armazenar Dados e Índices, respectivamente.
Observação: Para o DBAccess, o nome da Storage Area é case-sensitive. Quando informar o nome das Storage Areas na instalação ou configuração do DBAccess, insira corretamente o nome Storage Area.


3 - Criação de usuário no banco de dados:

Deve-se criar um usuário específico para o TAF. O usuário "PUB" não deverá ser utilizado.
Neste ponto, recomendamos criar um usuário chamado "TAF", para facilitar o entendimento e administração deste banco de dados.
O usuário deverá ser criado através do Data Administration, menu Admin > Security > Edit User List.


4 - Permissões para o usuário TAF:

O usuário TAF deverá possuir permissões de DBA, as quais são fornecidas através do SQL Explorer.
Conecte-se ao SQL Explorer com o usuário "sysprogress", e utilize os comandos abaixo:

Grant DBA to TAF;
Commit;


5 - Carga do banco de dados:

O banco de dados deverá ser iniciado com um segundo broker de login, para os acessos SQL provenientes da conexão ODBC. Abaixo um script de carga utilizado para a carga deste banco de dados:

set dlc=c:\dlc117
set path=c:\dlc117\bin;%path%

Call sql_env.bat

call proserve "d:\totvs\taf\banco\taf" -B 20000 -spin 10000 -bibufs 400 -L 200000 -Mm 4096 -N tcp -S 60000 -Ma 10 -Mn 11 -Mpb 2 -n 101
call proserve "d:\totvs\taf\banco\taf" -m3 -S 60001 -ServerType SQL -Ma 10 -Mpb 8

A linha "Call sql_env.bat" deverá ser inserida antes da carga do banco de dados. Este script é utilizado para configurar as variáveis de ambiente do Java, as quais são utilizadas para a execuções de procedures SQL. Se esta linha não for inserida, ocorrerão erros na utilização do TAF.
Para bancos de dados em Linux, referenciar as variáveis citadas no passo 2 deste kbase: https://knowledgebase.progress.com/articles/Article/Error-on-native-threads-when-running-sql-env


6 - Configuração da conexão ODBC:

No servidor onde estará o DBAccess, deverá ser configurada uma conexão ODBC 32-bit para o banco de dados do TAF.
Para criar uma conexão ODBC 32-bit, utilize o utilitário "C:\Windows\SysWOW64\odbcad32.exe".
Utilize nesta conexão a porta de conexão definida no broker identificado com o "-ServerType SQL", e os dados de autenticação do usuário "TAF" que foi previamente criado.


8 - Ativação de índices:

Durante o processo de inicialização do TAF, alguns índices são criados inativos. Após realizar o process de inicialização, recomendamos proceder com a ativação destes índices.
Este processo deve ser realizado através do proenv do Progress, com o utilitário "idxbuild". Abaixo um exemplo de sua execução:

proutil TAF -C idxbuild all

Este procedimento deve ser executado com o banco de dados Offline.


Informações adicionais:

O vídeo contido neste link (https://cat.totvs.com.br/eConsultor/Pesquisa/kbase_Det.aspx?kbid=63418) traz informações adicionais a respeito da configuração de conexões ODBC para o banco de dados Progress OpenEdge.
Nele serão encontradas informações sobre a carga de um segundo broker para conexões SQL, criação de usuário no banco de dados, concessão de privilégios para o usuário TAF e configuração da conexão ODBC.