guia de instalacao ap7

5/6/2018 Guia de Instalacao AP7 - slidepdf.com

http://slidepdf.com/reader/full/guia-de-instalacao-ap7 1/36

1

Instalação do AP7

Servidor de LicençasNa versão 7.10, disponibilizamos o Hardlock, um hardwarede proteção que tem por objetivo a segurançade suas informações e possibilita maior agilidade para liberação de senhas e grande ganho de performancenos processos de controle aos acessos simultâneos. Esse mecanismo de proteção de mensagens eletrônicas,baseado em algoritmos de criptografia com chaves de 128 bits, garante a proteção do sistema contra acessosindevidos. Para utilização do sistema, é necessário que um dos servidores AP7 seja o servidor de licenças.

Instalando o AP7 ServerO primeiro passo para instalação do AP7 é a instalação do AP7 Server. Esta instalação, como também doAP7 Remote e das ferramentas auxiliares (o AP7 IDE, AP7Dumpe o AP7 Monitor) é efetuada através doprograma de instalação.

• O AutoRun é executado automaticamente se o Windows estiver configurado com este recurso. Porém, é possívelexecutá-lo através do comando: X:\AUTORUN.EXE onde: X eé a unidade de CD -ROM

• Execução dos seguintes programas a partir da unidade de CD-ROM:– Windows:

AP7 Server: WINDOWS\AP7SERVER\SETUP.EXEAP7 Remote:WINDOWS\AP7REMOTE\SETUP.EXEHelp: WINDOWS\AP7HELP\SETUP.EXE

– Linux:

Português:LINUX\\AP7SERVER\INSTALL_LINUX

Inglês:LINUX\AP7SERVER\INSTALL_LINUX _ENGEspanhol:LINUX\AP7SERVER\INSTALL_LINUX _ESP

Cuidados a serem tomados

• Windows: ter efetuado login como Administrador ou usuário equivalente.• Linux: ter efetuado login como Administrador (ROOT).

• Windows/Linux: utilizar a última versão / ServicePack disponibilizada pelo fabricante do software.



2

Para instalar o AP7 Server :

No Linux:

1. Monte o volume do CD-ROM, utilizando o comando: mount/mnt/cdrom -o exec2. Acesse o diretório: /mnt/cdrom/linux/ap7server3. Execute o shell script: ./install_linux4. Siga os passos indicados pelo shell script .Após a instalação, no diretório "/microsiga", leia o arquivo LEIAME com instruções de execuçãodo AP7 Serverem Linux.

No Windows:

1. Coloque o CD-ROM no drivee aguarde a exibição da telade abertura. Do lado direito da tela são apresentadas asbandeiras referentes aos idiomas disponíveis para instala-ção doAP7. Clique no ícone correspondente ao idioma quedeseja utilizar. Na parte central da tela, são apresentadasas opções dos aplicativos para instalação:

• Instalação do AP7 Server• Instalação do AP7 Remote• Instalação do AP7 Help (nesta ordem)• Instalação do TopConnect

2. Clique na opção “AP7 Server”.

O Install Shield será iniciado. A janela de Bem-Vindo éapresentada.3. Clique no botão “Avançar” para prosseguir.



3

Diretório de Instalação do AP7 Server

• Indique o caminho onde o AP7 Server deve ser instalado.Clique no botão “Avançar” para prosseguir.Recomenda-se o uso do diretório padrão de instalaçãopara que o processo de suporte e treinamento seja facilita-do. Evite o uso de unidades lógicas (drives de rede) utili-zando o computador que faz o papel de servidor paraefetuar a instalação. Assim, é possível evitar erros emeventuais desinstalações do sistema.

Atualização/Primeira instalação

• Atualização de versão: informe o diretório onde estáinstalada a versão anterior. Após a instalação, o kernel doAP6 continuará a existir, porém, os dados já estarão pron-tos para a atualização da versão7.10. Este diretório conte-

rá os dados (SIGAADV, DADOSADV, RELATO,CPROVA, etc). Consulte no help:"A estrutura de diretóriosdo AP7".

Importante: antes de iniciar a atualização, faça um backup das bases de dados, arquivos deconfigurações (dicionário de dados, parâmetros, tabelas, CNAB, SISPAG, etc), menus e progra-

mas específicos dos usuários. Após a instalação, atualize os atalhos de acesso ao AP7 Server eRemote para o novo caminho e execute o programa Assistente de Configuração para importaro arquivo de configuração .INI.

• Primeira instalação: Indique o caminho onde os arquivos de dados do AP7 devem ser gravados.Clique no botão “Avançar” para prosseguir.



4

Idioma do Sistema/Base de Dados Utilizada

1. Os tipos de repositórios disponíveis no AP7: TopConnect(Integrado com todos os tipos de banco de dados disponí-veis para esta aplicação), ADS (Advantage DatabaseServer) para NT ou N ovell NetWare, ISAM padrão DBF,Btrieve ou Ctree. Neste momento, pode-se optar por ape-nas uma base de dados, porém, através de alterações noarquivo de configuração do AP7Server e cópia do repositóriocorreto, é possível fazer com que a mesma instalação doAP7 utilize dois tipos de base de dados.

2. Selecione o idioma do RPO a ser instalado.3. Selecione o país para instalação do arquivo "SXS<país>.TXT". Este arquivo é gravado no diretório

\AP_DATA\PATCHDAT, responsável pela criação do dicionário de dados e de demais arquivosespecíficos para cada país selecionado.

4. Clique no botão “Avançar” para prosseguir.

Verificação das Configurações de Instalação

• Verifique as configurações de instalação e confirme o seuinício, clicando no botão "Avançar". Se precisar alteraralguma opção, clique em "Voltar".



