Instalao do AP7

Servidor de Licenas
Na verso 7.10, disponibilizamos o Hardlock, um hardware de proteo que tem por objetivo a segurana de suas informaes e possibilita maior agilidade para liberao de senhas e grande ganho de performance nos processos de controle aos acessos simultneos. Esse mecanismo de proteo de mensagens eletrnicas, baseado em algoritmos de criptografia com chaves de 128 bits, garante a proteo do sistema contra acessos indevidos. Para utilizao do sistema, necessrio que um dos servidores AP7 seja o servidor de licenas.

Instalando o AP7 Server

O primeiro passo para instalao do AP7 a instalao do AP7 Server. Esta instalao, como tambm do AP7 Remote e das ferramentas auxiliares (o AP7 IDE, AP7Dump e o AP7 Monitor) efetuada atravs do programa de instalao. O AutoRun executado automaticamente se o Windows estiver configurado com este recurso. Porm, possvel
execut-lo atravs do comando: X:\AUTORUN.EXE onde: X e a unidade de CD-ROM

Execuo dos seguintes programas a partir da unidade de CD-ROM: Windows: AP7 Server: WINDOWS\AP7SERVER\SETUP.EXE AP7 Remote:WINDOWS\AP7REMOTE\SETUP.EXE Help: WINDOWS\AP7HELP\SETUP.EXE Linux: Portugus: LINUX\\AP7SERVER\INSTALL_LINUX Ingls: LINUX\AP7SERVER\INSTALL_LINUX _ENG Espanhol: LINUX\AP7SERVER\INSTALL_LINUX _ESP

Cuidados a serem tomados

Windows: ter efetuado login como Administrador ou usurio equivalente. Linux: ter efetuado login como Administrador (ROOT). Windows/Linux: utilizar a ltima verso /ServicePack disponibilizada pelo fabricante do software.

Para instalar o AP7 Server: No Linux: 1. Monte o volume do CD-ROM, utilizando o comando: mount/mnt/cdrom -o exec 2. Acesse o diretrio: /mnt/cdrom/linux/ap7server 3. Execute o shell script: ./install_linux 4. Siga os passos indicados pelo shell script. Aps a instalao, no diretrio "/microsiga", leia o arquivo LEIAME com instrues de execuo do AP7 Server em Linux. No Windows: 1. Coloque o CD-ROM no drive e aguarde a exibio da tela de abertura. Do lado direito da tela so apresentadas as bandeiras referentes aos idiomas disponveis para instalao do AP7. Clique no cone correspondente ao idioma que deseja utilizar. Na parte central da tela, so apresentadas as opes dos aplicativos para instalao: Instalao do AP7 Server Instalao do AP7 Remote Instalao do AP7 Help (nesta ordem) Instalao do TopConnect Clique na opo AP7 Server. O Install Shield ser iniciado. A janela de Bem-Vindo apresentada. Clique no boto Avanar para prosseguir.

2.

3.

Diretrio de Instalao do AP7 Server

Indique o caminho onde o AP7 Server deve ser instalado. Clique no boto Avanar para prosseguir. 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 (drives de rede) utilizando o computador que faz o papel de servidor para efetuar a instalao. Assim, possvel evitar erros em eventuais desinstalaes do sistema.

Atualizao/Primeira instalao
Atualizao de verso: informe o diretrio onde est instalada a verso anterior. Aps a instalao, o kernel do AP6 continuar a existir, porm, os dados j estaro prontos para a atualizao da verso 7.10. Este diretrio conter os dados (SIGAADV, DADOSADV, RELATO, CPROVA, etc). Consulte no help: "A estrutura de diretrios do AP7".

Importante: antes de iniciar a atualizao, faa um backup das bases de dados, arquivos de configuraes (dicionrio de dados, parmetros, tabelas, CNAB, SISPAG, etc), menus e programas especficos dos usurios. Aps a instalao, atualize os atalhos de acesso ao AP7 Server e Remote para o novo caminho e execute o programa Assistente de Configurao para importar o arquivo de configurao .INI. Primeira instalao: Indique o caminho onde os arquivos de dados do AP7 devem ser gravados. Clique no boto Avanar para prosseguir.

Idioma do Sistema/Base de Dados Utilizada

