Configuração de Domínio

Oracle Forms And Reports

V 1.0
 Lista de Distribuição

Nome E-mail Empresa

Tiago Calixto da Rocha trocha@empro.com.br EMPRO
Nilson Murai nmurai@empro.com.br EMPRO
Guilherme Machado Deusajute guilherme@empro.com.br EMPRO
Thiago Mendes de Souza thiago.souza@visualsystems.com.br VISUAL

Lista de Versões

Autor Descrição Data

Rodrigo Vannucci Criação do Documento 04/12/2017
Sumário
INTRODUÇÃO ............................................................................................................................. 4
INSTALAÇÃO ORACLE JDK ..................................................................................................... 4
ORACLE FORMS AND REPORTS ............................................................................................ 4
EXECUÇÃO DO RCU ......................................................................................................................... 5
CRIAÇÃO DOMÍNIO ORACLE FORMS REPORTS ............................................................................. 18
CONCLUSÃO .................................................................................................................................... 38
INICIANDO O DOMÍNIO ............................................................................................................ 38
CONCLUSÃO .................................................................................................................................... 40
CONFIGURANDO O SEGUNDO SERVIDOR ......................................................................... 41
CONCLUSÃO .................................................................................................................................... 42
ADMINISTRAÇÃO ..................................................................................................................... 42
STOP/START ................................................................................................................................... 42
CONCLUSÃO .................................................................................................................................... 45
Introdução
Este documento tem como principal objetivo descrever os passos para
implementação dos produtos Oracle WebLogic 12c R2 Server e Oracle Forms and
Reports 12c R2.

Instalação Oracle JDK

Para iniciar a instalação o Oracle Java HotSpot (JDK) versão 1.8, deve estar instalada
no ambiente, para isso basta baixar do site de downloads da Oracle, de preferencia
a versão mais recente, e desempacotar em um diretório de sua preferencia.

O diretório de instalação do Oracle JDK, para os ambientes da EMPRO foi:

ü /u01/app/oracle/products/java/jdk

Assim basta efetuar a chamada para o caminho completo, ou configurar dentro do

arquivo .bash_profile, o qual existe no home do usuário e inserir as seguintes
informações:

JAVA_HOME=/u01/app/oracle/products/java/jdk
export JAVA_HOME

PATH=$JAVA_HOME/bin:$PATH:$HOME/.local/bin:$HOME/bin

Oracle Forms And Reports

Nesta sessão descreveremos como configurar um ambiente do Oracle Forms and
Reports.

Os binários para todos os ambientes Oracle Forms and Reports, forma instalados
seguindo um padrão, assim sendo fica de fácil identificação, sendo o caminho:

ü /u01/app/oracle/products/middleware/fr_12.2.1

Para configurar um domínio do Oracle Forms and Reports existe um passo antes de
criar o domínio que é gerar o banco de metados com o utilitário Repository Creation
Utility (RCU).
Execução do RCU

Nesta sessão serão descritos os passos para criação do banco de dados.

Para executar o utilitário ir em

/u01/app/oracle/products/middleware/fr_12.2.1/oracle_common/bin/rcu

Está é a tela de boas vindas, clicar em next.

Nesta tela selecionar o método de criação do repositório de metadados do ambiente.
Também é possível remover um repositório já existem.
Ao selecionar a opção criar, o utilitário ira requisitar as opções de conexão com o
banco de dados, uma questão prioritária é que o utilitário requer o usuário sys com
permissões de SYSDBA.

Preencha com as informações de conexão e clique em próximo.

Nesta tela o utilitário executa uma validação para verificar a versão do banco de dados
é homologada e se todos os parâmetros de pré-requisitos estão configurados para o
banco de dados. Ao final clicar em OK.
Definimos o prefixo do usuário de banco dados como FORMSPROD, mas poderiam
ser utilizados qualquer nome que defina a quem estes schemas serão destinados.
Também é necessário selecionar quais recursos serão criados, por padrão:

ü Common Infrastructure Services;

ü Oracle Platform Security Services;
ü Audit Services;
ü Audite Services Append;
ü Audit Services Viewer;
ü WebLogic Services.

