Professional Documents
Culture Documents
Cuidados a serem tomados ........................................................... 9 Diretrio de Instalao do AP6 Server .......................................... 12 Atualizao/Primeira Instalao ................................................... 13 Idioma do Sistema/Base de Dados Utilizada ................................ 14 Espao Utilizado .......................................................................... 15 Processo de Instalao ............................................................... 15 Concluso da Instalao .............................................................. 16
Instalando o AP6 Remote (Windows) ........................................................ 17
Diretrio de Instalao ................................................................. 19 Espao Utilizado .......................................................................... 20 Processo de Instalao ............................................................... 21 Concluso da Instalao .............................................................. 21
Atualizao do Advanced Protheus ........................................................... 22 Executando o AP508TO609 .................................................................. 23 Desinstalando o AP6 .................................................................................. 34
AP6 IDE - Integrated Development Environment .................................. 62 AP6 Monitor ........................................................................................... 63 AP6 Dump ............................................................................................. 63 APSDU .................................................................................................. 63 Conversor SQL ...................................................................................... 64 Algumas mensagens .................................................................................. 64
Servidor de Aplicao
O AP6 Server a aplicao encarregada da compilao e da execuo do cdigo em ADVPL, no qual o Advanced Protheus est escrito. Na linguagem ADVPL, as rotinas so mantidas em APOs (Advanced Protheus Objects) individuais repositrios. Isso permite que as rotinas sejam carregadas e descarregadas dinamicamente da memria da mquina, onde o Servidor est sendo executado, ou seja, de acordo com a necessidade de execuo dos Terminais conectados, e isto facilita a atualizao aps correes de no-conformidades ou criao de melhorias, pois apenas os APOs modificados necessitam ser atualizados. Deste modo, a performance alta e no requer muito da mquina para a execuo do servidor.
Instalao - Advanced Protheus 6.09 - 3
O Terminal Thin-Client
O AP6 Remote a aplicao encarregada da interface com o usurio. No existe processamento local, por isso o trfego de rede entre o Terminal e o Servidor de Aplicao baixo, tratando-se apenas de comandos para o desenho das telas e do tratamento do teclado e mouse.
Os Dados
O acesso aos dados efetuado pelo Servidor de Aplicao atravs do ISAM padro DBF ou ADS Server (para padro DBF), do TopConnect (para padro SQL), Ctree ou Btrieve. Para bases de dados SQL, existe total suporte a Stored Procedures. Na verso AP6, todas as bases de dados tm suporte a controle de transao, inclusive a base de dados padro DBF, graas ao ISAM padro DBF e o ADS Server .
O repositrio de APOs
Nesta parte do sistema que esto os programas ADVPL a serem executados para a execuo do sistema ERP. atravs do repositrio de APOs que podemos incluir novas customizaes no sistema.
\AP6 (Ncleo)
Diretrio onde armazenado o ncleo (kernel) do AP6. Toda a parte de tecnologia AP6.
\AP6\APO
Diretrio onde so encontrados os repositrios de APOs.
\AP6\BIN\SERVER
nele que so encontrados os arquivos executveis, dlls e arquivos de configurao do sistema que devem ser executados no Servidor.
AP6\BIN\REMOTE
nele que so encontrados os arquivos executveis, dlls e arquivos de configurao do sistema para acesso ao Client.
\AP_DATA\PATCHDAT
Contm o dicionrio de dados em formato TXT, responsvel pela gerao dos arquivos customizadores (SXs), conforme a localizao de pas definida pelo usurio na entrada do sistema.
\AP_DATA\SIGAADV
Contm os arquivos de menus e os customizadores (SXs) gerados a partir do PATCHDAT.
\AP_DATA\DADOSADV
Contm a base de dados do cliente.
\AP_DATA\RELATO
Neste diretrio so gravados os relatrio gerados em disco.
\AP_DATA\CPROVA
Neste diretrio so gravados os arquivos de contabilizao.
\AP_DATA\IXBPAD
Neste diretrio esto os programas de exemplo e arquivos ADVPL padres da Microsiga.
\AP_DATA\INCLUDE
Aqui esto as bibliotecas necessrias para a compilao de programas ADVPL. Vale lembrar que esta estrutura refere-se a uma instalao padro do Advanced Protheus, podendo haver variaes.
AP6Remote (AP6Rmt.exe) o Remote que utilizamos para interagir com todo o sistema, ele pode ser instalado de duas maneiras, no servidor ou na prpria estao de trabalho.
AP6IDE (AP6Ide.exe) Trata-se do ambiente de desenvolvimento do Advanced Protheus, atravs deste aplicativo que vamos fazer todos os acessos aos repositrios de APOs (compilao de customizaes, visualizao de funes existentes etc.), alm de depurar programas customizados.
AP6Monitor (AP6Monit.exe) Atravs do AP6Monitor podemos interagir com os usurios conectados ao sistema. Analisar os programas em uso, derrubar conexes pendentes, enviar mensagens ao usurios etc.
A definio dos nomes dos arquivos dos repositrios de APOs e Patch seguem o mesmo padro (diferenciando-se apenas a extenso Patch=.PAT e repositrio=.RPO), sendo efetuada da seguinte maneira AP12345.RPO: 1 (D)bf, (T)op, (A)ds, (B)trieve, (C)tree; 2 (P)ortuguese, (E)nglish, (S)panish; 3 Verso; 4 Verso; 5 Verso. Por exemplo, APTP609.RPO ser um repositrio de APOs para base de dados Top Connect, idioma Portugus e verso 609.
Instalao do AP6
No Windows: Coloque o CD-ROM no drive e aguarde a exibio da tela de abertura conforme a seguir.
1. Na parte inferior da tela, so apresentadas as bandeiras referentes aos idiomas disponveis para instalao do Advanced Protheus. Clique no cone correspondente ao idioma que deseja utilizar. 2. Clique no Ambiente Operacional que ser utilizado: Windows ou Linux. 3. De acordo com o ambiente selecionado ser apresenta a janela com as opes dos aplicativos para instalao.
Windows
Instalao do AP6 Server Instalao do AP6 Remote Instalao do TopConnect (Consulte o captulo "Sobre o Top Connect").
Linux
4. Clique na opo AP6 Server. Como o AutoRun executado a partir de um browser, ser solicitada a confirmao de download do Instalador. Confirme este processo, clicando em "Executar" ou "Abrir". O Install Shield ser iniciado. A janela de Bem-Vindo apresentada.
Indique o caminho onde o AP6 Server deve ser instalado (arquivos binrios, kernel). 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, se diminui o risco de erros em eventuais desinstalaes do sistema
Atualizao/Primeira Instalao
Caso seja uma Atualizao de Verso, informe o diretrio onde est instalada a verso 5.08 do Advanced Protheus. Aps a instalao, este diretrio ser renomeado para AP_DATA e ir conter os arquivos para atualizao da verso 5.08 para 6.09, alm de todos os dados anteriores. importante, antes de iniciar a atualizao, fazer backup das bases de dados, arquivos customizadores e de configuraes, menus e RdMakes especficos. Aps a instalao, atualize os atalhos de acesso ao AP6 Server e Remote para o novo caminho e execute o programa Assistente de Configurao para importar o arquivo de configurao .INI.
Caso seja a Primeira Instalao - indique o caminho onde os arquivos de dados do AP6 devem ser gravados.
Nesta tela, deve-se selecionar: 1. O pas para instalao do arquivo "SXS<pas>.TXT". Este arquivo gravado no diretrio \AP_DATA\PATCHDAT, sendo responsvel pela criao dos dicionrio de dados e demais arquivos especficos para pas selecionado. 2 Os tipos de repositrios disponveis no Advanced Protheus: TopConnect (Integrado com todos os tipos de banco de dados disponveis para esta aplicao), Ads Server (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 AP6Server e cpia do repositrio correto, possvel fazer com que a mesma instalao do Advanced Protheus utilize dois tipos de base de dados. 3. O idioma do RPO a ser instalado. Clique no boto Avanar para prosseguir.
Espao Utilizado
Esta tela apresenta os espaos reservados para a instalao dos componentes do AP6. Clique no boto Avanar para prosseguir.
Processo de Instalao
Concluso da Instalao
Ao final da instalao, apresentada a tela sobre a concluso do processo. recomendada a reinicializao do computador para que os arquivos sejam corretamente atualizados. Clique no boto Concluir para finalizar. No Linux, pode ser necessrio alterar a permisso de execuo do AP6 Server. Para isto, basta utilizar o comando "chmod 700" no diretrio onde o mesmo est instalado, por default "/opt/ap6/bin/server".
1. Na parte inferior da tela, so apresentadas as bandeiras referentes aos idiomas disponveis para instalao do Advanced Protheus. Clique no cone correspondente ao idioma que deseja utilizar. 2. Clique no Ambiente Operacional "Windows". Ser apresenta a janela com as opes dos aplicativos para instalao.
Instalao do AP6 Server. Instalao do AP6 Remote. Instalao do TopConnect (Consulte o captulo "Sobre o Top Connect").
3. Clique na opo AP6 Remote. O Install Shield ser iniciado. A janela de Bem-Vindo apresentada.
Diretrio de Instalao
Indique o caminho onde o AP6 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, se diminui o risco de erros em eventuais desinstalaes do sistema
Espao Utilizado
Esta tela apresenta os espaos reservados para a instalao dos componentes do AP6 Remote. Clique no boto Avanar para prosseguir.
Processo de Instalao
Concluso da Instalao
Ao final da instalao, apresentada a tela sobre a concluso do processo. recomendada a reinicializao do computador para que os arquivos sejam corretamente atualizados. Clique no boto Concluir para finalizar.
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.
Executando o AP508TO609
Este programa exclusivo para migrao da verso 508 para a 6.09. Caso esteja utilizando uma verso anterior, deve-se migrar as verses progressivamente, utilizando os atualizadores respectivos, at obter a verso 5.08, para que ento o AP508TO609 possa ser executado.
Para execut-lo deve-se: 1. Acesse a pasta Advanced Protheus 6 e carregue o AP6 Server. 2. Em seguida, acesse o AP6 Remote.
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.
5. Com estas etapas concludas, clique na caixa de verificao Aceito as instrues acima descritas e confirme a operao.
A tela seguinte adverte que apenas o Administrador pode processar a atualizao de verso.
6. No campo Senha, digite a senha do Administrador. 7. 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. 8. No campo "Pas", selecione a localizao a ser atualizada.
9. 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 AP6SRV.INI (\ROOTPATH). 11. Clique no boto Avanar para prosseguir. Ser apresentada a janela para configurao de execuo do AP508TO609.
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.
Log de Incluso
O Log de Incluso grava todos os registros includos nos arquivos pelo Atualizador. selecionado 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. Somente sero indicados neste arquivo. Os logs so gravados no arquivos AP08TO09.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 atualizao executada.
recomendvel que esta caixa seja marcada, caso contrrio, 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. O boto Consulta arquivo de log pode ser utilizado sempre que a atualizao for interrompida para saber os processos j concludos. 17. Clique no boto Avanar para prosseguir. Ser apresentada a janela relacionando as tarefas que sero executadas pelo Atualizador.
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. Ser apresentada a janela para iniciar a Atualizao.
19. Clique no boto Ok para prosseguir. O Atualizador identifica cada processo iniciado e a sua evoluo.
20. Se diagnosticado algum problema na base do cliente, este ser apresentado com opes para a continuidade ou interrupo do processo.
21. 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 "Visualizar" para verificar o arquivo de log. Para mais detalhes sobre a janela de consulta, consulte o item "24" mais adiante.
22. Ao final de cada processo, o usurio poder optar por interromper a Atualizao, caso tenha selecionado esta opo no incio da configurao de execuo.
23. Se interrompida a Atualizao, ser possvel verificar o arquivo de log, clicando no boto Visualizar.
possvel escolher o tipo de evento a ser analisado, a empresa e a tarefa. 25. Se desejar um relatrio impresso, clique no boto Imprimir.
26. Configure a impresso e confirme a emisso do relatrio. Aps a interrupo da Atualizao, ser necessrio executar novamente o AP508TP609, porm sero identificadas as operaes j realizadas e o processo ser continuado a partir da ltima tarefa executada.
Desinstalando o AP6
A desinstalao do AP6 pode ser feita da seguinte forma:
Linux
Execute o Linux em ambiente grfico (KDE, GNOME, etc). Execute o seguinte programa: /opt/ap6/_uninst/uninstall (localizao padro)
Windows
Acesse o Painel de Controle. Selecione "Adicionar ou Remover Programas". Selecione "Advanced Protheus 6" e clique em "Adicionar/ Remover". O Install Shield ser iniciado. A janela de Bem-Vindo apresentada.
Localizao
Esta janela apresenta a localizao do Advanced Protheus 6 para desinstalao. Clique no boto Avanar para prosseguir.
Processo de Desinstalao
Concluso da Desinstalao
Ao final do desinstalao, apresentada a tela sobre a concluso do processo. Clique no boto Concluir para finalizar.
Adslocal.cfg: Semelhante ao arquivo AXS.CFG de instalaes do Ads em redes Netware, este arquivo permite diversas configuraes como nmero de usurios, nmero mximo de tabelas a serem abertas, nmero de Workareas disponveis entre outros (Este arquivo s utilizado para instalaes que possuam o parmetro LOCALFILES=ADS no arquivo AP6Srv.ini). AP6Ide.cfg: Aqui ficam guardadas todas as configuraes de comunicao feitas no AP6Ide (No deve ser alterado manualmente).
Indique a localizao dos arquivos de configurao ".INI" da verso 5.08 se quiser edit-los, utilizando as definies j estabelecidas. A tela inicial do Assistente ser ento apresentada.
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
De acordo com as opes selecionadas sero apresentadas as respectivas janelas de configurao para cada opo configurvel do AP6 Server. Todas estas configuraes se encontram no arquivo AP6SRV.INI que detalhado a seguir:
Seo
Environment
As sees Environment contm as informaes dos diretrios de execuo do AP6 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 AP6 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 AP6 Remote se conectar sem informar uma seo atravs de parmetros de linha de comando. Chave SourcePath Descrio Identifica o diretrio onde os repositrios de APOs so mantidos na mquina em que o AP6 Server est instalado. Identifica o diretrio raiz do AP6, a partir do qual todos os diretrios utilizados pelo Advanced Protheus sero criados. Identifica o diretrio onde os arquivos de configurao do Advanced Protheus se encontram. o diretrio inicial de execuo do sistema. Este diretrio criado a partir do diretrio raiz, definido na chave anterior.
RootPath
StartPath
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. 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.
RpoLanguage
RpoVersion AdsShare
Identifica a verso do Advanced. 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 (AP6Trace.log) ser criado no diretrio \Bin. Valores possveis: 1 (faz log), 0 (no faz log)
FilesOndDemand 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. LocalFiles Indica qual a base de dados que ser utilizada para abertura dos arquivos locais. Pode ser: ISAM padro DBF, ADS ou ADSServer.
Localdbextension Define qual ser a extenso default dos arquivos ISAM para os Drivers DBFCDX, DBFCDXAX. So definidos como arquivos ISAM: Quando verso TopConnect:
42 - Instalao - Advanced Protheus 6.09
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 WSPLReldir Define o diretrio (ligado ao RootPath) onde sero gravados os relatrios armazenados para visualizacao pelo WebSpool. Default= definido no parmetro MV_RELDIR, (padro \RELATO\). Ex: WSPReldir=\WebRelato\ WSplServer 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. 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.
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 DataBase Descrio 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). Identifica o nome ou o endereo IP do servidor do TopConnect. Identifica o alias utilizado no TopConnect para acesso base de dados. Protocolo de comunicao para o TopConnect. Valores possveis: TCPIP, NPIPE Se esta chave tambm estiver ativada no TopConnect, a conexo a este somente poder ser feita pelo Advanced Protheus. 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: 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 permitire o acesso ao sistema. Contedos possiveis = 0,1 DEFAULT = 0 PictFormat Esta chave permite a criao de environments com composio de data no formato "ms, dia, ano" , caso utilizar esta caracteristica basta informar AMERICAN nesta chave. Contedos Possiveis = 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
Drivers
A seo Drivers define quais os protocolos de conexo podero ser utilizados para que os terminais conectem-se ao AP6 Server. Chave Active Descrio 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.
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 Servers Descrio Especificar os nomes das sees que contm as informaes dos servidores, separados por vrgula e na sequncia de busca desejada. Dentro de cada nova seo de servidor, devese informar o nome, o tipo de conexo (TCP), a porta ou servio e o nmero de conexes permitidas. Exemplo: [ServerNetwork] Servers=SERVER1,SERVER2 Masterconnection=0 (Default ligado) Informa que o master no ira 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 AP6 Server atuar como Servidor Http (Protocolo Internet), ou seja, pode fornecer pginas em Html para um Browser. Chave Enable Path Descrio 1=Ligado e 0=Desligado Local onde ser o diretrio raiz para as pginas. Ex: C:\AP6\http Port RPCTimeout RPCEnv RPCServer Nmero da porta utilizada para a conexo http. Tempo limite para nova tentativa de conexo. Nome do Environment usado para a conexo. Nome da seo que indica a conexo do servidor para processamentos.
FTP
Esta seo permite ao AP6 Server atuar como Servidor FTP (Protocolo Internet). Chave Enable Path Port Descrio 1=Ligado e 0=Desligado Diretrio raiz para os arquivos de FTP. Ex: C:\AP6\FTP. 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 Jobs Descrio 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 AP6 Server no Windows NT. Esta opo til quando for necessrio utilizar mais de um AP6 Server rodando como servio na mesma mquina, pois permite ao usurio informar nomes diferentes. Chave Name Displayname Descrio Nome interno do Servio Nome a ser exibido na janela de servios do Windows NT.
A seguir apresentado um exemplo do arquivo de configuraes do AP6 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:\AP6\APO\ RootPath=C:\AP6 StartPath=\SIGAADV RpoDb=Dbf RpoLanguage=Portuguese RpoVersion=609 IncludePath=C:\AP_DATA\INCLUDE x2_path= ( No modificar o valor desta chave ) [EnvTop] SourcePath=C:\AP6\APO\ RootPath=C:\AP6 StartPath=\SIGAADVTOP RpoDb=Top RpoLanguage=English RpoVersion=609 IncludePath=C:\AP_DATA\INCLUDE x2_path= ( No modificar o valor desta chave ) TopServer=172.16.1.78 (ou nome do Servidor Top) TopDataBase=MSSQL7 [TopConnect] DataBase=MSSQL7 Server=172.16.1.13 ALIAS=TOPPROTHEUS Contype=TCPIP
Estas configuraes so mantidas no arquivo AP6RMT.INI que se encontra no diretrio de execuo do AP6 Remote:
Seo
Config
Identifica informaes gerais de configurao do AP6 Remote. Chave LastMainProg Descrio Contm a lista dos ltimos programas iniciais executados no AP6 Remote. o APO que inicia a execuo. Por exemplo, pode-se iniciar do SIGAADV, SIGAFIN, SIGAEST, etc. Informa se deve procurar o AP6 Server na mquina local, para ser executado automaticamente. Default = 0; para ativar especificar 1. Define o idioma utilizado para exibir as mensagens do AP6 Remote. Apenas as mensagens originadas do AP6 Remote so afetadas. Para uma traduo geral, deve-se ter o RPO no idioma requerido. 1 = Portugus, 2 = Espanhol, 3 = Ingls.
Twotier
Language
Drivers
A seo Drivers define quais os protocolos podem ser utilizados para que o Terminal conecte-se ao AP6 Server. igual a seo de mesmo nome no arquivo de configuraes do AP6 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.
Para instalar o AP6 Server como servio basta executar a seguinte linha de comando a partir do diretrio do executvel do Server. Ex: [c:\arquivos de programas\ap6]\bin\server\ap6srv.exe install.
Caso no exista o arquivo AP6RMT.INI, ser exibida a seguinte tela solicitando o nome ou IP do Servidor, bem como a porta para comunicao.
As opes de linha de comando do AP6 Remote so: -Q (Quiet): Indica que o AP6 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 AP6 Server;
-A (Parmetros para o Programa Inicial): Identifica um parmetro que ser passado para o programa inicial; -L (AP6 Remote Log File): Para no-conformidades que ocorram no AP6 Remote (antes que este possa se conectar ao AP6 Server), gerado um arquivo de log no diretrio de execuo deste aplicativo. Este arquivo tem o nome definido pela identificao do executvel (AP6Rmt) + um caracter de underline (_) + o nome da mquina em que o AP6 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 AP6 Remote (por exemplo, impossibilidade de conexo).
-M (AllowMultiSession): Permite mltiplas instncias (Cpias) do AP6 Remote na mesma mquina (Default: no permite);
Q P=SIGAEST E=ENV_TOP_ENGLISH
para executar o mdulo SIGAEST em uma base de dados utilizando o idioma ingls.
As conexes podem ser efetuadas atravs dos protocolos TCP-IP ou Named Pipes, simultaneamente; 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 AP6 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 AP6 Remote e o AP6 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 AP6 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 Protheus, pois influencia totalmente a performance. O maior trfego de rede est localizado entre o AP6 Server e o Banco de Dados, j que o trfego entre o AP6 Server e o AP6 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 AP6 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 AP6 Server para ser executado localmente nesta cidade pode ser uma boa soluo.
Acrescente na seo [CONFIG] do arquivo AP6RMT.INI (localizado no diretrio AP6\BIN), o parmetro TWOTIER=1; No diretrio AP6/BIN, edite o arquivo AP6SRV.INI e, na seo Environment, troque a unidade de disco para direcionar o novo local.
Exemplo: [ENVIRONMENT] SourcePath=C:\AP6\APO RootPath=C:\AP6 StartPath=\SIGAADV RpoDb=ADS RpoLanguage=Portuguese RpoVersion=609 IncludePath=C:\AP6\INCLUDE;C:\AP6\IXBPAD AdsShare=I:\ADS56 Local Files=ADS X2_path= [ENVIRONMENT] SourcePath=I:\AP6\APO RootPath=I:\AP6 StartPath=\SIGAADV RpoDb=ADS RpoLanguage=Portuguese RpoVersion=609 IncludePath=I:\AP6\INCLUDE;I:\AP6\IXBPAD AdsShare=I:\ADS56 Local Files=ADS X2_path= 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 AP6RMT.EXE localizado no diretrio \BIN do sistema. Ex. I:\AP6\BIN\AP6RMT.EXE;
No mesmo arquivo troque os parmetros File Sharing On Local Drives e File Sharing On Remote Drives para 1 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 Protheus para testes, desinstale o Protheus do drive local;
O uso do Advanced Protheus 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 Advanced Protheus faz duas conexes no ADS por usurio e por isso, o nmero de conexes deve ser o dobro do nmero de usurios. 2. Configurao do AP6SRV.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\ap6\ LocalFiles deve ser ADSSERVER ADSSHARE: diretrio no servidor ADS compartilhado full para o usurio do protheus. Este diretrio apenas utilizado para a conexo do Protheus com o Servidor ADS. Sugerimos que se crie um diretrio vazio na raiz do Servidor ADS e o compartilhe. Ex: ADSShare = \\servidor_ads\adsshare 3. Se o Advanced Protheus estiver rodando como servio, acrescentar uma senha de administrador ao servio.
Como ferramenta de edio e depurao, engloba todos os recursos disponveis nas melhores ferramentas de desenvolvimento do mercado.
AP6 Monitor
O AP6 Monitor utilizado para monitorar as conexes ao AP6 Server. Atravs dele pode-se: Verificar as conexes ativas; Enviar mensagens para uma ou mais conexes; Capturar a tela de uma conexo. A tela recebida como uma imagem no formato JPEG; Desabilitar novas conexes. Isto til quando se precisa efetuar alguma manuteno e se precisa evitar que outros usurios se conectem.
AP6 Dump
um aplicativo do Advanced Protheus que trabalha como um editor de arquivos hexadecimal.
APSDU
uma ferramenta para manuteno de arquivos que possui as mesmas funcionalidades do antigo SDU da MICROSIGA, porm com novos recursos: Interface Advanced Protheus; Utiliza os recursos de segurana do Advanced Protheus, inclusive o Senhap, o que evita que a base seja acessada por usurios no autorizados; Suporte a todos os bancos de dados disponveis pelo AP6.
Conversor SQL
um aplicativo do Advanced Protheus que permite a converso de bases DBF em SQL.
Algumas mensagens
Algumas mensagens de erro so mais comuns durante a instalao e uso do AP6. Estas mensagens so:
Servidor no encontrado
Isto significa que o AP6 Remote no pde se conectar ao AP6 Server. Deve-se verificar os seguintes pontos nessa ordem: 1. Se o AP6 Server est ativo; 2. Se a verso do AP6Remote a mesma do AP6Server (podese verificar a data dos arquivos AP6Cli.exe e AP6Srv.exe); 3. Se o meio de conexo (rede, modem, dial-up na internet) est no ar; 4. Se o nmero do IP ou nome do servidor est corretamente informado no AP6SRV.INI; 5. Se o nome do servio informado no AP6Rmt.ini coincide com o AP6Srv.ini (Conexes NPIPE); 6. Se as informaes dos arquivos de configuraes esto corretas nos Environment; 7. Se os protocolos esto corretamente instalado na estao.
Login Desabilitado
Isto significa que o login ao AP6 Server foi desabilitado pelo administrador, atravs do AP6Monitor. Para que o AP6 Remote possa conectar-se, o login deve ser habilitado novamente, atravs do AP6 Monitor ou o AP6 Server deve ser reinicializado.
Incompatibilidade de DLLs
Isto significa que a verso de qualquer um dos executveis, ou DLLs do AP6Remote, AP6Ide ou AP6Monitor est diferente das DLLs do AP6Server. Uma verso correta deve ser instalada (Atualizar o client de acordo com o AP6Server).
SOBRE
TOPCONNECT
Informaes Gerais
O TOPConnect for Windows conectividade base de dados, acessem uma ampla variedade de sem a necessidade de gerao de uma delas.
NT uma ferramenta de que permite que aplicativos servidores de banco de dados cdigos especficos para cada
Os Bancos de Dados hoje suportados so: Microsoft SQL-Server 6.5 ou superior Oracle 7.3.4 ou superior IBM Universal Database Informix Sybase Adaptive Server e Anywhere InterSystems Cach
BDC Domnio de Controle Backup ( Backup Domain Controller). Nesta configurao o Windows NT tem como funo substituir o PDC em casos de manuteno, mantendo para esta finalidade uma cpia das contas do PDC, porm ele no mantm cpia dos softwares instalados no PDC. Member Server Nesta configurao o Windows NT ser um servidor de aplicaes utilizando o PDC para controlar os direitos de acesso rede.
MS-DOS
Podero ser utilizadas estaes clientes utilizando o MS-DOS como sistema operacional, porm o aplicativo dever prever conexes utilizando o protocolo NamedPipes.
Cada vez que ao instalar novos componentes, o Windows NT ele solicitou a utilizao do CD de instalao original, o Service Pack dever ser instalado novamente, pois arquivos de uma verso mais antiga que os disponveis no Service Pack foram copiados para o servidor.
Ambiente de Rede
Os protocolos de comunicao que sero utilizados so: TCP/IP ou NETBEUI. Quanto menor for o nmero de protocolos instalados melhor ser a performance nas comunicaes. No caso de instalar ou reinstalar protocolos, devem-se atualizar novamente o Service Pack 3 ou superior do NT. Em Painel de Controle/Ambiente de rede temos 5 pastas com informaes e configuraes que devem ser checadas:
Propriedades do Sistema
Em Painel de Controle/Propriedades do Sistema/Performance, esto localizadas as configuraes da performance de aplicaes que rodam no prprio servidor. Por padro, o percentual disponibilizado para estas aplicaes de 0%, j que o servidor deve ser dedicado. Nesta pasta tambm configurada a memria virtual utilizada pelo Windows NT, devendo levar-se em conta que a memria virtual utiliza rea de disco, o que a torna extremamente lenta em funo da velocidade de acesso.
Servios
Os Servios, localizados no Painel de Controle Servios, so programas executados em background (na retaguarda). Estes programas podem ser iniciados automaticamente durante a carga do sistema operacional ou manualmente pelo usurio. Eles utilizam recursos de memria e CPU do servidor. Dependendo dos servios em uso a performance do equipamento pode diminuir. Como exemplo seguem alguns servios que devem ser utilizados em servidores independentes, ou seja, NO devem permanecer no mesmo servidor que o TOPConnect e/ou o Banco de Dados. Gateway (and Client) Services for NetWare IIS (Internet Information Server) RAS (Remote Access Service) Service for Macintosh WINS (Windows Internet Name Service) SNA Server
O Event Viewer
O Event Viewer um utilitrio que permite o monitoramento das mensagens de erro reportadas pelo Sistema Operacional. Estas mensagens so armazenadas, para futura verificao e anlise do administrador da rede, e de grande importncia o seu acompanhamento para resolver alguns problemas bsicos como: pouco espao em disco, servio no iniciado, falta de memria, etc. Claro que nem todas as mensagens so de nosso interesse, mas tudo que for reportado visualmente pelo NT, ser armazenado no arquivo de LOG. Existem trs tipos de LOG de erros, porm s nos interessa o LOG do sistema (Armazena erros referente ao software e programas do sistema operacional) e o LOG das Aplicaes (Armazena erros referente ao software desenvolvido por terceiros - no nosso caso o TOPConnect).
O Server Manager
Server Manager um utilitrio para verificao de conexes de usurios e utilizao de arquivos. A utilizao do Windows NT Server 4.0 sem a atualizao, ou com atualizao indevida, de Service Pack 3 ou superior, poder causar problemas de compartilhamento/travamento (share/lock) de arquivos..
O Task Manager
O Task Manager, utilitrio para verificao das tarefas em execuo, pode ser chamado com um click do boto direito do mouse na barra de tarefas do Windows NT. Ele demonstra a utilizao de CPU e MEMRIA por servio ou aplicao em execuo. Neste utilitrio podemos interromper a execuo de qualquer aplicao, alm de podermos verificar qual aplicao est consumindo o maior quantidade de memria ou CPU.
O TOPConnect
Instalao
O processo de instalao do TOPConnect bastante simples e feito atravs da execuo do arquivo TOPConnect_2.exe no CD de instalao*.
Depois de confirmar a instalao da verso informada, ser solicitado ao usurio que escolha a linguagem utilizada pelo assistente de instalao. As opes de linguagem so: Portugus, Ingls e Espanhol
Em seguida, ser apresentado ao usurio uma mensagem de boas vindas ao programa. *disponvel na Internet atravs de http://www.microsiga.com.br/ topconnect
Clique em "Avanar". Ser apresentada uma janela para selecionar o diretrio onde deve ser instalado o TopConnect.
O TOPCONNECT MANAGER
Apresentao
Todas a configuraes e monitoramento do TOPConnect ocorrem atravs da ferramenta TOPConnect Manager.
Logo na abertura do TOPConnect Manager temos a tela de informaes, onde sero encontrados dados sobre o registro do TOPConnect, usurios conectados, tabelas em uso, erros no acesso e seleo de idiomas. Nesta tela tambm poderemos controlar o acesso dos clientes ao TOPConnect habilitando/desabilitando a conexo atravs da opo Status de Login.
Monitor de Conexes
Na tela do monitor de conexes o usuro pode monitorar as conexes ativas no TOPConnect, bem como as tabelas utilizadas em cada conexo ativar/o Trace desativar ou encerrar qualquer uma das conexes. Para ativar/desativar o Trace, deve-se marcar/desmarcar o checkbox ao lado do ID (identificao) do usurio. Ativandose o Trace, iniciar um processo onde o TOPConnect ir gerar um arquivo texto contendo todas as operaes efetuadas para a conexo. Veja tambm: Propriedades
Monitor de Performance
Na tela do monitor de performance o usurio encontrar informaes sobre os nveis de utilizao do TOPConnect.
Log de Eventos
Na opo Log de Eventos o usurio encontrar todas as mensagens enviadas pelo servidor de Banco de Dados. Atravs da barra de ferramentas Eventos, pode-se salvar, limpar, imprimir e forar a atualizao destas informaes.
Propriedades
Nesta opo o usurio ir configurar o nome e senha do usurio, utilizado na conexo ao Banco de Dados, o diretrio onde sero criados os arquivos de trace, e se o TOPConnect utilizar ou no a compresso de dados na linha. A opo Servidor Remoto est reservada para implementaes futuras. A opo Compresso de Dados pode ser habilitada/desabilitada. Veja tambm: Monitor de Conexes
Licenas de Uso
Nesta opo o usurio ingressar com a chave de acesso fornecida pela Microsiga que ir liberar o usa do TOPConnect para o nmero desejado de usurios. A aplicao da chave ir configurar as informaes referentes a Usurios e Dias para utilizao. Para solicitar a chave, enviar e-mail para topconnect@microsiga.com.br, detalhando identificao da empresa, nmero de usurios, nmero de srie e e-mail para resposta; ou ainda atravs do telefone (011) 3981-7000 Suporte TOPConnect. Obs: Internacional 55-11-3981-7000 Suporte TOPConnect
Ambientes
Na opo Ambiente o usurio configura o ambiente de conexo do TOPConnect. Para todos os bancos de dados suportados pelo TOPConnect, exceto Oracle, um ambiente nada mais do que um System DNS criado atravs do Gerenciador do ODBC. Mais de um ambiente poder ser criado para acessar um mesmo Banco de Dados como por exemplo um ambiente de Testes e um de Produo.
Ao selecionar a opo Novo, ser apresentado ao usurio uma lista com os Drivers ODBC disponveis. O TOPConnect no uma ferramenta de acesso genrico, pois possui cdigo especfico para cada banco de dados suportado, portanto, mesmo sendo apresentada uma lista com uma srie de drivers ODBC apenas podero ser selecionados os drivers para os bancos de dados suportados pelo TOPConnect, qualquer seja o fabricante do Driver.
Depois de confirmado o Driver a ser utilizado ser apresentado ao usurio uma srie de perguntas que iro variar de acordo com cada fabricante de Driver ODBC. Para o Banco de Dados Oracle, o ambiente um alias criado atravs das ferramentas do SQL-Net.
MANUAIS ELETRNICOS
A documentao do Advanced Protheus conta com os Manuais Eletrnicos dos Mdulos. Os Manuais Eletrnicos podem ser consultados e impressos a partir do CD-ROM de Documentao, utilizando o software Acrobat Reader enviado tambm neste CD. Para que seja possvel consultar os Manuais, deve-se primeiramente instalar o software Acrobat Reader. Para instalar o Acrobat Reader: 1. Execute o seguinte arquivo: X:\DOCS\ACROREAD\ACRD4PTB.EXE onde: X a identificao da unidade de CD-ROM 2. Desta forma, o instalador Acrobat Reader ser carregado. Prossiga a instalao, seguindo as orientaes do instalador.
Acessando os Manuais
Para consultar um Manual Eletrnico: Com o Acrobat Reader j instalado, acesse o seguinte arquivo: X:\DOCS\MANUAL.PDF onde:
X a identificao da unidade de CD-ROM Desta forma, o software Acrobat Reader ser carregado, apresentando a tela de abertura dos Manuais Eletrnicos.
1.
Clique no boto referente ao Grupo de Mdulos que deseja consultar; Sero relacionados os Mdulos do grupo escolhido.
2.
A tela com as opes de Manuais ser apresentada. Clique sobre o Manual a ser consultado; O Sumrio do manual escolhido apresentado no lado direito da janela, relacionando os captulos existentes.
3. 4.
Posicione o cursor do mouse sobre o item desejado. O cursor se torna uma mo com o dedo indicador apontado. Clique sobre o item do Sumrio que deseja consultar. O item selecionado ser apresentado. Para ampliar a visualizao, clique no boto ferramentas. Clique no boto da barra de
5. 6.
Para visualizar todas as pginas do Sumrio, clique nas setas de rolagem apresentadas no lado direito da janela. Para consultar um tpico do Sumrio sem ter que acess-lo, clique na seta apresentada frente do seu nome. Os tpicos do Sumrio sero exibidos. Clique sobre o que desejar consultar. Para fechar os itens do Sumrio apresentados no lado esquerdo, clique na Seta p/ Baixo apresentada frente do seu nome.
7.
Para consultar outro manual, clique no item Mdulos no lado esquerdo da janela. O menu dos Mdulos ser reapresentado.
8.
Na parte superior da janela so apresentados alguns botes que facilitam a navegao pelos Manuais e Guias Eletrnicos: Boto O que faz apresenta os tpicos de hipertexto no lado esquerdo e o manual do lado direito. permite aproximar a visualizao da pgina. Para reduzir a visualizao, utilize as opes do menu View. permite selecionar textos no manual para utilizao das funes Copiar, Cortar e Fixar do menu Editar. permitem avanar ou retroceder pginas no manual. permite acessar uma visualizao anterior ou posterior.
amplia a visualizao na largura da pgina. permite pesquisar um texto no Manual. Na janela apresentada, digite o texto a ser pesquisado e clique no boto Find para prosseguir.
Imprimindo o Manual
Para imprimir o Manual Eletrnico ativo: 1. 2. Clique no boto .
Se desejar imprimir somente um intervalo de pginas, clique no boto de opo Pages e informe o nmero inicial e final do intervalo de pginas. Para verificar a numerao das pginas, observe a linha de status apresentada na parte inferior do monitor . Este boto informa o nmero da pgina posicionada e o nmero total de pginas do Manual. Clicando neste boto possvel acessar uma pgina especfica do manual.