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 é importante salientar que apenas um arquivo.lic deve estar localizado no diretório do servidor 10
Arquivo de configuração do servidor: ctsrvr.cfg 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 11
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 Clique com o botão direito sobre o servidor e selecione a opção Create New Database" 17
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 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 24
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
Não somos apenas um patrocínio, estamos ao seu lado sempre! 28
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.