5

Processo de Instalação

• O processo de descompactação e cópia dos arquivos seráiniciado uma vez informadas as variáveis de instalação.

Servidor de Licenças

• Informe o nome ou endereço IP (preferível) do Servidor deLicenças e a porta de conexão.Se o equipamento onde o AP7 Serverestá sendo instaladotambém for o Servidor de Licenças, marque a caixa "Esteservidor também é um servidor de licenças".

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

Assistente de Configuração

O programa de instalação prepara o AP7 Server com as confi-gurações mínimas para a sua correta execução. Porém, pode-seconfigurá-lo através da manutenção do arquivo de configura-ções (AP7SRV.INI). As configurações são mantidas em dife-rentes seções de Environment s, conforme a estrutura do arquivode configurações.



6

No Windows, é possível configurar o arquivo AP7SRV.INI utilizando este Assistente de Configuração doAP7.

• Clique no botão "Não" se não desejar executar o Assistente de Configuração neste momento. Este

aplicativo pode ser acessado após a instalação, através do menu Iniciar, pasta "AP7/Ferramentas/ Assistente de Configuração do Servidor".• Caso seja necessária a alteração do AP7SRV.INI, clique no botão "Sim" para iniciar o Assistente.

Consulte o tópico "Assistente de Configuração do Servidor" mais adiante.

Instalando o Help

Na finalização da instalação, será possível instalar os helps dosistema. Será apresentada a janela de inicialização da instalaçãodo help. Os arquivos de help poderão ser instalados posterior-mente, através da opção AP7 Help do menu inicial do programade Instalação.

Clique em "Avançar" para prosseguir.

Diretório de Instalação dos Arquivos de Help

Nesta janela, deve ser informado o diretório de instalação dosarquivos de helps (padrão \Program Files\AP7 Help).

Clique no botão "Avançar".



7

Localização do Servidor AP7

Nesta janela, deve ser informado o diretório onde está instala-do o AP7 Server para que seja configurado corretamente peloprograma de instalação.Clique no botão "Avançar".


Com a configuração da instalação do help, será iniciado oprocesso de cópia dos arquivos.

Este procedimento configura o acesso aos helps a partir do

Servidor AP7, caso o usuário queira utilizar outro servidor dehelp, poderá copiar os arquivos instalados para outro servidore alterar o arquivo AP7SRV.INI, indicando a sua nova locali-zação, através da configuração da chave "PATH" da seçãoHTTP e da chave HELPSERVER do ambiente utilizado. Paraisto, pode ser utilizado o Assistente de Configuração do Servi-dor.

Instalando o AP7 Remote (Windows)O AP7 Remote pode ser instalado fisicamente em uma estação, através de uma opção da tela inicial deinstalação do AP7.

Este recurso é útil para instalação do AP7 Remote em computadores que não estão conectados à redelocal, ou seja, que necessitam que os executáveis estejam fisicamente na máquina. Por exemplo, em casosde filiais que acessam a matriz por uma linha discada através do protocolo TCP/IP.

Devemos ressaltar que o procedimento de instalação do Remote nas estações só é recomendado em casos



8

específicos (utilização remota, alto tráfego de dados na rede, etc). Preferencialmente, é indicado o usocentralizado do Remote no Servidor, através da criação de atalho para acesso.

Para instalar o AP7 Remote com AutoRun:No Windows:1. Coloque o CD-ROM no drive e aguarde a exibição da tela

de abertura conforme a seguir.

2. Clique na opção “AP7 Remote”.O Install Shield será iniciado. A janela de Bem-Vindo é apresentada.


Diretório de Instalação

Indique o caminho onde o AP7 Remote deve ser instalado.Clique no botão “Avançar” para prosseguir.

Recomenda-se o uso do diretório padrão de instalaçãopara que o processo de suporte e treinamento seja facilita-

do.Evite o uso de unidades lógicas (drives de rede), para tantoutilize sempre o computador que faz o papel de servidorpara efetuar a instalação. Com isso, diminui-se o risco deerros em eventuais desinstalações do sistema



9

Pasta Instalação

Indique a pasta onde devem ser instaladas as opções de acessoaos aplicativos do AP7.

Verificação das Configurações de Instalação

Verifique a configuração de instalação e confirme o seu início,clicando no botão "Avançar". Se precisar alterar alguma opção,clique em "Voltar".


Informadas as variáveis de instalação, é iniciado o processo de

descompactação e cópia dos arquivos.



10

Conclusão da Instalação

Ao final da instalação, é apresentada a tela sobre a conclusão doprocesso. Clique no botão “Concluir” para finalizar.

Atualização do AP6 - AP7Quando se está processando a atualização de versão, é necessário após a instalação do AP7, executar oprograma AP609TO710, antes de qualquer processamento, para que os arquivos da empresa sejamcompatibilizados com os da nova versão enviada pela MICROSIGA. Leia sempre as Notas do Release queacompanham as novas versões para conhecer as alterações que serão efetuadas pelo programa decompatibilização e os novos recursos.

Este programa sempre que possível dará prioridade às configurações do cliente. Esta prioridade apenas serámodificada, quando a alteração da NOVA versão for imprescindível para o funcionamento da mesma.

O atualizador executa basicamente as seguintes tarefas:

• Inclui, exclui ou altera o conteúdo dos arquivos customizadores SXs do usuário de acordo com asmodificações feitas nos arquivos padrões.

• Acerta as tabelas de dados, incluindo, excluindo ou alterando a estrutura dos campos. O sistema não

exclui campos incluídos pelo usuário em sua base de dados, desde que todas as alterações tenham sidoefetuadas pelo Módulo Configurador.• Antes de fazer o acerto é gerado um backup de cada arquivo a ser alterado com a terminação #DB.

