Você está na página 1de 53

Notas de Release

guia_de_instalacao
Todos os direitos reservados. Partes deste trabalho no podem ser reproduzidas, de forma alguma ou por meio
algum - grfico, eletrnico ou mecnico, incluindo fotocpias, gravaes, digitaes ou armazenamento de
informaes e sistemas de restaurao - sem a permisso escrita do editor.
Os produtos referidos neste documento podem ser marcas registradas ou apenas marcas de seus respectivos
proprietrios. O editor e o autor no reivindicam a essas marcas registradas.
Uma vez que todas as precaues foram tomadas para a elaborao deste documento, o editor e o autor no se
responsabilizam por eventuais erros ou omisses, ou por danos resultantes do uso das informaes contidas neste
documento ou do uso dos programas ou cdigos-fonte que possam acompanh-lo. Em nenhum caso o editor e o
autor sero responsabilizados por quaisquer perdas de lucros ou qualquer outro dano comercial causado ou alegado,
direta ou indiretamente, por este documento.
quarta-feira, 21 de setembro de 2011 - So Paulo - Brasil
guia_de_instalacao
Todos os direitos reservados.
Publicao
TOTVS S.A
Produo
Equipe de Documentao
Av. Braz Leme, 1717
02511-000 - So Paulo - SP
(11) 2099 7100 Grande So Paulo
55 (11) 2099-7260
totvs.com.
3 Contedo
guia_de_instalacao
3
Sumrio
Guia de Instalao
.............................................................................................................. 7
Pr-Requisitos
......................................................................................................................... 7 Hardware Mnimo Recomendvel
......................................................................................................................... 9 DEP
.............................................................................................................. 10
Instalando o Application Server
......................................................................................................................... 10 No Linux
......................................................................................................................... 11 No Windows
......................................................................................................................... 11 Contrato de Licena
......................................................................................................................... 11 Diretrio de Instalao do Application Server
......................................................................................................................... 12 Instalao de DLLs
......................................................................................................................... 12 Verificao das Configuraes de Instalao
......................................................................................................................... 12 Processo de Instalao
......................................................................................................................... 12 License Server
.............................................................................................................. 14
Assistente de Configurao do Application Server
.............................................................................................................. 15
Instalando o Help
......................................................................................................................... 15 No Linux
......................................................................................................................... 15 No Windows
......................................................................................................................... 16 Contrato de Licena
......................................................................................................................... 16 Diretrio de Instalao dos Arquivos de help
.............................................................................................................. 17
Localizao do Application Server
......................................................................................................................... 17 Processo de Instalao
.............................................................................................................. 18
Instalando o Smart Client
......................................................................................................................... 18 No Linux
......................................................................................................................... 18 No Windows
......................................................................................................................... 18 No MAC OS
......................................................................................................................... 20 Contrato de Licena
......................................................................................................................... 20 Diretrio de Instalao
......................................................................................................................... 20 Pasta de Instalao
......................................................................................................................... 20 Instalao de DLLs
......................................................................................................................... 20 Verificao das Configuraes de Instalao
......................................................................................................................... 21 Processo de Instalao
......................................................................................................................... 21 Chave de Inicializao
guia_de_instalacao
4
Contedo
......................................................................................................................... 21 Chave de Emergncia
.............................................................................................................. 23
Protheus Search
......................................................................................................................... 23 No Linux
......................................................................................................................... 23 No Windows
......................................................................................................................... 23 Contrato de Licena
......................................................................................................................... 24 Diretrio de Instalao
......................................................................................................................... 24 Verificao das Configuraes de Instalao
......................................................................................................................... 24 Processo de Instalao
.............................................................................................................. 25
TOTVS Office Interface Integration com Microsoft Office 2007
......................................................................................................................... 25 Diretrio de Instalao
......................................................................................................................... 26 Confirmao da Instalao
......................................................................................................................... 26 Processo de Instalao
......................................................................................................................... 26 Concluso da Instalao
.............................................................................................................. 27
Atualizao do Sistema
.............................................................................................................. 28
Executando o MP710TO110
.............................................................................................................. 31
Instalando o Servidor de Licenas
......................................................................................................................... 31 Instalao Fsica do Hardlock
........................................................................................................................ 31 Hardlock (usb)
........................................................................................................................ 31 Hasp
.............................................................................................................. 34
Instalao do Driver do Proteq/Safenet (Compact-500)
......................................................................................................................... 34 No Windows
......................................................................................................................... 34 No Linux
......................................................................................................................... 34 Demais Ambientes Unix
......................................................................................................................... 34 Executando o Aplicador de Licenas TOTVSLIC.KEY
........................................................................................................................ 34 Como Executar o Aplicador de Licenas TOTVSLIC.KEY
.............................................................................................................. 36
Configurao do appserver.ini
......................................................................................................................... 36 Sees
........................................................................................................................ 36 Environment
........................................................................................................................ 38 DbAccess
........................................................................................................................ 39 Drivers
......................................................................................................................... 39 Sees de Protocolos de Conexo
........................................................................................................................ 39 Servernetwork
........................................................................................................................ 40 HTTP
........................................................................................................................ 40 FTP
........................................................................................................................ 41 ONSTART
........................................................................................................................ 41 License Server
5 Contedo
guia_de_instalacao
5
........................................................................................................................ 42 License Client
........................................................................................................................ 42 General
........................................................................................................................ 43 Service
........................................................................................................................ 43 cTree Server
.............................................................................................................. 45
Configurando o Smart Client
......................................................................................................................... 45 Config
......................................................................................................................... 45 Drivers
.............................................................................................................. 46
Sees de Protocolos de Conexo
.............................................................................................................. 47
Application Server
......................................................................................................................... 47 Servidor ADS
........................................................................................................................ 47 Instalao do Servidor ADS
........................................................................................................................ 47 Configurao do Servidor ADS
......................................................................................................................... 47 Servidor cTree
........................................................................................................................ 47 Instalando o Servidor cTree
........................................................................................................................ 48 Configurao do Servidor cTree
.............................................................................................................. 50
Topologia de Utilizao de Rede do Application Server
......................................................................................................................... 51 Instalao do Application Server em redes Netware Novell
Pr-Requisitos
1
Guia de Instalao
7
guia_de_instalacao
Hardware Mnimo Recomendvel
Banco de
Dados
10
Usurios
15
Usurios
20
Usurios
30
Usurios
50
Usurios
Banco de
dados e
aplicativo
Classic e
Express
Banco de
dados e
aplicativo
Classic e
Express
Banco de
dados e
aplicativo
Classic e
Express
Banco de
dados e
aplicativo
Classic e
Express
Banco de
dados
(***)
Classic e
Express
Aplicativo
Classic e
Express
Oracle
Windows,
Oracle
LINUX,
MSSql
Server,
Informix
Windows,
Informix
LINUX,
Sybase
Adaptive
Server,
DB2
Windows,
DB2 Linux,
(*)
Xeon 2.0
1X
Dual Core
L2 4,0 MB
2,0 GB
RAM
Ultra 4
SCSI
Xeon 2.6
1X
Dual Core
L2 4,0 MB
2,0 GB
RAM
Ultra 4
SCSI
Xeon 2.8
1X
Dual Core
L2 4,0 MB
3,0 GB
RAM
Ultra 4
SCSI
Controlado
ra com
cache e
bateria
backup.
Xeon 3.0
2X
Dual Core
L2 4,0 MB
4,0 GB
RAM
HD SAS
15K
Controlado
ra com
cache e
bateria
backup
Xeon 3.0
2X
Dual Core
L2 4,0 MB
4,0 GB
RAM
HD SAS
15K
Controlado
ra com
cache e
bateria
backup.
Pentium D,
3,0 Ghz L2
4,0 MB
3,0 GB
RAM
Ultra 4
SCSI
AS/400
(**)
Pentium D,
3,0 Ghz L2
4,0 MB
2,0 GB
RAM
Ultra 4
SCSI
(Aplicativo
e File
Server)
Pentium D,
3,0 Ghz L2
4,0 MB
2,0 GB
RAM
Ultra 4
SCSI
(Aplicativo
e File
Server)
Pentium D,
3,0 Ghz L2
4,0 MB
2,0 GB
RAM
Ultra 4
SCSI
(Aplicativo
e File
Server)
Pentium D,
3,0 Ghz L2
4,0 MB
2,0 GB
RAM
Ultra 4
SCSI
(Aplicativo
e File
Server)
Pentium
D,
3,0 Ghz
L2
4,0 MB
3,0 GB
RAM
Ultra 4
SCSI
(Aplicativo
e File
Server)
Postgree
v7.11 ou
acima
Windows e
Linux
Pentium D,
3,0 Ghz L2
4,0 MB
2,0 GB
RAM
Ultra 4
SCSI
No
recomend.
No
recomend.
No
recomend.
No
recomend.
No
recomend.
(*) At 5 GB de dados, utilize 2 discos rgidos em paralelos para acesso simultneos. Acima disso,
utilize Disk Array (Raid 5 ou Raid 0 + 1) que tenha controladora com cache e bateria de backup.
(**) Servidor apenas para o Application Server.
8
Guia de Instalao
guia_de_instalacao
Para dimensionamento do AS/400, deve-se considerar o nmero de 9 CPW - Commercial Processing
Workload por usurio em servidores de caractersticas batch.
(***) Servidor no possui capacidade para acrescentar processadores.
2x = Servidores com 2 (dois) processadores Xeon (Dual Core).
Pentium D - Para mais informaes, consulte o site do fabricante www.intel.com.
Recomendaes
As configuraes citadas, trata das necessidades mnimas e EXCLUSIVAS para utilizao do
Application Server e dos SGBDs (Sistema Gerenciador de Banco de Dados) homologados. No
entanto, diante da utilizao de outros aplicativos, as necessidades devero ser melhor
dimensionadas.
Nessas configuraes, no considerada a utilizao do Windows 2003 com Active Director (ADS).
Acrescente a licena do Ads Server ou c-tree Server para o gerenciamento do File Share quando
estiver utilizando entre 30 e 150 usurios.
Em sites com mais de 250 usurios, utilize o Memory Files por meio do c-tree Enterprise Server.
Ao utilizar os ambientes Call Center (SIGATMK) e Front Loja (SIGAFRT), do produto Microsiga
Protheus, deve-se utilizar mais 10 MB de memria RAM por usurio no servidor de aplicao.
Para sites com mais de 50 usurios ou base de dados maior que 5 GB, entre em contato conosco
pelo endereo www.totvs.com/customercenter.
A seguir, veja as recomendaes necessrias para:
Processador e Memria fsica
Estao com processamento no servidor:
Pentium III 700 MHz - 128 MB RAM + Memria recomendada para operao do sistema operacional.
Estao com processamento local (Two Tier)
Pentium III 700 MHz - 256 MB RAM (Sem base de dados na estao) + Memria recomendada para
operao do Sistema Operacional.
Espao em disco
O disco rgido (HD - Hard Disk) deve ser adquirido em funo das necessidades da empresa; ou seja,
conforme os volume de dados.
Link de comunicao
Linha privada (LP) de dados 48 kbps para uma sesso.
Linha privada (LP) de dados 15 kbps por sesso (utilize um Frame Relay puro), desde que esteja com
mais de 5 usurios.
O tempo de resposta, do site remoto, deve ser inferior a 120 ms (tempo de resposta do comando
Ping) em pacotes de 32 KB.
Utilize o WTS (Windows Terminal Server) com meta frame, caso o trecho seja realizado por meio de
atlite ou tenha um tempo de latncia muito elevado na comunicao remota.
Outros tipos de comunicao devem ser avaliados.
Nota
Guia de Instalao
9
guia_de_instalacao
1. Caso o produto Microsiga Protheus utilize integridade referencial (opo vlida para
Oracle, DB2 e MSSQL Server), deve-se considerar o sizing de 1 nvel acima.
2. Para utilizar as ferramentas Painel de Gesto e Protheus Search, do produto Microsiga
Protheus, utilize a mesma configurao do servidor de aplicao para at 50 usurios
(Pentium D, 3,0 GHz L2 4,0 MB, 3,0 GB RAM, Ultra 4 SCSI)
3. Para utilizar a ferramenta Indicadores DW Nativos, do produto Microsiga Protheus, entre
em contato conosco pelo endereo www.totvs.com/customercenter para obter especifica
es.
DEP (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 efetua verificaes adicionais na memria para


ajudar a proteg-la contra exploraes de cdigo malicioso.
Quando em ao, seu comportamento fechar o aplicativo, exibir uma mensagem ao usurio,
alertando-o sobre o problema, fornecer ao usurio a opo de aprender mais sobre a DEP e
desabilit-la para o aplicativo que foi fechado.
O seguinte procedimento descreve como providenciar a configurao manualmente a DEP:
1. No Windows

, clique Start + Start Menu + Control Panel.


2. No Control Panel, clique System and Maintenance + System.
3. Em System, clique Advance System Settings.
4. Em System Properties, clique em Advanced.
5. Na rea Performance, clique Settings.
6. Na janela Performance Options, clique em Data Execution Prevention.
7. Selecione Turn on DEP for all programs and services except those I select.
8. Clique Add e adicione o aplicativo que no deve ser executado com a DEP.
Exemplo: Application Server
9. Clique em Open.
Observe na janela Performance Options, que o aplicativo (Application Server) passa a ser
apresentado na lista.
10. Clique Apply para confirmar a alterao das configuraes.
10
Guia de Instalao
guia_de_instalacao
Instalando o Application Server
Atualizao/Primeira Instalao
Caso seja uma Atualizao de Verso, informe o diretrio em que est instalada a verso 11 do
Microsiga Protheus

. Em seguida, o kernel das verses anteriores do Microsiga Protheus

continuar a
existir, porm os dados j estaro prontos para a atualizao da verso. Este diretrio conter os dados
(SYSTEM, DATA, SPOOL etc.).
importante, antes de iniciar qualquer procedimento, fazer backup das bases de dados, arquivos de
configuraes (dicionrio de dados, parmetros, tabelas, CNAB, SISPAG, etc.), menus e programas
especficos dos usurios.
imprescindvel providenciar a atualizao dos menus nesse processo para evitar perdas de
funcionalidades no Microsiga Protheus

.
Aps a instalao, atualize os atalhos de acesso ao Application Server e Smart Client para o novo
caminho e execute o programa Assistente de Configurao para importar o arquivo de configurao
.INI.
Caso seja a Primeira Instalao, indique o caminho onde os arquivos de dados do Protheus
devem ser gravados. Clique em Avanar para prosseguir.
Idioma do Sistema/Base de Dados Utilizada
Nesta tela, deve-se selecionar:
1. Os tipos de repositrios disponveis no Microsiga Protheus

: DBAccess (integrado com todos os


tipos de banco de dados disponveis para esta aplicao), ADS

(Advantage Database Server) para


NT ou Novell NetWare

, ISAM padro DBF ou Ctree

.
Neste momento, pode-se optar por apenas uma base de dados, porm pelas alteraes no arquivo
de configurao do Application Server e cpia do repositrio correto, possvel fazer com que a
mesma instalao do Microsiga Protheus

utilize dois tipos de base de dados.


2. O idioma do RPO (Repositrio) a ser instalado.
3. 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. Clique em Avanar para prosseguir.
No Linux

1. Monte o volume de Instalao, utilizando o comando:


mount /mnt/cdrom -o exec
2. Acesse o diretrio:
/mnt/cdrom/linux/appserver
Guia de Instalao
11
guia_de_instalacao
3. Execute o Shell script:
./install_linux
4. Siga os passos indicados pelo Shell script.
5. Aps a instalao, no diretrio /microsiga, leia o arquivo LEIAME com instrues de execuo do
Application Server em Linux

.
No Windows

Na parte inferior da tela, so apresentados os idiomas disponveis para apresentao do instalador do


Microsiga Protheus

. Clique no cone correspondente ao idioma que deseja utilizar.


Ao lado direito da tela, so apresentadas as opes dos aplicativos para instalao:
Instalao do Application Server.
Instalao do Smart Client.
Instalao do DbAccess.
Instalao do TOTVS Office Interface Integration.
Instalao do Protheus Search.
Procedimento de instalao
1. Clique em Application Server. O instalador ser iniciado. A janela Bem-vindo apresentada.
2. Clique em Avanar para prosseguir.
Contrato de Licena
Leia o Contrato de Licena com ateno e clique em Sim para prosseguir.
Diretrio de Instalao do Application Server
1. Indique o caminho onde o Application Server deve ser instalado.
2. Clique em Avanar para prosseguir.
12
Guia de Instalao
guia_de_instalacao
Importante
Recomenda-se o uso do diretrio padro de instalao, para que o processo de suporte e
treinamento seja facilitado.
Evite o uso de unidades lgicas (drivers de rede), para tanto utilize sempre o computador que
faz o papel de servidor para efetuar a instalao. Com isso, diminui-se o risco de erro sem
eventuais desinstalaes do Sistema.
Instalao de DLLs
Clique em Sim se utilizar os mdulos de Automao Comercial (SIGALOJA, SIGAFRT).
Desta forma, sero instalados os arquivos de DLLs para comunicao com os perifricos homologados.
Verificao das Configuraes de Instalao
Verifique as configuraes de instalao e confirme o seu incio, clicando em Avanar.
Se precisar alterar alguma opo, clique em Voltar.
Processo de Instalao
Informadas as variveis de instalao, iniciado o processo de descompactao e cpia dos arquivos.
License Server
Nesta janela, informe o nome ou endereo IP (prefervel) do Servidor de Licenas e a porta de
conexo. Se o equipamento onde o Application Server est sendo instalado tambm for o Servidor de
Licenas, deve-se marcar a opo Este servidor tambm um Servidor de Licenas.
O License Server um recurso do produto Application Server, que tm como objetivo realizar o
controle das licenas de uso dos softwares e aplicaes TOTVS.
Por meio deste recurso, aliado ao uso de um dispositivo fsico Hardlock (HASP/USB e o Compact-500
USB e paralelo), dotado de um cdigo identificador nico e da utilizao de uma chave de liberao de
licenas de uso, codificada e exclusiva para cada cliente, possvel prover, de forma eficiente e segura,
as licenas e liberaes de utilizao de mdulos e/ou funcionalidades das aplicaes TOTVS em
conformidade com o contrato firmado entre o cliente e a TOTVS.
Por ser um servio de instncia nica, isto , em um ambiente e/ou instalao de um ou mais produtos
TOTVS, somente deve haver um nico License Server, este servio tambm utilizado internamente
por programas e rotinas para semaforizaes, controles de execuo mutuamente exclusivos (usados
Guia de Instalao
13
guia_de_instalacao
para programas ou rotinas que exigem uma nica execuo simultnea no ambiente) e sequncias de
numerao automtica.
Dada a criticidade de ambiente, o License Server foi projetado para permitir uma configurao de alta
disponibilidade do servio de controle, pois, assim, se o License Server ou o hardware sair de operao,
um segundo servio pode, automaticamente, substituir o primeiro. Neste projeto de arquitetura,
quando o primeiro servio interrompido os usurios tero que reconectar no sistema.
Os mdulos do ERP e suas rotinas necessitam de um License Server para o controle das licenas de uso
e, em ambientes/arquiteturas, onde existem restries ou segmentaes, possvel instalar/configurar
um ou mais License Server adicionais para cada um destes sites. Para tais casos, inclusive para a
configurao de redundncia no servio de licenciamento, deve-se verificar a documentao do ERP que
trata de forma mais detalhada este tpico, inclusive as indicaes, impactos e eventuais restries de
uso do License Server.
No projeto de arquitetura do License Server, foram previstos qualquer tipo de ocorrncia de hardware
que pudesse interromper o seu uso, para esses casos, a TOTVS fornece uma senha de emergncia que
pode ser obtida em nosso canal de atendimento (CST - Centro de Servios TOTVS). Tal senha permite
que o ERP opere sem a necessidade do License Server at o problema ser solucionado. Por ter uma
arquitetura simples, o License Server no necessita de nenhum outro componente, alm dos fornecidos
pela TOTVS, simplificando o processo de restaurao no qual um simples restore do diretrio de
instalao possibilita seu uso.
14
Guia de Instalao
guia_de_instalacao
Assistente de Configurao do Application Server
O programa de instalao prepara o Application Server com as configuraes mnimas para a sua
correta execuo. Porm, pode-se configur-lo pela manuteno do arquivo de configuraes
(appserver.ini). As configuraes so mantidas em diferentes sees de Environments, conforme a
estrutura do arquivo de configuraes.
No Windows

, possvel configurar o arquivo appserver.ini, utilizando este Assistente de


Configurao do Application Server.
Alm disso, o assistente permite a instalao e configurao dos mdulos Web do Microsiga Protheus

:

Portal Protheus
DW - Data Warehouse
BSC- Balanced Scorecard
WPS - WebPrint/WebSpool
RH Online - Terminal do Funcionrio e
WS - Web Service.
1. Clique em No, se no desejar executar o Assistente de Configurao, neste momento. O
Assistente de Configurao pode ser acessado aps a instalao pelo menu Iniciar, pasta
Protheus 11/Ferramentas/Assistente de Configurao.
2. Se desejar executar o assistente de configurao, clique em Sim. Consulte ao final deste guia as
informaes sobre as sees do arquivo de configurao do servidor (appserver.ini).
Guia de Instalao
15
guia_de_instalacao
Instalando o Help no Linux

A documentao acessada a partir dos mdulos do Microsiga Protheus

pela tecla [F1].


Procedimento de instalao
Para instalar o Help Online no Linux

. Certifique-se de que no existe nenhum volume montado para o


contedo de Help.
1. Monte o volume de Instalao, utilizando o comando:
mount /mnt/cdrom -o exec
2. Acesse o diretrio:
/mnt/cdrom/linux
3. Execute o Shell script:
./install_help
4. Siga os passos indicados pelo Shell script.
Instalando o Help no Windows

A documentao acessada a partir dos mdulos do Microsiga Protheus

pela tecla [F1].


Procedimento de instalao
Para instalar o Help Online no Windows

:
1. So apresentados os idiomas disponveis para exibio das telas do instalador do Microsiga Protheus

Help. Clique no cone correspondente ao idioma que deseja utilizar.


Ao lado direito da tela, apresentada a opo Protheus Help para instalao.
2. Clique em Protheus Help.
O instalador iniciado e ento a janela Bem-vindo apresentada.
3. Clique em Avanar para prosseguir.
16
Guia de Instalao
guia_de_instalacao
Contrato de Licena
Leia o contrato de licena com ateno e clique em Sim para prosseguir.
Diretrio de Instalao dos Arquivos de Help
Nesta janela, informe o diretrio de instalao dos arquivos de helps.
Clique em Avanar.
Guia de Instalao
17
guia_de_instalacao
Localizao do Application Server
Nesta janela, informe o diretrio em que est instalado o Application Server, para que seja configurado
corretamente pelo programa de instalao.
Clique em Avanar.
Processo de Instalao
Com a configurao da instalao do Help, ser iniciado o processo de cpia dos arquivos.
Esse procedimento configura o acesso aos helps a partir do Application Server. Caso queira utilizar
outro servidor de Help, pode-se copiar os arquivos instalados para outro servidor e alterar o arquivo
appserver.ini, indicando a sua nova localizao pela configurao da chave PATH da seo HTTP e da
chave HELPSERVER do ambiente utilizado.
Para isso, utilize o Assistente de Configurao do Application Server.
18
Guia de Instalao
guia_de_instalacao
No Linux

A aplicao do SmartClient Linux obtida no diretrio protheus11/bin/smartclient.


No Windows

O Smart Client pode ser instalado fisicamente em uma estao, por meio de uma opo da tela inicial
de instalao do Microsiga Protheus

.
Este recurso til para instalao do Smart Client em computadores que no esto conectados rede
local, ou seja, que necessitam que os executveis estejam fisicamente na mquina. Por exemplo, em
casos de filiais que acessam a matriz por uma linha discada pelo protocolo TCP/IP.
Ressalta-se que o procedimento de instalao do Smart Client nas estaes s recomendado em
casos especficos (utilizao remota, alto trfego de dados na rede, etc.).Preferencialmente, indicado
o uso centralizado do Smart Client no Servidor pela criao de atalho para acesso.
Procedimento de instalao
Para instalar o Smart Client com Autorun:
1. So apresentados os idiomas disponveis para apresentao da instalao do Microsiga Protheus

.
Clique no cone correspondente ao idioma que deseja utilizar. Ao lado direito da tela, so
apresentadas as opes dos aplicativos para instalao:
2. Clique em Smart Client.
O instalador ser iniciado. A janela de boas vindas apresentada.
3. Clique em Avanar para prosseguir.
No MAC OS

Para o sistema operacional Mac OS X



no h um instalador padro, o SmartClient MacOS um
aplicativo nativo.
Os aplicativos nativos para MAC OS

encapsulam todo seu contedo em um nico arquivo, para o


Microsiga Protheus

, no smartclient.app.
Guia de Instalao
19
guia_de_instalacao
Procedimento de instalao
Para instalar o Smart Client no MAC OS

:
1. No MAC OS

, abra o aplicativo Finder.


2. Crie uma pasta, como por exemplo: /Users/MeuUsuario/DeskTop/totvs.
3. Copie o arquivo smartclient.app na pasta criada.
Importante
O arquivo smartclient.app disponibilizado pela TOTVSTec.
Para configurar o smartclient.ini:
1. Selecione o arquivo smartclient.app e clique com o boto direito do mouse, em seguida selecione
Mostrar Contedo do Pacote.
2. exibida a pasta Contents, selecione a sub pasta MacOs e, em seguida, clique no arquivo
smartclient.ini.
3. Edite o arquivo smartclient.ini com duplo clique do mouse.
4. Altere o endereo IP e porta para seu AppServer.
Exemplo:
[tcp]
server=172.16.31.61
port=5055
5. Aps a instalao e configurao, d duplo clique no arquivo smartclient.app para edit-lo.
Para executar o Smart Client:
1. Clique em Smart Client.
2. Informe os dados dos Parmetros Iniciais e clique em Ok.
20
Guia de Instalao
guia_de_instalacao
Contrato de Licena
Leia o Contrato de Licena com ateno e clique em Sim para prosseguir.
Diretrio de Instalao
Indique o caminho em que o Smart Client deve ser instalado.
Clique em Avanar para prosseguir.
Importante
Recomenda-se o uso do diretrio padro de instalao, para que o processo de suporte e
treinamento seja facilitado.
Evite o uso de unidades lgicas (drivers de rede). Para tanto, utilize sempre o computador que faz o
papel de servidor para efetuar a instalao. Com isso, diminui-se o risco de erros em eventuais
desinstalaes do Sistema.
Pasta de Instalao
Indique a pasta onde devem ser instaladas as opes de acesso aos aplicativos do Microsiga Protheus

.
Instalao de DLLs
Clique em de opo Sim se utilizar os mdulos de Automao Comercial (SIGALOJA e SIGAFRT).
Desta forma, sero instalados os arquivos de DLLs para comunicao com os perifricos homologados.
Verificao das Configuraes de Instalao
Verifique a configurao de instalao e confirme o seu incio, clicando em Avanar.
Se precisar alterar alguma opo, clique em Voltar.
Guia de Instalao
21
guia_de_instalacao
Processo de Instalao
1. Informadas as variveis de instalao, iniciado o processo de descompactao e cpia dos
arquivos.
2. Ao final da instalao, apresentada uma tela sobre a concluso do processo.
3. Clique em Concluir para finalizar.
Chave de Inicializao
Para que seja possvel utilizar o Sistema logo aps a emisso de um documento fiscal de CDU (Cesso
de Direito e Uso), necessrio informar a Chave de Inicializao contida no documento emitido, nas
Informaes Corporativas no Cadastro de Empresas.
Procedimentos para Utilizao
1. No Configurador em Criao de Empresa, crie todas as empresas/filiais necessrias para a sua
operao.
2. Certifique-se de que as empresas foram gravadas.
3. De posse de seu documento fiscal de CDU, observe a Chave de Inicializao contida nas
mensagens do documento.
4. Retorne ao Configurador, em Criao de Empresa e informe a Chave de Inicializao na seo
Inf.Corporativas.
Importante
A Chave de Inicializao somente poder ser utilizada na primeira instalao do produto.
Chave de Emergncia
A senha de emergncia libera o uso de uma empresa por um dia e pode ser solicitada TOTVS, caso a
empresa ainda no possua a liberao definitiva.
Para obter essa senha, entre em contato com o Canal CST: 55 11 2099-7320, das 8h s 18h, de
segunda sexta-feira ou acesse www.totvs.com/suporte.
22
Guia de Instalao
guia_de_instalacao
Para informar uma Senha de Emergncia
1. No lado esquerdo da janela, clique em Inf. Corporativas.
2. Clique em Autor. Emergncia na barra de ferramentas.
apresentada a janela para informao da senha.
3. Informe a Chave de Emergncia fornecida pela TOTVS e confirme.
A empresa poder ser utilizada por um dia.
Guia de Instalao
23
guia_de_instalacao
Protheus Search
O Microsiga Protheus

possui um localizador de informaes nativo que encontrar, em seu banco de


dados, as expresses desejadas.
O Protheus Search uma especializao do Application Server otimizado para indexao e busca. Por
isso, esse servio no pode ser utilizado para receber conexes do Smart Client, processamentos em
batch, workflow ou servios Web.
O Protheus Search pode ser instalado em um servidor dedicado ou compartilhar o mesmo hardware que
o Application Server, desde que tenha capacidade de processamento ociosa.
Importante:
A porta configurada para o Protheus Search deve ser liberada no firewall quando necessrio.
No Linux

A aplicao do Protheus Search para Linux

obtida no diretrio protheussearch/bin/appserver.


No Windows

Procedimento de instalao
Para instalar o Protheus Search com AutoRun:
1. Clique em Protheus Search. O instalador iniciado e ento a janela Bem-Vindo apresentada.
2. Clique em Avanar para prosseguir.
Contrato de Licena
Leia o Contrato de Licena com ateno e clique em Sim para prosseguir.
24
Guia de Instalao
guia_de_instalacao
Diretrio de Instalao
Indique o caminho em que o Protheus Search deve ser instalado.
Clique em Avanar para prosseguir.
Importante
Recomenda-se o uso do diretrio padro de instalao para que o processo de suporte e
treinamento seja facilitado.
Evite o uso de unidades lgicas (drivers de rede), para tanto utilize sempre o computador que faz o
papel de servidor para efetuar a instalao. Com isso, diminui-se o risco de erro sem eventuais
desinstalaes do Sistema.
Verificao das Configuraes de Instalao
Verifique a configurao de instalao e confirme o seu incio, clicando em Avanar.
Se precisar alterar alguma opo, clique em Voltar.
Processo de Instalao
1. Informadas as variveis de instalao, iniciado o processo de descompactao e cpia dos
arquivos.
2. Ao final da instalao, apresentada a tela sobre a concluso do processo.
3. Clique em Concluir para finalizar.
Importante
Aps a instalao, o administrador do Sistema deve configurar o Protheus Search, por meio do
Assistente de Configurao do Microsiga Protheus.
Consulte o Help deste aplicativo para mais detalhes.
Guia de Instalao
25
guia_de_instalacao
TOTVS Office Interface Integration com Microsoft Office

2007
O TOTVS Office Interface integration a soluo que permite conectar o Microsiga Protheus

aos
aplicativos da sute Microsoft Office

2007 (Word

e Excel

).
O TOTVS Office Interface Integration deve ser instalado na estao de trabalho, conforme os
procedimentos a seguir:
Pr-Requisitos:
a) Microsoft Office