Após definir o prefixo do usuário e os recursos, basta clicar em next.

Neste ponto é executado uma nova validação de pré-requisitos para cada recurso
selecionado. Clicar em OK ao final da execução.
Nesta tela é possível definir a senha dos schemas de forma geral, um-a-um ou uma
senha apenas para o schema auxiliar. Aqui foi definida a mesma senha para todos os
schemas que serão configurados.
Nesta tela é possível verificar todos os schemas que serão criados as tablespaces
padrão e as tablespaces temporárias, que o utilitário ira gerar no banco de dados.
Neste ponto o utilitário apenas informa que as tablespaces não existem e se dexa
continuar com a criação, basta clicar em OK.
O primeiro passo é validar os pré-requisitos novamente e criar as tablespaces,
informadas na tela anterior. Ao final clicar em OK.
Nesta tela temos um resumo dos recursos que serão criados e tipos. Clicar em
Create.
Tela com as informações de criação para cada um dos recursos selecionados.
Pagina de informação de sucesso na criação do Repositório de Metadados. Clicando
em Close o utilitário será fechado liberando a shell para novos comandos.
Criação domínio Oracle Forms Reports

Para iniciar o instalador, basta seguir o caminho acima:

/u01/app/oracle/products/middleware/fr_12.2.1/oracle_common/common/bin/config.s
h

Assim a interface de instalação irá se abrir e será possível configurar o novo domino.

Nesta primeira tela definimos o local e nome do domínio.

Nesta tela é possível selecionar features necessárias para execução das aplicações;
a funcionalidade para cada uma delas pode ser verificada na documentação do
fabricante. Ao selecionar uma das opções as que forem pré-requisitos também serão
selecionados automaticamente.

Para saber quais são as opções necessárias acessar o link abaixo com o Roadmap
de instalação e configuração:

1.3 Installation and Configuration Roadmap for Oracle Forms and Reports
O Oracle Forms and Reports, possui algumas aplicações que são instaladas
juntamente com o ambiente, nesta tela temos que definir o local onde estas
aplicações serão instaladas, podendo ser qualquer lugar acessível pelo usuário.
Nesta tela inserimos o usuário e senha do administrador do domínio.

Nesta tela definimos se o ambiente será em modo produção ou modo

desenvolvimento, a única particularidade que diferencia um do outro é a necessidade
de se criar um lock no ambiente, para que não existam alterações simultâneas que
possam gerar conflito no ambiente. Recomenda-se sempre instalar ambientes que
não estejam na maquina do desenvolvedor em modo produção.
Nesta tela definimos quais os recursos queremos configurar de forma manual e não
automatizada pelo Oracle WebLogic Server.

Cada uma das configurações são:

ü Administration Server à Nome do servidor administrativo e porta para

conexão;
ü Node Manager à Usuário e senha de acesso, hostname de onde estará
executando e porta de comunicação;
ü Topology à Servidores gerenciados e portas e Cluster.
Nesta tela o utilitário ira capturar todas as informações de conexão com o banco
utilizando o schema com final STB, basta preencher com os dados de conexão com
o banco e inserir a senha definida na execução do RCU e clicar no botão Get RCU
Configuration, que o próprio instalador ira buscar os schemas necessários.
Nesta tela podemos ver o utilitário já identificou os schemas criados e buscou a senha
para cada um deles.
Nestá tela são executados os testes de conexão para cada um dos Datasources que
serão criados no ambiente.
Nesta tela iremos selecionamos as opções que pretendemos alterar no ambiente.
Nesta tela configuramos o nome do servidor administrativo, hostname de onde estar
executando e a porta de comunica HTTP, também é possível configurar a porta SSL
caso necessário.
Nesta tela é possível fazer as configurações do node manager, como usuário e senha,
utilizado por domínio ou compartilhado entre os domínios de uma mesmo servidor.
Nesta tela configuramos todos os servidores gerenciados ou JVMs, indicamos o
hostname de cada uma e a porta de execução. Servidores gerenciados que estiverem
no mesmo servidor devem possuir portas diferenciadas.