É imprescindível que o usuário faça um backup dos seus arquivos de dados(\AP_DATA\DADOSADV), dos arquivos customizadores SXs (\AP_DATA\SIGAADV) eseus programas específicos, antes de efetuar a Atualização de Versão.



11

Executando o AP609TO710

Este programa é exclusivo para migração da versão 609 para a 7.10. Caso esteja utilizando umaversão anterior, deve-se migrar as versões progressivamente, utilizando os atualizadores respec-

tivos, até obter a versão 6.09, para que então o AP609TO710 possa ser executado.

Para executá-lo deve-se:1. Acesse a pasta “Advanced Protheus 7” ou "AP7" e carre-

gue o AP7 Server.2. Em seguida, acesse o AP7 Remote.3. Em “Programa Inicial”, digite “AP609TO710”.

4. Clique no botão “OK” para confirmar.Será apresentada uma janela com orientações sobre oprocesso de atualização.

Antes de iniciar o processo deve-se:

• Efetuar o backup dos arquivos dos diretórios “SIGAADV”

e “DADOSADV”;• Ter espaço em disco de aproximadamente 3 vezes o espaço

utilizado pelos diretórios SIGAADV + DADOSADV.A tela seguinte adverte que apenas o Administrador podeprocessar a atualização de versão.

5. No campo “Senha”, digite a senha do Administrador.6. Se desejar apenas simular a atualização para verificar as

alterações a serem processadas e eventuais problemas nabase de dados, clique na caixa de verificação “Simular aAtualização”.Com esta opção ativada, não será gravada nenhuma alte-ração na base. O sistema gera um arquivo de log que pode

ser impresso.



12

7. No campo "País", selecione a localização a ser atualizada.8. A partir desta versão, é possível a utilização do dicionário de índices (SINDEX) por empresa. Se a opção

"SINDEX exclusivo" for selecionada, o AP609TO710 criará automaticamente um dicionário deíndice para cada empresa cadastrada. Se esta opção não for selecionada, será mantido o arquivo atualcompartilhado entre as empresas.

9. Clique no botão “Avançar” para prosseguir.Será apresentada a janela para informação do diretório padrão, onde serão criadas as novas tabelas dedados referentes as empresas identificadas e relacionadas.

10. Dê um duplo clique sobre o diretório e digite outro cami-nho, se necessário.

A localização informada será considerada abaixo do diretórioraiz definido no AP7SRV.INI (\ROOTPATH).


Será apresentada a janela para configuração de execução doAP609TO710.

12. Marque os logs desejados, observando:

Log de Processos

O Log de Processos grava todas as operações que oAtualizador realiza, como abertura de arquivos, criação deíndices e arquivos temporários.

Log de Atualização

O Log de Atualização grava todas as alterações que oAtualizador fez na base, campo a campo, armazenando ovalor anterior e o atual.



13

Log de Inclusão

O Log de Inclusão grava todos os registros incluídos nos arquivos pelo Atualizador. Esta caixa éselecionada automaticamente.

Log Critical ErrorO Log Critical Error grava erros críticos que inviabilizam a continuidade do processo de atualização.Durante a verificação da integridade, caso seja encontrado um erro crítico, o processo de atualizaçãosomente poderá prosseguir após a correção do mesmo.Esta caixa é selecionada automaticamente.

Log Warning Error

Este log grava erros que não impedem o processo de atualização e as correções efetuadas através doAssistente do Atualizador.Os logs são gravados no arquivos APUPDATE.LOG.

13. Marque a caixa “Permite interromper processo durante a execução” para que ao final de cadaprocesso, a Atualização possa ser interrompida.O processo será reiniciado a partir da última tarefa executada.Se esta caixa não for selecionada, não será possível paralisar a Atualização em nenhum momento.

Se o usuário desejar saber de todas as alterações processadas, pode marcar todas as opções deLogs e também a caixa “Permite interromper processo durante a execução”.Neste caso, deve-se interromper ao final de cada processo, analisar os logs e executar aAtualização, 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 análise deintegridade, o Atualizador corrija automaticamente alguns erros críticos.

15. Clique na caixa “Eliminar arquivos de backup ao término da atualização” para excluir automatica-mente 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 deatualização de versão após uma pausa.

17. Clique no botão “Avançar” para prosseguir.Será apresentada a janela relacionando as tarefas que serão executadas pelo Atualizador.



14

• Verificação da integridade das bases;• Atualização dos arquivos customizadores – SXs;• Atualização das tabelas;

• Atualização dos arquivos de helps;• Execução das funções compatibilizadoras.


O Atualizador identifica cada processo iniciado e a suaevolução.

19. Se diagnosticado algum problema na base do cliente, esteserá apresentado com opções para a continuidade ouinterrupção do processo.

20. Durante a verificação de integridade, se for diagnosticadoalgum "critical error" não previsto, o processo será inter-rompido e o administrador terá a possibilidade de analisaro arquivo de log, corrigir o erro e reiniciar a atualização.

Clique no botão "Consulta Log" para consultar o arquivo de log.Para mais detalhes sobre a janela de consulta, veja o item "23"mais adiante.



15

21. Ao final de cada processo, o usuário poderá optar porinterromper a Atualização, caso tenha selecionado estaopção no início da configuração de execução.

22. Se interrompida a Atualização, será possível verificar oarquivo de log, clicando no botão “Consulta Log”.

23. A janela para consulta aos Logs será exibida.

É possível escolher o t ipo de evento a ser analisado, a empresa ea tarefa, através do botão "Filtro".

Se desejar um relatório impresso, clique no botão “Imprimir”.



