Docs - App Updater - Manual de Instalação

Orientações Gerais

Este  documento  tem  como  objetivo  fornecer  as  informações  necessárias  para  instalação  e configuração do Application Updater Web em ambientes Windows e Unix.

Pre-Requisitos 

Para realizar a instalação do Application Updater se faz necessário que o servidor possua o wildfly instalado 

Criação de Tabelas Base H2

Para configurar um Banco H2 para aplicação, o SO necessita de um navegador WEB instalado. Usando a linha de comando do sistema operacional, navegue até o diretório raiz do Linx-Wildfly e

digite:

i)    Para Windows:

jre\bin\java -jar modules\system\layers\base\com\h2database\h2\main\h2-1.3.173.jar

ii)   Para Linux:

jre/bin/java -jar modules/system/layers/base/com/h2database/h2/main/h2-1.3.173.jar

O navegador será iniciado e abrirá o endereço http://localhost:8082. Caso isso não ocorra, acesse o endereço manualmente.

Ao carregar o endereço descrito, o seguinte conteúdo será exibido:

Insira o comando o campo “JDBC URL” com o endereço a seguir de acordo com o sistema operacional 

i)    Para Windows:

“jdbc:h2:[Diretório onde wildfly esta instalado]:/linx-wildlfly/

standalone/data/ApplicationUpdater/db/ApplicationUpdaterDB;DB_CLOSE_DELAY=-

1;AUTO_SERVER=TRUE;CACHE_SIZE=4096" (sem aspas).

ii)   Para Linux:

“jdbc:h2:/opt/linx-wildlfy

/standalone/data/ApplicationUpdater/db/ApplicationUpdaterDB;DB_CLOSE_DELAY=-

1;AUTO_SERVER=TRUE;CACHE_SIZE=4096" (sem aspas).

No campos user name inserir o usuário sa e deixa o campo password em branco e clicar no botão connect

Após clicar no botão connect  o sistema te direcionar para a pagina abaixo:

Navegar ate o diretório onde a pasta de instalação do Application Updater  e abrir o documento  tables_h2.sql

Copie todo o conteúdo do documento.

E cole o conteúdo na area sinalizada em amarelo e depois clique em Run(Ctrl+enter)

 Após a execução será exibida as tabelas criadas na H2

Clique no botão  para desconectar da base H2, e em seguida feche o navegador 

Verificar na barra de exibições de ícones  se encontra o ícone , se sim clicar com o botão direito, e depois clicar em Exit

Configuração do datasource da aplicação

Acesse a Interface de Administração do Linx-Wildfly através da URL: http:\\IP_EP:PORTA

Navegue nas opções "Configuration" → "Subsystems" → "Datasources" → "Non-XA".

Clique em Add e selecione a opção H2 Datasource

Na tela Step 1/3: Datasource Attributes, preencher o campo Name  com “ApplicationUpdaterDS”(sem     aspas), preencher  o  campo JNDI Name com “java:jboss/datasources/ApplicationUpdaterDS” (sem aspas) e clique em "Next";

Na tela "Step 2/3: JDBC Drive", clique em "Detected driver", selecione "h2" na tabela "Name" e clique em "Next”;

Na tela "Step 3/3: Connection Settings" você deve informar os dados de conexão do banco de dados nos campos abaixo:

• Connection URL*:  jdbc:h2:${jboss.server.data.dir}/ApplicationUpdater/ApplicationUpdaterDB;DB_CLOSE_DELA Y=-1;AUTO_SERVER=TRUE;CACHE_SIZE=4096
• Username: sa
• Password: Não preencher(em branco)

Após preencher os campos clicar em Next

Após realizar a configuração reiniciar o serviço do  Wildfly 

Acesse a Interface de Administração do Linx-Wildfly e navegue pelos Menus Configuration" → "Subsystems" → "Datasources" → "Non-XA" → ApplicationUpdaterDS → Test Connection, deve ser exibida a tela abaixo:

Realização de Deploy

Clicar em Deployments → Add

Selecionar a opção Upload a new deployment  e clicar em Next

Clicar em Escolher ficheiro

Navegar ate o diretório onde se encontra o arquivo linx-application-updater-web.war e clique em open e em next para prossseguir

Clicar em Finish  e aguardar o processamento do arquivo war

Após o processamento será adicionado o deploy referente ao Application Updater

Verifique o acesso a aplicação, por exemplo:  

http://IP SERVIDOR:8080/linx-application-updater-web

Configurações adicionais

Configurações de parâmetros para funcionamento do Application Updater

São necessárias as configurações dos parâmetros abaixo para total funcionamento do Application Updater:

• network.port - porta FTP de comunicação para do EP. Através dessa porta, o EP e SP irão realizar a comunicação.
• max.login.number - número máximo de conexões permitidas no FTP, equivalente ao número de lojas. Caso tenham 100 lojas, será necessário a configuração do parâmetro como 100.
• network.server.disabled - ativação/desativação de conexão com o servidor.

Estes parâmetros estão disponíveis em C:\linx-wildfly\standalone\data\ApplicationUpdater\config\appupdater-config

Configurações adicionais Opcionais 

Criando um Domínio de Segurança para a aplicação

Para criar datasource com senha criptografada é necessário criar um domínio de segurança para o mesmo. A criação desse domínio exige conhecimentos e linha de comando do Sistema Operacional onde o Linx-Wildfly está instalado.

Primeiro  precisamos  do  texto  correspondente  da  senha  criptografada.  Para  conseguir  a  senha criptografada ver seção 7.1. Vamos assumir que o texto da senha criptografada é: "64c5fd2979a86168". Aos passos:

i)    Acesse o diretório “bin”, dentro do diretório raiz do servidor.

ii)   Localize o arquivo "jboss-cli.bat" para Windows ou "jboss-cli.sh" para Linux e execute-o.

iii)  Ao iniciar digite:

connect localhost:PORTA_GERENCIAMENTO

Onde  "PORTA_GERENCIAMENTO"  é  a  porta  da  interface  de  gerenciamento  do  servidor. Ao conectar execute o comando:

/subsystem=security/security-domain= ApplicationUpdater-security-domain/:add(cache- type=default)

Se for executado com sucesso, teremos: {"outcome" => "success"}.

iv)  A  seguir  os  campos  para  “Login”  e  “Senha”  de  acesso  ao  banco  Oracle  deverão  ser informados.   Utilize   o   texto   gerado   da   senha   criptografada   para   o   valor   do   campo "DB_PASSWORD". VOCÊ DEVE MANTER AS ASPAS NO COMANDO ABAIXO:

/subsystem=security/security-domain=ApplicationUpdater-security- domain/authentication=classic:add(login- modules=[{"code"=>"org.picketbox.datasource.security.SecureIdentityLoginModule", "flag"=>"required",                                                                                                                 "module- options"=>[("username"=>"DB_USER"),("password"=>"DB_PASSWORD"),("managedConnect ionFactoryName"=>"jboss.jca:servce=LocalTxCM,name= ApplicationUpdaterDS")] }] )

Se for executado com sucesso, teremos: {"outcome" => "success", "response-headers" => { "operation-requires-reload"        =>        true,        "process-state"        =>        "reload-required"}}

v)   O  domínio  de  segurança  ApplicationUpdater-security-domain  foi criado  e  pode  ser  usado para a configuração de datasource.