2007 Instalado.
b) Sistema Operacional:
Ver requisitos de instalao do Microsoft Office

2007.
c) Hardware:
Ver requisitos de instalao do Microsoft Office

2007.
d) Software:
Net Framework 2.0.
Microsoft Office

2007 Primary Interop Assemblies.


Microsoft Visual Studio Tools

for Office Second Edition Runtime.


Os requisitos de software so instalados automaticamente pelo Assistente de Instalao do TOTVS
Office Interface Integration quando necessrio.
Para mais informaes sobre os requisitos de hardware e sistemas operacionais suportados pelo
Microsoft Office

2007, consulte o manual do produto ou site do fabricante (


http://office.microsoft.com/pt-br/default.aspx).
Para instalar o TOTVS Office Interface com Autorun:
1. Aguarde a exibio da tela de abertura.
2. Clique em TOTVS Office Interface Integration.
O instalador iniciado e ento a janela Bem-Vindo ser apresentada.
3. Clique em Avanar para prosseguir.
Diretrio de Instalao
1. Indique o caminho onde o TOTVS Office Interface Integration deve ser instalado.
2. Clique em Avanar para prosseguir.
26
Guia de Instalao
guia_de_instalacao
Confirmao da Instalao
Clique em Avanar para prosseguir a instalao.
Processo de Instalao
O processo de instalao iniciado.
Concluso da Instalao
1. Ao final da instalao, apresentada a tela sobre a concluso do processo.
2. Clique em Fechar para finalizar.
Guia de Instalao
27
guia_de_instalacao
Atualizao do Sistema
Quando se est processando a atualizao de verso, necessrio, aps a instalao do Microsiga
Protheus

, executar o programa MP710TO110, antes de qualquer processamento, para que os arquivos


da empresa sejam compatibilizados com os da nova verso enviada pela TOTVS. Leia atentamente as
Notas do Release que acompanham as novas verses para conhecer as alteraes que sero
efetuadas pelo programa de compatibilizao e os novos recursos.
Este programa, sempre que possvel, dar prioridade s configuraes do cliente, a qual apenas ser
modificada, quando a alterao da nova verso for imprescindvel ao seu funcionamento.
O atualizador executa basicamente as seguintes tarefas:
Inclui, exclui ou altera o contedo dos arquivos customizadores SXs de acordo com as modificaes
feitas nos arquivos padres.
Acerta as tabelas de dados, incluindo, excluindo ou alterando a estrutura dos campos. O Sistema
no exclui campos includos pelo usurio em sua base de dados, desde que todas as alteraes
tenham sido efetuadas pelo mdulo Configurador.
Antes de fazer o acerto gerado um backup de cada arquivo a ser alterado com a terminao #DB.
Importante:
imprescindvel realizar um backup dos arquivos de dados (\PROTHEUS_DATA\DATA), ou
antigo (\DADOSADV), dos arquivos customizadores SXs (\PROTHEUS_DATA\SYSTEM) ou
antigo (\SIGAADV) e seus programas especficos, antes de efetuar a atualizao da verso.
28
Guia de Instalao
guia_de_instalacao
Executando o MP710TO110
Importante:
Este programa exclusivo para migrao das verses 7.10 e 8.11 para Microsiga Protheus

. Caso
esteja utilizando uma verso anterior, devem-se migrar as verses progressivamente, utilizando os
atualizadores respectivos, at obter a verso 7.10, para que ento o MP710TO110 possa ser
executado.
Para execut-lo:
1. Acesse a pasta Protheus 11 e carregue o Application Server.
2. Em seguida, acesse o Smart Client.
3. Em Programa Inicial, digite MP710TO110.
4. Clique em OK para confirmar.
Ser apresentada uma janela com orientaes sobre o processo de atualizao.
5. Antes de iniciar o processo, deve-se:
Efetuar o backup dos arquivos dos diretrios SIGAADV e DADOSADV (at a verso 7.10) ou
SYSTEM e DATA (a partir da verso 8.11).
Ter espao em disco de aproximadamente 3 vezes o espao utilizado pelos diretrios SIGAADV e
DADOSADV (at a verso 7.10) ou SYSTEM e DATA (a partir da verso 8.11).
6. No campo Senha, digite a senha do Administrador.
Ser apresentada a janela Ateno, para que seja informada a partir de qual verso ser realizada
a atualizao. Tal informao muito importante, para que o ambiente seja preparado
corretamente:
7. A partir da verso 7.10, informe a verso atual e marque a caixa Atualizar 7.10 para 11.0.
possvel migrar diretamente para a verso 11.
8. Aps a escolha e confirmao, o Sistema retorna tela anterior para dar continuidade ao processo
de atualizao.
Importante:
A partir da verso 8.11, se a integridade referencial estiver ativa, o atualizador de verso ir
desativ-la antes de iniciar o processo de atualizao de verso.
Desta forma, ao final desse processo, ser necessrio executar a rotina que ativa a integridade
referencial, por meio do mdulo Configurador, opo Base de Dados/Integridade.
Se for necessrio apenas simular a atualizao para verificar as alteraes a serem processadas
e eventuais problemas na base de dados, clique na caixa de verificao Simulao. Com esta
opo ativada, no ser gravada nenhuma alterao na base. O Sistema gera um arquivo de log
que pode ser impresso.
9. Em seguida, selecione a localizao a ser atualizada.
10. Se a opo SINDEX exclusivo for selecionada, o MP710TO110 cria automaticamente um dicionrio
Guia de Instalao
29
guia_de_instalacao
de ndice para cada empresa cadastrada. Se esta opo no for selecionada, ser mantido o arquivo
atual compartilhado entre as empresas.
11. Clique em Avanar.
apresentada a janela para informao do diretrio padro, em que sero criadas as novas tabelas
de dados referentes s empresas identificadas e relacionadas.
12. D duplo clique sobre o diretrio e digite outro caminho, se necessrio. A localizao informada ser
considerada abaixo do diretrio raiz definido no appserver.ini (\ROOTPATH)
13. Clique em Avanar.
14. Marque os logs desejados, observando:
Log de Processos
O Log de Processos grava todas as operaes que o Atualizador realiza como, por exemplo,
abertura de arquivos, criao de ndices e arquivos temporrios.
Log de Atualizao
O Log de Atualizao grava todas as alteraes que o Atualizador fez na base, campo a campo,
armazenando o valor anterior e o atual.
Log de Incluso
O Log de Incluso grava todos os registros includos nos arquivos pelo Atualizador. Esta caixa
selecionada automaticamente.
Log Critical Error
O Log Critical Error grava erros crticos que inviabilizam a continuidade do processo de atualizao.
Durante a verificao da integridade, caso seja encontrado um erro crtico, o processo de
atualizao somente poder prosseguir aps a correo do mesmo.
Esta caixa selecionada automaticamente.
Log Warning Error
Este log grava erros que no impedem o processo de atualizao e correes efetuadas por meio do
Assistente do Atualizador. Somente sero indicados neste arquivo. Os logs so gravados nos
arquivos MPUPDATE.LOG.
15. Marque a caixa Permite interromper processo durante a execuo para que ao final de cada
processo, a Atualizao possa ser interrompida. O processo ser reiniciado a partir da ltima tarefa
executada. Se esta caixa no for selecionada, no ser possvel paralisar a Atualizao em nenhum
momento.
Importante
Se desejar saber de todas as alteraes processadas, pode marcar todas as opes de Logs e
tambm a caixa Permite interromper processo durante a execuo.
Neste caso, deve-se interromper ao final de cada processo, analisar os logs e executar a
Atualizao novamente.
Deve-se optar por limpar o Arquivo de Log para evitar que este fique muito grande.
30
Guia de Instalao
guia_de_instalacao
16. Selecione a caixa Corrigir todos os erros automaticamente para que durante o processo de
anlise de integridade, o Atualizador corrija automaticamente alguns erros crticos.
17. Selecione a caixa Eliminar arquivos de backup ao trmino da atualizao para excluir
automaticamente os arquivos de backup que o Atualizador cria durante o processo.
18. Selecione a caixa Manter o arquivo de log existente para manter o log ao reiniciar o processo de
atualizao de verso aps uma pausa.
19. Clique em Avanar para prosseguir.
apresentada a janela relacionando as tarefas que sero executadas pelo Atualizador, sendo:
Verificao das bases.
Atualizao dos arquivos customizadores SXs.
Atualizao das tabelas.
Atualizao dos arquivos de Helps.
Execuo das funes compatibilizadoras.
20. Clique em Avanar.
O Atualizador identifica cada processo iniciado e a sua evoluo.
21. Se diagnosticado algum problema na base do cliente, este apresentado com opes para a
continuidade ou interrupo do processo.
Durante a verificao de integridade, se for diagnosticado algum critical error o processo ser
interrompido e o administrador ter a possibilidade de analisar o arquivo de log, ajustar o que for
necessrio reiniciar a atualizao.
22. Clique em Consulta Log para consultar o arquivo de log. Para mais detalhes sobre a janela de
consulta, consulte o item 23 mais adiante.
23. Ao final de cada processo, pode-se optar por interromper a Atualizao, caso tenha selecionado esta
opo no incio da configurao de execuo.
24. Se interrompida a Atualizao, possvel verificar o arquivo de log, clicando em Consulta Log.
A janela para consulta aos Logs ser exibida.
25. possvel escolher o tipo de evento a ser analisado, a empresa e a tarefa, por meio do Filtro.
26. Se desejar um relatrio impresso, clique em Imprimir.
27. Configure a impresso e confirme a emisso do relatrio.
Aps a interrupo da Atualizao, necessrio executar novamente o MP710TO110, porm sero
identificadas as operaes j realizadas e o processo ser continuado a partir da ltima tarefa
executada.
Guia de Instalao
31
guia_de_instalacao
Instalando o Servidor de Licenas
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 TOTVS envia um Hardlock, que pode ser HASPouProteq/SafeNet.
A seguir, so descritos os procedimentos de instalao de cada dispositivo.
Importante
Devido necessidade de alta disponibilidade do Servidor de Licenas, recomendamos que este seja
configurado em um servio separado, mesmo que seja na mesma mquina.
Hardlock
Para instalao fsica do Hardlock, basta conectar o dispositivo na porta correspondente.
Hasp
Caso o seu dispositivo de segurana seja Hasp, execute as instrues descritas a seguir para sua
instalao fsica e de seu driver.
32
Guia de Instalao
guia_de_instalacao
No Windows

(2000/2003/XP/2008):
Execute o programa hdd32.exe para instalar o driver. Este programa pode ser encontrado no CD.
de instalao (\windows\tools\hasp\install\) ou na url Portal do Cliente.
No tipo de instalao, selecione typical para a instalao padro.
No Linux

(kernel 2.4. ou acima):


Para instalao em ambiente Linux

, necessrio ter efetuado login como Administrador (root) e


executar os seguintes procedimentos:
1. Copie o arquivo haspdriver.tar.gz para um diretrio no servidor Linux

.
2. Descompacte o arquivo tar xzf haspdriver.tar.gz
3. Gere o device node: mknod /dev/Hardlock c 42 0
4. Dar acesso ao node.
Para todos: chmod 666 /dev/Hardlock
Apenas para um grupo (ex: Protheus8grp):chgrp Protheus8grp /dev/Hardlock e chmod
550 /dev/Hardlock
5. Iniciar o driver: modprobe parport_pc
6. Carregar o driver: insmod <diretrio_driver>/aksparlnx.o -f
O diretrio utilizado o correspondente verso do kernel. Se no encontrado, utilize o mais
prximo, abaixo do Kernel utilizado.
7. Se o acesso for pela porta USB, usbdefs deve ser montado: mount t usbdefs none
/proc/bus/usb
8. Carregar o daemon: ./haspdriver/sbin/aksusbd
9. Inclua os comandos 5 a 8 ao script de inicializao.
Demais ambientes Unix

:
Para os demais ambientes Unix

, deve-se entrar em contato com o Departamento de Tecnologia


TOTVS.
Como executar o Aplicador de Licenas
Aps a instalao fsica e do driver do dispositivo de segurana, necessrio executar o Aplicador de
Licenas para fixao das licenas que sero utilizadas. Entre em contato com a TOTVS para obter a
senha de liberao.
Executando o Aplicador de Licenas:
1. Aps a instalao do Protheus, no menu Iniciar do Windows

, acesse a pasta Protheus/


Ferramentas/ Aplicador de Licenas.
2. Escolha o idioma do aplicativo.
Guia de Instalao
33
guia_de_instalacao
3. Na janela Aplicador de Licenas, so solicitadas as informaes da senha de liberao de uso do
sistema.
4. Se aplicada com sucesso, a nova configurao ser utilizada na prxima vez em que o servidor for
iniciado.
34
Guia de Instalao
guia_de_instalacao
No Windows

No Windows

(Win 95/98/Me/NT/2000/2003/XP/2008):
Execute o programa SetupProteq.exe para instalar o driver (PROTEQ.VXD e PROTEQ.SYS) e
DLLs correspondentes.
Este programa pode ser encontrado no DVD instalao atualizado (
\windows\tools\compact-500\install\). No caso do Windows

NT/2000/2003/XP, necessrio
ter efetuado login como Administrador e o uso da ltima verso do Service Pack disponvel.
No Linux

Para kernel 2.4. ou acima:


No necessria a instalao de driver algum. Utilize apenas o dispositivo de interface paralela, pois
a USB Proteq ou Safenet no est disponvel para este Sistema Operacional.
Demais Ambientes Unix

Para os demais ambientes Unix

, deve-se entrar em contato com o Departamento de Tecnologia


TOTVS.
Como Executar o Aplicador de Licenas - TOTVSLIC.KEY
Aps realizar a instalao fsica do Hardlock, necessrio realizar a instalao do arquivo totvslic.key
de liberao de acesso ao produto e acesso a linha de produtos.
totvslic.key - Liberao de acesso aos produtos TOTVS.
Procedimento
1. Notifique os usurios que o Sistema ficar indisponvel.
2. Pare o servio do License Server.
3. Realize backup do arquivo totvslic.key instalado anteriormente.
4. Salve o arquivo totvslic.key no diretrio de instalao do License Server que contm o arquivo
Guia de Instalao
35
guia_de_instalacao
executvel do Application Server (appserver.exe).
5. Inicie o servio do License Server.
36
Guia de Instalao
guia_de_instalacao
Configurao do appserver.ini
O arquivo appserver.ini responsvel pela configurao do Application Server. A sua atualizao
realizada pelo Assistente de Configurao durante a instalao do Microsiga Protheus

ou pela execuo
deste aplicativo a partir da pasta Protheus 11/Ferramentas/Assistente de Configurao.
A seguir, so detalhadas todas as configuraes em que se encontram no arquivo appserver.ini.
Environment
As sees Environment contm as informaes dos diretrios de execuo do Application Server, as
informaes do idioma, interface, diretrios e repositrio e, opcionalmente, as informaes para acesso
ao DbAccess. Essas informaes so identificadas para cada conexo, ou seja, cada Smart Client que
se conectar ao Servidor deve informar qual a seo 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 Smart Client
conectar-se sem informar uma seo pelos parmetros de linha de comando.
Chave Descrio
SourcePath
Identifica o diretrio em que os repositrios de APOs so mantidos na mquina
em que o Application Server est instalado.
RootPath
Identifica o diretrio raiz do Microsiga Protheus

, a partir do qual todos os


diretrios utilizados pelo Microsiga Protheus

sero criados.
StartPath
Identifica o diretrio em que os arquivos de configurao do Microsiga Protheus

esto. o diretrio inicial de execuo do Sistema. Este diretrio criado a partir


do diretrio raiz, definido na chave anterior.
RpoDb
Identifica o tipo de base de dados utilizada. Pode ser DBF, ADS ou SQL

. Esta
informao utilizada pelo servidor para definir qual repositrio ser acessado.
RpoLanguage
Identifica a linguagem que ser utilizada. Pode ser Portuguese, English ou Spanish
. Essa informao tambm utilizada pelo servidor para definio do repositrio a
ser acessado.
RpoVersion Identifica a verso do Protheus.
AdsShare
Indica o diretrio compartilhado em que est instalado o servidor ADS. Este
diretrio utilizado para fazer a conexo ao servidor ADS.
Trace
Indica se deve ser feito o Log de warnings em arquivo. O arquivo de log
(Trace.log) ser criado no diretrio: protheus11\bin\appserver. Valores
possveis: 1 (faz log), 0 (no faz log).
FilesOnDemand
Indica se durante a abertura dos mdulos, o Sistema efetuar a abertura pelo
menu (padro) ou por necessidade (abre e fecha arquivos conforme utilizao).
Os valores possveis so: 1- Abre arquivos por demanda, 0 - Abre os
arquivos a partir do menu.
Guia de Instalao
37
guia_de_instalacao
LocalFiles
Indica qual a base de dados que ser utilizada para abertura dos arquivos
locais. Pode ser: ADS, ADSServer ou Ctree.
Localdbextension
Define qual ser a extenso default dos arquivos ISAM para os drivers DBFCDX,
DBFCDXAX.
So definidos como arquivos ISAM:
Quando verso DbAccess
Sindex
SXs (com exceo do SX5)
Arquivos de trabalho
Quando Verso ADS

Todos os arquivos ISAM, com exceo do SIGAMAT.EMP


Quando Verso CTree

Sindex
SXs (com exceo do SX5).
Arquivos de Trabalho
Valores vlidos
Default .dbf para ADS e .dtc para Ctree
WSplServer
Ex: WsplServer= MyServer, 1024, MyEnvironment
Define o Servidor, a porta e o ambiente, onde o agendador de relatrios e o
executaro suas tarefas de relatrios assncronos.
De definir DEFAULT- Nome do equipamento onde for feita a conexo.
HelpServer Define o endereo do servidor HTTP de help online.
JumpSenhap
Esta chave permite que o responsvel da rede altere a segurana imposta pelo
SenhaP, no caso de quebra ou perda do aparelho do Administrador do Sistema.

Caso o contedo seja 1, o Sistema apresenta uma advertncia sobre a abertura
da segurana e permite acesso ao Sistema.
Contedos possveis =0,1
Se definir DEFAULT = 0
PictFormat Esta chave permite a criao de environments com composio de data no
38
Guia de Instalao
guia_de_instalacao
formato ms, dia, ano , caso utilizar esta caracterstica basta informar
AMERICAN nesta chave.
Contedos Possveis =DEFAULT, AMERICAN DEFAULT=Default (Dia, Ms, Ano)
DbAccess
A seo DbAccess contm as informaes utilizadas para o acesso base de dados relacional por meio
do DbAccess.
As informaes desta seo so utilizadas para todas as conexes, a no ser que estejam definidas no
environment das conexes, como detalhado a seguir. (Exceo: driver e ProtheusOnly).
Chave Descrio
Database
Identifica o nome da Database que deve ser utilizado para acesso via DbAccess
base de dados (MSSQL, ORACLE, , DB2, SYBASE, INFORMIX e outros ).
Para verificar a homologao dos bancos e suas verses homologadas consulte a
pgina tdn.totvs.com (Inteligncia Protheus > Engenharias > Engenharias de
Banco > Bancos Homologados).
Server Identifica o nome ou o endereo IP do servidor.
Alias Identifica o alias utilizado no DbAccess para acesso base de dados.
Protheus
Only
Se esta chave tambm estiver ativada, a conexo a este somente poder ser
feita Microsiga Protheus

. Valores vlidos: 0 ou 1
Default=0 (desligado)
PORT
Porta de conexo
Default=7980
Opcionalmente, pode-se colocar estas 4 chaves no environment,
acrescentando-se DB no incio da chave.
Exemplo:
[environment]
DBDataBase=MSSQL7
DBServer=Pesquisa3
BALIAS=DBsql
DBPort=5082
Driver=totvsapi.dll
Define a verso Client do DbAccess utilizado.
Guia de Instalao
39
guia_de_instalacao
Drivers
A seo Drivers define quais protocolos de conexo podero ser utilizados para que os terminais
conectem-se ao Application Server.
Chave Descrio
Active
Identifica os nomes das sees de configurao de protocolos ativos. Mais de
uma seo pode ser informada separando-as por uma vrgula (,).
Deste modo, permitindo que existam conexes de terminais ao servidor
efetuadas atravs de diferentes protocolos.
Sees de Protocolos de Conexo
O Application Server pode utilizar o protocolo TCP-IP para realizar a conexo com os terminais. A
configurao do protocolo utilizado efetuada atravs de sees com as chaves definindo informaes
como a porta de conexo, o servio e o tipo da conexo.
As conexes ativas, ou seja, que podem ser utilizadas pelos terminais para conexo ao Servidor, so
aquelas cujos nomes de sees esto definidos na chave Active descrita anteriormente. Pode-se criar
diversas sees com as conexes utilizadas.
Chave Descrio
InactiveTimeout
Determina o tempo de espera at a queda da conexo, no caso de no haver
respostas.
Port Identifica a porta que ser utilizada para as comunicaes via TCP-IP.
Importante:
O Application Server utiliza TCP Stack (a mesma porta para todos os usurios).
Servernetwork
Esta seo utilizada no caso do uso de Balanceamento de Carga. Deve-se informar na chave a
seguir quais so os servidores disponveis na rede.
Chave Descrio
Servers Especificar os nomes das sees que contm as informaes dos servidores,
40
Guia de Instalao
guia_de_instalacao
separados por vrgula e na sequncia de busca desejada.
Dentro de cada nova seo de servidor, deve-se informar o nome, o tipo de
conexo (TCP), a porta ou servio e o nmero de conexes permitidas.
Exemplo:
[ServerNetwork]
Servers=SERVER1,SERVER2
Masterconnection=0 (Default ligado)
Informa que o master no ir aceitar conexes
[SERVER1]
TYPE=TCPIP
Server=Servidor1
Port=1024
Connections=60
[SERVER2]
TYPE=TCPIP
Server=Servidor2
Port=3024
Connections=40
HTTP
Esta seo permite ao Application Server atuar como Servidor Http (Protocolo Internet); ou seja, pode
fornecer pginas em Html para um browser.
Chave Descrio
Enable 1=Ligado e 0=Desligado
Path Local onde ser o diretrio raiz para as pginas.
Port Nmero da porta utilizada para a conexo http.
RPCTimeout Tempo limite para nova tentativa de conexo.
RPCEnv Nome do environment usado para a conexo.
RPCServer Nome da seo que indica a conexo do servidor para processamentos.
FTP
Esta seo permite ao Application Server atuar como Servidor FTP (Protocolo Internet).
Chave Descrio
Enable 1=Ligado e 0=Desligado.
Path Diretrio raiz para os arquivos de FTP.
Guia de Instalao
41
guia_de_instalacao
Port Define o nmero da porta de conexo FTP.

ONSTART
Nesta seo, determine a execuo de uma funo (sem interface) logo aps o incio de execuo do
Application Server.
Chave Descrio
Jobs
Informe o(s) nome(s) de seo(s) para executar funes.
Exemplo:
[ONSTART]
Jobs=JOB1,JOB2
[JOB1]
Main = RecalcJur()
Environment = Envsql
[JOB2]
Main = GetProdAtu()
Environment=Environment
License Server
A seo License Server contm as informaes sobre o Servidor de Licenas.
Chave Descrio
Enable
Indica se o Application Server ser um Servidor de Licenas.
Valores vlidos: 0 ou 1
Default= 0 (desligado)
Port
Identifica a porta que ser utilizada para a comunicao entre o Servidor de
Licenas e o Application Server
ShowStatus Esta chave permite o controle de requisies, liberaes de licena e semforos
pelas mensagens na tela de console.
Valores vlidos: 0 ou 1
Default = 1 -apresenta mensagens
42
Guia de Instalao
guia_de_instalacao
EnableNumbe
r
Identifica como ser controlada a numerao no Application Server.
Valores Vlidos:
0-faz a numerao pelos arquivos SXE e SXF
1-controle pelo License Server (default)
Exemplo:
[LicenseServer]
Enable=1
Port=5555
ShowStatus=1
License Client
A seo LicenseClient define as informaes que sero utilizadas para o Application Server se conectar
a um Servidor de Licenas.
Chave Descrio
Server o nome ou nmero IP do computador onde est o Servidor de Licenas.
Port
Identifica a porta que ser utilizada para a comunicao entre o Application
Server e o Servidor de Licenas. Portanto, deve ser o mesmo valor da chave
Port na seo License server do Servidor de Licenas.
Exemplo:
[LicenseClient]
Server=192.16.01.12
Port=5555
Importante
A porta de conexo entre o Application Server e o servidor de licenas no pode ser a mesma
utilizada entre o Application Server e o Smart Client.
General
A seo General contm as informaes globais sobre o Application Server, comuns a todos os
ambientes.
Chave Descrio
CtreeMode
Indica se o Ctree ser utilizado em modo Local ou Servidor. Uma vez
selecionado o modo pela chave todos os ambientes devero utiliz-lo da mesma
forma.
Guia de Instalao
43
guia_de_instalacao
Valores vlidos: SERVER, LOCAL e BOUNDSERVER
Default= LOCAL
Service
Utilize esta seo para informar o nome interno e externo do Servio do Application Server no Windows

.
Esta opo til quando for necessrio utilizar mais de um Application Server, rodando como servio
na mesma mquina, pois permite ao usurio informar nomes diferentes.
Chave Descrio
Name Nome interno do Servio.
Displayname Nome a ser exibido na janela de servios do Windows

.
A seguir, apresentado um exemplo do arquivo de configuraes do Application Server, em que se
pode visualizar dois environments diferentes: EnvDbfe e EnvSQL.
A diferena entre ambos que utilizam bases de dados e idiomas diferentes.
[?????? ] ?????????? =? :\???????? 10\??? \ ???????? =? :\???????? 10
????????? =\?????? ????? =??? ??????????? =??????????
?????????? =101
[?????? ] ?????????? =? :\???????? 10\??? \ ???????? =? :\???????? 10
????????? =\????????? ????? =??? ??????????? =???????
?????????? =101
[???????? ] ???????? =????? 7 ?????? =172.16.1.13 ????? =??????????
[??????? ] ?????? =???
[??? ] ???? =????? ???? =1024
cTree

Server
A seo CtreeServer contm as informaes sobre o Servidor Ctree.
[GENERAL]
CTREEMODE=SERVER
Chave Descrio
Ctuserid Nome do usurio com acesso ao Servidor.
44
Guia de Instalao
guia_de_instalacao
Ctreectuserpass Senha do usurio para acesso ao Servidor.
Ctreectservername Identificao do Servidor Ctree, no formato: NOME@MQUINA, em que
MQUINA pode ser o nome da mquina no Windows

ou o IP nas demais
plataformas.
Exemplo:
[CtreeServer]
ctuserid=ADMIN
ctuserpass=ADMIN
ctservername=FAIRCOMS@172.16.0.100
Guia de Instalao
45
guia_de_instalacao
Configurando o Smart Client
As configuraes do Smart Client tambm podem ser customizadas, de modo que se mantenham
diferentes conexes em um nico servidor.
Exemplo
Uma rede local com conexes via TCP-IP e algumas outras conexes remotas, via modem ou
Internet, utilizando TCP-IP.
Diferentes redes conectadas por linha privada. Cada uma destas redes mantm um Application
Server para o processamento distribudo.
Estas configuraes so mantidas no arquivo smartclient.ini, o qual se encontra no diretrio de
execuo do Smart Client.
Config
Identifica informaes gerais de configurao do Smart Client.
Chave Descrio
LastMainProg
Contm a lista dos ltimos programas iniciais executados no Smart Client. o
APO que inicia a execuo. Por exemplo, pode-se iniciar do SIGAADV, SIGAFIN,
SIGAEST etc.
Twotier
Informa se deve procurar o Application Server na mquina local, para ser
executado automaticamente.
Default =0; para ativar especificar 1.
Language Define o idioma utilizado para exibir as mensagens do Smart Client. Apenas as
mensagens originadas do Smart Client so afetadas. Para uma traduo geral,
deve-se ter o RPO no idioma requerido, em que:
1 =Portugus
2 =Espanhol
3 =Ingls.
Drivers
A seo Drivers define quais os protocolos podem ser utilizados para que o Terminal conecte-se ao
Application Server; igual seo de mesmo nome no arquivo de configuraes.
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.
46
Guia de Instalao
guia_de_instalacao
Sees de Protocolos de Conexo
As sees de configuraes de protocolos so definidas da mesma forma que no arquivo de
configuraes do Application Server.
No necessitam ter o mesmo nome que o definido no 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 Application Server podem ser utilizados quando estiver configurando oSmart Client.
Notas
Para a execuo local (Application Server e Smart Client executados na mesma mquina), pode-se
informar: Server=LocalHost.
Para execuo remota, o nome do servidor ou o endereo IP informado para o Smart Client deve ser
o mesmo configurado no Application Server, em que o terminal est conectado. Do mesmo modo, a
porta informada na chave Port deve ser a mesma configurada em ambos.
A seguir, apresentado um exemplo do arquivo de configuraes do Smart Client:
[??????????? ]
????????? =???????????
[?????? ]
???????????? =???????
[??????? ]
?????? =???
[??? ]
???? =?????
?????? = [???? ?? ?????????? ?? ?????? ?? ?? ?????????? ]
???? =1024
Para instalar o Application Server como servio, execute a seguinte linha de comando a partir do
diretrio do executvel do server:
c:\protheus11\bin\appserver\appserver.exe install
Guia de Instalao
47
guia_de_instalacao
Instalao do Servidor ADS

1. Com o DVD de instalao do ADS, inicie a instalao do Application Server no Sistema Operacional
correspondente, escolhendo a opo All Others Countries.
2. Quando solicitado, informe o Serial Number e Validation Code enviado pelo fornecedor.
3. A opo ANSI character, normalmente, est como <Default on Machine>, e dever ser alterada
para Engl(Amer).
4. Para OEM characterset, selecione USA.
Instalao do Servidor ADS

1. Com o DVD de instalao do ADS, inicie a instalao do Application Server no Sistema Operacional
correspondente; marque a opo All Others Countries.
2. Quando solicitado, informe o Serial Number e Validation Code enviado pelo fornecedor.
3. A opo ANSI character, normalmente, est como <Default on Machine> e dever ser alterada
para Engl(Amer).
4. Para OEM characterset, selecione USA.
Instalando o Servidor cTree

1. A instalao do servidor Ctree feita normalmente (padro). Seguir a documentao da FairCom.


2. Ativao do c-tree Server: aps a instalao do c-tree Server, trs diretrios so criados: client,
server, utils.
3. No diretrio server, h um programa chamado fcactvat que ativa o servidor.
4. Execute-o com a chave de ativao em mos.
5. Fornea os valores solicitados.
Notas
Alguns destes parmetros tm impacto na utilizao de memria da mquina.
48
Guia de Instalao
guia_de_instalacao
ACE (Advantage Client Engine)
O ACE uma biblioteca de acesso a tabelas ISAM (DBF) sem recursos de um servidor de Banco de
Dados. Por isso, deve ser utilizado apenas para manipulao dos dicionrios e em ambientes com
poucos usurios.
Configurao do Servidor cTree

A configurao realizada pelo arquivo ctsrvr.cfg, que deve ter apenas as seguintes chaves:
?????????????
????? _????????? ?????????????
????? _?????? ???? _????????
? _????? ??? _??????
1000000 ??? _??????
1000000 ?????
32000 ???? _????
8192
??? _??? _???
3 2
As chaves IDX_MEMORY e DAT_MEMORY esto relacionadas ao tamanho do cache de memria e
podem ser alteradas para melhorar o desempenho de acordo com a capacidade do hardware. Os
demais valores no podem ser alterados, pois os arquivos ficaro incompatveis!
Configurao do servidor Ctree quando o Application Server est em outra mquina:
1. Windows


Configure permisso de acesso full-control ao diretrio Root do Application Server aos usurios dos
servidores.
2. Linux

a) Compartilhamento do Root do Application Server:


Logue como Super Usurio na mquina do diretrio Root do Application Server.
Execute o linuxconf.
No RedHat, selecione Config/Networking/Server tasks/Exported file systems
(NFS)/Add.
No Conectiva:
Selecione Rede/NFS sistema de arquivos exportados/Adicionar.
Guia de Instalao
49
guia_de_instalacao
Escreva o path do Root do Microsiga Protheus

para exportar.
Escreva o IP ds mquina do Application Server no nome do cliente.
Selecione o direito de Escrita e de Root.
Repita este procedimento para todos os demais servidores.
Acesse /etc/rc.d/init.d
Reinicie o servio de NFS (execute ./nfs stop e ./nfs start).
Reinicie o servio de Nfslock (execute ./nfslock stop e ./nfslock start).
b) Mapeamento do Root do Application Server:
O diretrio de Root do Application Server deve ser mapeado com o mesmo nome em todos os
servidores Protheus, para isso execute mount IP: path mapeamento em todos servidores, em
que:
I P IP da mquina do diretrio Root.
Path diretrio Root do Application Server.
Mapeamento nome que o servidor ir acessar o Root.
Exemplo:
mount 172.16.0.0:/home/app/protheus11/protheus11
50
Guia de Instalao
guia_de_instalacao
Topologia de Utilizao de Rede do Application Server
Devido sua diviso em camadas, a tecnologia Microsiga Protheus permite montar o ambiente de
execuo com diferentes topologias, priorizando a execuo, o trfego de rede ou os recursos
individuais das mquinas existentes, o que torna o processamento distribudo. Essa uma das grandes
vantagens da tecnologia TOTVS.
Caractersticas e Possibilidades de Topologias de Rede
Pode-se manter um ou mais Application Servers.
Um Application Server pode estar na mesma mquina que o gerenciador de banco de dados.
Mquinas melhores ou com mais recursos podem ter um Application Server executando localmente.
Isto prioriza o processamento local, mas aumenta o trfego de rede entre o gerenciador de banco de
dados e o Application Server.
Do mesmo modo, podem-se executar servidores remotamente, priorizando o processamento.
As conexes devem ser efetuadas atravs do protocolo TCP-IP.
Podem-se criar conexes via Internet atravs da montagem de um Web Server na empresa ou
atravs de provedores de acesso. Neste caso, o Application Server pode ser executado no provedor
ou na empresa utilizando uma LP para a conexo ao provedor de acesso.
A Internet utilizada apenas como o meio de comunicao, ou seja, a conexo TCP-IP entre o Smart
Client e o Application Server. Alm da segurana oferecida pelo sistema TOTVS, a segurana deve
ser oferecida pela conexo. Por isso, aconselhvel que o servidor Web no seja o mesmo servidor
da base de dados.
Pode-se manter uma pgina para o download do Smart Client, de modo que os usurios remotos
possam efetuar o download para conectar-se e utilizar o Sistema.
Guia de Instalao
51
guia_de_instalacao
Importante
A definio da melhor topologia para execuo um passo importante da implementao da
Tecnologia TOTVS, pois influencia totalmente a performance.
O maior trfego de rede est localizado entre o Application Server e o Banco de Dados, j que o trfego
entre o Application Server e o Smart Client contm somente informaes para montagem de telas e
controle de teclado e mouse.
Desta forma, dependendo do tipo e da velocidade da conexo, pode se tornar invivel manter um
Application Server em uma cidade conectado ao banco de dados em outra. Por outro lado, caso existam
muitas conexes nesta outra cidade, ou caso estas conexes executem processamentos pesados,
priorizar o processamento disponibilizando um Application Server para ser executado localmente nesta
cidade pode ser uma boa soluo.
Instalao do Application Server em redes Netware Novell

