Instalação do AP7Servidor de Licenças Na versão 7.10, disponibilizamos o Hardlock, um hardware de proteção que tem por objetivo a segurança de suas informações e possibilita maior agilidade para liberação de senhas e grande ganho de performance nos 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 acessos indevidos. Para utilização do sistema, é necessário que um dos servidores AP7 seja o servidor de licenças. Instalando o AP7 Server O primeiro passo para instalação do AP7 é a instalação do AP7 Server. Esta instalação, como também do AP7 Remote e das ferramentas auxiliares (o AP7 IDE, AP7Dump e o AP7 Monitor) é efetuada através do programa de instalação. O AutoRun é executado automaticamente se o Windows estiver configurado com este recurso. Porém, é possível • executá-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.EXE AP7 Remote:WINDOWS\AP7REMOTE\SETUP.EXE Help: WINDOWS\AP7HELP\SETUP.EXE – Linux: Português: LINUX\\AP7SERVER\INSTALL_LINUX Inglês: LINUX\AP7SERVER\INSTALL_LINUX _ENG Espanhol: 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. 1 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 diretório: /mnt/cdrom/linux/ap7server 3. Execute o shell script: ./install_linux 4. 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ção do AP7 Server em Linux. No Windows: 1. Coloque o CD-ROM no drive e aguarde a exibição da tela de abertura. Do lado direito da tela são apresentadas as bandeiras referentes aos idiomas disponíveis para instalação do AP7. Clique no ícone correspondente ao idioma que deseja utilizar. Na parte central da tela, são apresentadas as 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 Clique na opção “AP7 Server”. O Install Shield será iniciado. A janela de Bem-Vindo é apresentada. Clique no botão “Avançar” para prosseguir. 2. 3. 2 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ção para que o processo de suporte e treinamento seja facilitado. Evite o uso de unidades lógicas (drives de rede) utilizando o computador que faz o papel de servidor para efetuar a instalação. Assim, é possível evitar erros em eventuais 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 do AP6 continuará a existir, porém, os dados já estarão prontos para a atualização da versão 7.10. Este diretório conterá os dados (SIGAADV, DADOSADV, RELATO, CPROVA, etc). Consulte no help: "A estrutura de diretórios do AP7". Importante: antes de iniciar a atualização, faça um backup das bases de dados, arquivos de configurações (dicionário de dados, parâmetros, tabelas, CNAB, SISPAG, etc), menus e programas específicos dos usuários. Após a instalação, atualize os atalhos de acesso ao AP7 Server e Remote para o novo caminho e execute o programa Assistente de Configuração para importar o 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. 3 TXT". ISAM padrão DBF. Selecione o idioma do RPO a ser instalado.Idioma do Sistema/Base de Dados Utilizada 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). 4 . pode-se optar por apenas uma base de dados. 1. clicando no botão "Avançar". porém. Verificação das Configurações de Instalação • Verifique as configurações de instalação e confirme o seu início. 3. Clique no botão “Avançar” para prosseguir. clique em "Voltar". Selecione o país para instalação do arquivo "SXS<país>. Se precisar alterar alguma opção. 2. através de alterações no arquivo de configuração do AP7Server e cópia do repositório correto. responsável pela criação do dicionário de dados e de demais arquivos específicos para cada país selecionado. ADS (Advantage Database Server) para NT ou Novell NetWare. Neste momento. 4. Este arquivo é gravado no diretório \AP_DATA\PATCHDAT. é possível fazer com que a mesma instalação do AP7 utilize dois tipos de base de dados. Btrieve ou Ctree. Servidor de Licenças • Informe o nome ou endereço IP (preferível) do Servidor de Licenças e a porta de conexão. marque a caixa "Este servidor também é um servidor de licenças". pode-se configurá-lo através da manutenção do arquivo de configurações (AP7SRV. conforme a estrutura do arquivo de configurações.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.INI). esta caixa deve obrigatoriamente ser marcada. As configurações são mantidas em diferentes seções de Environments. 5 . Porém. Assistente de Configuração O programa de instalação prepara o AP7 Server com as configurações mínimas para a sua correta execução. Se o equipamento onde o AP7 Server está sendo instalado também for o Servidor de Licenças. Em ambientes com apenas um servidor. através do menu Iniciar. pasta "AP7/Ferramentas/ Assistente de Configuração do Servidor". Diretório de Instalação dos Arquivos de Help Nesta janela. Instalando o Help Na finalização da instalação.No Windows. • Caso seja necessária a alteração do AP7SRV. clique no botão "Sim" para iniciar o Assistente. Os arquivos de help poderão ser instalados posteriormente.INI utilizando este Assistente de Configuração do AP7. Será apresentada a janela de inicialização da instalação do help. Clique no botão "Avançar". • Clique no botão "Não" se não desejar executar o Assistente de Configuração neste momento. será possível instalar os helps do sistema. através da opção AP7 Help do menu inicial do programa de Instalação. Consulte o tópico "Assistente de Configuração do Servidor" mais adiante. Este aplicativo pode ser acessado após a instalação.INI. é possível configurar o arquivo AP7SRV. Clique em "Avançar" para prosseguir. 6 . deve ser informado o diretório de instalação dos arquivos de helps (padrão \Program Files\AP7 Help). será iniciado o processo de cópia dos arquivos. Clique no botão "Avançar". Este recurso é útil para instalação do AP7 Remote em computadores que não estão conectados à rede local. indicando a sua nova localização. poderá copiar os arquivos instalados para outro servidor e alterar o arquivo AP7SRV. que necessitam que os executáveis estejam fisicamente na máquina. Processo de Instalação Com a configuração da instalação do help. Devemos ressaltar que o procedimento de instalação do Remote nas estações só é recomendado em casos 7 . caso o usuário queira utilizar outro servidor de help.Localização do Servidor AP7 Nesta janela. ou seja. Por exemplo.INI. através da configuração da chave "PATH" da seção HTTP e da chave HELPSERVER do ambiente utilizado. deve ser informado o diretório onde está instalado o AP7 Server para que seja configurado corretamente pelo programa de instalação. através de uma opção da tela inicial de instalação do AP7. Este procedimento configura o acesso aos helps a partir do Servidor AP7. pode ser utilizado o Assistente de Configuração do Servidor. Para isto. em casos de filiais que acessam a matriz por uma linha discada através do protocolo TCP/IP. Instalando o AP7 Remote (Windows) O AP7 Remote pode ser instalado fisicamente em uma estação. 2. O Install Shield será iniciado. Evite o uso de unidades lógicas (drives de rede). através da criação de atalho para acesso. para tanto utilize sempre o computador que faz o papel de servidor para efetuar a instalação. Para instalar o AP7 Remote com AutoRun: No Windows: 1. Com isso. alto tráfego de dados na rede. Recomenda-se o uso do diretório padrão de instalação para que o processo de suporte e treinamento seja facilitado. Coloque o CD-ROM no drive e aguarde a exibição da tela de abertura conforme a seguir. Preferencialmente. Clique no botão “Avançar” para prosseguir. 3. é indicado o uso centralizado do Remote no Servidor. Clique na opção “AP7 Remote”. diminui-se o risco de erros em eventuais desinstalações do sistema 8 . Clique no botão “Avançar” para prosseguir.específicos (utilização remota. etc). A janela de Bem-Vindo é apresentada. Diretório de Instalação Indique o caminho onde o AP7 Remote deve ser instalado. clique em "Voltar". Processo de Instalação Informadas as variáveis de instalação.Pasta Instalação Indique a pasta onde devem ser instaladas as opções de acesso aos aplicativos do AP7. é iniciado o processo de descompactação e cópia dos arquivos. 9 . Verificação das Configurações de Instalação Verifique a configuração de instalação e confirme o seu início. Se precisar alterar alguma opção. clicando no botão "Avançar". • Antes de fazer o acerto é gerado um backup de cada arquivo a ser alterado com a terminação #DB. para que os arquivos da empresa sejam compatibilizados com os da nova versão enviada pela MICROSIGA. incluindo. excluindo ou alterando a estrutura dos campos. executar o programa AP609TO710. quando a alteração da NOVA versão for imprescindível para o funcionamento da mesma. Leia sempre as Notas do Release que acompanham as novas versões para conhecer as alterações que serão efetuadas pelo programa de compatibilização e os novos recursos. é apresentada a tela sobre a conclusão do processo. O sistema não exclui campos incluídos pelo usuário em sua base de dados.AP7 Quando se está processando a atualização de versão. desde que todas as alterações tenham sido efetuadas pelo Módulo Configurador. antes de efetuar a Atualização de Versão. Clique no botão “Concluir” para finalizar. É imprescindível que o usuário faça um backup dos seus arquivos de dados (\AP_DATA\DADOSADV). é necessário após a instalação do AP7. O atualizador executa basicamente as seguintes tarefas: • Inclui. Esta prioridade apenas será modificada. antes de qualquer processamento. exclui ou altera o conteúdo dos arquivos customizadores SXs do usuário de acordo com as modificações feitas nos arquivos padrões. Atualização do AP6 . • Acerta as tabelas de dados. dos arquivos customizadores SXs (\AP_DATA\SIGAADV) e seus programas específicos.Conclusão da Instalação Ao final da instalação. Este programa sempre que possível dará prioridade às configurações do cliente. 10 . No campo “Senha”. deve-se migrar as versões progressivamente. digite a senha do Administrador. Antes de iniciar o processo deve-se: • Efetuar o backup dos arquivos dos diretórios “SIGAADV” e “DADOSADV”. digite “AP609TO710”.09. Para executá-lo deve-se: Acesse a pasta “Advanced Protheus 7” ou "AP7" e carregue o AP7 Server. A tela seguinte adverte que apenas o Administrador pode processar a atualização de versão.10. 4.Executando o AP609TO710 Este programa é exclusivo para migração da versão 609 para a 7. Em “Programa Inicial”. 3. Clique no botão “OK” para confirmar. 6. O sistema gera um arquivo de log que pode ser impresso. Se desejar apenas simular a atualização para verificar as alterações a serem processadas e eventuais problemas na base de dados. até obter a versão 6. • Ter espaço em disco de aproximadamente 3 vezes o espaço utilizado pelos diretórios SIGAADV + DADOSADV. clique na caixa de verificação “Simular a Atualização”. não será gravada nenhuma alteração na base. utilizando os atualizadores respectivos. 11 . para que então o AP609TO710 possa ser executado. 5. 1. Será apresentada uma janela com orientações sobre o processo de atualização. Em seguida. 2. Com esta opção ativada. acesse o AP7 Remote. Caso esteja utilizando uma versão anterior. é possível a utilização do dicionário de índices (SINDEX) por empresa. A localização informada será considerada abaixo do diretório raiz definido no AP7SRV. A partir desta versão. Clique no botão “Avançar” para prosseguir. armazenando o valor anterior e o atual. selecione a localização a ser atualizada. Dê um duplo clique sobre o diretório e digite outro caminho. o AP609TO710 criará automaticamente um dicionário de índice para cada empresa cadastrada. 11. 12 . onde serão criadas as novas tabelas de dados referentes as empresas identificadas e relacionadas. Clique no botão “Avançar” para prosseguir. será mantido o arquivo atual compartilhado entre as empresas.INI (\ROOTPATH). Marque os logs desejados. Se a opção "SINDEX exclusivo" for selecionada. No campo "País". se necessário. criação de índices e arquivos temporários. 9. Será apresentada a janela para configuração de execução do AP609TO710.7. como abertura de arquivos. campo a campo. Log de Atualização O Log de Atualização grava todas as alterações que o Atualizador fez na base. 10. 12. observando: Log de Processos O Log de Processos grava todas as operações que o Atualizador realiza. Será apresentada a janela para informação do diretório padrão. Se esta opção não for selecionada. 8. Será apresentada a janela relacionando as tarefas que serão executadas pelo Atualizador. 13. caso seja encontrado um erro crítico.LOG. Log Critical Error O Log Critical Error grava erros críticos que inviabilizam a continuidade do processo de atualização. 17. Esta caixa é selecionada automaticamente. Clique na caixa “Eliminar arquivos de backup ao término da atualização” para excluir automaticamente os arquivos de backup que o Atualizador cria durante o processo. O processo será reiniciado a partir da última tarefa executada.Log de Inclusão O Log de Inclusão grava todos os registros incluídos nos arquivos pelo Atualizador. Clique no botão “Avançar” para prosseguir. o Atualizador corrija automaticamente alguns erros críticos. Log Warning Error Este log grava erros que não impedem o processo de atualização e as correções efetuadas através do Assistente do Atualizador. analisar os logs e executar a Atualização. deve-se interromper ao final de cada processo. pode marcar todas as opções de Logs e também a caixa “Permite interromper processo durante a execução”. Marque a caixa “Permite interromper processo durante a execução” para que ao final de cada processo. Neste caso. não será possível paralisar a Atualização em nenhum momento. novamente. Os logs são gravados no arquivos APUPDATE. o processo de atualização somente poderá prosseguir após a correção do mesmo. 15. 14. Esta caixa é selecionada automaticamente. Se esta caixa não for selecionada. Durante a verificação da integridade. Deve-se optar por limpar o Arquivo de Log para evitar que este fique muito grande. 16. Clique na caixa "Corrigir todos os erros automaticamente" para que durante o processo de análise de integridade. Clique na caixa "Manter o arquivo de log existente" para manter o log ao reiniciar o processo de atualização de versão após uma pausa. Se o usuário desejar saber de todas as alterações processadas. 13 . a Atualização possa ser interrompida. O Atualizador identifica cada processo iniciado e a sua evolução. se for diagnosticado algum "critical error" não previsto. 20. 19. Clique no botão “Avançar” para prosseguir. o processo será interrompido e o administrador terá a possibilidade de analisar o arquivo de log. Durante a verificação de integridade. 18. Atualização das tabelas. este será apresentado com opções para a continuidade ou interrupção do processo.• • • • • Verificação da integridade das bases. Se diagnosticado algum problema na base do cliente. Atualização dos arquivos customizadores – SXs. Atualização dos arquivos de helps. Clique no botão "Consulta Log" para consultar o arquivo de log. 14 . Execução das funções compatibilizadoras. Para mais detalhes sobre a janela de consulta. corrigir o erro e reiniciar a atualização. veja o item "23" mais adiante. o usuário poderá optar por interromper a Atualização. A janela para consulta aos Logs será exibida. será possível verificar o arquivo de log. 23. Se desejar um relatório impresso.21. a empresa e a tarefa. clique no botão “Imprimir”. 22. Se interrompida a Atualização. 15 . clicando no botão “Consulta Log”. caso tenha selecionado esta opção no início da configuração de execução. através do botão "Filtro". Ao final de cada processo. É possível escolher o tipo de evento a ser analisado. Após a interrupção da Atualização. porém serão identificadas as operações já realizadas e o processo será continuado a partir da última tarefa executada. este será o servidor de licenças. 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. No tipo de instalação. Em ambientes com um único servidor AP7.25. 16 . escolher “typical” e fazer a instalação padrão. 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 USB e o driver do HASP instalado. executar o instalador hdd32.exe. Configure a impressão e confirme a emissão do relatório. deve-se: 1. Para cada contrato de manutenção. a MICROSIGA está enviando um Hardlock. será necessário executar novamente o AP609TO710. Instalação Física do hardlock Para instalação física do Hardlock HASP. tgz 3. Iniciar o driver: modprobe parport_pc 6. Descompactar arquivo: tar –xzf hasplinux104nn. 7. Se o acesso for pela porta USB.tgz para um diretório no servidor Linux. 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. 2. é necessário executar o Aplicador de Licenças para fixação das licenças que serão utilizadas. Demais ambientes Unix: Entrar em contato com a Microsiga.o -f O diretório utilizado é o correspondente à versão do kernel. Como executar o Aplicador de Licenças Após a instalação física e do driver HASP. Se não encontrado. usbdefs deve ser montado. Copiar o arquivo \linux\hasp\hasplinux104nn. 17 . utilizar o mais próximo. mount –t usbdefs none /proc/bus/usb 8.No Linux (operações com usuário “root”): 1. Gerar o “device node”: mknod /dev/Hardlock c 42 0 4. Carregar o driver: insmod <diretório_to_driver>/aksparlnx. Carregar o daemon: /hasp/sbin/aksusbd Incluir os comandos 5 a 8 ao script de inicialização. 09 instalada.Executando o Aplicador de Licenças: 1. Escolha o idioma do aplicativo. enviada em um envelope que acompanha o produto. a nova configuração será utilizada na próxima vez que o servidor for iniciado. Se aplicada com sucesso. Neste. Todas as seções descritas a seguir podem ser configuradas no Assistente de Configuração. Na janela "Aplicador de Licenças". caso. 2.INI” da versão 6. utilizando as definições já estabelecidas. • A tela inicial do Assistente será então apresentada. 18 . 3. indique a localização dos arquivos de configuração “. Assistente de Configuração do Servidor • Se existir a versão 6. No menu Iniciar do Windows. são solicitadas as informações que estão descritas na carta com as senhas de liberação de uso do sistema. Caso seja a primeira instalação. será possível importar as suas configurações.09 se quiser editá-los. acesse a pasta "AP7/ Ferramentas/ Aplicador de Licenças". clique no botão "Ignorar". INI que é detalhado a seguir: 19 . a lista de Ambientes. Todas estas configurações se encontram no arquivo AP7SRV.permite adicionar uma configuração de acordo com as informações preenchidas. Por exemplo. 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 cada opção configurável do AP7 Server. Remover .possibilita limpar a lista (excluir) de configurações. É necessário que todos os campos obrigatórios estejam digitados. a ordem conforme ilustrado na tela inicial seria: 1. Servidor Internet Botões das Telas de Configuração • • • • Adicionar . a tela seguinte será referente ao primeiro item selecionado.Fluxo de janelas Ao clicar no botão "Avança" (Next). Balanceamento de Carga 4. Ambientes 2. Limpar . Conexão 3.permite excluir uma configuração. Por exemplo. diretórios e repositório. Este diretório é criado a partir do diretório raiz. Uma seção padrão. 20 . É o diretório inicial de execução do sistema. e opcionalmente as informações para acesso ao TopConnect. O arquivo de log (AP7Trace. RootPath Identifica o diretório raiz do AP7. chamada Environment. os diretórios para trabalho. Estas informações são identificadas para cada conexão. RpoDb Identifica o tipo de base de dados utilizada. cada AP7 Remote que se conectar ao Servidor deve informar qual a seção que deseja utilizar. as informações do idioma. definido na chave anterior. Pode ser DBF. Esta informação é utilizada pelo servidor para definir qual repositório será acessado. a interface e o repositório podem ser obtidos a partir das informações da seção definida. Chave Descrição SourcePath Identifica o diretório onde os repositórios de APOs são mantidos na máquina em que o AP7 Server está instalado. English ou Spanish. 0 (não faz log) FilesOnDemand Indica se durante a abertura dos módulos.Seção Environment As seções Environment contêm as informações dos diretórios de execução do AP7 Server. StartPath Identifica o diretório onde os arquivos de configuração do AP7 se encontram. ou seja. Assim. RpoLanguage Identifica a linguagem que será utilizada. TOP ou BTV. é criada na instalação e utilizada sempre que o AP7 Remote se conectar sem informar uma seção através de parâmetros de linha de comando. a partir do qual todos os diretórios utilizados pelo AP7 serão criados. Trace Indica se deve ser feito o Log de warnings em arquivo. Esta informação também é utilizada pelo servidor para definição do repositório a ser acessado. o idioma.Abre arquivos por demanda. 0-Abre os arquivos a partir do menu. Valores possíveis: 1 (faz log). Pode ser Portuguese. ADS. AP7 ou anterior). O valores possíveis são: 1. RpoVersion Identifica a versão do produto (AP6. interface. AdsShare Indica o diretório compartilhado onde está instalado o servidor ADS.log) será criado no diretório “\Bin”. o sistema irá efetuar a abertura pelo menu (padrão) ou por necessidade (abre e fecha arquivos conforme utilização). Este diretório é utilizado para fazer a conexão ao servidor ADS. (padrão \RELATO\).EMP. 1024. Pode ser: ISAM padrão DBF.LocalFiles Localdbextension Indica qual é a base de dados que será utilizada para abertura dos arquivos locais. com exceção do SIGAMAT. 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. onde o agendador de relatórios e o WebSpool executarão suas tarefas de relatórios assíncronos. ADS ou ADSServer. com exceção do SIGAMAT. Quando Versão Btrieve ou cTree: • Sindex • SXs (com exceção do SX5) Arquivos de Trabalho Valores válidos: Devem iniciar com ponto e 3 caracteres adicionais válidos para extensão de arquivo no SO utilizado.nome do equipamento onde for feita a conexão. a porta e o ambiente. DEFAULT . Define qual será a extensão default dos arquivos ISAM para os Drivers DBFCDX.EMP.dbf Define o diretório (ligado ao RootPath) onde serão gravados os relatórios armazenados para visualização pelo WebSpool. DBFCDXAX. Default: . Quando Versão ADS: Todos os arquivos ISAM. Default= definido no parâmetro MV_RELDIR. MyEnvironment Define o Servidor. 21 WSPLReldir WSplServer . Ex: WSPReldir=\WebRelato\ Ex: WsplServer= MyServer. Server Identifica o nome ou o endereço IP do servidor do TopConnect. acrescentando “TOP” no início da chave: 22 . sempre que for um arquivo Btrieve. AS/400. INFORMIX e outros). esta chave indica onde devem ser criados e abertos todos os arquivos. como detalhado anteriormente.HelpServer Para environment Btrieve: BTVPATH=\\ServidorBTV\dados Quando a versão do Btrieve é Server (Ex: PervasiveSQL2000).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 do TopConnect. Valores possíveis: TCPIP. NPIPE ProtheusOnly Se esta chave também estiver ativada no TopConnect. Valores válidos: 0 ou 1 Default = 0 (desligado) PORT Porta do listener do Topconnect (válido para versão 4. a não ser que estejam definidas no environment das conexões. Deste modo. ConType Protocolo de comunicação para o TopConnect. As informações desta seção são utilizadas para todas as conexões. em conexão TCPIP) Default = 798 Opcionalmente. a conexão a este somente poderá ser feita pelo AP7.0 ou superior.com.: HELPSERVER = servidor. Chave Descrição DataBase Identifica o nome do DataBase que deve ser utilizado para acesso via TopConnect à base de dados (MSSQL. pode-se colocar estas 6 chaves no environment. Define o endereço do servidor HTTP de help on-line. o sistema ignora o caminho descrito no SX2 e utilizará o que estiver definido nesta chave. MSSQL7. SYBASE. Alias Identifica o alias utilizado no TopConnect para acesso à base de dados. Ex. ORACLE. Conteúdos possíveis = 0.Ano) FilesOnDemand Esta chave é aplicada apenas se o RpoDb for DBF. Seu objetivo é fazer com que o sistema faça a abertura somente dos arquivos indispensáveis. AMERICAN DEFAULT = Default (Dia.dll (para versões anteriores à 4.1 DEFAULT = 0 PictFormat Esta chave permite a criação de environments com composição de data no formato "mês. Caso o conteúdo seja 1. caso utilizar esta característica basta informar AMERICAN nesta chave.dll (para versão 4.0) • topapi40. no caso de quebra ou perda do aparelho do Administrador do Sistema.Mês.dll JumpSenhap Esta chave permite que o responsável da rede altere a segurança imposta pelo Senhap. ano" .Exemplo: [environment] TOPDataBase=MSSQL7 TOPServer=Pesquisa3 TOPALIAS=TOPsql TOPcontype=NPIPE TOPPort=5082 TOPProtheusOnly=1 TOPdll=topapi32.1 DEFAULT = 0 23 . dia.dll Define a versão Client do TopConnect utilizado. o Sistema apresenta uma advertência sobre a abertura da segurança e permitir acesso ao sistema. Conteúdos Possíveis = DEFAULT. Conteúdos possíveis = 0. Valores válidos: • topapi32.0) Default = topapi32. no caso de não haver respostas. Port Identifica a porta que será utilizada para as comunicações via TCP-IP. Pode-se criar diversas seções com as conexões utilizadas. 24 . Seções Protocolos de Conexão O AP7 Server pode se utilizar do protocolo TCP-IP para realizar a conexão com os terminais.). Chave Descrição Inactive Timeout Determina o tempo de espera até a queda da conexão. A configuração do protocolo utilizado é efetuada através de seções com as chaves definindo informações como a porta de conexão. deve-se informar o nome. o serviço e o tipo da conexão. Chave Descrição Active Identifica os nomes das seções de configuração de protocolos ativos. separados por vírgula e na seqüência de busca desejada.Drivers A seção Drivers define quais os protocolos de conexão poderão ser utilizados para que os terminais conectem-se ao AP7 Server. Mais de uma seção pode ser informada separando-as por uma vírgula (. Chave Descrição Servers Especificar os nomes das seções que contêm as informações dos servidores. As conexões ativas. que podem ser utilizadas pelos terminais para se conectar ao Servidor. desse modo permitindo que existam conexões de terminais ao servidor efetuadas através de diferentes protocolos. ou seja. o tipo de conexão (TCP). a porta ou serviço e o número de conexões permitidas. Dentro de cada nova seção de servidor. 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. são aquelas cujos nomes de seções estão definidos na chave Active descrita anteriormente. 25 . RPCServer Nome da seção que indica a conexão do servidor para processamentos. RPCEnv Nome do Environment usado para a conexão. pode fornecer páginas em html para um Browser. Ex: C:\AP7\http Port Número da porta utilizada para a conexão http. ou seja. RPCTimeout Tempo limite para nova tentativa de conexão. Chave Descrição Enable 1=Ligado e 0=Desligado Path Local onde será o diretório raiz para as páginas.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 HTTP Esta seção permite ao AP7 Server atuar como Servidor Http (Protocolo Internet). Chave Descrição Jobs Informe o(s) nome(s) de seção(ões) para executar funções. pode-se determinar a execução de uma função (Sem interface) logo após o acesso ao Server. Port Define o número da porta de conexão FTP. Chave Descrição Enable 1=Ligado e 0=Desligado Path Diretório raiz para os arquivos de FTP.FTP Esta seção permite ao AP7 Server atuar como Servidor FTP (Protocolo Internet). pois permite ao usuário informar nomes diferentes.JOB2 [JOB1] Main=RecalcJur() Environment=Envtop [JOB2] Main=GetProdAtu() Environment=Environment Service Utilize esta seção para informar o nome interno e externo do Serviço do AP7 Server no Windows NT. Ex: [ONSTART] Jobs=JOB1. Ex: C:\AP7\FTP. 26 . Esta opção é útil quando for necessário utilizar mais de um AP7 Server rodando como serviço na mesma máquina. Chave Descrição Name Nome interno do Serviço Displayname Nome a ser exibido na janela de serviços do Windows NT. ONSTART Nesta seção. Valores válidos: 0 ou 1 Default= 0 (desligado) 27 .78 (ou TopDataBase=MSSQL7 [TopConnect] DataBase=MSSQL7 Server=172.16.1. A diferença 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.A seguir é apresentado um exemplo do arquivo de configurações do AP7 Server. Chave Descrição Enable : Indica se o servidor AP7 será um servidor de Licenças. onde pode-se visualizar dois Environments diferentes: EnvDbf e EnvTop.13 ALIAS=TOPPROTHEUS Contype=TCPIP [Drivers] Active=TCP [TCP] TYPE=TCPIP Port=1024 nome do Servidor Top) LicenseServer A seção LicenseServer contém as informações sobre o Servidor de Licenças.16.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 um Servidor de Licenças. Valores válidos: 0 ou 1 Default= 1 .16.: [LicenseClient] Server=192.01.12 Port=5555 Cuidado!: A porta de conexão entre o AP7 Server e o servidor de licenças não pode ser a mesma utilizada entre o AP7 Server e o AP7 Remote. Chave Descrição Server : É o nome ou número IP do computador onde está o Servidor de Licenças. deve ser o mesmo valor da chave “Port” na seção “LicenseServer” do servidor de Licenças. Portanto. Port: Identifica a porta que será utilizada para a comunicação entre o servidor AP7 e o Servidor de Licenças. Esta chave permite o controle de requisições e liberações de licença e semáforos através de mensagens na tela de console. Ex.Port: ShowStatus Identifica a porta que será utilizada para a comunicação entre o Servidor de Licenças e os servidores AP7. 28 . Valores válidos: 2.100 29 . 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. No formato: NOME@MÁQUINA.11 CtreeServer A seção CtreeServer contém as informações sobre o Servidor Ctree.16.11 Default= 6. Uma vez selecionado o modo através desta chave todos os ambientes deverão utilizá-lo da mesma forma. onde “MÁQUINA” pode ser o nome da máquina no Windows ou o IP nas demais plataformas. aquelas que são comuns para todos os ambientes. Chave Descrição ctuserid: 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.0. Ex: [CtreeServer] ctuserid = ADMIN ctuserpass = ADMIN ctservername = FAIRCOMS@172. Chave Descrição CtreeMode: Indica se o Ctree será utilizado em modo Local ou Servidor.General A seção General contém as informações globais sobre o Servidor AP7.50 e 6. utilizando TCP-IP. SIGAFIN. A diferença é que as seções aqui informadas (que devem ser separadas por vírgulas) são utilizadas em tentativas de conexão. de modo que pode-se manter diferentes conexões em um mesmo servidor.INI que se encontra no diretório de execução do AP7 Remote: Seção Config Identifica informações gerais de configuração do AP7 Remote. 30 . devese ter o RPO no idioma requerido. Cada uma destas redes mantém um AP7 Server para o processamento distribuído. Para uma tradução geral. via modem ou Internet. Estas configurações são mantidas no arquivo AP7RMT. para ser executado automaticamente. Drivers A seção Drivers define quais os protocolos podem ser utilizados para que o Terminal conecte-se ao AP7 Server. Language Define o idioma utilizado para exibir as mensagens do AP7 Remote.Configurando o AP7 Remote As configurações do AP7 Remote também podem ser customizadas. Twotier Informa se deve procurar o AP7 Server na máquina local. • Diferentes redes conectadas via linha privada. de acordo com a ordem em que foram informadas. 3 = Inglês. para ativar especificar 1. É igual a seção de mesmo nome no arquivo de configurações do AP7 Server. É o APO que inicia a execução. 1 = Português. etc. Apenas as mensagens originadas do AP7 Remote são afetadas. SIGAEST. pode-se iniciar do SIGAADV. Chave Descrição LastMainProg Contém a lista dos últimos programas iniciais executados no AP7 Remote. Default = 0. Por exemplo: • Uma rede local com conexões via Named Pipes e algumas outras conexões remotas. 2 = Espanhol. Por exemplo. 31 . Não necessitam ter o mesmo nome que o definido no AP7 Server. a porta informada na chave Port deve ser a mesma configurada em ambos. AP7 Server e AP7 Remote. Ex: [c:\arquivos de programas\AP7]\bin\server\AP7srv. 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. porém as informações devem ser as mesmas e.exe – install. somente os protocolos definidos na chave Active da seção Drivers do arquivo de configuração do AP7 Server. • Para execução remota.INI. bem como a porta para comunicação.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ções do AP7 Server. será exibida a seguinte tela solicitando o nome ou IP do Servidor. Do mesmo modo. podem ser utilizados quando estiver configurando o 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 do executável do Server. Notas: • Para a execução local (AP7 Server e AP7 Remote executados na mesma máquina) pode-se informar: Server = LocalHost. Caso não exista o arquivo AP7RMT. As opções de linha de comando do AP7 Remote são: • -Q (Quiet): Indica que o AP7 Remote não deve mostrar o Splash (imagem de apresentação) e a tela de identificação de parâmetros iniciais necessita ser acompanhada da cláusula –P. -P (Main Program): Identifica o programa (APO) inicial. o AP7 Remote exibe a tela de parâmetros iniciais. impossibilidade de conexão). -A (Parâmetros para o Programa Inicial): Identifica um parâmetro que será passado para o programa inicial. tais informações podem ser informadas através da linha de comando do ícone de acesso ao AP7 Remote. Este arquivo tem o nome definido pela identificação do executável (AP7Rmt) + um caracter de underline (_) + o nome da máquina em que o AP7 Remote está sendo executado (com extensão .Parâmetros da Linha de Comando do AP7 Remote Ao ser iniciado. pode-se utilizar a seguinte linha de comando: AP7RMT. da Conexão e do APO inicial. -L (AP7 Remote Log File): Para não-conformidades que ocorram no AP7 Remote (antes que este possa se conectar ao AP7 Server). Porém. é gerado um arquivo de log no diretório de execução deste aplicativo.INI do Server que será utilizada para definições gerais. para identificação do Ambiente. visando automatizações específicas que necessitem saber quando uma não-conformidade ocorreu no AP7 Remote (por exemplo. Esta opção permite informar um nome específico para a geração deste arquivo de log.EXE –Q –P=SIGAEST –E=ENV_TOP_ENGLISH • • • • • • • para executar o módulo SIGAEST em uma base de dados utilizando o idioma inglês. -E (Environment): Nome da seção de environment no . Por default é “Config”. Por exemplo. -R (CfgSection): Nome da seção de configuração.LOG). 32 . -C (Connection): Nome da seção de conexão que será utilizada para a conexão ao AP7 Server. -M (AllowMultiSession): Permite múltiplas instâncias (Cópias) do AP7 Remote na mesma máquina (Default: não permite). 33 . o tráfego de rede ou os recursos individuais das máquinas existentes. o que torna o processamento distribuído. Essa é uma das grandes vantagens da tecnologia AP7. a tecnologia AP7 permite montar o ambiente de execução com diferentes topologias.Topologia de Utilização de Rede do AP7 Devido à sua divisão em camadas. priorizando a execução. ou seja. o AP7 Server pode ser executado no provedor ou na empresa utilizando uma LP para a conexão ao provedor de acesso. A definição da melhor topologia para execução é um passo importante da implementação da tecnologia AP7. Neste caso. • Um AP7 Server pode estar na mesma máquina que o gerenciador de banco de dados. dependendo do tipo e da velocidade da conexão. • Pode-se manter uma página para o download do AP7 Remote. Por outro lado. Por isso. é aconselhável que o servidor Web não seja o mesmo servidor da base de dados. pois influencia totalmente a performance. já que o tráfego entre o AP7 Server e o AP7 Remote contém somente informações para montagem de telas e controle de teclado e mouse. Além da segurança oferecida pelo sistema Advanced. caso existam muitas conexões nesta outra cidade. a segurança deve ser oferecida pela conexão. ou caso estas conexões executem processamentos pesados. mas aumenta o tráfego de rede entre o gerenciador de banco de dados e o AP7 Server. pode-se executar servidores remotamente. pode se tornar inviável manter um AP7 Server em uma cidade conectado ao banco de dados em outra. Desta forma. priorizar o processamento disponibilizando um AP7 Server para ser executado localmente nesta cidade pode ser uma boa solução. a conexão TCP-IP entre o AP7 Remote e o AP7 Server.Características e Possibilidades de Topologias de Rede • Pode-se manter um ou mais servidores de aplicação do AP7 (AP7 Server). • As conexões devem ser efetuadas através do protocolo TCP-IP . 34 . • 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 UOL e o ZAZ). priorizando o processamento. • A Internet é utilizada apenas como o meio de comunicação. • Máquinas melhores ou com mais recursos podem ter um AP7 Server executando localmente. • Do mesmo modo. O maior tráfego de rede está localizado entre o AP7 Server e o Banco de Dados. de modo que os usuários remotos possam efetuar o download para conectar-se e utilizar o sistema. Isto prioriza o processamento local. crie o mapeamento a ser utilizado pelo AP7 (recomenda-se a criação de drive específico para o sistema) Ex. edite o arquivo AP7SRV. 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 . • Na estação a partir da qual está sendo instalado o sistema. edite o arquivo AP7RMT.INI e. faça a cópia idêntica da árvore de diretórios criada pela instalação no disco local. troque a unidade de disco para direcionar o novo local. faça a instalação do sistema em unidade de disco local. Segue um roteiro para a instalação e configuração do sistema: • A partir de uma estação qualquer. coloque o parâmetro Server igual a LocalHost.INI (localizado no diretório AP7\BIN). na seção TCP. • Na unidade rede. • No diretório AP7\BIN. na seção Environment. o parâmetro TWOTIER=1. I:. • No diretório AP7/BIN.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. [TCP] TYPE=TCPIP Server=SERVIDOR Port=1024 [TCP] TYPE=TCPIP Server=LOCALHOST Port=1024 • Acrescente na seção [CONFIG] do arquivo AP7RMT.INI e. ou seja. 36 . desinstale o AP7 do drive local. Ex. Ex: ADSShare = \\servidor_ads\adsshare 3. Atenção ao executar este passo. Ex: RootPath=\\servidor_ads\AP7\ LocalFiles deve ser ADSSERVER ADSSHARE: diretório no servidor ADS compartilhado full para o usuário do AP7. Se o AP7 estiver rodando como serviço. (A letra para definir a unidade tem que ser a mesma). tabelas. locks.• • Crie.EXE localizado no diretório \BIN do sistema. O AP7 faz duas conexões no ADS por usuário e por isso. O uso do AP7 em redes Novell com a topologia acima exige uma modalidade Fat Client. etc. Configuração do AP7SRV. Crie nas estações. • Observações: Instalação do ADS e configuração: 1. ícone de acesso para o AP7RMT. pois erros implicarão em problemas no Registro do Windows. Teste o acesso do sistema nas estações. Sugerimos que se crie um diretório vazio na raiz do Servidor ADS e o compartilhe. acrescentar uma senha de administrador ao serviço. cada estação efetua seu processamento e o tráfego de dados na rede cresce consideravelmente quando comparado às instalações convencionais em redes NT. Este diretório é apenas utilizado para a conexão do AP7 com o Servidor ADS. o número de conexões deve ser o dobro do número de usuários. I:\AP7\BIN\AP7RMT. Número máximo de usuários. 2. caso tudo esteja funcionando corretamente e não seja necessária uma aplicação AP7 para testes. em todas as estações que utilizarão o sistema.EXE. o “RootPath” será um endereço na rede. um mapeamento idêntico ao da estação que fez a instalação e cópia.INI Os dados devem estar na máquina onde o ADS foi instalado e por isso.