Também é possível configurar a porta SSL caso seja necessário.

Nesta tela configuramos os clusters que iram compor o ambiente, definimos o nome
de cada um deles, e o endereço de acesso a cada servidor gerenciado que ira compor
o cluster, com a sua respetiva porta de acesso HTTP ou SSL.

Existe a possibilidade de configurar o endereço de frontends e porta do front HTTP e

SSL.
Nesta tela associamos os servidores gerenciados criados aos clusters.
 Nesta tela, definimos o servidor de execução de cada um dos gerenciados de nós
(nodemanager), e porta que será utilizada para execução.
Para que os servidores gerenciados possam ser administrados e acessos pelo
servidor administrativo, temos que associar cada um ao seu respetivo servidor onde
o nodemanager estará em execução.

Assim nesta tela fazemos a associação entre eles.

Nesta tela selecionamos quais instancias do serviço do Forms iram subir com os
servidores gerenciados, lembrando este serviço é 1 para 1, ou seja, cada servidor
gerenciado carrega o seu serviço do Forms.
Nesta tela definimos o host de frontend para os forms em execução no ambiente.
Nesta tela associamos cada um dos serviços do forms ao seu respectivo servidor,
para que possa ser gerenciado pelo gerenciador de nós do domínio.
Nesta tela temos o resumo de toda a configuração do ambiente, com os servidores
gerenciados, servidor administrativo e os clusters criados durante o passo-a-passo
entre as telas.
Nesta tela temos o status do processo de criação do domínio.

Conclusão

Após os passos acima serem seguidos temos o novo domínio Oracle Forms and
Reports criado e pronto para ser utilizado.

Iniciando o Domínio
Para iniciarmos o domínio basta acessar a console do sistema operacional (shell) e
acessar o diretório de instalação onde foi configurado. Após este passo devemos
fazer a primeira execução em primeiro plano, sem executar em background e
executar o comando abaixo:

./startWebLogic.sh

Durante o startup será solicitado o usuário e senha do administrador, configurado

durante a criação do domínio.

Ao finalizar o processo de startup, pode se dar o comando Ctrl + c (Control + c), para
finalizar o processo, assim parando o domínio.
Após a parada completa, seguir para o diretório servers, dentro do diretório do
domínio e acessar o diretório do servidor administrativo. Neste diretório devemos criar
um novo chamado security, neste diretório iremos colocar as um arquivo chamado
boot.properties, dentro deste arquivos precisamos colocar duas propriedades
conforme abaixo:

username=weblogic
password=welcome1

Obs.: Acima são exemplos de usuário e senhas que devem ser inseridos neste
arquivo.

Após todas as configurações, criar no diretório de logs (/u01/app/oracle/logs) o

diretório com o nome do domínio e abaixo dele o diretório com o nome do servidor
administrativo. Criar e copiar o conteúdo do script de startup ligaAdmin.sh, o qual está
abaixo, apenas no servidor que foi executada a configuração do domínio, mudando
os seguintes parâmetros:

DOMAINNAME à Para o nome do domínio configurado;

ADMNAME à Para o nome do Servidor Administrativo configurado.

#!/bin/bash

DOMAINSPATH=/u01/app/oracle/domains
DOMAINNAME=APPHMLG_Domain
ADMNAME=APPHMLGServer
LOGSPATH=/u01/app/oracle/logs
STARTSCR=startWebLogic.sh
DATEHOURSTART=$(date +'%Y_%d_%m_%H_%M')

if [ "${USER}" = "oracle" ]; then

PIDADM=`ps -ef | egrep -i "${ADMNAME}" | egrep -v grep | gawk '{ print $2 }'`
if [ ! -z "${PIDADM}" ]; then
printf "O Admin server esta em execucao com o pid %s!\nDeseja reniciar o admin? [s|n]\n" "${PIDADM}"
read op
case $op in
s|S|y|Y) kill -9 "${PIDADM}"; sleep 2;;
n|N) exit 0;;
esac
fi
/usr/bin/nohup "${DOMAINSPATH}"/"${DOMAINNAME}"/"${STARTSCR}" >
"${LOGSPATH}"/"${DOMAINNAME}"/"${ADMNAME}"/"${ADMNAME}"_"${DATEHOURSTART}".out &
tail -f "${LOGSPATH}"/"${DOMAINNAME}"/"${ADMNAME}"/"${ADMNAME}"_"${DATEHOURSTART}".out
else
printf "O usuario %s nao possui permissao para iniciar o ambiente. favor utilizar o usuario oracle" "${USER}"
fi