Para a instalao do Application Server em redes Novell Netware

so necessrios alguns
procedimentos especficos:
A partir de uma estao qualquer, faa a instalao do Sistema em unidade de disco local.
52
Guia de Instalao
guia_de_instalacao
Na estao a partir da qual est sendo instalado o sistema, crie o mapeamento a ser utilizado pelo
Application Server (recomenda-se a criao de driver especfico para o sistema). Ex. I:
Na unidade rede, faa a cpia idntica da rvore de diretrios criada pela instalao no disco local.
No diretrio PROTHEUS11\BIN, edite o arquivo smartclient.ini e na seo TCP, coloque o
parmetro Server igual a Local Host.
[??? ] [??? ]
???? =?????
???? =?????????
??? =????????
?????? =?????????
???? =1024
???? =1024
Acrescente na seo [CONFIG] do arquivo smartclient.ini (localizado no diretrio
Protheus11\BIN), o parmetro TWOTIER=1.
No diretrio Protheus11\BIN, edite o arquivo appserver.ini e, na seo Environment, troque a
unidade de disco para direcionar o novo local. Exemplo:
[??????????? ]
?????????? =? :\???????? 11\???
???????? =? :\???????? 11
????????? =\??????
????? =???
??????????? =??????????
?????????? =110
???????? =? :\??? 56
?????????? =???
[??????????? ]
?????????? =? :\???????? 11\???
???????? =? :\???????? 11
????????? =\???????
????? =???
??????????? =??????????
?????????? =110
???????? =? :\??? 56
?????????? =???
Crie em todas as estaes que utilizaro o sistema um mapeamento idntico ao da estao que fez
a instalao e cpia (a letra para definir a unidade deve ser a mesma).
Crie nas estaes, cone de acesso para o smartclient.exe localizado no diretrio \BIN do Sistema.