16

25. Configure a impressão e confirme a emissão do relatório.Após a interrupção da Atualização, será necessário execu-tar novamente o AP609TO710, porém serão identificadasas operações já realizadas e o processo será continuado apartir da última tarefa executada.

Como instalar o Servidor de Licenças

O servidor de licenças deve ter conectado o Hardlock (dispositivo de segurança) na porta paralela ou USBe o driver do HASP instalado. Para cada contrato de manutenção, a MICROSIGA está enviando umHardlock.

Em ambientes com um único servidor AP7, este será o servidor de licenças.

Instalação Física do hardlock

Para instalação física do Hardlock HASP, deve-se:1. Conectar o HASP na porta correspondente:

Dispositivo com interface USB Dispositivo com interface paralela

Instalação do driver do HASP

No Windows:

No diretório \ windows\hasp\install, executar o instalador hdd32.exe. No tipo de instalação,escolher “typical” e fazer a instalação padrão.



17

No Linux (operações com usuário “root”):1. Copiar o arquivo \linux\hasp\hasplinux104nn.tgz para um diretório no servidor Linux.2. Descompactar arquivo:

tar –xzf hasplinux104nn.tgz3. Gerar o “device node”:

mknod /dev/H ardlock c 42 04. Dar acesso ao “node”

• Para todos:chmod 666 /dev/Hardlock

• Apenas para um grupo (ex: ap7grp)chrp ap7grp /dev/Hardlockchmod 550 /dev/Hardlock

5. Iniciar o driver:modprobe parport_pc

6. Carregar o driver:insmod <diretório_to_driver>/aksparlnx.o -f

O diretório utilizado é o correspondente à versão do kernel. Se não encontrado, utilizar omais próximo.

7. Se o acesso for pela porta USB, usbdefsdeve ser montado.mount –t usbdefs none /proc/bus/usb

8. Carregar o daemon: /hasp/sbin/aksusbdIncluir os comandos 5 a 8 ao script de inicialização.

Demais ambientes Unix:Entrar em contato com a Microsiga.

Como executar o Aplicador de Licenças

Após a instalação física e do driver H ASP, é necessário executar o Aplicador de Licenças para fixação daslicenças que serão ut ilizadas.



18

Executando o Aplicador de Licenças:1. No menu Iniciar do Windows, acesse a pasta "AP7/

Ferramentas/ Aplicador de Licenças".2. Escolha o idioma do aplicativo.3. Na janela "Aplicador de Licenças", são solicitadas as

informações que estão descritas na carta com as se-nhas de liberação de uso do sistema, enviada em umenvelope que acompanha o produto.

Se aplicada com sucesso, a nova configuração será utilizadana próxima vez que o servidor for iniciado.

Assistente de Configuração do Servidor

• Se existir a versão 6.09 instalada, será possível importar assuas configurações. Neste, caso, indique a localização dos

arquivos de configuração “.INI” da versão 6.09 se quisereditá-los, utilizando as definições já estabelecidas.• Caso seja a primeira instalação, clique no botão "Ignorar".

A tela inicial do Assistente será então apresentada.

Todas as seções descritas a seguir podem ser configuradas no

Assistente de Configuração.



19

Fluxo de janelas

Ao clicar no botão "Avança" (Next), a tela seguinte será referente ao primeiro item selecionado. Porexemplo, a ordem conforme ilustrado na tela inicial seria:

1. Ambientes2. Conexão3. Balanceamento de Carga4. Servidor Internet

Botões das Telas de Configuração

• Adicionar - permite adicionar uma configuração de acordo com as informações preenchidas. Énecessário que todos os campos obrigatórios estejam digitados.

• Remover - permite excluir uma configuração.• Limpar - possibilita limpar a lista (excluir) de configurações. Por exemplo, a lista de Ambientes.• Reset - restaura a configuração original.

Exemplo de Criação de uma Configuração

Ambiente (Environment) Balanceamento de Carga

De acordo com as opções selecionadas serão apresentadas as respectivas janelas de configuração para cadaopção configurável do AP7 Server.

Todas estas configurações se encontram no arquivo AP7SRV.INI que é detalhado a seguir:



20

Seção

Environment

As seções Environment contêm as informações dos diretórios de execução do AP7 Server, as informaçõesdo idioma, interface, diretórios e repositório, e opcionalmente as informações para acesso ao TopConnect.Estas informações são identificadas para cada conexão, ou seja, cada AP7 Remote que se conectar aoServidor deve informar qual a seção que deseja utilizar. Assim, os diretórios para trabalho, o idioma, ainterface e o repositório podem ser obtidos a partir das informações da seção definida.

Uma seção padrão, chamada Environment, é criada na instalação e utilizada sempre que o AP7 Remotese conectar sem informar uma seção através de parâmetros de linha de comando.

Chave DescriçãoSourcePath Identifica o diretório onde os repositórios de APOs são mantidos na máquina em que

o AP7 Server está instalado.

RootPath Identifica o diretório raiz do AP7, a partir do qual todos os diretórios utilizados peloAP7 serão criados.

StartPath Identifica o diretório onde os arquivos de configuração do AP7 se encontram. É o

diretório inicial de execução do sistema.Este diretório é criado a partir do diretório raiz, definido na chave anterior.

RpoDb Identifica o t ipo de base de dados ut ilizada. Pode ser DBF, ADS, TOP ou BTV . Estainformação é utilizada pelo servidor para definir qual repositório será acessado.

RpoLanguage Identifica a linguagem que será utilizada. Pode ser Portuguese, English ou Spanish.

Esta informação também é utilizada pelo servidor para definição do repositório a seracessado.