Efetuar a chamada para o script com ./ligaAdmin.sh.

Durante o processo de startup o script já executa um tail no arquivo de log do

ambiente, para que possa acompanhar a subida do servidor administrativo.
Configurando o Gerenciador de Nós

O gerenciador de nós, por mais que já foi configurado durante a criação do domínio,
existem parâmetros que são necessárias configurações manuais.

Ir no diretório do domínio e acessar o diretório bin, dentro do diretório bin existe um

executável chamado startNodeManager.sh, execute em primeiro plano, ao finalizar o
processo execute Ctrl + c (Control + c) para parar e acesse o diretório nodemanager
na raiz do diretório do domínio.

Crie o diretório nodemanager dentro do diretório de logs (/u01/app/oracle/logs)

seguindo nomdedodominio/nodemenager.

Abra o arquivo nodemanager.properties e edite os seguintes parâmetros:

weblogic.StartScriptEnabled à trocando para true

LogFile à Alterando o diretório de logs para o criado acima.

Criar e copiar o conteúdo do script de startup do nodemanager ligaNode.sh, inserido

o conteúdo abaixo, trocando o parâmetro, DOMAINNAME para o nome do domínio
configurado:

#!/bin/bash

DOMAINSPATH=/u01/app/oracle/domains
DOMAINNAME=APPHMLG_Domain
LOGSPATH=/u01/app/oracle/logs
SERVICENAME=nodemanager
STARTSCR=startNodeManager.sh
DATEHOURSTART=$(date +'%Y_%d_%m_%H_%M')

if [ "${USER}" = "oracle" ]; then

PIDNODE=`ps -ef | egrep -i java | egrep -i 200m | egrep -i ${SERVICENAME} | egrep -v grep | gawk '{ print $2 }'`
if [ ! -z "${PIDNODE}" ]; then
printf "O Node Manager esta em execucao com o pid %s!\nDeseja reniciar o Node Manager? [s|n]\n" "${PIDNODE}"
read op
case $op in
s|S|y|Y) kill -9 "${PIDNODE}"; sleep 2;;
n|N) exit 0;;
esac
fi
/usr/bin/nohup "${DOMAINSPATH}"/"${DOMAINNAME}"/bin/"${STARTSCR}" >
"${LOGSPATH}"/"${DOMAINNAME}"/"${SERVICENAME}"/"${SERVICENAME}"_"${DATEHOURSTART}".out &
tail -f "${LOGSPATH}"/"${DOMAINNAME}"/"${SERVICENAME}"/"${SERVICENAME}"_"${DATEHOURSTART}".out
else
printf "O usuario %s nao possui permissao para iniciar o ambiente. favor utilizar o usuario oracle" "${USER}"
fi

Ao executar o comando, ira iniciar verificar se já existe algum em execução e solicitar

ao usuário se deseja ou não o atual e iniciar o nodemanager em segundo plano.

Conclusão

Com todos os passos acima já temos o ambiente em pleno funcionamento e é

possível acessar a console do domínio e iniciar os servidores gerenciados, ou fazer
qualquer nova configuração de recursos, caso sejam necessários.
Configurando o Segundo Servidor
Após todo o processo é necessário replicar o ambiente no segundo servidor, isso para
ambientes clusterizados.

Para que possa replicar o ambiente é necessário fazer um pacote (pack) do domínio
no servidor principal e copiar o arquivo gerado no segundo servidor desempacotando
(unpack).

Para isso devesse acessar o diretório de instalação do ambiente,

/u01/app/oracle/products/middleware/fr_12.2./oracle_common/bin e executar o
comando pack, para empacotar, conforme exemplo abaixo:

./pack.sh -domain=/u01/app/oracle/domains/NOME_DOMINIO -
template=/tmp/NOME_DOMINIO.jar -template_name="NOME_DOMINIO"

Vamos descrever as opções do comando:

-domain à Indica o diretório home do domínio;

-template à Indica onde será gerado o template;
-template_name à Um nome de identificação do template.

Após a execução do comando será gerado um arquivo com a extensão jar no diretório
especificado, copiar o arquivo jar para o outro servidor.

Ao finalizar a copia, executar o comando de desempacotamento, conforme o exemplo

abaixo:

./unpack.sh -domain=/u01/app/oracle/domains/NOME_DOMINIO -
template=/tmp/NOME_DOMINIO.jar -user_name=weblogic -password=welcome1 -
log_priority=ALL -log=/tmp/unpack.log

Vamos descrever as opções do comando:

-domain à Diretório onde será criado o domínio;

-template à Local onde foi copiado o template gerado no servidor primário;
-user_name à Nome do usuário administrativo do domínio;
-password à Senha do usuário administrativo do domínio;
-log_priority à Prioridade do log a ser gerado;
-log à Local onde gerar o log de desempacotamento.

Quando finalizar o processo o domínio será criado com estrutura parecida no servidor.
Acessar o diretório e remover o script ligaAdmin.sh, isso é necessário para que não
exista tentativa de subir o Servidor Administrativo no segundo nó. Neste servidor
existe apenas a necessário de ser criado e copiado o conteúdo do script ligaNode.sh.

Execute o script de start do gerenciador de nós.

Conclusão

Ao finalizar os comandos e passos acima já é possível gerenciar o segundo servidor

pela console administrativa do Oracle WebLogic Suite. Sendo possível efetuar o
start/stop e criação de recursos no cluster.

Administração
Nesta sessão serão descritos os passos para stop/start do ambiente, bem como
procedimentos de limpeza de logs.

Stop/Start

Para efetuar o stop do ambiente deve-se acessar a console administrativa do domínio

com o usuário e senha administrativo do domínio.
Ao acessar a console administrativa será apresentada a tela acima.

No canto esquerdo existe o menu de estrutura de domínio (Domains Structure),

expandir a opção Ambiente (Environment) e clicar em servidores.

Ao acessar servidores será apresentada a aba Configurações (Configuration), clique

na aba Controle (Control) e selecione os Servidores Gerenciados que deseja baixar.

Obs.: Se o Servidor Administrativo (Administration Server), for selecione o mesmo

também será baixo, por isso tome cuidado ao selecionar todos.

Nesta tela existem 5 botões, para fazer o stop dos servidores gerenciados, clique no
botão Baixar (Shutdown).
Ao clicar no botão Baixar (Shutdown), serão apresentadas duas opções Completar
as Atividades (When work completes) e Forçar Baixar Agora (Force Shutdown Now).
Selecione sempre a opção Forçar Baixar Agora (Force Shutdown Now).

Após selecionar a opção de shutdown, será apresentada a tela de confirmação, valide

os servidores selecionados e clique em Sim (Yes), caso queira alterar clique em Não
(No) e será redirecionado para a tela de controle dos servidores gerenciados.
Não existe qualquer ordem para efetuar o shutdown do ambiente, sendo apenas
necessário deixar o servidor administrativo por ultima para que não perca o acesso a
console. Mas caso queira baixar apenas o servidor administrativo também pode ser
executado sem qualquer problema, sendo necessário efetuar o start pelo script de
startup descrito em sessões anteriores.

Para iniciar os servidores gerenciados, o Servidor Administrativo e o Gerenciador de

nós devem estar em execução e acessíveis. Para isso basta executar os scripts
informados nas sessões anteriores.

Conclusão

Com os passos acima descritos já é possível efetuar o gerenciado de stop e start do

ambiente.

Qualquer duvida sobre o gerenciamento do ambiente, basta consultar os documentos

para cada caso no site da Oracle em:

https://docs.oracle.com/middleware/12213/formsandreports/index.html