Linha Datasul

Árvore de páginas

CONTEÚDO

  1. Introdução
  2. Instalação
  3. Configuração
    1. Progress 11.7
    2. Progress 12
  4. Testando o servidor PASOE

01. Introdução

O PASOE surgiu para trabalhar em ambientes 64Bits, onde consegue obter uma melhor performance devido a essa arquitetura. O PASOE vem para substituir o AppServer e necessita de uma licença do tipo Pacific Production Application Server. Ele possui uma performance elevada na conexão dos seus agentes devido a trabalhar dentro de um servidor Tomcat Web.


02. Instalação

Durante o processo de instalação do Progress, você terá que informar as portas HTTP, HTTPs e Shutdown na página Progress Application Server Details, onde elas serão utilizadas para conexão do PASOE pelo produto da linha Datasul.

A instalação do PASOE com Progress 12 é bem similar à instalação do PASOE com Progress 11.7


Caso você queira, poderá manter em uma única máquina as duas versões do Progress 32Bits e o 64Bits, onde você deverá tomar alguns cuidados conforme abaixo:

A) Para que não ocorram conflitos de portas entre as duas instalações do Progress, algumas configurações deverão ser realizadas, conforme abaixo:

  • Caso não exista o arquivo DLC117_64\properties\fathom.properties, acesse o seu \DLC117_64\bin\proenv.exe e execute o comando unglue e depois o comando reglue, após isso tente executar o comando proadsv -start
  • No arquivo DLC117_64\properties\fathom.properties, alterar o valor de HttpPort, que é a porta onde se acessa o webserver (valor default é 9090), para 9064, conforme o exemplo abaixo:


[WebServer]
HttpPort=9064


  • No arquivo DLC117_64\properties\AdminServerPlugins.properties, incluir as chaves port e adminport com um valor diferente do default 20931 e 7832 respectivamente, conforme o exemplo abaixo:


[PluginPolicy.Progress.ProAdsv]
port=20941
adminport=7842


  • Após realizar as alterações, reiniciar o serviço do AdminServer for OpenEdge 11.7 (64-bit), utilizando um login válido de rede para iniciar o serviço.


03. Configuração

a. Progress 11.7

Abaixo temos os passos a serem realizados para configurar o PASOE:

  • Faça o login na tela de gerenciamento do PASOE, através do link http://localhost:9064, onde o primeiro login é com o usuário admin e senha em branco, onde após este login será solicitado para alterar a senha.
  • Clique em Resources → Progress Application Server


  • Onde será apresentado seguinte tela com as informações abaixo:


  • Informações importantes:

    • Instance Name é o nome que dará ao seu servidor.
    • Security model use developer
    • Instance directory é onde será instalado o Tomcat responsável por servir sua aplicação.
    • Http port, https port e shutdown port utilize portas não utilizadas por outros serviços em sua máquina.
    • Login e senha podem ser tomcat e tomcat.


  • Depois que for clicado no botão Create, será apresentado a tela abaixo com informações da instância do PASOE criado:


  • Na aba ABL Applications, clique no nome do seu servidor para ver as informações completas do seu servidor, conforme abaixo:


  • Depois clique em Configuration para poder fornecer as informações faltantes da configuração:


  • Os dados a serem informados:
    • Em Agent startup parameter informe o .pf da sua aplicação que irá conectar os bancos.
    • Em PROPATH informe o propath da sua aplicação, lembrando de deixar, ao final, as pastas que já estão no campo.
    • Em Session startup procedure informe o programa que cria os alias de sua aplicação.
    • Em Disconnect procedure informe o programa utp/ut-apsv-gc.p, que é responsável por fazer o Garbage Collector das sessões do PASOE


  • Depois clique em Save, onde será apresentado a seguinte tela:


  • Clicando em Resources, na aplicação que você criou, clique na opção Start para iniciar o seu servidor de aplicação.


b. Progress 12