RpoVersion Identifica a versão do produto (AP6, AP7 ou anterior).AdsShare Indica o diretório compartilhado onde está instalado o servidor ADS.

Este diretório é utilizado para fazer a conexão ao servidor ADS.

Trace Indica se deve ser feito o Log de warnings em arquivo. O arquivo de log (AP7Trace.log)será criado no diretório “\Bin”. Valores possíveis: 1 (faz log), 0 (não faz log)

FilesOnDemand Indica se durante a abertura dos módulos, o sistema irá efetuar a abertura pelo menu

(padrão) ou por necessidade (abre e fecha arquivos conforme utilização). O valorespossíveis são: 1- Abre arquivos por demanda, 0-Abre os arquivos a partir do menu.



21

LocalFiles Indica qual é a base de dados que será utilizada para abertura dos arquivos locais. Podeser: ISAM padrão DBF, ADS ou ADSServer.

Localdbextension Define qual será a extensão default dos arquivos ISAM para os Drivers DBFCDX,DBFCDXAX.

São definidos como arquivos ISAM:

Quando versão TopConnect:• Sindex

• SXs (com exceção do SX5)

• Arquivos de trabalho

Quando Versão Codebase:Todos os arquivos ISAM, com exceção do SIGAMAT.EMP.

Quando Versão ADS:Todos os arquivos ISAM, com exceção do SIGAMAT.EMP.

Quando Versão Btrieve ou cTree:• Sindex

• SXs (com exceção do SX5)

Arquivos de TrabalhoValores válidos:

Devem iniciar com ponto e 3 caracteres adicionais válidos para extensão de arquivono SO utilizado.

Default: .dbf

WSPLReldir Define o diretório (ligado ao RootPath) onde serão gravados os relatórios armazenados

para visualização pelo WebSpool.Default= definido no parâmetro MV_RELDIR, (padrão \RELATO\).

Ex: WSPReldir=\WebRelato\

WSplServer Ex: WsplServer= MyServer, 1024, MyEnvironment

Define o Servidor, a porta e o ambiente, onde o agendador de relatórios e o WebSpoolexecutarão suas tarefas de relatórios assíncronos.

DEFAULT - nome do equipamento onde for feita a conexão.



22

Para environment Btrieve:

BTVPATH=\\ServidorBTV\dados

Quando a versão do Btrieve é Server (Ex: PervasiveSQL2000), esta chave indica onde

devem ser criados e abertos todos os arquivos. Deste modo, sempre que for um arquivoBtrieve, o sistema ignora o caminho descrito no SX2 e utilizará o que estiver definidonesta chave.

HelpServer Define o endereço do servidor HTTP de help on-line.

Ex.: HELPSERVER = servidor.com.br ou <nome do servidor>

TopConnect

A seção TopConnect contém as informações utilizadas para o acesso à base de dados SQL através doTopConnect. As informações desta seção são utilizadas para todas as conexões, a não ser que estejamdefinidas no environment das conexões, como detalhado anteriormente.

Chave DescriçãoDataBase 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 endereço IP do servidor do TopConnect.

Alias Identifica o alias utilizado no TopConnect para acesso à base de dados.

ConType Protocolo de comunicação para o TopConnect. Valores possíveis: TCPIP, NPIPE

ProtheusOnly Se esta chave também estiver ativada no TopConnect, a conexão a este somentepoderá ser feita pelo AP7.

Valores válidos: 0 ou 1

Default = 0 (desligado)

PORT Porta do listener do Topconnect (válido para versão 4.0 ou superior, em conexãoTCPIP)

Default = 798

Opcionalmente, pode-se colocar estas 6 chaves no environment, acrescentando“TOP” no início da chave:



23

Exemplo:

[environment]

TOPDataBase=MSSQL7

TOPServer=Pesquisa3TOPALIAS=TOPsql

TOPcontype=NPIPE

TOPPort=5082

TOPProtheusOnly=1

TOPdll=topapi32.dll Define a versão Client do TopConnect utilizado.

Valores válidos:• topapi32.dll (para versões anteriores à 4.0)

• topapi40.dll (para versão 4.0)

Default = topapi32.dll

JumpSenhap Esta chave permite que o responsável da rede altere a segurança imposta pelo Senhap,no caso de quebra ou perda do aparelho do Administrador do Sistema.

Caso o conteúdo seja 1, o Sistema apresenta uma advertência sobre a abertura dasegurança e permitir acesso ao sistema.Conteúdos possíveis = 0,1

DEFAULT = 0

PictFormat Esta chave permite a criação de environments com composição de data no formato"mês, dia, ano" , caso utilizar esta característica basta informar AMERICAN nestachave.

Conteúdos Possíveis = DEFAULT, AMERICANDEFAULT = Default (Dia,Mês,Ano)

FilesOnDemand Esta chave é aplicada apenas se o RpoDb for DBF. Seu objetivo é fazer com que osistema faça a abertura somente dos arquivos indispensáveis.

Conteúdos possíveis = 0,1

DEFAULT = 0



24

Drivers

A seção Drivers define quais os protocolos de conexão poderão ser utilizados para que os terminaisconectem-se ao AP7 Server.

Chave DescriçãoActive Identifica os nomes das seções de configuração de protocolos ativos. Mais de uma

seção pode ser informada separando-as por uma vírgula (,), desse modo permitindoque existam conexões de terminais ao servidor efetuadas através de diferentesprotocolos.

Seções Protocolos de Conexão

O AP7 Server pode se utilizar do protocolo TCP-IP para realizar a conexão com os terminais. A configuraçãodo protocolo utilizado é efetuada através de seções com as chaves definindo informações como a porta deconexão, o serviço e o t ipo da conexão. As conexões ativas, ou seja, que podem ser utilizadas pelos terminaispara se conectar ao Servidor, são aquelas cujos nomes de seções estão definidos na chave Active descritaanteriormente. Pode-se criar diversas seções com as conexões utilizadas.

