Download as
Browse Code »

Commit e22f1102b338619299c995747a0e9be5c825b53a

Authored by andre.guimaraes
1 parent 7fadd172
Exists in master and in 1 other branch removing-depencies

Documenta a configuração dos datasources 

- Procedimento de configuração dos datasources no JBoss.
Showing 1 changed file with 28 additions and 2 deletions   Show diff stats
README.md
  Diff comments   View file @e22f110
1 1 # SEI-Broker - Camada REST de acesso ao SEI
2   -O SEI-Broker é uma camada de integração que foi desenvolvida para integrar os sistemas corporativos da ANS e o SEI, Sistema Eletrônico de Informações do TRF 4. Toda essa camada foi criada utilizando o padrão RESTful de serviços web, sua função é facilitar a integração dos sistemas da ANS com o SEI, utilizando um protocolo mais simples, moderno e performático. A adoção do broker nos permite criar uma camada de abstração para evitar que mudanças no SEI afetem as integrações, isso é possivel pelo fato do broker utilizar REST e possuir contrato fraco.
  2 +O SEI-Broker é uma camada de integração que foi desenvolvida para integrar os sistemas corporativos da ANS e o SEI, Sistema Eletrônico de Informações do TRF 4. Toda essa camada foi criada utilizando o padrão RESTful de serviços web, sua função é facilitar a integração dos sistemas da ANS com o SEI, utilizando um protocolo mais simples, moderno e performático. A adoção do broker nos permite criar uma camada de abstração para evitar que mudanças no SEI afetem as integrações, isso é possível pelo fato do broker utilizar REST e possuir contrato fraco.
3 3  
4 4 O Broker atualmente está na versão 2.9, essa versão é compatível com o SEI 3.0.13. É importante destacar que é necessário atualizar o SEI-Broker a cada atualização do SEI que altere os serviços web.
5 5  
... ... @@ -11,4 +11,30 @@ Alguns serviços adicionais foram desenvolvidos extrair dados que não são ofer
11 11 - Apache Maven para baixar as dependências e compilar o pacote.
12 12 - Servidor JBoss EAP 7.0.4 ou Wildfly 10.
13 13 - Banco relacional, o Broker foi desenvolvido usando Oracle 12g, mas com pouco esforço pode utilizar o MySQL.
14   -- Conexão com a internet para que o Maven acesse os repositórios hospedeiros das dependências.
15 14 \ No newline at end of file
  15 +- Conexão com a internet para que o Maven acesse os repositórios hospedeiros das dependências.
  16 +
  17 +## Procedimentos para instalação
  18 +1. Configure as propriedades dos datasources no JBoss, elas são declaradas como System Properties.
  19 +
  20 +O broker possui dois datasources e ambos estão declarados no arquivo `sei-broker-ds.xml`, eles são identificados como `jdbc/sei-broker` e `jdbc/sei-mysql`. O `jdbc/sei-broker` foi definido para acessar as tabelas que foram projetadas para o broker, o `jdbc/sei-mysql` se conecta ao banco de dados do SEI.
  21 +
  22 +| Chave | Valor |
  23 +| --------------------------------------------- | --------------------------------------------- |
  24 +| br.gov.ans.seiBroker.db.oracle.connectionUrl | String de conexão com o banco Oracle |
  25 +| br.gov.ans.seiBroker.db.oracle.password | Senha do usuário utilizado no datasource |
  26 +| br.gov.ans.seiBroker.db.mysql.connectionUrl | String de conexão com o banco MySQL do SEI |
  27 +| br.gov.ans.seiBroker.db.mysql.user | Nome usuário com acesso ao MySQL do SEI |
  28 +| br.gov.ans.seiBroker.db.oracle.password | Senha do usuário com acesso ao MySQL do SEI |
  29 +
  30 +Abaixo um exemplo de declaração de propriedades feita no arquivo `standalone.xml`.
  31 +```xml
  32 +<!-- Geralmente no início do arquivo, após as extensions -->
  33 +<system-properties>
  34 + <!-- Outras propriedades ... -->
  35 + <property name="br.gov.ans.seiBroker.db.oracle.connectionUrl" value="jdbc:oracle:thin:@exans01db04.ans.gov.br:1523:anshm2"/>
  36 + <property name="br.gov.ans.seiBroker.db.oracle.password" value="******"/>
  37 + <property name="br.gov.ans.seiBroker.db.mysql.user" value="usuario_sei_brok"/>
  38 + <property name="br.gov.ans.seiBroker.db.mysql.connectionUrl" value="jdbc:mysql://anshmmysql01:3306/sei-ds"/>
  39 + <property name="br.gov.ans.seiBroker.db.mysql.password" value="******"/>
  40 +</system-properties>
  41 +```
... ...