INSTALAO DO PROTHEUS 11

Neste documento, iremos abordar o processo de instalao do Protheus 11,

lembrando que aps a instalao, ser necessria atualizao da build, e
este processo ser tratado em outro documento.

1. Instalando o Protheus 11
O Microsiga Protheus uma linha de software ERP baseada na tecnologia
By You, criada e desenvolvida pela TOTVS. Para instalar a verso mais
atualizada do sistema, a primeira coisa a se fazer acessar o endereo da
Totvs,
http://www.totvs.com/suporte/central-de-download/seusegmento/produto/microsiga, depois selecionar o link para instalao.

Principais aplicativos:
TOTVS BA (Business Analytics): A TOTVS e a IBM se unem em uma
parceria na rea de Business Analytics para oferecer a seus clientes uma
soluo analtica, flexvel e intuitiva, que utiliza a expertise da TOTVS para
potencializar sua gesto de negcios.
O resultado desta parceria uma soluo que maximiza o poder de anlise
e apoia decises, por meio da tecnologia de solues analticas Cognos da
IBM.
TOTVS SmartClient: a aplicao encarregada da Interface com o
usurio. No existe Processamento Local, por isso o Trfego de Rede entre o
Terminal e o Servidor de Aplicao Baixo, tratando apenas de comandos,
para o Desenho das Telas e tratamento do Teclado e Mouse.
TOTVS Application Server: O TOTVS Application Server (AppServer), a
aplicao encarregada da Compilao e Execuo do Cdigo em (ADVPL), no
qual o Protheus 11, foi escrito. Na Linguagem ADVPL, as rotinas so
mantidas em APOs individuais em Repositrios.
Isso permite que as mesmas sejam carregadas e descarregadas
dinamicamente da memria da mquina onde o Servidor est sendo
executado, ou seja, de acordo com a necessidade de execuo dos
Terminais conectados.

Instalao do HelpOnLine: Para consultar a documentao on-line,

necessrio instalar o Help do Protheus 11. A documentao acessada a
partir dos ambientes do Protheus, pela tecla[F1]. So apresentados os
idiomas disponveis para exibio das telas do instalador, conforme figura
acima.

1.1

TOTVS Application Server

Iremos instalar o TOTVS Application Server e o TOTVS Smart Client,

juntamente com todas as Ferramentas que o Protheus 11, disponibiliza.
O primeiro passo para instalao do Protheus a instalao do TOTVS
Application Server. A instalao do AppServer, assim como do SmartClient e
das Ferramentas auxiliares (DevStudio, Wizard e o TotvsMonitor) realizada,
atravs do Instalador do Server, localizado no link citado anteriormente.
Clique em Install.

Na tela de apresentao do sistema Clique em Next para prosseguir:

A prxima tela a do contrato de Licena, leia-o com ateno e clique no

boto YES para prosseguir.
Na tela seguinte, indique o caminho onde o TOTVS Application Server deve
ser instalado. Clique no boto Next para prosseguir.

Indique o caminho onde os arquivos de dados do Protheus 11 devem ser

gravados. Clique no boto Next para prosseguir.

Nesta tela, deve-se selecionar:

a. Os tipos de Banco de Dados disponveis no Protheus:
SQL
ADS (Advantage Database Server)
ISAM padro DBF ou C-Tree.
Neste momento, pode-se optar por apenas uma base de dados, porm,
atravs de alteraes no arquivo de configurao do TOTVS Application
Server e cpia do repositrio correto, possvel fazer com que a mesma
instalao do Protheus utilize dois tipos de base de dados.
b. O idioma do RPO a ser instalado.
c. O pas para instalao do arquivo SXS<pas>.TXT. Este arquivo
gravado no diretrio\Protheus_Data\SYSTEMLOAD, sendo responsvel pela
criao dos dicionrio de dados e demais arquivos especficos para o pas
selecionado.
d. Clique em no boto Forward para prosseguir.

Na prxima tela, clique no boto de opo YES se utilizar os ambientes de

Automao Comercial (SigaLoja), desta forma, sero instalados os arquivos
de DLLs para comunicao com os perifricos homologados.

Verifique as configuraes de instalao e confirme o seu incio, clicando no

boto
Next. Se precisar alterar alguma opo, clique em Back para voltar.

Depois de informadas as variveis de instalao,

descompactao e cpia dos arquivos iniciado.

processo

de

Ser criada no local indicado uma pasta chamada TOTVS 11, nela estaro
todos os arquivos necessrios para utilizao e configurao do sistema
Protheus.

1.2

Instalando o Help OnLine

Para instalar a verso do Help OnLine, necessrio clicar no link

Instalao do HelpOnLine no idioma desejado, neste caso adotaremos o
Portugus.

A instalao do Protheus 11 Help ocupa aproximadamente de 970Mb.

O Install Shield ser iniciado. A janela de Bem-vindo apresentada. Clique
no boto Next para prosseguir.

Na prxima tela, leia o contrato de licena com ateno e clique no boto

YES para prosseguir.
Na tela seguinte, deve ser informado o diretrio de instalao dos arquivos
de helps.
Clique no boto Next.

Nesta janela, deve ser informado o diretrio onde est instalado o Protheus
11 Server para que seja configurado corretamente pelo programa de
instalao. Clique no boto Next.

Com a configurao da instalao do help, ser iniciado o processo de cpia

dos arquivos.
Este procedimento configura o acesso aos helps a partir do TOTVS
Application Server, caso o usurio queira utilizar outro servidor de help,
poder copiar os arquivos instalados para outro servidor e alterar o arquivo
AppServer.INI, indicando a sua nova localizao, atravs da configurao da
chave PATH da seo HTTP e da chave HELPSERVER do ambiente utilizado.

1.3

TOTVS Application Server

Servidor de Licenas: A Microsiga envia junto aos DVDs de instalao do