Chave Descrição

Inactive Timeout Determina o tempo de espera até a queda da conexão, no caso de não haver respostas.Port Identifica a porta que será utilizada para as comunicações via TCP-IP.

Obs: O AP7 utiliza TCP Stack (A mesma porta para todos os usuários)

ServerNetwork

Esta seção é utilizada no caso do uso de Balanceamento de Carga. Deve-se informar na chave a seguir quais

são os servidores disponíveis na rede.Chave DescriçãoServers Especificar os nomes das seções que contêm as informações dos servidores, separados

por vírgula e na seqüência de busca desejada.

Dentro de cada nova seção de servidor, deve-se informar o nome, o tipo de conexão(TCP), a porta ou serviço e o número de conexões permitidas.



25

Exemplo:

[ServerNetwork]

Servers=SERVER1,SERVER2

Masterconnection=0 (Default ligado)Informa que o master não irá aceitar conexões

[SERVER1]

TYPE=TCPIP

Server=Servidor1

Port=1024

Connections=60

[SERVER2]

TYPE=TCPIP

Server=Servidor2

Port=3024

Connections=40

HTTPEsta seção permite ao AP7 Server atuar como Servidor Http (Protocolo Internet), ou seja, pode fornecerpáginas em html para um Browser.

Chave DescriçãoEnable 1=Ligado e 0=Desligado

Path Local onde será o diretório raiz para as páginas.

Ex: C:\AP7\httpPort Número da porta utilizada para a conexão http.

RPCTimeout Tempo limite para nova tentativa de conexão.

RPCEnv Nome do Environment usado para a conexão.

RPCServer Nome da seção que indica a conexão do servidor para processamentos.



26

FTP

Esta seção permite ao AP7 Server atuar como Servidor FTP (Protocolo Internet).Chave Descrição

Enable 1=Ligado e 0=DesligadoPath Diretório raiz para os arquivos de FTP. Ex: C:\AP7\FTP.

Port Define o número da porta de conexão FTP.

ONSTART

Nesta seção, pode-se determinar a execução de uma função (Sem interface) logo após o acesso ao Server.

Chave DescriçãoJobs Informe o(s) nome(s) de seção(ões) para executar funções.

Ex:

[ONSTART]Jobs=JOB1,JOB2

[JOB1]

Main=RecalcJur()Environment=Envtop

[JOB2]

Main=GetProdAtu()

Environment=Environment

ServiceUtilize esta seção para informar o nome interno e externo do Serviço do AP7 Server no Windows NT. Estaopção é útil quando for necessário utilizar mais de um AP7 Server rodando como serviço na mesmamáquina, pois permite ao usuário informar nomes diferentes.

Chave DescriçãoName Nome interno do Serviço

Displayname Nome a ser exibido na janela de serviços do Windows NT.



27

A seguir é apresentado um exemplo do arquivo de configurações do AP7 Server, onde pode-se visualizardois Environments diferentes: EnvDbf e EnvTop. A diferença entre eles é que utilizam de bases de dadose 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 nome do Servidor Top)

TopDataBase=MSSQL7

[TopConnect]DataBase=MSSQL7

Server=172.16.1.13

ALIAS=TOPPROTHEUS

Contype=TCPIP

[Drivers]

Active=TCP

[TCP]

TYPE=TCPIPPort=1024

LicenseServer

A seção LicenseServer contém as informações sobre o Servidor de Licenças.

Chave DescriçãoEnable : Indica se o servidor AP7 será um servidor de Licenças.

Valores válidos: 0 ou 1Default= 0 (desligado)



28

Port: Identifica a porta que será utilizada para a comunicação entre o Servidor de Licençase os servidores AP7.

ShowStatus Esta chave permite o controle de requisições e liberações de licença e semáforosatravés de mensagens na tela de console.

Valores válidos: 0 ou 1

Default= 1 - apresenta mensagens

Ex:

[LicenseServer]

Enable=1

Port=5555

ShowStatus=1

LicenseClient

A seção LicenseClient define as informações que serão utilizadas para o servidor AP7 se conectar a umServidor de Licenças.

Chave Descrição

Server : É o nome ou número IP do computador onde está o Servidor de Licenças.Port: Identifica a porta que será utilizada para a comunicação entre o servidor AP7 e o

Servidor de Licenças. Portanto, deve ser o mesmo valor da chave “Port” na seção“LicenseServer” do servidor de Licenças.

Ex.:

[LicenseClient]

Server=192.16.01.12Port=5555

Cuidado!: A porta de conexão entre o AP7 Server e o servidor de licenças não podeser a mesma utilizada entre o AP7 Server e o AP7 Remote.



29

General

A seção General contém as informações globais sobre o Servidor AP7, aquelas que são comuns para todosos ambientes.

Chave DescriçãoCtreeMode: Indica se o Ctree será utilizado em modo Local ou Servidor. Uma vez selecionado o

modo através desta chave todos os ambientes deverão utilizá-lo da mesma forma.

Valores válidos: SERVER e LOCAL

Default= LOCAL

AceVersion: Define versão do Advantage Client Engine para abertura dos arquivos padrão DBF

ou ADS Server.Valores válidos: 2.50 e 6.11

Default= 6.11

CtreeServerA seção CtreeServer contém as informações sobre o Servidor Ctree.

Chave Descriçãoctuserid: Nome do usuário com acesso ao Servidor Ctree

ctuserpass: Senha do usuário para acesso ao Servidor Ctree

