Manual de Operações – SGR

Introdução

Este manual tem por objetivo auxiliar a instalação do ambiente de desenvolvimento para trabalhar com
a aplicação SGR (Sistema de Gerenciamento de Reajustes). Ao final deste documento você será capaz de
executar o SGR em sua máquina local, tendo acesso às funcionalidades da aplicação.

O que é o SGR?

O SGR é um sistema web que faz o gerenciamento de reajuste na base do Kenan. Em linhas gerais, por
esta aplicação, o usuário consegue cadastrar reajustes de produtos selecionando o tipo de produto, um
índice para ser aplicado, a safra na qual haverá a alteração, dentre outras informações. A partir disso, o
SGR é capaz de fazer o reajuste ou de simulá-lo, informando até o ganho de receita que o reajuste causará.

Instalação do Ambiente de Desenvolvimento

A seguir, segue conjunto de especificações necessárias para o desenvolvimento de acordo com a

ferramenta utilizada.

Maven

Para construção deste manual, foram utilizados os seguintes requisitos:

Maven-3.2.5 associado à JDK 1.6 ou superior utilizando a configuração “settings.xml” da Telefônica,

disponível em: https://adtkm1amr1.accenture.com/sites/FabDes/FabCG/Faturamento

A Figure 1 apresenta a configuração do Maven utilizada para realizar o build da aplicação no Eclipse.
Figure 1 - Configuração de Maven no Eclipse
Figure 2 - Estrutura de Diretórios do Projeto no Eclipse

Eclipse

Deve ser utilizado o Eclipse com plugin para Servidores Weblogic na versão 12c.

LoginBypass

LoginBypass é uma aplicação desenvolvida na própria Fábrica de Faturamento com objetivo de simular o
sistema de Login utilizado pelo SGR. Ela foi desenvolvida utilizando a tecnologia Spring Boot e faz a geração
de uma chave de autenticação que é comparada com uma chave de autenticação gerada pelo próprio
SGR.

Para execução desta aplicação, é necessário executar o comando abaixo no console do Sistema
Operacional:
java -jar loginbypass2-0.2.0-SNAPSHOT.jar

Após isso, a aplicação fica implantada em um servidor apache embutido, disponível para receber
requisições HTTP no endereço abaixo:
http://<ip_localhost>:<porta>/login.html

Observação: A aplicação sempre fica implantada na máquina local (localhost), entretanto é possível
alterar a porta onde a aplicação executa. Para tanto, deve-se abrir o binário com uma ferramenta de
compactação (winzip ou winrar) e alterar o arquivo “\BOOT-INF\classes\application.properties”.

Figure 3 - Execução do LoginBypass

Atenção: Para que o SGR aponte para a aplicação LoginBypass no momento do login, é necessário alterar
o valor do parâmetro “loginUrl” dentro do arquivo “\sgr-web\src\main\webapp\WEB-INF\web.xml” da
aplicação SGR.
Exemplo:
<init-param>
<param-name>loginUrl</param-name>
<param-value>http://127.0.0.1:7015/login.html</param-value>
</init-param>

Importante: Esta configuração NUNCA deve ser submetida a commit no SVN da

aplicação, deve ser utilizada apenas em ambiente de DEV.

Weblogic

Para o SGR, deve ser utilizado o Weblogic na versão 12c para deploy. Neste manual, foi utilizada a versão
12c R2 (12.2.1). Para realizar a instalação deste Weblogic, foram utilizados os passos abaixo.
Atenção: Deve ser executado o prompt de comando como Administrador para realizar a instalação abaixo.

2.1 Starting the Installation Program

You launch the installation program from the JDK directory on your system.
To start the installation program:
1. Log in to the target system.

2. Verify that a certified JDK already exists on your system; the installer requires a certified JDK.
See Oracle Fusion Middleware Systems Requirements and Specifications for more information. To
download the JDK, see Understanding JDK Requirements for an Oracle Fusion Middleware
Installation.

3. Go to the directory where you downloaded the installation program.

4. Launch the installation program by running java -jar from the JDK directory on your system.
See the following examples:

On UNIX operating systems:

/home/Oracle/jdk/jdk1.8.0_77/bin/java -jar
fmw_12.2.1.1.0_wls_generic.jar

On Windows operating systems:

C:\Program Files\Java\jdk1.8.0_77\bin\java -jar
fmw_12.2.1.1.0_wls_generic.jar

Be sure to replace JDK location in these examples with the actual JDK location on your system.
When the installation program opens, you are ready to begin the installation. Navigating the Installation
Screens describes each screen.

Após instalação e criação do domínio da aplicação, devem ser criadas as Origens de dados e realizada a
impantação do EAR da aplicação conforme abaixo.

Origens de Dados:

Nome: SGR_CAT_DS
JDNI: jdbc/SGR_CAT_DS
Driver: oracle.jdbc.xa.client.OracleXADataSource
BASE: CAT (exemplo: DB11CAT)
Usuário: ARBORGVT_BILLING
Nome: SGR_DS
JDNI: jdbc/SGR_DS
 Diver: oracle.jdbc.xa.client.OracleXADataSource
BASE: CAT (exemplo: DB11CAT)
Usuário: ARBORGVT_BILLING

Figure 4 - Origens de dados configuradas

Figure 5 - Exemplo de configuração de Origem de dados

Implantação

A Implantação da aplicação é realizada de forma simples, utilizando o arquivo .EAR da aplicação.

Configurações Adicionais

Abaixo seguem algumas configurações adicionais necessárias para finalizar a implantação do SGR.

Parâmetros do Weblogic

Devem ser passados dois parâmetros adicionais ao servidor do Weblogic. A forma mais simples de fazer
isso é por meio da alteração da aba “Environment” do “Run Configurations” do Eclipse conforme abaixo:

Parâmetro Valor
 CLASSPATH <CAMINHO>\src\resources\dev
JAVA_OPTIONS -DaccessControl.url=sv2klab2:7777

Importante: O host sv2klab2 deve ser configurado no arquivo de hosts da máquina apontando para o IP
correto. No momento da construção deste manual, o IP é: 10.41.252.78

Figure 6 - Parâmetros adicionais via Eclipse

Adição de Cabeçalho no Navegador

Para que o LoginBypass seja capaz de gerar a chave de autenticação do SGR, ele precisa receber o login
de acesso do Usuário. Para tanto, deve ser adicionado um cabeçalho HTTP na requisição que é enviada
para o SGR. Seguem informações do cabeçalho:

Nome Valor
login G0038268

O valor configurado acima é o Login do usuário Helder Barbos. Não se sabe de outros usuários possíveis.
Para configurar estas informações de cabeçalho, existe uma grande quantidade de aplicações. Entretanto,
para criação deste manual, foi utilizada a ferramenta “Modify Headers” para Google Chrome.

Figure 7 - Modify Headers