CONTEÚDO
- Introdução
- Instalação
- Configuração
- Progress 11.7
- Progress 12
- 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:
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 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
05. Links