Protheus 11 (exceto quando se tratar de atualizao) um hardware de
proteo que tem por objetivo a segurana de suas informaes usando
algoritmo de criptografia (recurso para proteo de mensagens eletrnicas),
baseados em chaves de 128 bits, liberando mecanismos mais eficientes
para proteger o sistema contra acessos indevidos. Aliado a isso, mais
agilidade no processo de liberao de senhas e grande ganho de
performance nos processos de controle aos acessos simultneos so
obtidos.
O servidor de licenas deve ter conectado o Hardlock (dispositivo de
segurana) na porta paralela ou USB e o driver do dispositivo instalado (se
necessrio).
Para cada contrato de manuteno, a MICROSIGA est enviando um
Hardlock, que pode ser HASP ou Proteq/SafeNet.
Para baixa o instalador do LicenseServer, entre no portal da TOTVS/Central
de dowloads/Produto/Tecnologia ou acesse o link:
http://www.totvs.com/suporte/central-de-download/seusegmento/produto/tecnologia
Na tela de apresentao do sistema clique em Avanar para prosseguir:

A prxima tela a do contrato de Licena, leia-o com ateno e clique no

boto SIM para prosseguir.
Na tela seguinte, indique o caminho onde o LicenseServer deve ser
instalado. Clique no boto Avanar para prosseguir.

A partir deste ponto, o usurio estar configurando o License Server de

acordo com suas necessidades onde sempre haver um default para os
usurios que desejam uma configurao bsica, apesar de no ser
recomendado devido grande variao de ambientes possveis.
Podemos optar por:
Habilitar ou no o License Server. Caso se opte por habilitlo, sero
apresentadas as telas com
os parmetros necessrios para a montagem do arquivo de configurao do
License Server.

Como o servio do License Server um listener, precisamos informar uma

porta para a comunicao com os servidores. A porta default 5555 ou
outra qualquer que esteja disponvel no range entre 1024 e 65535.

Temos a possibilidade de habilitar a Numerao Automtica para que seja

controlada pelo License Server. Vale ressaltar que a indicao da TOTVS
para que utilizemos a numerao automtica pelo License Server.

Nesta prxima tela poderemos escolher se ser ou no instalado o driver do

Hardlock de forma automtica pelo instalador. Caso escolha no instalar, os
drivers homologados para os modelos de Hardlock sero copiados para a
pasta DRIVERS dentro do path de instalao do License Server para que
assim a instalao possa ser efetuada manualmente aps o trmino do
assistente de instalao. O path padro para a pasta de driver
C:\TOTVSLicense\Drivers.
Se for escolhida a opo para instalao automtica, ser apresentada a
tela para seleo do modelo de Hardlock que ser utilizado no TOTVS
License Server.

Encerrados os passos de seleo das opes de instalao, o assistente

exibir o path para instalao e cpia dos arquivos e, ao clicar em Avanar,
o assistente ir efetuar os seguintes passos:

 Cpia dos arquivos;

Montagem do arquivo de configurao do TOTVS License Server;
Caso fora selecionado, a instalao do driver do Hardlock;
Instalao do servio do TOTVS License Server na lista de servios do
sistema operacional.

1.4

Instalando o TOTVS DBAccess

Neste documento abordaremos a instalao do TOTVS DBAccess para

computadores com Sistema Operacional de 64 bits, para isso ser
necessrio o download do arquivo executvel que pode ser baixado no
portal da Totvs atravs do link: https://suporte.totvs.com/download e
escolher a linha PROTHEUS.
1. Acesse o sistema como Administrador.
2. No Windows, clique Iniciar.
3. No Menu Iniciar, clique Computador.
4. Na barra de endereo, informe %PROGRAMFILES% e pressione ENTER.
5. Crie o diretrio base para instalao
o

Acesse Arquivo + Novo + Pasta.

Ser criado uma nova pasta.

Informe o nome TOTVSDBAccess64.

6. Copie e descompacte arquivo

totvsdbaccess_4.2_win64_aaaammdd.zip (onde aaaammdd se refere
a build do produto) na pasta criada.
Como o arquivo foi compactado no formato ZIP qualquer
descompactador compatvel com este formato poder ser utilizado e
ao seu trmino o TOTVS DBAccess estar instalado.
Para instalar o TOTVS DBAccess 64 bits como servio do Windows:
1. Acesse o prompt de comandos como Administrador.
2. Acesse o diretrio base de instalao do TOTVS DBAccess 64 bits.
Utilize o comando cd %PROGRAMFILES%\TOTVSDBAccess64.
3. Execute o comando dbaccess64.exe -install.
Ao trmino o TOTVS DBAccess estar configurado como um servio
do Windows.
IMPORTANTE:
Para Configurarmos o TocConnect, devemos ter previamente instalado o
Banco de Dados e tambm criado uma Instncia de Conexo (Alias) na
Fonte de Dados (ODBC), localizado no Painel de Controle do Windows,
pois atravs do ODBC, que o TopConnect, localiza o Banco de Dados.
Configurao do Top Connect
1. Aps instalar o Top Connect: entrar no painel de controle, ferramentas
administrativas e servios. A seguir, eu devo deixar o Top
Startado(automtico).
2. Instalar o Banco (por exemplo o SQL).
3. Criar a Base de Dados que se deseja utilizar.

4. ODBC - No painel de controle, ferramentas administrativas, fontes de

dados (ODBC). Na aba Fonte de Dados do Sistema, boto Adicionar, localizar
SQL Server, boto Concluir.

Preencha os dados de Nome, Descrio e Servidor onde se encontra a fonte

de dados. Clique em avanar, avanar, marcar Alterar o banco de dados
padro para:, selecionar o Banco de Dados, avanar, clicar em Alterar
idioma. Selecionar o idioma: Brazilian, concluir.

Clique em Testar Fonte de Dados, e no boto OK. Sero executados testes

de conectividade e se estiver tudo certo aparecer a tela de xito concluso
dos testes.

1.4.1 DBMonitor
Todas as configuraes e monitoramentos possveis atravs do TOTVS
DBAccess ocorrem neste monitor, permitindo gerenciar informaes como:
-

