Configurando  Protheus  para  uso  com    c-­‐treeACE  SQL  Server:    

 

FairCom    Almir  Fernandes  

c-treeACE SQL Server como base principal – Pré requisitos*

•  Neste momento, as seguintes versões estão homologadas**:

–  Protheus V11.x

–  DBAccess 4.2 –  c-treeACE SQL Server V10.1

* tdn.totvs.com/display/public/mp/c-treeACE-SQL ** Apenas o c-tree Server ISAM V9 está homologado para uso como dicionário do Protheus

2

Instalando c-treeACE SQL Server •  Passo inicial: Solicitar o servidor à FairCom

3

Instalando c-treeACE SQL Server

•  Você deve instalar o c-treeACE SQL Engine, Driver ODBC e as

Ferramentas gráficas.

•  Note que há versões de 32 e 64 bits de cada um dos instaladores.

–  Você pode instalar o produto de 32 bits em uma máquina 64 bits, mas

não o contrário

–  Você pode instalar o driver ODBC de 32 para uso com o c-treeACE

SQL Server 64 bits (por exemplo, para utilizar com o Excel). É

importante que a versão do driver ODBC seja a mesma do DBAccess.

4

Inicie o instalador do Servidor

5

Leia e certifique-se de aceitar a licença

6

Selecione Custom para definir a pasta em que o servidor será instalado (padrão é c:\FairCom\V10.x.x)

7

Opções ao selecionar Custom

8

Instalando e configurando c-treeACE SQL •  Ao final do processo, o servidor estará instalado como um

serviço, mas de operação manual. Para alterar esta definição, você pode: –  Utilizar o gerenciador de serviços do Windows –  Utilizar o utilitário de linha de comando ctntinst

•  Antes de iniciar o servidor pela primeira vez, você precisa de um arquivo de licenças válido (ctsrvr22016xxxx.lic) e também ajustar alguns parâmetros no arquivo de configuração (ctsrvr.cfg)

9

Arquivo de licença: ctsrvr22016xxx.lic

10

•  é importante salientar que apenas um arquivo .lic deve estar localizado no diretório do servidor

Arquivo de configuração do servidor: ctsrvr.cfg

11

•  O nome da instância do c-treeACE SQL Server (palavra chave SERVER_NAME) tem que ser único no ambiente (hardware ou VM).

•  Como o c-tree Server pode ser utilizado para controlar o dicionário (versão ISAM) e a base principal (versão SQL), cada instância deve ter um nome único. –  Se os servidores estiverem em máquinas ou VMs diferentes, de tal

forma que não compartilhem o mesmo endereço IP, podem manter o mesmo nome, sendo unicamente definidos pela definição completa, SERVER_NAME@ENDEREÇO_IP (FAIRCOMS@10.0.0.1, por exemplo)

–  Na sequência deste exercício, estamos alterando o nome do servidor da base principal para FAIRCOMSBP

Arquivo de configuração: ctsrvr.cfg

12

Database Name

•  Database padrão c-treeSQL Server: ctreeSQL.

•  Vamos aqui criar o database ctreeMainDB.

•  Para criar este DB, você tem várias opções: –  Acrescentar a palavra chave abaixo no arquivo ctsrvr.cfg:

SQL_DATABASE ctreeMainDB

–  Ou utilizar o utilitário em linha de comando, ctsqlcdb:

ctsqlcdb –create ctreeMainDB

–  Ou por meio da ferramenta gráfica c-treeSQL Explorer.

13

Vamos instalar as ferramentas

14

c-tree ACE SQL - Ferramentas

15

c-treeACE SQL Explorer

16

Criando Database com c-treeACE SQL Explorer

17 Clique com o botão direito sobre o servidor e selecione a opção “Create New Database"

Instalação Driver ODBC

18

Configuração Driver ODBC

19

Configuração Driver ODBC

20

Configuração Driver ODBC

21

Configuração DBAccess

22

Configuração Protheus Server

23

Vinculação Protheus & DBAccess x c-treeACE SQL Server

24

   c-­‐tree  Server   Gerenciador  

ODBC   DBAccess   Protheus  Server  

ctsrvr.cfg       DB  Monitor   AppServer.ini  Palavra  chave   SERVER_NAME    -­‐   Ctree  Server    -­‐  

Significado   c-­‐tree  Server  name  valor   FAIRCOMSBP    -­‐   FAIRCOMSBP@localhost   -­‐    

Palavra  chave   SERVER_PORT   Service   -­‐     -­‐    Significado   porta  SQL  servidor  (6597  =  padrão)  

valor   6597   6597   -­‐     -­‐    Palavra  chave   SQL_DATABASE   Database   Ctree  Database   -­‐    

Significado   nome  database  valor   ctreeMainDB   ctreeMainDB   ctreeMainDB   -­‐    

Palavra  chave    -­‐   DSN   Environment   DBAlias  Significado   Data  Source  Name  (ambiente  para  o  DBAcess)  

valor   -­‐     ctree   ctree   ctree  

Iniciando o sistema

•  Uma vez que todo o sistema esteja configurado, devemos iniciar pela seguinte ordem: 1.  c-tree Server que gerencia os dicionários (pode ser

instalado como serviço) *

2.  c-treeACE SQL Server que gerencia a base principal (pode ser instalado como serviço) *

3.  DBMonitor Console

4.  App Server

5.  Smart Client

* De fato, o importante é iniciar os servidores de banco de dados e o DBMonitor antes do Servidor de Aplicações, e este antes do SmartClient.

25

Erros comuns

•  c-tree 941 na configuração/teste com DBAcess -> checar versão do DBAcess (incompatibilidade entre client e server)

•  Erro 133 -> Servidor não está no ar – checar configuração –  dbAlias [AppServer.ini] = Ambiente [DBAccess] –  DBAccess -> verificar se o servidor apontado na configuração é o

correto (no nosso exemplo, FAIRCOMSBP@127.0.0.1)

26

Outras fontes de informação

•  www.tdn.totvs.com/display/tec/Banco+de+dados+homologado+para+o+DBAccess

•  www.faircom.com/TOTVS

•  http://www.faircom.com/ace/support_doc_t.php

•  http://www.faircom.com/doc/sqlops/index.htm#cover.htm

Almir.Fernandes@FairCom.com

27

28

Não somos apenas um patrocínio, estamos ao seu lado sempre!

 

Almir Fernandes Diretor Filial Brasil

Copyright Notice This presentation is copyrighted and contains copyrighted material owned by FairCom Corporation. Any publication or distribution to a third-party, whether in whole or in part, requires prior written approval from FairCom. FairCom reserves the right to deny approval of external usage for any reason. Copyright 2014 FairCom Corporation. All rights reserved.