Ex: I:\PROTHEUS11\BIN\smartclient.exe; Ateno ao executar este passo, pois erros implicaro em
problemas no registro do Windows

.
Importante
Guia de Instalao
53
guia_de_instalacao
O uso do Application Server em redes Novell

com a topologia acima exige uma modalidade Fat


Client; ou seja, cada estao efetua seu processamento e o trfego de dados na rede cresce
consideravelmente quando comparado s instalaes convencionais em redes Windows

/TCP-IP.
Observaes
Instalao do ADS e configurao:
1. Nmero mximo de usurios, tabelas, locks, etc. O Microsiga Protheus

faz duas conexes no ADS


por usurio e por isso, o nmero de conexes deve ser o dobro do nmero de usurios.
2. Configurao do appserver.ini.
Os dados devem estar na mquina em que o ADS foi instalado e, por isso, o RootPath ser um
endereo na rede.
Ex: RootPath=\\servidor_ads\PROTHEUS11\LocalFiles deve ser ADSSERVERADSSHARE: diretrio no
servidor ADS compartilhado full para o usurio do Application Server. Este diretrio apenas
utilizado para a conexo do Microsiga Protheus

com o Servidor ADS.


Sugerimos que se crie um diretrio vazio na raiz do Servidor ADS e o compartilhe. Ex: ADSShare
=\\servidor_ads\adsshare
3. Se o Application Server estiver rodando como servio, acrescente uma senha de administrador ao
servio.