Usurios logados
Bancos de dados em utilizao
Ambiente dos bancos
Testes de conexo
Monitores de ndices
Informaes gerais, etc.

Para utilizar o DBMonitor:

1. Acesse o cone do programa criado no sistema operacional: DBMonitor .
O sistema apresenta uma pequena janela referente s configuraes de
Monitor.

2. A prxima tela apresenta as opes de gerenciamento de informaes do

TOTVSDBAccess, subdividindo-as em pastas, sendo:

Informaes - relao dos dados de registro do TOTVSDBAccess.

Usurios - relao dos usurios conectados ao TOTVSDBAccess.
Mensagens - apresentao de mensagens referentes a erros e ocorrncias
do banco de dados.
Configuraes - configurao de acesso, senhas, usurios, chaves, para
cada um dos bancos de dados suportados.
Assistentes - configurao e monitoramento de conexes e ndices
gerados.
Cada uma dessas pastas apresentam os campos necessrios informao
dos principais dados, fundamentais ao gerenciamento oferecido pelo
TOTVSDBAccess.
3. Na barra de ferramentas da tela Monitor, esto disponveis as opes:
Monitor - informaes de conexo ao servidor.
Visualizar - configurao da visualizao das informaes estatsticas.
Ajuda - informaes sobre o aplicativo e acionamento dos itens de ajuda.
Para testarmos a conexo com a Base de Dados, acesse a aba
Configuraes -> Microsoft SQL

Clique no boto Novo e digite um nome para o Ambiente. Caso necessite

coloque um usurio e uma senha.
Na aba Assistentes, clique no cone de Validao de Conexo:

Aps a tela de apresentao clique em Avanar

Na prxima tela escolha a Base de Dados a ser utilizada:

Insira na prxima tela o ambiente a ser testado e clique em Finalizar.

Caso esteja tudo certo, aparecer uma janela informando que a conexo
est OK.

2 Arquivos de Configurao
A partir de agora, iremos conhecer um pouco mais os Arquivos de
Configurao do Protheus 11. Dentre eles, aprofundaremos nosso
conhecimento no arquivo (AppServer.INI), que o Arquivo de Configurao,
utilizado pelo TOTVS Application Server e no arquivo (SmartClient.INI), que
indica as configuraes, para o TOTVS Smart Client (SmartClient).
A saber, existem os seguintes Arquivos de Configurao no Protheus 11 os
quais esto localizados na pasta (\BIN), no diretrio raiz, do Protheus 11:
AppServer.INI: Atravs dele poderemos configurar praticamente todas
as Funcionalidades disponveis no Protheus 11.
SmartClient.INI: Aqui realizaremos as configuraes pertinentes ao
TOTVS Smart Client (SmartClient), tais como: Direcionar a Conexo, Definir
Protocolos Utilizados entre outros;
DevStudio.INI: Neste arquivo ficam gravadas todas as opes do TOTVS
Development Studio(DevStudio), tais como: Posio de Janelas, Fonte
Utilizada, ltimos Arquivos Abertos, Preferncias de Idioma, Diretrio para
Localizao de Fontes entre outros. (Este arquivo no deve ser alterado
manualmente);

 Adslocal.CFG: Este arquivo permite diversas configuraes como:

Nmero de Usurios, Nmero Mximo de Tabelas a serem abertas, Nmero
de Workreas disponveis entre outros.
(Este arquivo s utilizado para instalaes que possuam o Parmetro
LOCALFILES = ADS, no Arquivo (AppServer.INI));
DevStudio.CFG: Aqui ficam guardadas todas as Configuraes de
Comunicao, realizadas no Totvs Development Studio (DevStudio). (No
deve ser alterado manualmente).

1.5

Configurao do AppServer.INI

A seguir, so detalhadas as sees e um exemplo de configurao de suas

chaves:
Seo

Descrio

DBAccess

A seo [DBAccess] contm as informaes utilizadas para o

acesso base de dados relacional atravs do TOTVS DBAccess.

Drivers

Contm informaes sobre os protocolos utilizados na conexo

entre os terminais e o servidor.

Contm informaes dos diretrios de execuo do TOTVS

Environmen Application Server, tais como: idioma, interface, diretrios,
t
repositrios e,opcionalmente, informaes para acesso ao
TOTVS DBAccess.
FTP

Esta seo permite o TOTVS Application Server atuar como

servidor FTP - File Transfer Protocol (Protocolo de Transferncia
de Arquivos).

General

Contm as informaes comuns (globais) para os ambientes

administrados pelo servidor.

HTTP

Esta seo permite o TOTVS Application Server atuar como

servidor HTTP - HyperText Transfer Protocol (Protocolo de
Transferncia de Hipertexto), ou seja, pode fornecer pginas
em HTML para um browser.

A seo [LicenseClient] define as informaes que sero

LicenseClie
utilizadas para o TOTVS Application Server se conectar a um
nt
Servidor de Licenas (TOTVS License Server).
LicenseServ A seo [LicenseServer] contm as informaes sobre o
er
Servidor de Licenas (TOTVS License Server).
OnStart

Permite determinar a execuo de uma funo (sem interface)

logo aps o incio de execuo do TOTVS Application Server.

ServerNetw Permite configurar mais de um servidor para balanceamento

ork
de carga via software.
Service

Utilize esta seo para informar o nome interno e externo do

Seo

Descrio
servio do TOTVS Application Server no Microsoft Windows.

A seo [SSLConfigure] permite habilitar o TOTVS Application

SSLConfigur Server para criptografar e autenticar as informaes que so
e
transmitidas pela internet, assim como outras operaes de
assinatura e certificao.
O TOTVS Application Server pode se utilizar do protocolo TCP/IP
Sees
para realizar a conexo com os terminais. A configurao do
Protocolos protocolo utilizado efetuada atravs de sees com as
de conexo chaves definindo informaes como porta de conexo, o
servio e o tipo de conexo.
Update

