View
28
Download
0
Category
Preview:
Citation preview
Notas de Release
guia_de_instalacao
Todos os direitos reservados. Partes deste trabalho no podem ser reproduzidas, de forma alguma ou por meioalgum - grfico, eletrnico ou mecnico, incluindo fotocpias, gravaes, digitaes ou armazenamento deinformaes e sistemas de restaurao - sem a permisso escrita do editor.
Os produtos referidos neste documento podem ser marcas registradas ou apenas marcas de seus respectivosproprietrios. 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 seresponsabilizam por eventuais erros ou omisses, ou por danos resultantes do uso das informaes contidas nestedocumento ou do uso dos programas ou cdigos-fonte que possam acompanh-lo. Em nenhum caso o editor e oautor 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, 171702511-000 - So Paulo - SP
(11) 2099 7100 Grande So Paulo55 (11) 2099-7260
totvs.com.
3Contedo
guia_de_instalacao
3
Sumrio
Guia de Instalao .............................................................................................................. 7Pr-Requisitos
......................................................................................................................... 7Hardware Mnimo Recomendvel
......................................................................................................................... 9DEP
.............................................................................................................. 10Instalando o Application Server ......................................................................................................................... 10No Linux
......................................................................................................................... 11No Windows
......................................................................................................................... 11Contrato de Licena
......................................................................................................................... 11Diretrio de Instalao do Application Server
......................................................................................................................... 12Instalao de DLLs
......................................................................................................................... 12Verificao das Configuraes de Instalao
......................................................................................................................... 12Processo de Instalao
......................................................................................................................... 12License Server
.............................................................................................................. 14Assistente de Configurao do Application Server
.............................................................................................................. 15Instalando o Help ......................................................................................................................... 15No Linux
......................................................................................................................... 15No Windows
......................................................................................................................... 16Contrato de Licena
......................................................................................................................... 16Diretrio de Instalao dos Arquivos de help
.............................................................................................................. 17Localizao do Application Server ......................................................................................................................... 17Processo de Instalao
.............................................................................................................. 18Instalando o Smart Client ......................................................................................................................... 18No Linux
......................................................................................................................... 18No Windows
......................................................................................................................... 18No MAC OS
......................................................................................................................... 20Contrato de Licena
......................................................................................................................... 20Diretrio de Instalao
......................................................................................................................... 20Pasta de Instalao
......................................................................................................................... 20Instalao de DLLs
......................................................................................................................... 20Verificao das Configuraes de Instalao
......................................................................................................................... 21Processo de Instalao
......................................................................................................................... 21Chave de Inicializao
guia_de_instalacao
4 Contedo
......................................................................................................................... 21Chave de Emergncia
.............................................................................................................. 23Protheus Search ......................................................................................................................... 23No Linux
......................................................................................................................... 23No Windows
......................................................................................................................... 23Contrato de Licena
......................................................................................................................... 24Diretrio de Instalao
......................................................................................................................... 24Verificao das Configuraes de Instalao
......................................................................................................................... 24Processo de Instalao
.............................................................................................................. 25TOTVS Office Interface Integration com Microsoft Office 2007 ......................................................................................................................... 25Diretrio de Instalao
......................................................................................................................... 26Confirmao da Instalao
......................................................................................................................... 26Processo de Instalao
......................................................................................................................... 26Concluso da Instalao
.............................................................................................................. 27Atualizao do Sistema
.............................................................................................................. 28Executando o MP710TO110
.............................................................................................................. 31Instalando o Servidor de Licenas ......................................................................................................................... 31Instalao Fsica do Hardlock
........................................................................................................................ 31Hardlock (usb)
........................................................................................................................ 31Hasp
.............................................................................................................. 34Instalao do Driver do Proteq/Safenet (Compact-500) ......................................................................................................................... 34No Windows
......................................................................................................................... 34No Linux
......................................................................................................................... 34Demais Ambientes Unix
......................................................................................................................... 34Executando o Aplicador de Licenas TOTVSLIC.KEY
........................................................................................................................ 34Como Executar o Aplicador de Licenas TOTVSLIC.KEY
.............................................................................................................. 36Configurao do appserver.ini ......................................................................................................................... 36Sees
........................................................................................................................ 36Environment
........................................................................................................................ 38DbAccess
........................................................................................................................ 39Drivers
......................................................................................................................... 39Sees de Protocolos de Conexo
........................................................................................................................ 39Servernetwork
........................................................................................................................ 40HTTP
........................................................................................................................ 40FTP
........................................................................................................................ 41ONSTART
........................................................................................................................ 41License Server
5Contedo
guia_de_instalacao
5
........................................................................................................................ 42License Client
........................................................................................................................ 42General
........................................................................................................................ 43Service
........................................................................................................................ 43cTree Server
.............................................................................................................. 45Configurando o Smart Client ......................................................................................................................... 45Config
......................................................................................................................... 45Drivers
.............................................................................................................. 46Sees de Protocolos de Conexo
.............................................................................................................. 47Application Server ......................................................................................................................... 47Servidor ADS
........................................................................................................................ 47Instalao do Servidor ADS
........................................................................................................................ 47Configurao do Servidor ADS
......................................................................................................................... 47Servidor cTree
........................................................................................................................ 47Instalando o Servidor cTree
........................................................................................................................ 48Configurao do Servidor cTree
.............................................................................................................. 50Topologia de Utilizao de Rede do Application Server ......................................................................................................................... 51Instalao do Application Server em redes Netware Novell
Pr-Requisitos
1
Guia de Instalao 7
guia_de_instalacao
Hardware Mnimo Recomendvel
Banco deDados
10 Usurios
15Usurios
20Usurios
30Usurios
50Usurios
Banco dedados e
aplicativoClassic eExpress
Banco dedados e
aplicativoClassic eExpress
Banco dedados e
aplicativoClassic eExpress
Banco dedados e
aplicativoClassic eExpress
Banco dedados(***)
Classic eExpress
AplicativoClassic eExpress
OracleWindows,
OracleLINUX,MSSqlServer,InformixWindows,InformixLINUX,Sybase
AdaptiveServer,
DB2Windows,DB2 Linux,
(*)
Xeon 2.01X
Dual CoreL2 4,0 MB
2,0 GBRAM
Ultra 4SCSI
Xeon 2.61X
Dual CoreL2 4,0 MB
2,0 GBRAM
Ultra 4SCSI
Xeon 2.81X
Dual CoreL2 4,0 MB
3,0 GBRAM
Ultra 4SCSI
Controladora comcache ebateriabackup.
Xeon 3.02X
Dual CoreL2 4,0 MB
4,0 GBRAM
HD SAS15K
Controladora comcache ebateriabackup
Xeon 3.02X
Dual CoreL2 4,0 MB
4,0 GBRAM
HD SAS15K
Controladora comcache ebateriabackup.
Pentium D,3,0 Ghz L2
4,0 MB
3,0 GBRAM
Ultra 4SCSI
AS/400(**)
Pentium D,3,0 Ghz L2
4,0 MB
2,0 GBRAM
Ultra 4SCSI
(Aplicativoe File
Server)
Pentium D,3,0 Ghz L2
4,0 MB
2,0 GBRAM
Ultra 4SCSI
(Aplicativoe File
Server)
Pentium D,3,0 Ghz L2
4,0 MB
2,0 GBRAM
Ultra 4SCSI
(Aplicativoe File
Server)
Pentium D,3,0 Ghz L2
4,0 MB
2,0 GBRAM
Ultra 4SCSI
(Aplicativoe File
Server)
PentiumD,
3,0 GhzL2
4,0 MB
3,0 GBRAM
Ultra 4SCSI
(Aplicativo e File
Server)
Postgreev7.11 ou
acima
Windows eLinux
Pentium D,3,0 Ghz L2
4,0 MB
2,0 GBRAM
Ultra 4SCSI
Norecomend.
Norecomend.
Norecomend.
Norecomend.
Norecomend.
(*) 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 ProcessingWorkload 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 doApplication Server e dos SGBDs (Sistema Gerenciador de Banco de Dados) homologados. Noentanto, diante da utilizao de outros aplicativos, as necessidades devero ser melhordimensionadas.
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 quandoestiver 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 MicrosigaProtheus, 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 conoscopelo 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 paraoperao 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 commais de 5 usurios.
O tempo de resposta, do site remoto, deve ser inferior a 120 ms (tempo de resposta do comandoPing) em pacotes de 32 KB.
Utilize o WTS (Windows Terminal Server) com meta frame, caso o trecho seja realizado por meio deatlite 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 paraOracle, 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 MicrosigaProtheus, 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, entreem contato conosco pelo endereo www.totvs.com/customercenter para obter especificaes.
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 paraajudar 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 edesabilit-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 serapresentado 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 doMicrosiga Protheus. Em seguida, o kernel das verses anteriores do Microsiga Protheus continuar aexistir, 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 deconfiguraes (dicionrio de dados, parmetros, tabelas, CNAB, SISPAG, etc.), menus e programasespecficos dos usurios.
imprescindvel providenciar a atualizao dos menus nesse processo para evitar perdas defuncionalidades no Microsiga Protheus.
Aps a instalao, atualize os atalhos de acesso ao Application Server e Smart Client para o novocaminho 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 Protheusdevem 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 ostipos de banco de dados disponveis para esta aplicao), ADS (Advantage Database Server) paraNT ou Novell NetWare, ISAM padro DBF ou Ctree.
Neste momento, pode-se optar por apenas uma base de dados, porm pelas alteraes no arquivode configurao do Application Server e cpia do repositrio correto, possvel fazer com que amesma 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.TXT. Este arquivo gravado no diretrio\Protheus_Data\SYSTEMLOAD, sendo responsvel pela criao dos dicionrio de dados e demaisarquivos 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 doApplication Server em Linux.
No Windows
Na parte inferior da tela, so apresentados os idiomas disponveis para apresentao do instalador doMicrosiga 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 etreinamento seja facilitado.
Evite o uso de unidades lgicas (drivers de rede), para tanto utilize sempre o computador quefaz o papel de servidor para efetuar a instalao. Com isso, diminui-se o risco de erro semeventuais 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 deconexo. Se o equipamento onde o Application Server est sendo instalado tambm for o Servidor deLicenas, 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 ocontrole 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-500USB e paralelo), dotado de um cdigo identificador nico e da utilizao de uma chave de liberao delicenas 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 emconformidade 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 produtosTOTVS, somente deve haver um nico License Server, este servio tambm utilizado internamentepor 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 denumerao automtica.
Dada a criticidade de ambiente, o License Server foi projetado para permitir uma configurao de altadisponibilidade 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 usoe, em ambientes/arquiteturas, onde existem restries ou segmentaes, possvel instalar/configurarum ou mais License Server adicionais para cada um destes sites. Para tais casos, inclusive para aconfigurao de redundncia no servio de licenciamento, deve-se verificar a documentao do ERP quetrata de forma mais detalhada este tpico, inclusive as indicaes, impactos e eventuais restries deuso do License Server.
No projeto de arquitetura do License Server, foram previstos qualquer tipo de ocorrncia de hardwareque pudesse interromper o seu uso, para esses casos, a TOTVS fornece uma senha de emergncia quepode ser obtida em nosso canal de atendimento (CST - Centro de Servios TOTVS). Tal senha permiteque o ERP opere sem a necessidade do License Server at o problema ser solucionado. Por ter umaarquitetura simples, o License Server no necessita de nenhum outro componente, alm dos fornecidospela TOTVS, simplificando o processo de restaurao no qual um simples restore do diretrio deinstalao 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 suacorreta execuo. Porm, pode-se configur-lo pela manuteno do arquivo de configuraes(appserver.ini). As configuraes so mantidas em diferentes sees de Environments, conforme aestrutura do arquivo de configuraes.
No Windows, possvel configurar o arquivo appserver.ini, utilizando este Assistente deConfigurao 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. OAssistente de Configurao pode ser acessado aps a instalao pelo menu Iniciar, pastaProtheus 11/Ferramentas/Assistente de Configurao.
2. Se desejar executar o assistente de configurao, clique em Sim. Consulte ao final deste guia asinformaes 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 ocontedo 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 configuradocorretamente 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 utilizaroutro servidor de Help, pode-se copiar os arquivos instalados para outro servidor e alterar o arquivoappserver.ini, indicando a sua nova localizao pela configurao da chave PATH da seo HTTP e dachave 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 inicialde instalao do Microsiga Protheus.
Este recurso til para instalao do Smart Client em computadores que no esto conectados redelocal, ou seja, que necessitam que os executveis estejam fisicamente na mquina. Por exemplo, emcasos 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 emcasos especficos (utilizao remota, alto trfego de dados na rede, etc.).Preferencialmente, indicadoo 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, soapresentadas 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 umaplicativo nativo.
Os aplicativos nativos para MAC OS encapsulam todo seu contedo em um nico arquivo, para oMicrosiga 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 selecioneMostrar Contedo do Pacote.
2. exibida a pasta Contents, selecione a sub pasta MacOs e, em seguida, clique no arquivosmartclient.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 etreinamento seja facilitado.
Evite o uso de unidades lgicas (drivers de rede). Para tanto, utilize sempre o computador que faz opapel de servidor para efetuar a instalao. Com isso, diminui-se o risco de erros em eventuaisdesinstalaes 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 dosarquivos.
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 (Cessode Direito e Uso), necessrio informar a Chave de Inicializao contida no documento emitido, nasInformaes Corporativas no Cadastro de Empresas.
Procedimentos para Utilizao
1. No Configurador em Criao de Empresa, crie todas as empresas/filiais necessrias para a suaoperao.
2. Certifique-se de que as empresas foram gravadas.
3. De posse de seu documento fiscal de CDU, observe a Chave de Inicializao contida nasmensagens 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 aempresa 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, desegunda 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 dedados, as expresses desejadas.
O Protheus Search uma especializao do Application Server otimizado para indexao e busca. Porisso, esse servio no pode ser utilizado para receber conexes do Smart Client, processamentos embatch, workflow ou servios Web.
O Protheus Search pode ser instalado em um servidor dedicado ou compartilhar o mesmo hardware queo 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 etreinamento seja facilitado.
Evite o uso de unidades lgicas (drivers de rede), para tanto utilize sempre o computador que faz opapel de servidor para efetuar a instalao. Com isso, diminui-se o risco de erro sem eventuaisdesinstalaes 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 dosarquivos.
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 doAssistente 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 aosaplicativos da sute Microsoft Office 2007 (Word e Excel).
O TOTVS Office Interface Integration deve ser instalado na estao de trabalho, conforme osprocedimentos 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 TOTVSOffice Interface Integration quando necessrio.
Para mais informaes sobre os requisitos de hardware e sistemas operacionais suportados peloMicrosoft 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 MicrosigaProtheus, executar o programa MP710TO110, antes de qualquer processamento, para que os arquivosda empresa sejam compatibilizados com os da nova verso enviada pela TOTVS. Leia atentamente asNotas do Release que acompanham as novas verses para conhecer as alteraes que seroefetuadas pelo programa de compatibilizao e os novos recursos.
Este programa, sempre que possvel, dar prioridade s configuraes do cliente, a qual apenas sermodificada, 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 modificaesfeitas nos arquivos padres.
Acerta as tabelas de dados, incluindo, excluindo ou alterando a estrutura dos campos. O Sistemano exclui campos includos pelo usurio em sua base de dados, desde que todas as alteraestenham 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), ouantigo (\DADOSADV), dos arquivos customizadores SXs (\PROTHEUS_DATA\SYSTEM) ouantigo (\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. Casoesteja utilizando uma verso anterior, devem-se migrar as verses progressivamente, utilizando osatualizadores respectivos, at obter a verso 7.10, para que ento o MP710TO110 possa serexecutado.
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) ouSYSTEM e DATA (a partir da verso 8.11).
Ter espao em disco de aproximadamente 3 vezes o espao utilizado pelos diretrios SIGAADV eDADOSADV (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 realizadaa atualizao. Tal informao muito importante, para que o ambiente seja preparadocorretamente:
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 processode atualizao.
Importante:
A partir da verso 8.11, se a integridade referencial estiver ativa, o atualizador de verso irdesativ-la antes de iniciar o processo de atualizao de verso.
Desta forma, ao final desse processo, ser necessrio executar a rotina que ativa a integridadereferencial, por meio do mdulo Configurador, opo Base de Dados/Integridade.
Se for necessrio apenas simular a atualizao para verificar as alteraes a serem processadase eventuais problemas na base de dados, clique na caixa de verificao Simulao. Com estaopo ativada, no ser gravada nenhuma alterao na base. O Sistema gera um arquivo de logque 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 arquivoatual compartilhado entre as empresas.
11.Clique em Avanar.
apresentada a janela para informao do diretrio padro, em que sero criadas as novas tabelasde dados referentes s empresas identificadas e relacionadas.
12.D duplo clique sobre o diretrio e digite outro caminho, se necessrio. A localizao informada serconsiderada 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 deatualizao 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 doAssistente do Atualizador. Somente sero indicados neste arquivo. Os logs so gravados nosarquivos MPUPDATE.LOG.
15.Marque a caixa Permite interromper processo durante a execuo para que ao final de cadaprocesso, a Atualizao possa ser interrompida. O processo ser reiniciado a partir da ltima tarefaexecutada. Se esta caixa no for selecionada, no ser possvel paralisar a Atualizao em nenhummomento.
Importante
Se desejar saber de todas as alteraes processadas, pode marcar todas as opes de Logs etambm a caixa Permite interromper processo durante a execuo.
Neste caso, deve-se interromper ao final de cada processo, analisar os logs e executar aAtualizao 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 deanlise de integridade, o Atualizador corrija automaticamente alguns erros crticos.
17.Selecione a caixa Eliminar arquivos de backup ao trmino da atualizao para excluirautomaticamente 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 deatualizao 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 acontinuidade ou interrupo do processo.
Durante a verificao de integridade, se for diagnosticado algum critical error o processo serinterrompido e o administrador ter a possibilidade de analisar o arquivo de log, ajustar o que fornecessrio reiniciar a atualizao.
22.Clique em Consulta Log para consultar o arquivo de log. Para mais detalhes sobre a janela deconsulta, consulte o item 23 mais adiante.
23.Ao final de cada processo, pode-se optar por interromper a Atualizao, caso tenha selecionado estaopo 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 seroidentificadas as operaes j realizadas e o processo ser continuado a partir da ltima tarefaexecutada.
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 ouUSB 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 sejaconfigurado 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 suainstalao 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) eexecutar 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 chmod550 /dev/Hardlock
5. Iniciar o driver: modprobe parport_pc
6. Carregar o driver: insmod /aksparlnx.o -f
O diretrio utilizado o correspondente verso do kernel. Se no encontrado, utilize o maisprximo, 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 TecnologiaTOTVS.
Como executar o Aplicador de Licenas
Aps a instalao fsica e do driver do dispositivo de segurana, necessrio executar o Aplicador deLicenas para fixao das licenas que sero utilizadas. Entre em contato com a TOTVS para obter asenha 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 dosistema.
4. Se aplicada com sucesso, a nova configurao ser utilizada na prxima vez em que o servidor foriniciado.
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) eDLLs correspondentes.
Este programa pode ser encontrado no DVD instalao atualizado (\windows\tools\compact-500\install\). No caso do Windows NT/2000/2003/XP, necessrioter 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, poisa 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 TecnologiaTOTVS.
Como Executar o Aplicador de Licenas - TOTVSLIC.KEY
Aps realizar a instalao fsica do Hardlock, necessrio realizar a instalao do arquivo totvslic.keyde 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 execuodeste 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, asinformaes do idioma, interface, diretrios e repositrio e, opcionalmente, as informaes para acessoao DbAccess. Essas informaes so identificadas para cada conexo, ou seja, cada Smart Client quese 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 dasinformaes da seo definida.
Uma seo padro chamada Environment criada na instalao e utilizada sempre que o Smart Clientconectar-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 mquinaem 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.
StartPathIdentifica o diretrio em que os arquivos de configurao do Microsiga Protheusesto. o diretrio inicial de execuo do Sistema. Este diretrio criado a partirdo 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.
RpoLanguageIdentifica a linguagem que ser utilizada. Pode ser Portuguese, English ou Spanish. Essa informao tambm utilizada pelo servidor para definio do repositrio aser acessado.
RpoVersion Identifica a verso do Protheus.
AdsShare Indica o diretrio compartilhado em que est instalado o servidor ADS. Estediretrio utilizado para fazer a conexo ao servidor ADS.
TraceIndica se deve ser feito o Log de warnings em arquivo. O arquivo de log(Trace.log) ser criado no diretrio: protheus11\bin\appserver. Valorespossveis: 1 (faz log), 0 (no faz log).
FilesOnDemand
Indica se durante a abertura dos mdulos, o Sistema efetuar a abertura pelomenu (padro) ou por necessidade (abre e fecha arquivos conforme utilizao).Os valores possveis so: 1- Abre arquivos por demanda, 0 - Abre osarquivos a partir do menu.
Guia de Instalao 37
guia_de_instalacao
LocalFiles Indica qual a base de dados que ser utilizada para abertura dos arquivoslocais. 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 peloSenhaP, no caso de quebra ou perda do aparelho do Administrador do Sistema.
Caso o contedo seja 1, o Sistema apresenta uma advertncia sobre a aberturada 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 informarAMERICAN 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 meiodo DbAccess.
As informaes desta seo so utilizadas para todas as conexes, a no ser que estejam definidas noenvironment 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 apgina tdn.totvs.com (Inteligncia Protheus > Engenharias > Engenharias deBanco > Bancos Homologados).
Server Identifica o nome ou o endereo IP do servidor.
Alias Identifica o alias utilizado no DbAccess para acesso base de dados.
ProtheusOnly
Se esta chave tambm estiver ativada, a conexo a este somente poder serfeita 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 terminaisconectem-se ao Application Server.
Chave Descrio
Active
Identifica os nomes das sees de configurao de protocolos ativos. Mais deuma seo pode ser informada separando-as por uma vrgula (,).
Deste modo, permitindo que existam conexes de terminais ao servidorefetuadas 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. Aconfigurao do protocolo utilizado efetuada atravs de sees com as chaves definindo informaescomo 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, soaquelas cujos nomes de sees esto definidos na chave Active descrita anteriormente. Pode-se criardiversas sees com as conexes utilizadas.
Chave Descrio
InactiveTimeout Determina o tempo de espera at a queda da conexo, no caso de no haverrespostas.
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 aseguir 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 deconexo (TCP), a porta ou servio e o nmero de conexes permitidas.
Exemplo:
[ServerNetwork]Servers=SERVER1,SERVER2Masterconnection=0 (Default ligado)Informa que o master no ir aceitar conexes[SERVER1]TYPE=TCPIPServer=Servidor1Port=1024Connections=60[SERVER2]TYPE=TCPIPServer=Servidor2Port=3024Connections=40
HTTP
Esta seo permite ao Application Server atuar como Servidor Http (Protocolo Internet); ou seja, podefornecer 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 doApplication 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 deLicenas e o Application Server
ShowStatus Esta chave permite o controle de requisies, liberaes de licena e semforospelas mensagens na tela de console.
Valores vlidos: 0 ou 1
Default = 1 -apresenta mensagens
42 Guia de Instalao
guia_de_instalacao
EnableNumber
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 conectara 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 ApplicationServer e o Servidor de Licenas. Portanto, deve ser o mesmo valor da chavePort na seo License server do Servidor de Licenas.
Exemplo:
[LicenseClient]Server=192.16.01.12Port=5555
Importante
A porta de conexo entre o Application Server e o servidor de licenas no pode ser a mesmautilizada entre o Application Server e o Smart Client.
General
A seo General contm as informaes globais sobre o Application Server, comuns a todos osambientes.
Chave Descrio
CtreeModeIndica se o Ctree ser utilizado em modo Local ou Servidor. Uma vezselecionado o modo pela chave todos os ambientes devero utiliz-lo da mesmaforma.
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 serviona 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 sepode 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 queMQUINA pode ser o nome da mquina no Windows ou o IP nas demaisplataformas.
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 mantenhamdiferentes conexes em um nico servidor.
Exemplo
Uma rede local com conexes via TCP-IP e algumas outras conexes remotas, via modem ouInternet, utilizando TCP-IP.
Diferentes redes conectadas por linha privada. Cada uma destas redes mantm um ApplicationServer para o processamento distribudo.
Estas configuraes so mantidas no arquivo smartclient.ini, o qual se encontra no diretrio deexecuo do Smart Client.
Config
Identifica informaes gerais de configurao do Smart Client.
Chave Descrio
LastMainProgContm a lista dos ltimos programas iniciais executados no Smart Client. oAPO que inicia a execuo. Por exemplo, pode-se iniciar do SIGAADV, SIGAFIN,SIGAEST etc.
TwotierInforma se deve procurar o Application Server na mquina local, para serexecutado automaticamente.
Default =0; para ativar especificar 1.
Language Define o idioma utilizado para exibir as mensagens do Smart Client. Apenas asmensagens 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 aoApplication Server; igual seo de mesmo nome no arquivo de configuraes.
A diferena que as sees, aqui informadas (que devem ser separadas por vrgulas), so utilizadasem 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 deconfiguraes do Application Server.
No necessitam ter o mesmo nome que o definido no Application Server, porm as informaes devemser as mesmas e somente os protocolos definidos na chave Active da seo Drivers do arquivo deconfigurao 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-seinformar: Server=LocalHost.
Para execuo remota, o nome do servidor ou o endereo IP informado para o Smart Client deve sero mesmo configurado no Application Server, em que o terminal est conectado. Do mesmo modo, aporta 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 dodiretrio 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 Operacionalcorrespondente, 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 , e dever ser alteradapara 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 Operacionalcorrespondente; 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 e dever ser alteradapara 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 deDados. Por isso, deve ser utilizado apenas para manipulao dos dicionrios e em ambientes compoucos 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 epodem ser alteradas para melhorar o desempenho de acordo com a capacidade do hardware. Osdemais 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 dosservidores.
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 osservidores Protheus, para isso execute mount IP: path mapeamento em todos servidores, emque:
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 deexecuo com diferentes topologias, priorizando a execuo, o trfego de rede ou os recursosindividuais das mquinas existentes, o que torna o processamento distribudo. Essa uma das grandesvantagens 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 dedados 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 ouatravs de provedores de acesso. Neste caso, o Application Server pode ser executado no provedorou 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 SmartClient e o Application Server. Alm da segurana oferecida pelo sistema TOTVS, a segurana deveser oferecida pela conexo. Por isso, aconselhvel que o servidor Web no seja o mesmo servidorda base de dados.
Pode-se manter uma pgina para o download do Smart Client, de modo que os usurios remotospossam 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 daTecnologia 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 trfegoentre o Application Server e o Smart Client contm somente informaes para montagem de telas econtrole de teclado e mouse.
Desta forma, dependendo do tipo e da velocidade da conexo, pode se tornar invivel manter umApplication Server em uma cidade conectado ao banco de dados em outra. Por outro lado, caso existammuitas conexes nesta outra cidade, ou caso estas conexes executem processamentos pesados,priorizar o processamento disponibilizando um Application Server para ser executado localmente nestacidade 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 algunsprocedimentos 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 peloApplication 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 oparmetro Server igual a Local Host.
[??? ] [??? ]
???? =?????
???? =?????????
??? =????????
?????? =?????????
???? =1024
???? =1024
Acrescente na seo [CONFIG] do arquivo smartclient.ini (localizado no diretrioProtheus11\BIN), o parmetro TWOTIER=1.
No diretrio Protheus11\BIN, edite o arquivo appserver.ini e, na seo Environment, troque aunidade 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 feza 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 emproblemas 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 FatClient; ou seja, cada estao efetua seu processamento e o trfego de dados na rede cresceconsideravelmente 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 ADSpor 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 umendereo na rede.
Ex: RootPath=\\servidor_ads\PROTHEUS11\LocalFiles deve ser ADSSERVERADSSHARE: diretrio noservidor ADS compartilhado full para o usurio do Application Server. Este diretrio apenasutilizado 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 aoservio.
Guia de InstalaoPr-RequisitosHardware Mnimo RecomendvelDEP
Instalando o Application ServerNo LinuxNo WindowsContrato de LicenaDiretrio de Instalao do Application ServerInstalao de DLLsVerificao das Configuraes de InstalaoProcesso de InstalaoLicense Server
Assistente de Configurao do Application ServerInstalando o HelpNo LinuxNo WindowsContrato de LicenaDiretrio de Instalao dos Arquivos de help
Localizao do Application ServerProcesso de Instalao
Instalando o Smart ClientNo LinuxNo WindowsNo MAC OSContrato de LicenaDiretrio de InstalaoPasta de InstalaoInstalao de DLLsVerificao das Configuraes de InstalaoProcesso de InstalaoChave de InicializaoChave de Emergncia
Protheus SearchNo LinuxNo WindowsContrato de LicenaDiretrio de InstalaoVerificao das Configuraes de InstalaoProcesso de Instalao
TOTVS Office Interface Integration com Microsoft Office 2007Diretrio de InstalaoConfirmao da InstalaoProcesso de InstalaoConcluso da Instalao
Atualizao do SistemaExecutando o MP710TO110Instalando o Servidor de LicenasInstalao Fsica do HardlockHardlock (usb)Hasp
Instalao do Driver do Proteq/Safenet (Compact-500)No WindowsNo Linux Demais Ambientes UnixExecutando o Aplicador de Licenas TOTVSLIC.KEYComo Executar o Aplicador de Licenas TOTVSLIC.KEY
Configurao do appserver.iniSeesEnvironmentDbAccessDrivers
Sees de Protocolos de ConexoServernetworkHTTPFTPONSTARTLicense ServerLicense ClientGeneralServicecTree Server
Configurando o Smart ClientConfigDrivers
Sees de Protocolos de ConexoApplication ServerServidor ADSInstalao do Servidor ADSConfigurao do Servidor ADS
Servidor cTreeInstalando o Servidor cTreeConfigurao do Servidor cTree
Topologia de Utilizao de Rede do Application ServerInstalao do Application Server em redes Netware Novell
Recommended