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.

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:

• 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.

• 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 minimas 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 "startado" juntamente com adminserver.... Em caso de duvida verificar a imagem

• Para criar a instancia, valem os mesmo procedimentos citados para a 117; E as informações a seguir referentes a criação de novas instancias PAS(deploy) também valem para o 117;
• Na pagina principal da instancia, 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.
• Apos configurar a instancia poderá ser criado um novo PAS através do botão Deploy, será solicitado que informe um .war para gerar a nova instancia 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 sera 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-sessionclear.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 sera 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 instancia sera aberto um tomcat, No caso um tomcat rodara o fathom(Gerenciador), outro tomcat rodara a instancia (no meu caso Pasoe12) e no modelo de suporte um terceiro tomcat roda o produto, no modelo agregação o tomcat da instancia (Pasoe12) receberia os .wars do produto.

04. Testando o servidor PASOE

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

• Garantir que a sua instancia do PASOE esta carregada, atraves 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 instancia criada, conforme abaixo:

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:

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 codigo 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 instancia do PASOE
  • propath - O Conteúdo do PROPATH do agente da instancia do PASOE

05. Links

https://tdn.totvs.com/pages/releaseview.action?pageId=45127294