Para agilizar a atualizao do TOTVS SmartClient nas estaes,

possvel configurar uma mquina com a verso mais recente
e, a partir dela, efetuar a atualizao automtica nas estaes.

Proxy

Permite configurar um proxy para ser utilizado pelas funes,

da linguagem AdvPL, que interagem com ambiente Web
(HTTPGet(), HTTPPost(), HTTPPostXml(), funes Client de
WebServices, etc) e que no esto sendo executadas a partir
de um ambiente ERP - Enterprise Resource Planning. Por
exemplo, a gerao de cdigo-fonte para WebServices
(gerao de Client), atravs do TOTVS Development Studio.

1.5.1 Seo [Environment]

A seo [Environment] contm informaes dos diretrios de execuo do
TOTVS Application Server, idioma, interface, diretrios e repositrios, e
opcionalmente as informaes para acesso ao TOTVS DBAccess.
Estas informaes so identificadas para cada conexo, ou seja,
cada TOTVS SmartClient que se conectar ao Servidor deve informar qual a
seo que deseja utilizar. Assim, os diretrios para trabalho, o idioma, a
interface e o repositrio podem ser obtidos a partir das informaes da
seo definida.
Uma seo padro, chamada Environment, criada na instalao e utilizada
sempre que o TOTVS SmartClient se conectar sem informar uma seo
atravs de parmetros de linha de comando.
A seguir, veja a documentao de algumas das chaves relacionadas a
configurao de um ambiente de trabalho:
Chave
ADSShare

Descrio
Indica o diretrio compartilhado onde est instalado o
servidor ADS. Este diretrio utilizado para fazer a
conexo ao servidor ADS.

Indica o tempo, em segundos, que o TOTVS Application

Server deve aguardar quando enviar um pacote de
ConnectionTimeou
comunicao para o TOTVS SmartClient solicitando
t
retorno de dados.
Valor padro: 180 segundos.
CtreeRootPath

Indica o diretrio compartilhado acessado pelos

servidores de aplicao (RootPath) dos ambientes que

Chave

Descrio
utilizam o c-tree Server.

FilesOnDemand

Indica se durante a abertura dos ambientes, o Sistema

ir efetuar a abertura pelo menu (padro) ou por
necessidade (abre e fecha arquivos conforme utilizao).

GetMv_NOUpper_F Indica a utilizao de filial, em minsculo, na funo

ilial
GetMV().
HelpServer

Define o endereo do servidor HTTP de help on-line.

InactiveTimeOut

Define o intervalo de tempo por inatividade, em

segundos, para derrubar automaticamente a conexo
entre
o TOTVS
Application
Server
e
o TOTVS
SmartClient.

LocalDbExtension

Define qual ser a extenso padro dos arquivos ISAM

para os Drivers DBFCDX, DBFCDXAX.

LocalFiles

Indica qual a base de dados que ser utilizada para

abertura dos arquivos locais. Pode ser: ADS, ADSServer
ou c-tree.

MaxLocks

Define o nmero mximo de locks simultneos por

conexo.

PictFormat

Esta chave atua na utilizao de picture @E, utilizada no

Sistema em campos de entrada e sada de valores
numricos (@...SAY/GET...PICTURE'@E...'), bem como na
funo AdvPL Transform(), quando utilizada esta picture.

RootPath

Identifica o diretrio raiz do Sistema (ERP), a partir do

qual todos os diretrios utilizados pelo Sistema sero
criados.

RpoDb

Identifica o tipo de base de dados utilizada. Esta

informao utilizada pelo servidor para definir qual
repositrio ser acessado.

RpoLanguage

Identifica a linguagem que ser utilizada. Pode ser

Portuguese, English ou Spanish.
Esta informao tambm utilizada pelo servidor para
definio do repositrio a ser acessado.

RpoVersion

Identifica a verso do Sistema (ERP).

SourcePath

Identifica o diretrio onde os repositrios de APOs so

mantidos na mquina em que o TOTVS Application
Server est instalado.

SpecialKey

Define uma string que concatenada string bsica em

funes
de
controle
aos
acessos
simultneos
(semaforizao).

StartPath

Identifica o diretrio onde os arquivos de configurao

do Sistema (ERP) se encontram. o diretrio inicial de
execuo do sistema.
Este diretrio criado a partir do diretrio raiz, definido
na chave anterior.

ThreadMemLimit

Define um limite mximo de memria para os processos

em execuo, onde um processo em execuo no
ambiente, atinja o valor definido, interrompido com

Chave

Descrio
uma ocorrncia de erro fatal AdvPL.

Define, para um determinado ambiente, uma mensagem

de advertncia, no TOTVS Application Server, gravada
ThreadMemWarnin
no log de console da aplicao, quando um processo em
g
execuo ultrapassar o valor definido para o consumo de
memria.
Trace

Indica se deve ser feito o Log de warnings em arquivos.

O arquivo de log (trace.log) ser criado no diretrio onde
se encontram os arquivos executveis e DLLs do
Sistema.

TraceStack

Identifica a origem de uma possvel ocorrncia de

advertncia no console.

TOPMemoMega

Permite que as conexes SGBD (Sistema de

Gerenciamento de Banco de Dados), realizadas atravs
do TOTVS DBAccess, utilizem campo "M" Memo com at
1000000 de bytes.

WSPLReldir

Define o diretrio, a partir do RootPath, onde ficaro

armazenados os relatrios em disco para visualizao
atravs do WebSpool do ERP - Enterprise Resource
Planning.

WSPLServer

Define o servidor, a porta e o ambiente onde o

agendador de relatrios e o WebSpool executaro suas
tarefas de relatrios assncronos.

WarningShowStac Identifica a origem de uma possvel ocorrncia de

k
advertncia no console.

ThreadMemStep

Define, para um determinado ambiente, o tamanho da