ctservername: Identificação do Servidor Ctree. No formato: NO ME@MÁQUIN A, onde“MÁQUINA” pode ser o nome da máquina no Windows ou o IP nas demaisplataformas;

Ex:

[CtreeServer]ctuserid = ADMIN

ctuserpass = ADMIN

ctservername = [email protected]



30

Configurando o AP7 RemoteAs configurações do AP7 Remote também podem ser customizadas, de modo que pode-se manterdiferentes conexões em um mesmo servidor. Por exemplo:

• Uma rede local com conexões via Named Pipes e algumas outras conexões remotas, via modem ouInternet, utilizando TCP-IP;• Diferentes redes conectadas via linha privada. Cada uma destas redes mantém um AP7 Server para

o processamento distribuído.Estas configurações são mantidas no arquivo AP7RMT.INI que se encontra no diretório de execução doAP7 Remote:

SeçãoConfig

Identifica informações gerais de configuração do AP7 Remote.

Chave DescriçãoLastMainProg Contém a lista dos últimos programas iniciais executados no AP7 Remote. É o APO

que inicia a execução. Por exemplo, pode-se iniciar do SIGAADV, SIGAFIN, SIGAEST,etc.

Twotier Informa se deve procurar o AP7 Server na máquina local, para ser executadoautomaticamente. Default = 0; para ativar especificar 1.

Language Define o idioma utilizado para exibir as mensagens do AP7 Remote. Apenas asmensagens originadas do AP7 Remote são afetadas. Para uma tradução geral, deve-se ter o RPO no idioma requerido. 1 = Português, 2 = Espanhol, 3 = Inglês.

Drivers

A seção Drivers define quais os protocolos podem ser utilizados para que o Terminal conecte-se ao AP7Server. É igual a seção de mesmo nome no arquivo de configurações do AP7 Server. A diferença é que asseções aqui informadas (que devem ser separadas por vírgulas) são utilizadas em tentativas de conexão, deacordo com a ordem em que foram informadas.



31

Seções de Protocolos de Conexão

As seções de configurações de protocolos são definidas da mesma forma que no arquivo de configuraçõesdo AP7 Server.

Não necessitam ter o mesmo nome que o definido no AP7 Server, porém as informações devem ser asmesmas e, somente os protocolos definidos na chave Activeda seção Driversdo arquivo de configuração doAP7 Server, podem ser utilizados quando estiver configurando o AP7 Remote.

Notas:

• Para a execução local (AP7 Server e AP7 Remote executados na mesma máquina) pode-se informar:Server = LocalHost .

• Para execução remota, o nome do servidor ou o endereço IP informado para o AP7 Remote deve ser

o mesmo configurado no AP7 Server onde o terminal está conectado. Do mesmo modo, a portainformada na chave Port deve ser a mesma configurada em ambos, AP7 Server e AP7 Remote;

A seguir é apresentado um exemplo do arquivo de configurações do AP7 Remote:[Environment]

EnvServer=ENVIRONMENT

[Config]

LastMainProg=sigaadv

[Drivers] Active=TCP

[TCP]

TYPE=TCPIP

Server= [Nome do Computador ou número IP do Computador]

Port=1024

Para instalar o AP7 Server como serviço basta executar a

seguinte linha de comando a partir do diretório doexecutável do Server.Ex:[c:\arquivos de programas\AP7]\bin\server\AP7srv.exe –install.Caso não exista o arquivo AP7RMT.INI, será exibida aseguinte tela solicitando o nome ou IP do Servidor, bemcomo a porta para comunicação.



32

Parâmetros da Linha de Comando do AP7 Remote

Ao ser iniciado, o AP7 Remote exibe a tela de parâmetros

iniciais, para identificação do Ambiente, da Conexão e do APOinicial. Porém, tais informações podem ser informadas atravésda linha de comando do ícone de acesso ao AP7 Remote.

As opções de linha de comando do AP7 Remote são:

• -Q (Quiet): Indica que o AP7 Remote não deve mostrar oSplash (imagem de apresentação) e a tela de ident ificaçãode parâmetros iniciais necessita ser acompanhada da

cláusula –P;• -P (Main Program): Identifica o programa (APO) inicial;• -R (CfgSection): Nome da seção de configuração. Por default é “Config”;• -E (Environment): Nome da seção de environment no .INI do Server que será utilizada para definições

gerais;• -C (Connection): Nome da seção de conexão que será utilizada para a conexão ao AP7 Server;• -A (Parâmetros para o Programa Inicial): Ident ifica um parâmetro que será passado para o programa

inicial;• -L (AP7 Remote Log File): Para não-conformidades que ocorram no AP7 Remote (antes que este possa

se conectar ao AP7 Server), é gerado um arquivo de log no diretório de execução deste aplicativo.Este arquivo tem o nome definido pela identificação do executável (AP7Rmt) + um caracter deunderline(_) + o nome da máquina em que o AP7 Remote está sendo executado (com extensão .LOG).Esta opção permite informar um nome específico para a geração deste arquivo de log, visandoautomatizações específicas que necessitem saber quando uma não-conformidade ocorreu no AP7

Remote (por exemplo, impossibilidade de conexão).• -M (AllowMultiSession): Permite múltiplas instâncias (Cópias) do AP7 Remote na mesma máquina

(Default: não permite);Por exemplo, pode-se utilizar a seguinte linha de comando:AP7RMT.EXE –Q –P=SIGAEST –E=ENV_TOP_ENGLISH

para executar o módulo SIGAEST em uma base de dados utilizando o idioma inglês.



33

Topologia de Utilização de Rede do AP7

Devido à sua divisão em camadas, a tecnologia AP7 permite montar o ambiente de execução com

