Boletim Tcnico

1 TODOS os mdulos Ctree Server

Ctree Server V. 9.5.2

Produto : Ctree Server V.9.5.2

Chamado : TGRDCJ Data da publicao : 21/02/13

Pas(es) : Todos Banco(s) de Dados : Todos

O Ctree Server um servidor de banco de dados desenvolvido pela empresa Faircom. O Protheus utiliza o Ctree Server para

manipulao dos dicionrios de dados (SXs), arquivos de help, arquivo de senhas e profile de usurio. A instalao do Ctree Server

est liberada para at 64 usurios simultneos. Para um nmero maior de usurios, necessrio entrar em contato com a TOTVS.

PROCEDIMENTOS PARA IMPLEMENTAO

Esta verso do Ctree Server no deve ser utilizada para manipulao do banco de dados principal.

As configuraes de um CtreeServer para um ambiente com Load Balance e/ou um ambiente em que o RootPath

compartilhado por mais de um servidor Protheus, deve ser utilizada uma configurao adicional em todos os ambientes,

atravs da chave CtreeRootPath.

O CtreeServer trabalha com arquivos do tipo Ctree, criados atravs do Ctree Local e/ou Ctree Server. Para utilizar o CtreeServer

para controle dos dicionrios e/ou banco de dados, caso o seu ambiente utilize LOCALFILES=ADS, necessrio converter os

dicionrios para o formato CTREE, atravs da ferramenta APSDU.

No possvel utilizar Ctree Local e/ou CtreeServer para os dicionrios nos ambientes em que a base de dados principal

(RpoDb) ADS ou DBF.

As informaes completas sobre as configuraes para os tipos diferentes de ambientes e sistemas operacionais, converses de

arquivo, e particularidades de operao pertinentes a esta infra-estrutura, esto documentadas no site do TDN Totvs

Developer Network, acessvel atravs do endereo http://tdn.totvs.com/, na seo Tecnologia TOTVS / TOTVS Aplication

Server / Softwares complementares / Ctree - Ctree Server.

Boletim Tcnico

2 TODOS os mdulos Ctree Server

CONFIGURAES BSICAS DO PROTHEUS

Para utilizao adequado do Ctree Server necessrio alterar o arquivo de configurao do Protheus Server (TotvsAppServer.ini, se

verso Protheus 10, ou AppServer.ini, se verso Protheus 11) com as seguintes sees e chaves:

1. Finalize o Protheus Server. Para alterar o arquivo de configurao do TotvsAppServer.ini ou AppServer.ini, o Protheus Server

no deve estar em execuo.

2. Inclua no arquivo de configurao TotvsAppServer.ini ou AppServer.ini:

[GENERAL] ctreemode=server [ctreeserver] ctuserid=ADMIN ctuserpass=ADMIN ctservername=FAIRCOMS@ip_do_servidor

3. Na chave CTSERVERNAME, no lugar de IP_do_servidor, deve ser colocado o IP do servidor em que o CtreeServer est sendo executado. Exemplo

[CTREESERVER] CTSERVERNAME=FAIRCOMS@183.34.63.01

PROCEDIMENTO DE INSTALAO

Verso Windows

1. Crie um diretrio, por exemplo, C:\CTREESERVER e descompacte o arquivo da pasta Windows dentro do diretrio criado. Desta forma, a estrutura de subdiretrios do CtreeServer ser criada.

2. Para iniciar o servidor Ctree, em modo console, execute o aplicativo ctsrvr.exe, localizado no diretrio:

C:\ctreeserver\FairCom\V9.5.2\winX64\bin\ace\isam.

3. Para parar o servidor ctree, tanto como console como servio, execute ctstop -auto, no diretrio C:\ctreeserver\FairCom\V9.5.2\winX64\tools\cmdline\admin\client.

4. Para parar o servio em modo console, na tela do Ctree Server, escolha a opo Control\Shutdown. Acesse com usurio e

senha (ADMIN, ADMIN).

5. Para aplicar uma nova licena, execute o aplicativo fcactvat.exe, no diretrio C:\ctreeserver\FairCom\V9.5.2\winX64\bin\ace\isam. necessrio que o servio do Ctree esteja parado para a aplicao da licena.

6. Para instalar o CtreeServer como um servio, execute o aplicativo ctntinst.exe -install, localizado no diretrio

C:\ctreeserver\FairCom\V9.5.2\winX64\bin\ace\isam. O servio instalado chamado de ctreeserver, e configurado com start manual.

Verso Linux

1. Crie um diretrio, por exemplo ctreeserver, e descompacte o arquivo da pasta Linux no mesmo. Ex: tar -zxvf ctsrvr_linux_v8_050520.tar.gz

Boletim Tcnico

3 TODOS os mdulos Ctree Server

2. Na seo de execuo do Servidor Ctree, defina o diretrio do ctreeserver para busca da libctreecb.so (biblioteca de callback utilizada para resoluo de alguns ndices e filtros), aumente o nmero mximo de arquivos do sistema operacional, atravs dos comandos: export LD_LIBRARY_PATH=/ctreeserver/faircom/linux.v2.6.x86.32bit/bin/ace/isam.

3. Para iniciar o servidor ctree, execute o aplicativo ctsrvr, atravs do comando ./ctsrvr, na pasta

/ctreeserver/faircom/linux.v2.6.x86.32bit/bin/ace/isam.

4. Para parar o CtreeServer, execute o aplicativo ctstop, atravs do comando ./ctstop -auto, na pasta / ctreeserver/faircom/linux.v2.6.x86.32bit/tools/cmdline/admin/client.

5. Para aplicar uma nova licena, execute o aplicativo fcactvat, atravs do comando ./fcactvat, na pasta /

ctreeserver/faircom/linux.v2.6.x86.32bit/bin/ace/isam . necessrio que o servio do Ctree esteja parado para a aplicao da licena.