memria que quando consumido por um processo em
execuo que j utilizou o valor definido em
ThreadMemWarning ir disparar o registro de uma
mensagem de advertncia.

Veja abaixo um exemplo do de comoo uma seo Environment pode se

apresentar no arquivo AppServer.INI:
[Environment]
SourcePath=C:\TOTVS 11\Microsiga\Protheus\APO
RootPath=C:\TOTVS 11\Microsiga\Protheus_Data
StartPath=\system\
RpoDb=TOP
RpoLanguage=Portuguese
RpoVersion=110
LocalFiles=ads
HelpServer=<SERVIDOR DE HELP>
Trace=0
localdbextension=.dbf
PictFormat=DEFAULT
DateFormat=DEFAULT
RegionalLanguage=BRA

Caso sejam utilizados mais de um ambiente com TOTVS DBAccess e exista a

necessidade de estabelecer conexo com bancos de dados diferentes e/ou
de estaes com outro servidor TOTVS DBAccess, possvel configurar os
parmetros desta conexo com o TOTVS DBAccess na seo de
configurao do prprio Ambiente, para isso basta acrescentar na sesso
Environmnet:
TOPDATABASE=<TIPO DE BANCO DE DADOS> (MSSQL, ORACLE, INFORMIX,
ECT...)
TOPSERVER=<SERVIDOR DE CONEXO C/BANCO>
TOPALIAS=<ALIAS DA BASE DE DADOS>
PROTHEUSONLY=0 (Quando setada 1 permite apenas conexes vindas do
Protheus Server).

1.5.2 Sesso [Drivers]

A seguir, detalhada a chave relacionada aos protocolos utilizados
conexo entre os terminais e o servidor:
Chav
e

na

Descrio

Activ
Identifica os nomes das sees de configurao de protocolos ativos.
e
[Drivers]
Active=TCP

1.5.3 Sesso Protocolos de Conexo

As conexes ativas, ou seja, que podem ser utilizadas pelos terminais para
se conectar ao Servidor, so aquelas cujos nomes das sees esto
definidos na chave Active, da seo [Drivers], descrita anteriormente.
Podem-se criar diversas sees com as conexes utilizadas.
A seguir, veja a documentao de todas as chaves relacionadas a
configurao de conexo:
Chave

Descrio

InactiveTime Determina o tempo de espera at a queda da conexo, no

out
caso de no haver respostas.
Port

Exemplo:
[TCP]
TYPE=TCPIP
Port=1234

Indica a porta que ser utilizada para as comunicaes via

TCP/IP. Observao: O TOTVS Application Server utiliza TCP
Stack (a mesma porta para todos os usurios).

1.5.4 Sesso [General]

A seguir, so detalhadas as chaves relacionadas a configurao das
informaes comuns (globais) para os ambientes administrados pelo
servidor:
Chave

Descrio

CanAcceptDebbuger

Define se a instncia atual, do TOTVS Application

Server, receber conexes do TOTVS Development
Studio.

CanAcceptLB

Define se a instncia atual, do TOTVS Application

Server, receber conexes de monitoramente do
servio master para balanceamento de carga.

CanAcceptMonitor

Permite configurar se a instncia atual, do TOTVS

Application
Server,
receber
conexes
de
monitoramento do TOTVS Monitor.

CanAcceptRPC

Define se a instncia atual, do TOTVS Application

Server, receber conexes de RPC AdvPL.

CanRunJobs

Define se a instncia atual, do TOTVS Application

Server, ir ignorar todos os jobs configurados na
seo [OnStart].

ctreeMode

Indica o uso da engine Server ou Local do c-tree

Server.

Console

Permite habilitar o console do TOTVS Application

Server, quando utilizada a verso ISAPI do mesmo
(advplISAPI.DLL)
com
o
Microsoft
Internet
Information Services.

ConsoleFile

Permite especificar um novo path e nome do

arquivo para gravao do log de console do TOTVS
Application Server.

ConsoleLog

Determina a gravao de log das mensagens

apresentadas no console do TOTVS Application
Server.

ConsoleMaxSize

Define o tamanho padro do arquivo (console.log)

gravado pelo TOTVS Application Server, quando
utilizado como servio, ISAPI ou quando a chave
ConsoleLog est configurada como 1 na seo
[General].

ConnectionTimeout

Indica o tempo, em segundos, que o TOTVS

Application Server deve aguardar quando enviar
um pacote de comunicao para o TOTVS
SmartClient solicitando retorno de dados.

DisableDevicePort

Define o bloqueio das portas de impresso no

TOTVS Application Server.

InactiveTimeOut

Define o intervalo de tempo (em segundos), por

inatividade, para derrubar automaticamente a
conexo entre o TOTVS Application Server e o
TOTVS SmartClient.

MonitorConnections

Determina a quantidade mxima de conexes do

Chave

Descrio
TOTVS Monitor no TOTVS Application Server.

DebugThreadUsedMe Habilita o monitoramento de memria consumida,

mory
por processo, do TOTVS Application Server.
ServerMemoryLimit

LogMessages

Determina o limite de alocao de memria (MB)

residente.
Define a gravao de log (console.log), no diretrio
de instalao o TOTVS Application Server, com as
informaes necessrias para diagnosticar erros e
calcular o tempo de execuo de uma determinada
rotina
no
TOTVS
Application
Server.
Observao: Habilitar esta configurao pode
impactar no crescimento acelerado do registro de
log de console da aplicao, e pode impactar na
performance da aplicao.

IdeMessages

Esta chave determina o registro de log de

comunicao/mensagens
entre
o
TOTVS
Application Server e o TOTVS Development Studio.
utilizada apenas como auxiliar em solues e
diagnsticos de problemas especficos.

SocketMessages

Permite registrar a troca dos eventos e pacotes

pela rede entre o TOTVS SmartClient e o TOTVS
Application Server.
Observao: Habilitar esta configurao pode
impactar no crescimento acelerado do registro de
log de console da aplicao, e pode impactar na
performance da apl

ErrorMaxSize