As informações acima contemplam a migração para o Progress 12 (Pasoe) com mínimas diferenças: 

  • A Primeira diferença com o Progress 12 é que a interface de gerenciamento ficou separada do AdminServer; Para o AdminServer estar carregado não é obrigatório o fathom (Gerenciador) estar carregado, mas para gerenciar é necessário que o AdminServer esteja no ar;
  • Pra subir o fathom, utilizar o tomcat que fica na oemgmt (no meu caso alterei o nome da pasta para appserver, mas poderia ter informado ServiceFathom ou algo do tipo para facilitar o entendimento do  que a ele compete); Na 11.7 ainda não havia o tomcat para subir esse serviço e o mesmo era "inicializado" juntamente com AdminServer. Em caso de duvida verificar a imagem


  • Para criar a instância, valem os mesmo procedimentos citados para a 117; E as informações a seguir referentes a criação de novas instâncias PAS(deploy) também valem para o 117;
  • Na pagina principal da instância, no menu lateral esquerdo se encontram as opções de instance control | monitoring Plans | configuration | log File | Charts/Graphs


  • Em configuration temos a opções de configuração de connection e server configurations. Esta configurações já são exemplificadas e sugeridos valores na parte inicial de configuração.
  • Configuration - http:  Manter o http conector e alterar a porta padrão do http que é 8080, para não conflitar com o tomcat. Sugestão porta 8085 como informado acima, as demais configurações podem ser mantidas.
  • Após configurar a instância poderá ser criado um novo PAS através do botão Deploy, será solicitado que informe um .war para gerar a nova instância PAS:


  • Onde:
    • Select application .war file - é o .war disponibilizado pela progress, para montar a nova instancia PAS, o mesmo pode ser localizado no caminho: "C:\dlc12_64\servers\pasoe\extras\oeabl.war";
    • ABL application name - Nome que o seu PAS terá, no meu caso, este server será utilizado por uma empresa então denominei como "Empresa10";
    • Web application - Mantive o sugerido (oeabl), mas, pode ser informado o mesmo nome ou outro conforme for a necessidade;



  • Efetuado o deploy, basta informar os arquivos .pf, .ini e alias e informar também o propath e o programa de desconexão utp\ut-apsv-gc.r no campo Disconnect Procedure;


  • Acessando as informações do ABL WebApps → Name: oeabl - é o nome do webapplication da empresa 10 será possível localizar a url deste Appserver; Esta url que será utilizada para, por exemplo, a funcionalidade  "um broker por empresa", onde a supra citada é informada na cadastro da empresa, ao trocar de empresa no produto é validado o broker desta empresa e conectado assim seus respectivos bancos de dados. Ou ainda, para utilizar como Appserver principal basta informa-la no context.xml do tomcat;




  • Para cada instância será aberto um tomcat, No caso um tomcat rodara o fathom(Gerenciador), outro tomcat rodara a instância (no meu caso Pasoe12) e no modelo de suporte um terceiro tomcat roda o produto, no modelo agregação o tomcat da instância (Pasoe12) receberia os .wars do produto.

04. Testando o servidor PASOE

Para testar se a sua instância do servidor PASOE está funcionando, podemos fazer os seguintes passos:

  • Garantir que a sua instância do PASOE esta carregada, através do link http://localhost:9064
  • Criar um programa pequeno e simples (appteste.p), que deverá ser compilado e gravado em um diretório que esteja dentro do PROPATH da instância criada, conforme abaixo:
appteste.p
DEFINE OUTPUT PARAMETER p AS CHARACTER NO-UNDO.
DEFINE OUTPUT PARAMETER d AS INTEGER   NO-UNDO.

ASSIGN p = PROPATH
       d = NUM-DBS.


  • No editor do progress, utilize o programa abaixo para realizar o teste de conexão:
Executar no client Progress
DEFINE VARIABLE hAppSrv  AS HANDLE    NO-UNDO. 
DEFINE VARIABLE lConnect AS LOGICAL   NO-UNDO. 
DEFINE VARIABLE prop     AS CHARACTER NO-UNDO. 
DEFINE VARIABLE dbs      AS INTEGER   NO-UNDO. 

CREATE SERVER hAppSrv. 
lConnect = hAppSrv:CONNECT("-URL http://localhost:8085/apsv ").
IF  lConnect THEN DO: 
    RUN appteste.p ON hAppSrv (OUTPUT prop, OUTPUT dbs). 
END. 
MESSAGE lConnect SKIP 
        "Número de bancos conectados: " dbs SKIP 
        "Propath: " prop 
        VIEW-AS ALERT-BOX INFORMATION BUTTONS OK.


  • Após executar o código acima e tudo estiver correto, será retornada a seguinte mensagem:


  • As informações retornadas:
    • yes - O servidor foi conectado com sucesso
    • 19 - Numero total de bancos conectados na instância do PASOE
    • propath - O Conteúdo do PROPATH do agente da instância do PASOE