diferentes topologias, priorizando a execução, o tráfego de rede ou os recursos individuais das máquinasexistentes, o que torna o processamento distribuído. Essa é uma das grandes vantagens da tecnologia AP7.



34

Características e Possibilidades de Topologias de Rede• Pode-se manter um ou mais servidores de aplicação do AP7 (AP7 Server);• Um AP7 Server pode estar na mesma máquina que o gerenciador de banco de dados;• Máquinas melhores ou com mais recursos podem ter um AP7 Server executando localmente. Isto

prioriza o processamento local, mas aumenta o tráfego de rede entre o gerenciador de banco de dadose o AP7 Server;

• Do mesmo modo, pode-se executar servidores remotamente, priorizando o processamento;• As conexões devem ser efetuadas através do protocolo TCP-IP ;• Pode-se criar conexões via Internet através da montagem de um Web Server na empresa ou através de

provedores de acesso (como a UO L e o ZAZ). Neste caso, o AP7 Server pode ser executado no provedor

ou na empresa utilizando uma LP para a conexão ao provedor de acesso;• A Internet é utilizada apenas como o meio de comunicação, ou seja, a conexão TCP-IP entre o AP7Remote e o AP7 Server. Além da segurança oferecida pelo sistema Advanced, a segurança deve seroferecida pela conexão. Por isso, é aconselhável que o servidor Web não seja o mesmo servidor da basede dados;

• Pode-se manter uma página para o download do AP7 Remote, de modo que os usuários remotos possamefetuar o download para conectar-se e utilizar o sistema.

A definição da melhor topologia para execução é um passo importante da implementação datecnologia AP7, pois influencia totalmente a performance.O maior tráfego de rede está localizado entre o AP7 Server e o Banco de Dados, já que o tráfego entreo AP7 Server e o AP7 Remote contém somente informações para montagem de telas e controle deteclado e mouse. Desta forma, dependendo do tipo e da velocidade da conexão, pode se tornarinviável manter um AP7 Server em uma cidade conectado ao banco de dados em outra. Por outrolado, caso existam muitas conexões nesta outra cidade, ou caso estas conexões executem processamentos

pesados, priorizar o processamento disponibilizando um AP7 Server para ser executado localmentenesta cidade pode ser uma boa solução.



35

Instalação do AP7 em redes Netware Novell

Para a instalação do AP7 em redes Novell Netware são necessários alguns procedimentos específicos. Segue

um roteiro para a instalação e configuração do sistema:• A partir de uma estação qualquer, faça a instalação do sistema em unidade de disco local;• Na estação a partir da qual está sendo instalado o sistema, crie o mapeamento a ser utilizado pelo AP7

(recomenda-se a criação de drive específico para o sistema) Ex. I:;• Na unidade rede, faça a cópia idêntica da árvore de diretórios criada pela instalação no disco local;• No diretório AP7\BIN, edite o arquivo AP7RMT.INI e, na seção TCP, coloque o parâmetro Server

igual a LocalHost.

[TCP] [TCP]TYPE=TCPIP TYPE=TCPIP

S erver =SER VIDO R Serve r=LO CALH OST

Port=1024 Port=1024

• Acrescente na seção [CONFIG] do arquivo AP7RMT.INI (localizado no diretório AP7\BIN), oparâmetro TWO TIER=1;

• No diretório AP7/BIN, edite o arquivo AP7SRV.INI e, na seção Environment, troque a unidade de

disco para direcionar o novo local.Exemplo:

[ENVIRONMENT]

SourcePath=C:\AP7\APO

RootPath=C:\AP7

StartPath=\SIGAADV

RpoDb=ADSRpoLanguage=Portuguese

RpoVersion=710

AdsShare=I:\ADS56

LocalFiles=ADS

[ENVIRONMENT]

SourcePath=I:\AP7\APO

RootPath=I:\AP7

StartPath=\SIGAADV

RpoDb=ADSRpoLanguage=Portuguese

RpoVersion=710

AdsShare=I:\ADS56

LocalFiles=ADS

C i d ili i idê i d f



36

• Crie, em todas as estações que utilizarão o sistema, um mapeamento idêntico ao da estação que fez ainstalação e cópia. (A letra para definir a unidade tem que ser a mesma);

• Crie nas estações, ícone de acesso para o AP7RMT.EXE localizado no diretório \BIN do sistema. Ex.I:\AP7\BIN\AP7RMT.EXE;

Atenção ao executar este passo, pois erros implicarão em problemas no Registro do Windows.• Teste o acesso do sistema nas estações, caso tudo esteja funcionando corretamente e não seja

necessária uma aplicação 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 estação efetua seu processamento e o tráfego de dados na rede cresce consideravelmentequando comparado às instalações convencionais em redes NT.

Observações: Instalação do ADS e configuração:1. Número máximo de usuários, tabelas, locks, etc.

O AP7 faz duas conexões no ADS por usuário e por isso, o número de conexões deve ser o dobro donúmero de usuários.

2. Configuração do AP7SRV.INIOs dados devem estar na máquina onde o ADS foi instalado e por isso, o “RootPath” será um endereço

na rede.Ex: RootPath=\\servidor_ads\AP7\ LocalFiles deve ser ADSSERVERADSSHARE: diretório no servidor ADS compartilhado full para o usuário do AP7. Este diretório éapenas utilizado para a conexão do AP7 com o Servidor ADS. Sugerimos que se crie um diretório vaziona raiz do Servidor ADS e o compartilhe.Ex: ADSShare = \\servidor_ads\adsshare

3. Se o AP7 estiver rodando como serviço, acrescentar uma senha de administrador ao serviço.

guia de instalacao ap7

Documents