Permite
especificar
um
tamanho
mximo
diferenciado para o log de ocorrncias do TOTVS
Application Server.

** Observaes: Nas configuraes acima descritas, onde existem

observaes sobre possvel impacto na performance da aplicao, ser
perceptvel uma degradao na performance a partir do momento que mais
de um processo simultaneamente gerar informaes no registro de LOG da
aplicao, pois a gravao deste LOG serializada. Deste modo,
recomenda-se fortemente que estas configuraes de LOG e diagnstico
sejam habilitados preferencialmente em um cenrio controlado; ou em um
servio especfico configurado para fins de diagnstico, para no causar
impacto e onerar o ambiente de produo.

1.5.5 Sesso [LicenseServer]

O Servidor de Licenas responsvel pela liberao de senhas e controle
aos acessos simultneos (semaforizao).
Ao utilizar uma empresa que no seja teste (99), no ERP - Enterprise
Resource Planning, necessrio que um dos servidores seja o Servidor de
Licenas.
Principais vantagens:
- Maior segurana;

- Melhor controle do processo de liberao de senhas;

- Ganho de performance;
Observao
Alm de habilitar o Servidor de Licenas, na seo [LicenseServer], a
mquina precisa ter um dispositivo de segurana (Hardlock) conectado, na
porta paralela ou USB, o driver instalado (se necessrio) e o arquivo
applylic.key ou totvslic.key instalado.
A seguir, veja a documentao de todas a chaves relacionadas seo
[LicenseServer]:
Chave
Descrio
Enable

Indica se o TOTVS Application Server ser um servidor de

Licenas.

EnableNum Identifica como ser

ber
Application Server.

controlada

numerao

no TOTVS

Identifica a porta que ser utilizada para a comunicao entre

o Servidor de Licenas e o TOTVS Application Server.

Port

Esta chave permite o controle de requisies e liberaes de

ShowStatus licena e semforos atravs de mensagem na tela de console
do TOTVS Application Server.
Instances

Define o nmero mnimo de conexes, do Servidor de Licenas,

que sero pr-disponibilizados para atender as chamadas de
licenas.

Exemplo:
[LICENSESERVER]
enable=0
port=5555
ShowStatus=1

1.5.6 Sesso [LicenseClient]

A seo [LicenseClient] define as informaes que sero utilizadas para o
TOTVS Application Server se conectar a um Servidor de Licenas.
A seguir, veja a documentao de todas a chaves relacionadas s seo
[LicenseClient]:
Cha
Descrio
ve
Port

Identifica a porta que ser utilizada para a comunicao entre

o TOTVS Application Server e o Servidor de Licenas.

Serv Indica o nome ou nmero IP do computador onde est o Servidor de

er
Licenas.

Exemplo:

[LICENSECLIENT]
server=192.168.2.20
port=5555

1.5.7 Sesso [TCPSERVER]

TOTVS Processor Application Server utiliza o protocolo TCP/IP para realizar a
conexo com os terminais e o Servidor de Licenas (TOTVS License Server).
Atravs desta seo, possvel definir a porta de conexo e o detalhamento
das operaes do TOTVS Processor Application Server, tais como: tempo de
espera at a queda da conexo, operaes de debug e protocolo entre o
terminal e o TOTVS Processor Application Server.
A seguir, veja a documentao de todas a chaves relacionadas s seo
[TCPServer]:
Chave

Descrio

Port

Indica a porta que ser

comunicao via TCP/IP.

utilizada

para

realizar

Indica o tempo de espera (em segundos) at a queda da

InactiveTimeout conexo, no caso de no haver respostas do client que est
conectado.
Verbose

Indica o detalhamento (debug) das operaes entre o

terminal e o TOTVS Processor Application Server.

VerboseConnec Indica o detalhamento (debug) das operaes de protocolo

tion
entre o terminal e o TOTVS Processor Application Server.

1.5.8 Sesso [HTTP]

O TOTVS Application Server pode ser configurado para trabalhar como um
servidor Web. Isso significa trabalhar como um servidor de requisies dos
protocolos HTTP e/ou FTP, do mesmo modo que outros servidores
conhecidos no mercado (exemplo: IIS - Internet Information Server, da
Microsoft, ou Apache para Linux).
Para isso, basta ter o Sistema (ERP) instalado para criar uma intranet em
uma rede local, publicar o endereo IP da mquina com o TOTVS Application
Server na Internet e executar funes de RPC ou simplesmente criar o um
Web Site com pgina HTML estticas ou dinmicas.
Servio HTTP
O protocolo HTTP (HyperText Transfer Protocol) utilizado na comunicao
entre um servidor e uma Web Browser e para o envio/recebimento de
pginas formatadas em padres SGML (HTML, XML, etc.). Este procotolo se
baseia principalmente em dois comandos GET e POST.
O comando GET utilizado para obter alguma informao do servidor HTTP
e o POST para postar informaes para o servidor. Mas adiante, ser mais
fcil compreender onde tais comandos so utilizados no TOTVS Application
Server.
Ao utilizar o TOTVS Application Server como um servidor HTTP, o mesmo
poder ser acessado atravs de uma Web Browser como o Internet Explorer,

da Microsoft, que receber as pginas HTML enviadas de um diretrio

configurado no servidor. Adicionalmente, o envio e recebimento de pginas
estticas formatadas, pode-se utilizar a linguagem AdvPL, do Sistema (ERP),
para processar pginas mistas, ou seja, que contenham cdigo AdvPL e
comandos HTML de formatao.
Desta forma, as pginas so processadas, no TOTVS Application Server, e
enviadas para a Web Browser que ir format-las de acordo com os
comandos HTML. Alm disso, possvel executar diretamente as funes
compiladas no repositrio do Sistema, atravs de um request HTTP (por
exemplo, um POST em um formulrio em HTML, link ou diretamente na linha
da URL da Web Browser. O mesmo vale para qualquer outra aplicao que
consiga efetuar comandos GET ou POST utilizando o protocolo HTTP).
A seguir, veja a documentao de todas a chaves relacionadas s sees
HTTP, HOSTS, JOBS para Working Threads, ambiente Web e a utilizao
do TOTVS Application Server como servidor de HTTP:

Chave

Descrio

CacheControl

Define qual ser o retorno padro do elemento Cache-Control,

da header HTTP, ao browser para cada solicitao de
processamento de pginas dinmicas em AdvPL, atravs
do link .APL ou .APW.

DisablePath

Identifica um diretrio absoluto no disco, a partir do qual o

Sistema (ERP) disponibilizar arquivos HTML e demais
arquivos para Web Browse, quando um host de acesso HTTP
estiver desabilitado (atravs da chave Enable=0).

Enable

Identifica se o servio HTTP ser habilitado quando o TOTVS

Application Server for inicializado.

Instances

Define quantas threads internas, do servio de HTTP do

Sistema (ERP), podem ser disponibilizadas para estabelecer
conexes simultneas e atender as requisies via HTTP de
pginas estticas, dinmicas, arquivos, imagens e etc.

Path

Identifica um diretrio absoluto no disco, a partir do qual o

Sistema (ERP) disponibilizar arquivos HTML e demais
arquivos para a Web Browser.

Port

Define o nmero da porta de conexo HTTP.

Pragma

Define o retorno padro do elemento Pragma da header HTTP.

RPCEnv

Indica o nome do ambiente (environment) local, configurado

no mesmo equipamento, para realizar o atendimento de links
de gerao de pginas dinmicas a partir do processamento
de uma funo AdvPL de um link com extenso .APL.

RPCServer

Nome da seo que indica a conexo do servidor para

processamentos.

Define qual ser o tempo, em segundos, de timeout da thread

criada e mantida, no servidor do Sistema (ERP), para atender
RPCTimeout
a uma requisio de pgina dinmica AdvPL atravs de uma
URL/link com extenso .APL.
SenhaP

Define a proteo de pginas estticas e/ou dinmicas,

do TOTVS Application Server HTTP, atravs de um kit de

Chave

Descrio
integrao com o SenhaP/SafeCARD.

SenhaPPort

Define a porta de
SenhaP/SafeCARD.

conexo

do

kit

de

integrao

do

Define o nome ou endereo IP do equipamento onde est

SenhaPServe instalado o kit de integrao SenhaP/SafeCARD para proteo
r
de pginas estticas e/ou dinmicas do TOTVS Application
Server HTTP.
Define o intervalo, em segundos, das variveis da sesso do
SessionTime usurio ao utilizar uma configurao de working threads
Out
extended para atender, atravs de link .APW, as solicitaes
de gerao de pginas dinmicas em AdvPL.
UploadPath

Indica onde sero gravados os arquivos submetidos ao TOTVS

Application Server para Upload.

Exemplo da Sesso Hppt:

[http]
enable=1
path=C:\TOTVS 11\Microsiga\Help OnLine
port=80

1.5.9 Sesso [Service]

Esta opo til quando for necessrio utilizar mais de um TOTVS
Application Server rodando como servio na mesma mquina, pois permite
ao usurio informar nomes diferentes.
A seguir, veja a documentao de todas as chaves relacionadas a
configurao:
Chave
Name

Descrio
Indica o nome interno do servio.

Displayna Indica o nome que ser apresentado na janela de servios do

me
Microsoft Windows.
[service]
Name=AppServer_Teste
displayname=.TOTVS AppServer
Observao: Sugerimos que todos os servios da Totvs sejam colocados na
chave displayname o nome do Servio precedido do ponto (.), conforme
exemplos abaixo. Para isso, devem ser editados os aquivos .INI de tais
servios.
.TOTVS AppServer
.TOTVS DBAccess
.TOTVS LicenseServer

1.6

Configurao do arquivo SmartClient.INI

As configuraes do TOTVS SmartClient tambm podem ser customizadas,

de modo que pode-se manter diferentes conexes em um mesmo servidor.
Por exemplo:
Uma rede local com conexes via TCP/IP e algumas outras conexes
remotas, via modem ou Internet, utilizando TCP/IP;
Diferentes redes conectadas via linha privada. Cada uma destas redes
mantm um TOTVS Application Server para o processamento distribudo.
Estas configuraes so mantidas no arquivo smartclient.ini que se encontra
no diretrio de execuo do TOTVS SmartClient.
A seguir, so detalhadas as sees e um exemplo de configurao de suas
chaves:
Seo
Descrio
Config

Identifica
informaes
do TOTVS SmartClient.

Drivers

A seo [Drivers] define quais os protocolos podem ser

utilizados para que o Terminal conecte-se ao TOTVS
Application Server. igual a seo de mesmo nome no
arquivo de configuraes do TOTVS Application Server.
A diferena que as sees aqui informadas (que
devem ser separadas por vrgulas) so utilizadas em
tentativas de conexo, de acordo com a ordem em que
foram informadas.

Sees
Protocolos
Conexo

gerais

de

configurao

As sees de configuraes de protocolos so definidas

da mesma forma que no arquivo de configuraes
do TOTVS Application Server.
No necessitam ter o mesmo nome que o definido
no TOTVS Application Server, porm as informaes
devem ser as mesmas e, somente os protocolos
definidos na chave Active, da seo [Drivers], do
arquivo de configurao do TOTVS Application Server,
podem ser utilizados quando estiver configurando
de o TOTVS SmartClient.
de Notas:
Para a execuo local (TOTVS Application Server
e TOTVS SmartClient executados na mesma mquina)
pode-se informar: Server = LocalHost.
Para execuo remota, o nome do servidor ou o
endereo IP informado para o TOTVS SmartClient deve
ser o mesmo configurado no TOTVS Application Server
onde o terminal est conectado. Do mesmo modo, a
porta informada na chave Port deve ser a mesma
configurada em ambos, TOTVS Application Server
e TOTVS SmartClient;