Os tipos de repositrios disponveis no AP7: TopConnect (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, Btrieve ou Ctree. Neste momento, pode-se optar por apenas uma base de dados, porm, atravs de alteraes no arquivo de configurao do AP7Server e cpia do repositrio correto, possvel fazer com que a mesma instalao do AP7 utilize dois tipos de base de dados. 2. Selecione o idioma do RPO a ser instalado. Selecione o pas para instalao do arquivo "SXS<pas>.TXT". Este arquivo gravado no diretrio \AP_DATA\PATCHDAT, responsvel pela criao do dicionrio de dados e de demais arquivos especficos para cada pas selecionado. Clique no boto Avanar para prosseguir. 1.

3.

4.

Verificao das Configuraes de Instalao

Verifique as configuraes de instalao e confirme o seu incio, clicando no boto "Avanar". Se precisar alterar alguma opo, clique em "Voltar".

Processo de Instalao
O processo de descompactao e cpia dos arquivos ser iniciado uma vez informadas as variveis de instalao.

Servidor de Licenas
Informe o nome ou endereo IP (prefervel) do Servidor de Licenas e a porta de conexo. Se o equipamento onde o AP7 Server est sendo instalado tambm for o Servidor de Licenas, marque a caixa "Este servidor tambm um servidor de licenas".

Em ambientes com apenas um servidor, esta caixa deve obrigatoriamente ser marcada.

Assistente de Configurao
O programa de instalao prepara o AP7 Server com as configuraes mnimas para a sua correta execuo. Porm, pode-se configur-lo atravs da manuteno do arquivo de configuraes (AP7SRV.INI). As configuraes so mantidas em diferentes sees de Environments, conforme a estrutura do arquivo de configuraes.

No Windows, possvel configurar o arquivo AP7SRV.INI utilizando este Assistente de Configurao do AP7. Clique no boto "No" se no desejar executar o Assistente de Configurao neste momento. Este aplicativo pode ser acessado aps a instalao, atravs do menu Iniciar, pasta "AP7/Ferramentas/ Assistente de Configurao do Servidor". Caso seja necessria a alterao do AP7SRV.INI, clique no boto "Sim" para iniciar o Assistente. Consulte o tpico "Assistente de Configurao do Servidor" mais adiante.

Instalando o Help
Na finalizao da instalao, ser possvel instalar os helps do sistema. Ser apresentada a janela de inicializao da instalao do help. Os arquivos de help podero ser instalados posteriormente, atravs da opo AP7 Help do menu inicial do programa de Instalao. Clique em "Avanar" para prosseguir.

Diretrio de Instalao dos Arquivos de Help

Nesta janela, deve ser informado o diretrio de instalao dos arquivos de helps (padro \Program Files\AP7 Help). Clique no boto "Avanar".

Localizao do Servidor AP7

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

Processo de Instalao
Com a configurao da instalao do help, ser iniciado o processo de cpia dos arquivos. Este procedimento configura o acesso aos helps a partir do Servidor AP7, caso o usurio queira utilizar outro servidor de help, poder copiar os arquivos instalados para outro servidor e alterar o arquivo AP7SRV.INI, indicando a sua nova localizao, atravs da configurao da chave "PATH" da seo HTTP e da chave HELPSERVER do ambiente utilizado. Para isto, pode ser utilizado o Assistente de Configurao do Servidor.

Instalando o AP7 Remote (Windows)

O AP7 Remote pode ser instalado fisicamente em uma estao, atravs de uma opo da tela inicial de instalao do AP7. Este recurso til para instalao do AP7 Remote 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 atravs do protocolo TCP/IP. Devemos ressaltar que o procedimento de instalao do Remote nas estaes s recomendado em casos 7

especficos (utilizao remota, alto trfego de dados na rede, etc). Preferencialmente, indicado o uso centralizado do Remote no Servidor, atravs da criao de atalho para acesso. Para instalar o AP7 Remote com AutoRun: No Windows: 1. Coloque o CD-ROM no drive e aguarde a exibio da tela de abertura conforme a seguir.

2. 3.

Clique na opo AP7 Remote. O Install Shield ser iniciado. A janela de Bem-Vindo apresentada. Clique no boto Avanar para prosseguir.

Diretrio de Instalao
Indique o caminho onde o AP7 Remote deve ser instalado. Clique no boto Avanar para prosseguir. 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 (drives 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 Instalao
Indique a pasta onde devem ser instaladas as opes de acesso aos aplicativos do AP7.

Verificao das Configuraes de Instalao

Verifique a configurao de instalao e confirme o seu incio, clicando no boto "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.

Concluso da Instalao
Ao final da instalao, apresentada a tela sobre a concluso do processo. Clique no boto Concluir para finalizar.

Atualizao do AP6 - AP7

Quando se est processando a atualizao de verso, necessrio aps a instalao do AP7, executar o programa AP609TO710, antes de qualquer processamento, para que os arquivos da empresa sejam compatibilizados com os da nova verso enviada pela MICROSIGA. Leia sempre 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. Esta prioridade apenas ser modificada, quando a alterao da NOVA verso for imprescindvel para o funcionamento da mesma. O atualizador executa basicamente as seguintes tarefas: Inclui, exclui ou altera o contedo dos arquivos customizadores SXs do usurio 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. imprescindvel que o usurio faa um backup dos seus arquivos de dados (\AP_DATA\DADOSADV), dos arquivos customizadores SXs (\AP_DATA\SIGAADV) e seus programas especficos, antes de efetuar a Atualizao de Verso.

10

Executando o AP609TO710
Este programa exclusivo para migrao da verso 609 para a 7.10. Caso esteja utilizando uma verso anterior, deve-se migrar as verses progressivamente, utilizando os atualizadores respectivos, at obter a verso 6.09, para que ento o AP609TO710 possa ser executado. Para execut-lo deve-se: Acesse a pasta Advanced Protheus 7 ou "AP7" e carregue o AP7 Server. Em seguida, acesse o AP7 Remote. Em Programa Inicial, digite AP609TO710. Clique no boto OK para confirmar. Ser apresentada uma janela com orientaes sobre o processo de atualizao.

1. 2. 3. 4.

Antes de iniciar o processo deve-se: Efetuar o backup dos arquivos dos diretrios SIGAADV e DADOSADV; Ter espao em disco de aproximadamente 3 vezes o espao utilizado pelos diretrios SIGAADV + DADOSADV. A tela seguinte adverte que apenas o Administrador pode processar a atualizao de verso. 5. 6. No campo Senha, digite a senha do Administrador. Se desejar apenas simular a atualizao para verificar as alteraes a serem processadas e eventuais problemas na base de dados, clique na caixa de verificao Simular a Atualizao. Com esta opo ativada, no ser gravada nenhuma alterao na base. O sistema gera um arquivo de log que pode ser impresso. 11

7. 8.

9.

No campo "Pas", selecione a localizao a ser atualizada. A partir desta verso, possvel a utilizao do dicionrio de ndices (SINDEX) por empresa. Se a opo "SINDEX exclusivo" for selecionada, o AP609TO710 criar automaticamente um dicionrio de ndice para cada empresa cadastrada. Se esta opo no for selecionada, ser mantido o arquivo atual compartilhado entre as empresas. Clique no boto Avanar para prosseguir. Ser apresentada a janela para informao do diretrio padro, onde sero criadas as novas tabelas de dados referentes as empresas identificadas e relacionadas. 10. D um duplo clique sobre o diretrio e digite outro caminho, se necessrio. A localizao informada ser considerada abaixo do diretrio raiz definido no AP7SRV.INI (\ROOTPATH). 11. Clique no boto Avanar para prosseguir.

Ser apresentada a janela para configurao de execuo do AP609TO710. 12. Marque os logs desejados, observando: Log de Processos O Log de Processos grava todas as operaes que o Atualizador realiza, como 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.

12

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 as correes efetuadas atravs do Assistente do Atualizador. Os logs so gravados no arquivos APUPDATE.LOG. 13. 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. Se o usurio 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. 14. Clique na caixa "Corrigir todos os erros automaticamente" para que durante o processo de anlise de integridade, o Atualizador corrija automaticamente alguns erros crticos. 15. Clique na caixa Eliminar arquivos de backup ao trmino da atualizao para excluir automaticamente os arquivos de backup que o Atualizador cria durante o processo. 16. Clique na caixa "Manter o arquivo de log existente" para manter o log ao reiniciar o processo de atualizao de verso aps uma pausa. 17. Clique no boto Avanar para prosseguir. Ser apresentada a janela relacionando as tarefas que sero executadas pelo Atualizador. 13

Verificao da integridade das bases; Atualizao dos arquivos customizadores SXs; Atualizao das tabelas; Atualizao dos arquivos de helps; Execuo das funes compatibilizadoras.

18. Clique no boto Avanar para prosseguir. O Atualizador identifica cada processo iniciado e a sua evoluo.

19. Se diagnosticado algum problema na base do cliente, este ser apresentado com opes para a continuidade ou interrupo do processo. 20. Durante a verificao de integridade, se for diagnosticado algum "critical error" no previsto, o processo ser interrompido e o administrador ter a possibilidade de analisar o arquivo de log, corrigir o erro e reiniciar a atualizao. Clique no boto "Consulta Log" para consultar o arquivo de log. Para mais detalhes sobre a janela de consulta, veja o item "23" mais adiante.

14

21. Ao final de cada processo, o usurio poder optar por interromper a Atualizao, caso tenha selecionado esta opo no incio da configurao de execuo. 22. Se interrompida a Atualizao, ser possvel verificar o arquivo de log, clicando no boto Consulta Log.

23. A janela para consulta aos Logs ser exibida.

possvel escolher o tipo de evento a ser analisado, a empresa e a tarefa, atravs do boto "Filtro".

Se desejar um relatrio impresso, clique no boto Imprimir.

15

25. Configure a impresso e confirme a emisso do relatrio. Aps a interrupo da Atualizao, ser necessrio executar novamente o AP609TO710, porm sero identificadas as operaes j realizadas e o processo ser continuado a partir da ltima tarefa executada.

Como instalar 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 HASP instalado. Para cada contrato de manuteno, a MICROSIGA est enviando um Hardlock.

Em ambientes com um nico servidor AP7, este ser o servidor de licenas.

Instalao Fsica do hardlock

Para instalao fsica do Hardlock HASP, deve-se: 1. Conectar o HASP na porta correspondente:

Dispositivo com interface USB

Dispositivo com interface paralela

Instalao do driver do HASP

No Windows: No diretrio \windows\hasp\install, executar o instalador hdd32.exe. No tipo de instalao, escolher typical e fazer a instalao padro. 16

No Linux (operaes com usurio root): 1. Copiar o arquivo \linux\hasp\hasplinux104nn.tgz para um diretrio no servidor Linux. 2. Descompactar arquivo: tar xzf hasplinux104nn.tgz 3. Gerar 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: ap7grp) chrp ap7grp /dev/Hardlock chmod 550 /dev/Hardlock 5. Iniciar o driver: modprobe parport_pc 6. Carregar o driver: insmod <diretrio_to_driver>/aksparlnx.o -f O diretrio utilizado o correspondente verso do kernel. Se no encontrado, utilizar o mais prximo. 7. Se o acesso for pela porta USB, usbdefs deve ser montado. mount t usbdefs none /proc/bus/usb 8. Carregar o daemon: /hasp/sbin/aksusbd Incluir os comandos 5 a 8 ao script de inicializao. Demais ambientes Unix: Entrar em contato com a Microsiga.

Como executar o Aplicador de Licenas

Aps a instalao fsica e do driver HASP, necessrio executar o Aplicador de Licenas para fixao das licenas que sero utilizadas. 17

Executando o Aplicador de Licenas: 1. No menu Iniciar do Windows, acesse a pasta "AP7/ Ferramentas/ Aplicador de Licenas". 2. Escolha o idioma do aplicativo. 3. Na janela "Aplicador de Licenas", so solicitadas as informaes que esto descritas na carta com as senhas de liberao de uso do sistema, enviada em um envelope que acompanha o produto. Se aplicada com sucesso, a nova configurao ser utilizada na prxima vez que o servidor for iniciado.

Assistente de Configurao do Servidor

Se existir a verso 6.09 instalada, ser possvel importar as suas configuraes. Neste, caso, indique a localizao dos arquivos de configurao .INI da verso 6.09 se quiser edit-los, utilizando as definies j estabelecidas. Caso seja a primeira instalao, clique no boto "Ignorar".

A tela inicial do Assistente ser ento apresentada. Todas as sees descritas a seguir podem ser configuradas no Assistente de Configurao.

18

Fluxo de janelas
Ao clicar no boto "Avana" (Next), a tela seguinte ser referente ao primeiro item selecionado. Por exemplo, a ordem conforme ilustrado na tela inicial seria: 1. Ambientes 2. Conexo 3. Balanceamento de Carga 4. Servidor Internet

Botes das Telas de Configurao

Adicionar - permite adicionar uma configurao de acordo com as informaes preenchidas. necessrio que todos os campos obrigatrios estejam digitados. Remover - permite excluir uma configurao. Limpar - possibilita limpar a lista (excluir) de configuraes. Por exemplo, a lista de Ambientes. Reset - restaura a configurao original.

Exemplo de Criao de uma Configurao Ambiente (Environment) Balanceamento de Carga

De acordo com as opes selecionadas sero apresentadas as respectivas janelas de configurao para cada opo configurvel do AP7 Server. Todas estas configuraes se encontram no arquivo AP7SRV.INI que detalhado a seguir:

19

Seo
Environment
As sees Environment contm as informaes dos diretrios de execuo do AP7 Server, as informaes do idioma, interface, diretrios e repositrio, e opcionalmente as informaes para acesso ao TopConnect. Estas informaes so identificadas para cada conexo, ou seja, cada AP7 Remote que se conectar ao Servidor deve informar qual a seo que deseja utilizar. Assim, os diretrios para trabalho, o idioma, a interface e o repositrio podem ser obtidos a partir das informaes da seo definida. Uma seo padro, chamada Environment, criada na instalao e utilizada sempre que o AP7 Remote se conectar sem informar uma seo atravs de parmetros de linha de comando. Chave Descrio SourcePath Identifica o diretrio onde os repositrios de APOs so mantidos na mquina em que o AP7 Server est instalado. RootPath Identifica o diretrio raiz do AP7, a partir do qual todos os diretrios utilizados pelo AP7 sero criados. StartPath Identifica o diretrio onde os arquivos de configurao do AP7 se encontram. 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, TOP ou BTV. Esta informao utilizada pelo servidor para definir qual repositrio ser acessado. RpoLanguage Identifica a linguagem que ser utilizada. Pode ser Portuguese, English ou Spanish. Esta informao tambm utilizada pelo servidor para definio do repositrio a ser acessado. RpoVersion Identifica a verso do produto (AP6, AP7 ou anterior). AdsShare Indica o diretrio compartilhado onde 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 (AP7Trace.log) ser criado no diretrio \Bin. Valores possveis: 1 (faz log), 0 (no faz log) FilesOnDemand Indica se durante a abertura dos mdulos, o sistema ir efetuar a abertura pelo menu (padro) ou por necessidade (abre e fecha arquivos conforme utilizao). O valores possveis so: 1- Abre arquivos por demanda, 0-Abre os arquivos a partir do menu. 20

LocalFiles Localdbextension

Indica qual a base de dados que ser utilizada para abertura dos arquivos locais. Pode ser: ISAM padro DBF, ADS ou ADSServer. Define qual ser a extenso default dos arquivos ISAM para os Drivers DBFCDX, DBFCDXAX. So definidos como arquivos ISAM: Quando verso TopConnect: Sindex SXs (com exceo do SX5) Arquivos de trabalho Quando Verso Codebase: Todos os arquivos ISAM, com exceo do SIGAMAT.EMP. Quando Verso ADS: Todos os arquivos ISAM, com exceo do SIGAMAT.EMP. Quando Verso Btrieve ou cTree: Sindex SXs (com exceo do SX5) Arquivos de Trabalho Valores vlidos: Devem iniciar com ponto e 3 caracteres adicionais vlidos para extenso de arquivo no SO utilizado. Default: .dbf Define o diretrio (ligado ao RootPath) onde sero gravados os relatrios armazenados para visualizao pelo WebSpool. Default= definido no parmetro MV_RELDIR, (padro \RELATO\). Ex: WSPReldir=\WebRelato\ Ex: WsplServer= MyServer, 1024, MyEnvironment Define o Servidor, a porta e o ambiente, onde o agendador de relatrios e o WebSpool executaro suas tarefas de relatrios assncronos. DEFAULT - nome do equipamento onde for feita a conexo. 21

WSPLReldir

WSplServer

HelpServer

Para environment Btrieve: BTVPATH=\\ServidorBTV\dados Quando a verso do Btrieve Server (Ex: PervasiveSQL2000), esta chave indica onde devem ser criados e abertos todos os arquivos. Deste modo, sempre que for um arquivo Btrieve, o sistema ignora o caminho descrito no SX2 e utilizar o que estiver definido nesta chave. Define o endereo do servidor HTTP de help on-line. Ex.: HELPSERVER = servidor.com.br ou <nome do servidor>

TopConnect
A seo TopConnect contm as informaes utilizadas para o acesso base de dados SQL atravs do TopConnect. As informaes desta seo so utilizadas para todas as conexes, a no ser que estejam definidas no environment das conexes, como detalhado anteriormente. Chave Descrio DataBase Identifica o nome do DataBase que deve ser utilizado para acesso via TopConnect base de dados (MSSQL, MSSQL7, ORACLE, AS/400, SYBASE, INFORMIX e outros). Server Identifica o nome ou o endereo IP do servidor do TopConnect. Alias Identifica o alias utilizado no TopConnect para acesso base de dados. ConType Protocolo de comunicao para o TopConnect. Valores possveis: TCPIP, NPIPE ProtheusOnly Se esta chave tambm estiver ativada no TopConnect, a conexo a este somente poder ser feita pelo AP7. Valores vlidos: 0 ou 1 Default = 0 (desligado) PORT Porta do listener do Topconnect (vlido para verso 4.0 ou superior, em conexo TCPIP) Default = 798 Opcionalmente, pode-se colocar estas 6 chaves no environment, acrescentando TOP no incio da chave:

22

Exemplo: [environment] TOPDataBase=MSSQL7 TOPServer=Pesquisa3 TOPALIAS=TOPsql TOPcontype=NPIPE TOPPort=5082 TOPProtheusOnly=1 TOPdll=topapi32.dll Define a verso Client do TopConnect utilizado. Valores vlidos: topapi32.dll (para verses anteriores 4.0) topapi40.dll (para verso 4.0) Default = topapi32.dll 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 permitir acesso ao sistema. Contedos possveis = 0,1 DEFAULT = 0 PictFormat Esta chave permite a criao de environments com composio de data no formato "ms, dia, ano" , caso utilizar esta caracterstica basta informar AMERICAN nesta chave. Contedos Possveis = DEFAULT, AMERICAN DEFAULT = Default (Dia,Ms,Ano) FilesOnDemand Esta chave aplicada apenas se o RpoDb for DBF. Seu objetivo fazer com que o sistema faa a abertura somente dos arquivos indispensveis. Contedos possveis = 0,1 DEFAULT = 0

23

Drivers
A seo Drivers define quais os protocolos de conexo podero ser utilizados para que os terminais conectem-se ao AP7 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 (,), desse modo permitindo que existam conexes de terminais ao servidor efetuadas atravs de diferentes protocolos.

Sees Protocolos de Conexo

O AP7 Server pode se utilizar do 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 se conectar 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 Inactive Timeout 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. Obs: O AP7 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, separados por vrgula e na seqncia 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.

24

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 AP7 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. Ex: C:\AP7\http 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.

25

FTP
Esta seo permite ao AP7 Server atuar como Servidor FTP (Protocolo Internet). Chave Descrio Enable 1=Ligado e 0=Desligado Path Diretrio raiz para os arquivos de FTP. Ex: C:\AP7\FTP. Port Define o nmero da porta de conexo FTP.

ONSTART
Nesta seo, pode-se determinar a execuo de uma funo (Sem interface) logo aps o acesso ao Server. Chave Descrio Jobs Informe o(s) nome(s) de seo(es) para executar funes. Ex: [ONSTART] Jobs=JOB1,JOB2 [JOB1] Main=RecalcJur() Environment=Envtop [JOB2] Main=GetProdAtu() Environment=Environment

Service
Utilize esta seo para informar o nome interno e externo do Servio do AP7 Server no Windows NT. Esta opo til quando for necessrio utilizar mais de um AP7 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 NT. 26

A seguir apresentado um exemplo do arquivo de configuraes do AP7 Server, onde pode-se visualizar dois Environments diferentes: EnvDbf e EnvTop. A diferena entre eles que utilizam de bases de dados e idiomas diferentes.
[EnvDbf] SourcePath=C:\AP7\APO\ RootPath=C:\AP7 StartPath=\SIGAADV RpoDb=Dbf RpoLanguage=Portuguese RpoVersion=710 [EnvTop] SourcePath=C:\AP7\APO\ RootPath=C:\AP7 StartPath=\SIGAADVTOP RpoDb=Top RpoLanguage=English RpoVersion=710 TopServer=172.16.1.78 (ou TopDataBase=MSSQL7 [TopConnect] DataBase=MSSQL7 Server=172.16.1.13 ALIAS=TOPPROTHEUS Contype=TCPIP [Drivers] Active=TCP [TCP] TYPE=TCPIP Port=1024

nome do Servidor Top)

LicenseServer
A seo LicenseServer contm as informaes sobre o Servidor de Licenas. Chave Descrio Enable : Indica se o servidor AP7 ser um servidor de Licenas. Valores vlidos: 0 ou 1 Default= 0 (desligado) 27

Port: ShowStatus

Identifica a porta que ser utilizada para a comunicao entre o Servidor de Licenas e os servidores AP7. Esta chave permite o controle de requisies e liberaes de licena e semforos atravs de mensagens na tela de console. Valores vlidos: 0 ou 1 Default= 1 - apresenta mensagens Ex: [LicenseServer] Enable=1 Port=5555 ShowStatus=1

LicenseClient
A seo LicenseClient define as informaes que sero utilizadas para o servidor AP7 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 servidor AP7 e o Servidor de Licenas. Portanto, deve ser o mesmo valor da chave Port na seo LicenseServer do servidor de Licenas. Ex.: [LicenseClient] Server=192.16.01.12 Port=5555 Cuidado!: A porta de conexo entre o AP7 Server e o servidor de licenas no pode ser a mesma utilizada entre o AP7 Server e o AP7 Remote.

28

General
A seo General contm as informaes globais sobre o Servidor AP7, aquelas que so comuns para todos os ambientes. Chave Descrio CtreeMode: Indica se o Ctree ser utilizado em modo Local ou Servidor. Uma vez selecionado o modo atravs desta chave todos os ambientes devero utiliz-lo da mesma forma. Valores vlidos: SERVER e LOCAL Default= LOCAL AceVersion: Define verso do Advantage Client Engine para abertura dos arquivos padro DBF ou ADS Server. Valores vlidos: 2.50 e 6.11 Default= 6.11 CtreeServer A seo CtreeServer contm as informaes sobre o Servidor Ctree. Chave Descrio ctuserid: Nome do usurio com acesso ao Servidor Ctree ctuserpass: Senha do usurio para acesso ao Servidor Ctree ctservername: Identificao do Servidor Ctree. No formato: NOME@MQUINA, onde MQUINA pode ser o nome da mquina no Windows ou o IP nas demais plataformas; Ex: [CtreeServer] ctuserid = ADMIN ctuserpass = ADMIN ctservername = FAIRCOMS@172.16.0.100

29

Configurando o AP7 Remote

As configuraes do AP7 Remote tambm podem ser customizadas, de modo que pode-se manter diferentes conexes em um mesmo servidor. Por exemplo: Uma rede local com conexes via Named Pipes e algumas outras conexes remotas, via modem ou Internet, utilizando TCP-IP; Diferentes redes conectadas via linha privada. Cada uma destas redes mantm um AP7 Server para o processamento distribudo. Estas configuraes so mantidas no arquivo AP7RMT.INI que se encontra no diretrio de execuo do AP7 Remote:

Seo
Config
Identifica informaes gerais de configurao do AP7 Remote. Chave Descrio LastMainProg Contm a lista dos ltimos programas iniciais executados no AP7 Remote. o APO que inicia a execuo. Por exemplo, pode-se iniciar do SIGAADV, SIGAFIN, SIGAEST, etc. Twotier Informa se deve procurar o AP7 Server na mquina local, para ser executado automaticamente. Default = 0; para ativar especificar 1. Language Define o idioma utilizado para exibir as mensagens do AP7 Remote. Apenas as mensagens originadas do AP7 Remote so afetadas. Para uma traduo geral, devese ter o RPO no idioma requerido. 1 = Portugus, 2 = Espanhol, 3 = Ingls.

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

30

Sees de Protocolos de Conexo

As sees de configuraes de protocolos so definidas da mesma forma que no arquivo de configuraes do AP7 Server. No necessitam ter o mesmo nome que o definido no AP7 Server, porm as informaes devem ser as mesmas e, somente os protocolos definidos na chave Active da seo Drivers do arquivo de configurao do AP7 Server, podem ser utilizados quando estiver configurando o AP7 Remote. Notas: Para a execuo local (AP7 Server e AP7 Remote executados na mesma mquina) pode-se informar: Server = LocalHost. Para execuo remota, o nome do servidor ou o endereo IP informado para o AP7 Remote deve ser o mesmo configurado no AP7 Server onde o terminal est conectado. Do mesmo modo, a porta informada na chave Port deve ser a mesma configurada em ambos, AP7 Server e AP7 Remote; A seguir apresentado um exemplo do arquivo de configuraes do AP7 Remote:
[Environment] EnvServer=ENVIRONMENT [Config] LastMainProg=sigaadv [Drivers] Active=TCP [TCP] TYPE=TCPIP Server= [Nome do Computador ou nmero IP do Computador] Port=1024

Para instalar o AP7 Server como servio basta executar a seguinte linha de comando a partir do diretrio do executvel do Server. Ex: [c:\arquivos de programas\AP7]\bin\server\AP7srv.exe install. Caso no exista o arquivo AP7RMT.INI, ser exibida a seguinte tela solicitando o nome ou IP do Servidor, bem como a porta para comunicao. 31

Parmetros da Linha de Comando do AP7 Remote

Ao ser iniciado, o AP7 Remote exibe a tela de parmetros iniciais, para identificao do Ambiente, da Conexo e do APO inicial. Porm, tais informaes podem ser informadas atravs da linha de comando do cone de acesso ao AP7 Remote. As opes de linha de comando do AP7 Remote so: -Q (Quiet): Indica que o AP7 Remote no deve mostrar o Splash (imagem de apresentao) e a tela de identificao de parmetros iniciais necessita ser acompanhada da clusula P; -P (Main Program): Identifica o programa (APO) inicial; -R (CfgSection): Nome da seo de configurao. Por default Config; -E (Environment): Nome da seo de environment no .INI do Server que ser utilizada para definies gerais; -C (Connection): Nome da seo de conexo que ser utilizada para a conexo ao AP7 Server; -A (Parmetros para o Programa Inicial): Identifica um parmetro que ser passado para o programa inicial; -L (AP7 Remote Log File): Para no-conformidades que ocorram no AP7 Remote (antes que este possa se conectar ao AP7 Server), gerado um arquivo de log no diretrio de execuo deste aplicativo. Este arquivo tem o nome definido pela identificao do executvel (AP7Rmt) + um caracter de underline (_) + o nome da mquina em que o AP7 Remote est sendo executado (com extenso .LOG). Esta opo permite informar um nome especfico para a gerao deste arquivo de log, visando automatizaes especficas que necessitem saber quando uma no-conformidade ocorreu no AP7 Remote (por exemplo, impossibilidade de conexo). -M (AllowMultiSession): Permite mltiplas instncias (Cpias) do AP7 Remote na mesma mquina (Default: no permite); Por exemplo, pode-se utilizar a seguinte linha de comando:
AP7RMT.EXE Q P=SIGAEST E=ENV_TOP_ENGLISH

para executar o mdulo SIGAEST em uma base de dados utilizando o idioma ingls.

32

Topologia de Utilizao de Rede do AP7

Devido sua diviso em camadas, a tecnologia AP7 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 AP7.

33

Caractersticas e Possibilidades de Topologias de Rede

Pode-se manter um ou mais servidores de aplicao do AP7 (AP7 Server); Um AP7 Server pode estar na mesma mquina que o gerenciador de banco de dados; Mquinas melhores ou com mais recursos podem ter um AP7 Server executando localmente. Isto prioriza o processamento local, mas aumenta o trfego de rede entre o gerenciador de banco de dados e o AP7 Server; Do mesmo modo, pode-se executar servidores remotamente, priorizando o processamento; As conexes devem ser efetuadas atravs do protocolo TCP-IP ; Pode-se criar conexes via Internet atravs da montagem de um Web Server na empresa ou atravs de provedores de acesso (como a UOL e o ZAZ). Neste caso, o AP7 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 AP7 Remote e o AP7 Server. Alm da segurana oferecida pelo sistema Advanced, 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 AP7 Remote, de modo que os usurios remotos possam efetuar o download para conectar-se e utilizar o sistema. A definio da melhor topologia para execuo um passo importante da implementao da tecnologia AP7, pois influencia totalmente a performance. O maior trfego de rede est localizado entre o AP7 Server e o Banco de Dados, j que o trfego entre o AP7 Server e o AP7 Remote 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 AP7 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 AP7 Server para ser executado localmente nesta cidade pode ser uma boa soluo. 34

Instalao do AP7 em redes Netware Novell

Para a instalao do AP7 em redes Novell Netware so necessrios alguns procedimentos especficos. Segue um roteiro para a instalao e configurao do sistema: A partir de uma estao qualquer, faa a instalao do sistema em unidade de disco local; Na estao a partir da qual est sendo instalado o sistema, crie o mapeamento a ser utilizado pelo AP7 (recomenda-se a criao de drive 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 AP7\BIN, edite o arquivo AP7RMT.INI e, na seo TCP, coloque o parmetro Server igual a LocalHost.
[TCP] TYPE=TCPIP Server=SERVIDOR Port=1024 [TCP] TYPE=TCPIP Server=LOCALHOST Port=1024

Acrescente na seo [CONFIG] do arquivo AP7RMT.INI (localizado no diretrio AP7\BIN), o parmetro TWOTIER=1; No diretrio AP7/BIN, edite o arquivo AP7SRV.INI e, na seo Environment, troque a unidade de disco para direcionar o novo local. Exemplo:
[ENVIRONMENT] SourcePath=C:\AP7\APO RootPath=C:\AP7 StartPath=\SIGAADV RpoDb=ADS RpoLanguage=Portuguese RpoVersion=710 AdsShare=I:\ADS56 LocalFiles=ADS [ENVIRONMENT] SourcePath=I:\AP7\APO RootPath=I:\AP7 StartPath=\SIGAADV RpoDb=ADS RpoLanguage=Portuguese RpoVersion=710 AdsShare=I:\ADS56 LocalFiles=ADS

35

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 tem que ser a mesma); Crie nas estaes, cone de acesso para o AP7RMT.EXE localizado no diretrio \BIN do sistema. Ex. I:\AP7\BIN\AP7RMT.EXE; Ateno ao executar este passo, pois erros implicaro em problemas no Registro do Windows. Teste o acesso do sistema nas estaes, caso tudo esteja funcionando corretamente e no seja necessria uma aplicao AP7 para testes, desinstale o AP7 do drive local; O uso do AP7 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 NT.

Observaes: Instalao do ADS e configurao: 1. Nmero mximo de usurios, tabelas, locks, etc. O AP7 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 AP7SRV.INI Os dados devem estar na mquina onde o ADS foi instalado e por isso, o RootPath ser um endereo na rede. Ex: RootPath=\\servidor_ads\AP7\ LocalFiles deve ser ADSSERVER ADSSHARE: diretrio no servidor ADS compartilhado full para o usurio do AP7. Este diretrio apenas utilizado para a conexo do AP7 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 AP7 estiver rodando como servio, acrescentar uma senha de administrador ao servio.

36