A
seo
[Printer_Map_Port2Spool]
define
o
Printer_Map_Port2S
mapeamento de portas de impresso para spool de
pool
impresso.
Exemplo de configurao do arquivo SmartClient.INI
[Config]

LastMainProg=sigaadv
EnvServer=environment
Language=1
BrowserEnabled=1
[Drivers]
Active=tcp
[TCP]
Server=localhost
Port=1237

2. Acessando o Protheus 11
1 Parmetros do Atalho dos Aplicativos TOTVS
Antes de instalarmos e iniciarmos os aplicativos TOTVS como
AppServer.exe, devemos inicialmente entender seus (Parmetros de
Inicializao):
Parmetro (-Console) ou (-Debug) como uma janela console.
Executado como uma (Janela Console), as informaes recebidas das
conexes com o TOTVS Application Server (AppServer) conectados so
exibidas diretamente na tela do console do TOTVS Application Server
(AppServer), bem como informaes de (No Conformidades), e a execuo
do TOTVS Application Server (AppServer) pode ser interrompida com o
pressionamento da combinao de teclas [Ctrl]+[Break];
Parmetro (-Install)
Se o TOTVS Application Server (AppServer), no for instalado como um
(Servio do NT), durante a Instalao, isto pode ser realizado, executando-o
com a opo de (Linha de Comando). Ao optar por executar o TOTVS
Application Server (AppServer), como um (Servio do NT), durante o
processo de Instalao, o mesmo ser adicionado (Lista de Servios do
NT) e iniciado.
O administrador poder ento (Iniciar ou Parar o Servio), atravs do Item
(Services), do (Painel de Controle do Windows NT) ou ainda remov-lo do
servio, atravs do Parmetro (-Remove). Para remov-lo da (Lista de
Servios do NT), pode-se execut-lo com a opo de Linha de Comando).

Importante: os mesmos parmetros servem para o aplicativo TOTVS

DBAcces, atravs do arquivo DBAccess64.exe:
Para rodar modo console o TOTVS DBAccess 64 bits como servio do
Windows:
Acesse o prompt de comandos como Administrador.
Acesse o diretrio base de instalao do TOTVS DBAccess 64 bits.
Utilize o comando cd %PROGRAMFILES%\TOTVSDBAccess64.
Execute o comando dbaccess64.exe -console. Tecle ENTER.
Para instalar o TOTVS DBAccess 64 bits como servio do Windows:
Acesse o prompt de comandos como Administrador.
Acesse o diretrio base de instalao do TOTVS DBAccess 64 bits.
Utilize o comando cd %PROGRAMFILES%\TOTVSDBAccess64.

Execute o comando dbaccess64.exe -install.

Ao trmino o TOTVS DBAccess estar configurado como um servio do
Windows.
Para remover o servio do TOTVS DBAccess 64 bits do Windows:

Observao: Antes de remover o servio instalado, pare o servio.

Acesse o prompt de comandos como Administrador.
Acesse o diretrio base de instalao do TOTVS DBAccess 64 bits.
Utilize o comando cd %PROGRAMFILES%\TOTVSDBAccess64.
Execute o comando dbaccess64.exe -remove.
Ao trmino, o TOTVS DBAccess no estar mais configurado como servio
do Windows

1 Acessando o sistema
- Coloque os aplicativos Appserver.exe e DBAccess64.exe para rodar em
modo console;
- Execute o Client do Protheus 11 atravs do cone do SmartClient dentro do
diretrio \Bin\SmartClient;
- Confira os dados e confirme os Parmetros Iniciais.

- Preencha os dados solicitados e at a escolha do pas;

- Agora o Protheus 11, ir criar os Arquivos Customizadores.

- Ao aparecer a janela Diretrio dos Arquivos de Dados, a partir do
Servidor, selecione o diretrio \Data\, confirme-a.

A partir deste momento j temos todo o Ambiente pronto, para iniciarmos

os Testes necessrios, para a Efetiva Implementao do Protheus 11.
- Caso o sistema funcione normalmente, feche-o instale os servios do
AppServer, DBAccess64 e LicenseServer e coloque-os para inicializao
Automtica.

2 Data Execution Prevention

A DEP (Preveno de Execuo de Dados) um conjunto de tecnologias de
hardware e software, includo no sistema operacional Microsoft
Windows, que efetuam verificaes adicionais na memria para ajudar a
proteger contra exploraes de cdigo malicioso.
Quando em ao, seu comportamento fechar o aplicativo, exibir uma
mensagem ao usurio alertando o problema, fornecer ao usurio a opo de
aprender mais sobre a DEP e de desabilit-la para o aplicativo que foi
fechado.

Por que a DEP importante?

Embora causar o encerramento de um processo ou uma falha no sistema e
exibir um erro no seja uma experincia ideal, isso pode evitar
especificamente alguns ataques em que um vrus ou outro tipo de ataque
injete um processo com cdigo executvel e tente executar o cdigo
injetado.

Como definir as configuraes da DEP

O seguinte procedimento descreve como configurar manualmente a DEP:
No Windows, clique Iniciar + Painel de Controle.
No Control Panel, clique Sistema e Segurana + Sistema.
Em Sistema, clique Configuraes Avanadas do Sistema.
Em Propriedades do Sistema, clique na guia Avanado.
Na rea Desempenho, clique Configuraes.
Na janela Opes de Desempenho, clique na guia Preveno de Execuo
de Dados.
Selecione Ativar a DEP para todos os programas e services, exceto
os que eu selecionar.
Clique Adicionar e adicione o aplicativo que no deve ser executados
com a DEP.
Exemplo: Aplication Server (appserver.exe).

Depois de selecionado, clique Abrir.

Observe na Janela Opes de Desempenho, que o aplicativo (Application
Server) passa a ser apresentado na lista.

Clique Aplicar para confirmar a alterao das configuraes.

3 Cadastrando Empresas
- Falar sobre o sigamat.emp (envio pelo portal)