JBoss Enterprise Application Platform 6.3 Guia de Instalação

Transcrição

JBoss Enterprise Application
Platform 6.3
Guia de Instalação
Para uso com o JBoss Enterprise Application Plataform 6
Red Hat Customer Content Services
JBoss Enterprise Application Platform 6.3 Guia de Instalação
Para uso com o JBoss Enterprise Application Plataform 6
Nota Legal
Co pyright © 20 15 Red Hat, Inc..
This do cument is licensed by Red Hat under the Creative Co mmo ns Attributio n-ShareAlike 3.0
Unpo rted License. If yo u distribute this do cument, o r a mo dified versio n o f it, yo u must pro vide
attributio n to Red Hat, Inc. and pro vide a link to the o riginal. If the do cument is mo dified, all Red
Hat trademarks must be remo ved.
Red Hat, as the licenso r o f this do cument, waives the right to enfo rce, and agrees no t to assert,
Sectio n 4 d o f CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shado wman lo go , JBo ss, MetaMatrix, Fedo ra, the Infinity
Lo go , and RHCE are trademarks o f Red Hat, Inc., registered in the United States and o ther
co untries.
Linux ® is the registered trademark o f Linus To rvalds in the United States and o ther co untries.
Java ® is a registered trademark o f Oracle and/o r its affiliates.
XFS ® is a trademark o f Silico n Graphics Internatio nal Co rp. o r its subsidiaries in the United
States and/o r o ther co untries.
MySQL ® is a registered trademark o f MySQL AB in the United States, the Euro pean Unio n and
o ther co untries.
No de.js ® is an o fficial trademark o f Jo yent. Red Hat So ftware Co llectio ns is no t fo rmally
related to o r endo rsed by the o fficial Jo yent No de.js o pen so urce o r co mmercial pro ject.
The OpenStack ® Wo rd Mark and OpenStack Lo go are either registered trademarks/service
marks o r trademarks/service marks o f the OpenStack Fo undatio n, in the United States and o ther
co untries and are used with the OpenStack Fo undatio n's permissio n. We are no t affiliated with,
endo rsed o r spo nso red by the OpenStack Fo undatio n, o r the OpenStack co mmunity.
All o ther trademarks are the pro perty o f their respective o wners.
Resumo
Este livro é um guia para a instalação do JBo ss Enterprise Applicatio n Platafo rm 6 e seus
lançamento s de patch.
Índice
Índice
.Prefácio
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. . . . . . . . . .
⁠1. Co nvenç õ es d e Do c umento s
3
⁠1.1. Co nvenç õ es Tip o g ráfic as
3
⁠1.2. Co nvenç õ es d e Pull-Q uo te
4
⁠1.3. No tas e Avis o s
5
⁠2 . O b tend o Ajud a e Fo rnec end o Co mentário s
5
⁠2 .1. Vo c ê p rec is a d e ajud a?
6
⁠2 .2. Nó s p rec is amo s d o s eu Co mentário !
6
. .apít
⁠C
. . . ulo
...1
. .. .Visão
. . . . .G. eral
. . . . do
. . .Produt
. . . . . . o. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7. . . . . . . . . .
⁠1.1. Red Hat JBo s s Enterp ris e Ap p lic atio n Platfo rm 6
7
⁠1.2. Rec urs o s d o JBo s s EAP 6
7
. .apít
⁠C
. . . ulo
...2
. .. .Int
. . rodução
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9. . . . . . . . . .
⁠2 .1. Po rtal d o Cliente Red Hat
9
. .apít
⁠C
. . . ulo
. . . 3.
. . Solicit
. . . . . . ações
. . . . . .do
. . .sist
. . .ema
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. 0. . . . . . . . . .
⁠3 .1. Pré-req uis ito s d a Ins talaç ão d o JBo s s EAP 6
10
. .apít
⁠C
. . . ulo
...4
. .. .Inst
. . . ruções
. . . . . . .de
. . Inst
. . . .alação
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. 1. . . . . . . . . .
⁠4 .1. Méto d o s d e Ins talaç ão d o JBo s s EAP 6
11
⁠4 .2. Ins talaç ão Zip
11
⁠4 .2.1. Do wnlo ad d o JBo s s EAP 6 (Ins talaç ão Zip )
11
⁠4 .2.2. Ins talaç ão d o JBo s s EAP 6 (Ins talaç ão ZIP)
12
⁠4 .2.3. Des ins talaç ão d o JBo s s EAP 6 (Ins talaç ão Zip )
13
⁠4 .3. Ins taller
13
⁠4 .3.1. Do wnlo ad d o JBo s s EAP 6 (Ins taller)
13
⁠4 .3.2. Exec uç ão d o Pro g rama d e Ins talaç ão d o JBo s s EAP
14
⁠4 .3.3. Des ins talaç ão d o JBo s s EAP 6 (Ins taller)
17
⁠4 .4. Ins talaç ão G ráfic a RPM
18
⁠4 .4.1. Ins talaç ão d o JBo s s EAP 6 (Ins talaç ão RPM G ráfic a)
18
⁠4 .5. Ins talaç ão RPM b as ead a em texto
19
⁠4 .5.1. Ins talaç ão d o JBo s s EAP 6 (Ins talaç ão RPM b as ead o em texto )
19
⁠4 .6 . Ins talaç ão Auto matiz ad a
20
⁠4 .6 .1. Ins talaç ão d e Ins tânc ias Múltip las d o JBo s s EAP 6 (Ins taller)
20
⁠4 .6 .2. Us o d o Sc rip t d e Ins talaç ão Auto mátic a (auto .xml) a p artir d e fo ntes d iferentes p ara
ins talaç ão d o JBo s s EAP 6
21
⁠4 .7. Ab o rd ag ens d a Ins talaç ão Auto matiz ad a
21
⁠4 .7.1. Ab o rd ag ens d a Ins talaç ão Auto mátic a
21
⁠4 .7.2. Ins talaç ão d o JBo s s EAP 6 p ela p ré-c o nfig uraç ão d e Valo res d a Chave/Senha no Arq uivo
d a Variável d e Ins talaç ão Auto mátic a
22
⁠4 .7.3. Ins tale o JBo s s EAP 6 auto matic amente p ela es p ec ific aç ão d o s Valo res d e Chave/Senhas
d urante o p erío d o d e ins talaç ão
22
⁠4 .8 . Ins talaç ão d o Native Co mp o nents e Utilities
23
⁠4 .8 .1. Ins talaç ão d o Native Co mp o nents e Native Utilities (Zip , Ins taller)
23
⁠4 .8 .2. Ins talaç ão d o Native Co mp o nents e Native Utilities (Ins talaç ão RPM)
24
⁠4 .9 . Co nfig uraç ão d e Serviç o
25
⁠4 .9 .1. Co nfig ure o JBo s s EAP 6 c o mo um Serviç o no Red Hat Enterp ris e Linux (Méto d o RPM)
25
⁠4 .9 .2. Co nfig uraç ão d o JBo s s EAP 6 c o mo um Serviç o no Red Hat Enterp ris e Linux (Zip ,
Ins taller)
26
⁠4 .9 .3. Co nfig ure o JBo s s EAP 6 c o mo um Serviç o no Servid o r d o Mic ro s o ft Wind o ws (Zip ,
Ins taller)
29
. .apít
⁠C
. . . ulo
. . . 5.
. . Pat
. . . ching
. . . . . .e. At
. . ualiz
. . . . .ação
. . . . do
. . . JBoss
. . . . . .EAP
. . . .6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
...........
1
JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação
. .apít
⁠C
. . . ulo
. . . 5.
. . Pat
. . . ching
. . . . . .e. At
. . ualiz
. . . . .ação
. . . . do
. . . JBoss
. . . . . .EAP
. . . .6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
...........
⁠5 .1. Patc hes e Atualiz aç õ es
32
⁠5 .2. Realiz and o o p atc hing ao JBo s s EAP 6
32
⁠5 .2.1. Mec anis mo s d e Ap lic aç ão d e Patc h
32
⁠5 .2.2. Realiz and o o p atc hing a uma Ins talaç ão ZIP/Ins taller
⁠5 .2.2.1. Patc h Manag ement Sys tem
33
33
⁠5 .2.2.2. Ins talaç ão d e Patc hes no Fo rmulário Zip us and o o Patc h Manag ement Sys tem
⁠5 .2.2.3. Revers ão d o Ap lic ativo d e um Patc h no Fo rmulário Zip us and o o Patc h Manag ement
Sys tem
⁠5 .2.3. Realiz and o uma Ins talaç ão RPM
⁠5 .2.4. Sub s c riç ão p ara as Lis tas d e Co rreio Patc h
⁠5 .2.5. Clas s ific aç ão d e imp ac to e g ravid ad e d o JBo s s Sec urity Patc hes (Patc hes d e Seg uranç a
JBo s s )
⁠5 .3. Atualiz aç ão d o JBo s s EAP 6
⁠5 .3.1. Atualiz aç ão d a Ins talaç ão ZIP d o JBo s s EAP 6
⁠5 .3.2. Atualiz aç ão d a Ins talaç ão RPM d o JBo s s EAP 6
⁠5 .3.3. Atualiz aç ão d o JBo s s EAP Clus ter a p artir d o 6 .2 p ara o 6 .3
35
36
38
40
40
42
42
43
44
. . . .erial
Mat
. . . .de
. . .Referência
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4. 5. . . . . . . . . .
⁠A .1. Do wnlo ad s Dis p o níveis p ara o JBo s s EAP 6
⁠A .2. Es trutura d o Diretó rio d o JBo s s EAP 6
45
46
⁠A .3. Lis ta d o Pac o te RPM p ara o JBo s s EAP 6
⁠A .4. O s Arq uivo s d a Co nfig uraç ão d e Ins talaç ão p ara o JBo s s EAP 6
48
49
. . . . .ura
Capt
. . .de
. . .T.ela
. . .do
. . .Inst
. . . aller
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
...........
⁠B .1. Seleç ão d o Id io ma
⁠B .2. Ac o rd o d a Lic enç a d o Us uário
51
51
⁠B .3. Caminho d a Ins talaç ão
⁠B .4. Seleç ão d e Pac o tes p ara Ins talaç ão
52
53
⁠B .5. No va c riaç ão d e us uário
⁠B .6 . Ins talaç ão d e Inic iaç ão Ráp id a
54
55
⁠B .7. Co nfig uraç ão d o Rep o s itó rio Maven
⁠B .8 . Co nfig uraç ão So c ket Bind ing
⁠B .9 . So c ket Bind ing s Pers o naliz ad o s p ara as Co nfig uraç õ es Autô no mas
56
57
60
⁠B .10 . So c ket Bind ing s Pers o naliz ad o s p ara as Co nfig uraç õ es Do main
⁠B .11. Iníc io d o Servid o r
64
69
⁠B .12. Co nfig uraç ão d o s Níveis d e Lo g o n
⁠B .13. Co nfig uraç ão d o Amb iente d o Perío d o d e Exec uç ão
70
71
⁠B .14. Revis ão d o s Co mp o nentes d e Ins talaç ão
⁠B .15. Pro g res s o d a Ins talaç ão
73
74
⁠B .16 . Co nfig uraç ão Vault d e Senha
⁠B .17. Co nfig uraç ão d a Seg uranç a SSL
75
76
⁠B .18 . Co nfig uraç ão LDAP
⁠B .19 . Co nfig uraç ão Infinis p an
⁠B .20 . Co nfig uraç ão d o Sec urity Do main
77
78
79
⁠B .21. Co nfig uraç ão d o JDBC Driver
⁠B .22. Co nfig uraç ão d a Fo nte d e Dad o s
81
82
⁠B .23. Pro c es s amento d e Ins talaç ão Co nc luíd a
⁠B .24. Criaç ão d e Atalho s
83
84
⁠B .25. G erand o o Sc rip t d e Ins talaç ão
85
. . . . órico
Hist
. . . . . de
. . .Revisão
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8. 7. . . . . . . . . .
2
Prefácio
Prefácio
1. Convenções de Document os
Este manual usa diversas convenções para destacar certas palavras e frases e chamar a atenção
para informações específicas.
1.1. Convenções T ipográficas
São usadas quatro convenções tipográficas para realçar palavras e frases específicas. Estas
convenções, e circunstâncias a que se aplicam, são as seguintes:
Neg ri to Espaço Úni co (Mono-spaced Bold)
Usada para realçar entradas do sistema, incluindo comandos de shell, nomes de arquivos e
caminhos. São também usadas para realçar teclas Maiúsculas/Minúsculas e as combinações de
teclas. Por exemplo:
Para ver o conteúdo do arquivo my_next_bestsel l i ng _no vel em sua pasta de
trabalho atual, insira o comando cat my_next_bestsel l i ng _no vel na janela
de solicitação e pressione Enter para executar o comando.
O comando acima inclui um nome de arquivo, um comando de shell e uma tecla, todos
apresentados em Negrito Espaço Único (Mono-spaced Bold) e todos distintos, graças ao conteúdo.
As combinações de tecla podem ser diferenciadas de uma tecla individual pelo sinal positivo que
conecta cada parte da combinação da tecla. Por exemplo:
Pressione Enter para executar o comando.
Pressione C trl +Al t+F2 para trocar ao terminal virtual.
A primeira sentença, destaca uma tecla específica a ser pressionada. A segunda destaca duas
combinações de teclas: um conjunto de três teclas pressionadas simultaneamente.
Caso o código fonte seja discutido, serão apresentados como acima, os nomes de classe, métodos,
funções, nomes de variantes e valores retornados mencionados em um parágrafo, em Neg ri to d e
Espaço Úni co (Mo no -spaced Bo l d ). Por exemplo:
Classes baseadas em arquivo, incluem fi l esystem para sistemas de arquivo,
fi l e para arquivos, e d i r para diretórios. Cada classe possui seu conjunto próprio
de permissões associadas.
N eg rit o Pro p o rcio n al
Esta representa as palavras e frases encontradas no sistema, incluindo os nomes de aplicativos,
texto de caixa de diálogo, botões rotulados, caixa de seleção e rótulos de botão de opção, títulos de
menus e submenus. Por exemplo:
Escolha Sist ema → Pref erên cias → Mo u se da barra do menu principal para
lançar Mo u se Pref eren ces. Na aba Bo tõ es selecione o Bo tão d a esq uerd a
d o mo use selecione a caixa e cliquem emFecharpara mudar o botão inicial do
mouse da esquerda para a direita (tornando o mouse adequado para o uso na mão
esquerda).
Selecione Ap p licat io n s → Accesso ries → C h aract er Map a partir da barra de
menu principal, com o objetivo de inserir um caractere especial ao arquivo g ed it . Em
3
seguida, selecione Search → Fin d … a partir da barra do menu C h aract er Map ,
digite o nome do caractere no campo Search e clique em Next. O caractere
pesquisado aparecerá destacado no C haracter T abl e. Clique duas vezes no
caractere destacado para posicioná-lo no campo T ext to co py e clique no botão
C o py. Retorne ao seu documento e selecione Ed it → Past e a partir da barra do
menu g ed it .
O texto acima inclui nomes de aplicativos, nomes de menu e itens de todo o sistema, nomes de menu
específicos do aplicativo, e botões e textos encontrados na Interface Gráfica GUI, todos
apresentados em Negrito Proporcional (Proportional Bold) e todos diferenciados de acordo com o
contexto.
Itálico em Negrito de Espaço Único (Mono-spaced Bold Italic) ou Itálico em
Negrito Proporcional (Proportional Bold Italic)
Sendo o Negrito Espaço Único (Mono-spaced Bold) ou Negrito Proporcional (Proportional Bold), os
itálicos extras indicam textos substituíveis ou variáveis. O Itálico denota o texto que você não inseriu
literalmente ou textos exibidos que mudam dependendo das circunstâncias. Por exemplo:
Para conectar-se à uma máquina remota usando o ssh, digite ssh nome do
usuário@ domain.name na janela de comandos. Por exemplo, considere que a
máquina remota seja exampl e. co m e seu nome de usuário nesta máquina seja
john, digite ssh jo hn@ exampl e. co m.
O comando mo unt -o remo unt file-system remonta o sistema de arquivo
nomeado. Por exemplo, para remontar o sistema de arquivo /ho me, o comando é
mo unt -o remo unt /ho me.
Para ver a versão de um pacote instalado, use o comando rpm -q package. Ele
retornará um resultado como este: package-version-release.
Perceba as palavras em negrito e itálico acima - username, domain.name, file-system, package,
version e release. Cada palavra é um espaço reservado, tanto para o texto que você insere quando
emitindo um comando ou para textos exibidos pelo sistema.
Além de uso padrão para apresentar o título de um trabalho, os itálicos denotam a primeira vez que
um termo novo e importante é usado. Por exemplo:
O Publican é um sistema de publicação do DocBook.
1.2. Convenções de Pull-Quot e
Resultado de terminal e listagem de código fonte são definidos visualmente com base no contexto.
O resultado enviado à um terminal é configurado em R o mano d e Espaço Úni co (Mo no spaced R o man) e apresentado assim:
books
books_tests
Desktop
Desktop1
documentation drafts mss
downloads
images notes
photos
scripts
stuff
svgs
svn
As listas de código fonte também são configuradas em R o mano d e Espaço Úni co (Mo no spaced R o man), porém são apresentadas e realçadas como a seguir:
static int kvm_vm_ioctl_deassign_device(struct kvm *kvm,

struct kvm_assigned_pci_dev *assigned_dev)

{

int r = 0;
4
Prefácio

struct kvm_assigned_dev_kernel *match;

mutex_lock(& kvm->lock);

match = kvm_find_assigned_dev(& kvm->arch.assigned_dev_head,
assigned_dev->assigned_dev_id);
if (!match) {
printk(KERN_INFO "%s: device hasn't been assigned

before, "

"so cannot be deassigned\n", __func__);
r = -EINVAL;
goto out;

}

kvm_deassign_device(kvm, match);

kvm_free_assigned_device(kvm, match);
o ut:

mutex_unlock(& kvm->lock);
return r;

}
1.3. Not as e Avisos
E por fim, usamos três estilos visuais para chamar a atenção para informações que possam passar
despercebidas.
Nota
Uma nota é uma dica ou símbolo, ou ainda uma opção alternativa para a tarefa em questão.
Se você ignorar uma nota, provavelmente não resultará em más consequências, porém
poderá deixar passar uma dica importante que tornará sua vida mais fácil.
Importante
Caixas importantes detalham coisas que são geralmente fáceis de passarem despercebidas:
mudanças de configuração que somente se aplicam à sessão atual, ou serviços que
precisam ser reiniciados antes que uma atualização seja efetuada. Se você ignorar estas
caixas importantes, não perderá dados, porém isto poderá causar irritação e frustração.
Atenção
Um Aviso não deve ser ignorado. Se você ignorar avisos, muito provavelmente perderá
dados.
2. Obt endo Ajuda e Fornecendo Coment ários
5
2.1. Você precisa de ajuda?
Se encontrar dificuldades com o procedimento descrito nesta documentação, você pode encontrar
ajuda visitando o Portal do Cliente da Red Hat em http://access.redhat.com. Você poderá realizar o
seguinte através do portal do cliente:
realize buscas ou navegue através da base de conhecimento dos artigos de suporte técnico
sobre os produtos da Red Hat.
insira o caso de suporte nos Serviços de Suporte Global da Red Hat (GSS).
acesso a outra documentação da Red Hat.
A Red Hat acomoda um grande número de listas de correio eletrônico para discussão de software e
tecnologias da Red Hat. Você pode encontrar uma lista contendo as listas públicas disponíveis em
https://www.redhat.com/mailman/listinfo. Clique no nome de qualquer lista para subscrever àquela
lista ou acessar o histórico das listas.
2.2. Nós precisamos do seu Coment ário!
Se você encontrar erro ortográfico neste manual, ou se você tem uma sugestão para melhoramento
deste manual, nós gostaríamos muito de ouvir sua opinião! Por favor submita um relatório em
Bugzilla:http://bugzilla.redhat.com/ contra o produto JB o ss En t erp rise Ap p licat io n Plat f o rm..
Ao submeter um relatório de erro, certifique-se de mencionar a identificação do
manual:Installation_Guide.
Se você tiver uma sugestão para o melhoramento deste documento, por favor tente ser o mais
específico possível em sua descrição. Caso você tenha encontrado um erro, por favor inclua o
número da seção e alguns detalhes a respeito do texto para a nossa melhor identificação.
6
⁠Capít ulo 1 . Visão G eral do Produt o
Capítulo 1. Visão Geral do Produto
1.1. Red Hat JBoss Ent erprise Applicat ion Plat form 6
O Red Hat JBoss Enterprise Application Platform 6 (JBoss EAP 6) é uma plataforma middleware
construída nos padrões open source e compatível à especificação Java Enterprise Edition 6. Ele
integra o JBoss Application Server 7 com clustering altamente disponível, mensagens, cache
distribuído e outras tecnologias.
O JBoss EAP 6 inclui uma estrutura nova e modular que permite o serviço habilitar apenas o que é
requerido, melhorando a velocidade de início.
O Management Console e a Management Command Line Interface fazem edições desnecessárias
dos arquivos de configuração XML e adicionam a habilidade ao script e de automatizar tarefas.
Além disso, o JBoss EAP inclui APIs e frameworks de desenvolvimento para assegurar o
desenvolvimento rápido e escalável dos aplicativos Java EE.
Reportar um erro
1.2. Recursos do JBoss EAP 6
T ab ela 1.1. R ecu rso s 6 .3.0
R ecu rso
D escrição
Certificação Java
Java Enterprise Edition 6 Full Profile e Web
Profile certificado.
Managed D omain
O gerenciamento centralizado das
instâncias do servidor múltiplo e hosts
físicos, enquanto o servidor autônomo
permite uma instância do servidor única.
O gerenciamento do grupo por servidor da
configuração, implementação, socket
bindings, módulos, extensões e
propriedades de sistema.
Gerenciamento centralizado e simplificado
da segurança do aplicativo (incluindo
security domains).
Management Console e Management CLI
Novas interfaces de gerenciamento do servidor
autônomo e domain. A edição do arquivo de
configuração XML não é mais requerido. O
Management CLI inclui também um modo em
lote que pode realizar o script e automatizar as
tarefas de gerenciamento.
7
R ecu rso
D escrição
Layout de gerenciamento simplificado
O diretório mo d ul es contém agora todos os
módulos dos servidores. Os diretórios l i b
comuns e específicos de servidor estão
preteridos. Os diretórios d o mai n e
stand al o ne contém os artefatos e arquivos de
configuração para as implantações autônomas
e de domain respectivamente.
Os módulos são carregados e descarregados
sob pedido. Isto aumenta o desempenho,
possui benefícios de segurança e reduz os
períodos de início e reinício.
Os drivers de banco de dados são implantados
da mesma maneira que outros serviços. Além
disso, as fontes de dados são criadas e
gerenciadas diretamente no Management
Console ou Management CLI.
O JBoss EAP 6 usa os recursos de sistema e os
usa de forma mais eficiente que as versões
anteriores. Entre os benefícios está o início e
encerramento mais rápido do JBoss EAP 6
comparado ao JBoss EAP 5.
Mecanismo de carregamento de carga modular
Gerenciamento da fonte de dados aprimorados
Uso de recurso mais eficiente e reduzido.
Reportar um erro
8
⁠Capít ulo 2 . Int rodução
Capítulo 2. Introdução
2.1. Port al do Client e Red Hat
O Portal do Cliente Red Hat é uma plataforma centralizada para recursos de subscrição e
conhecimento da Red Hat. Use o Portal do Cliente Red Hat para:
Gerenciar e manter os contratos de suporte e direitos Red Hat;
Baixar o software oficialmente suportado;
Acessar a documentação do produto e o Red Hat Knowledgebase;
Contatar o Serviço de Suporte Global e;
Submeter bugs em relação aos produtos Red Hat.
O Portal do Cliente encontra-se disponível no: https://access.redhat.com.
Reportar um erro
9
Capítulo 3. Solicitações do sistema
3.1. Pré-requisit os da Inst alação do JBoss EAP 6
Cada processo de instalação para o JBoss EAP 6 possui um número de pré-requisitos. Esta seção
descreve os requerimentos comuns, assim como os requerimentos que são específicos da
instalação.
Pré- req u isit o s C o mu n s
Crie uma conta do Portal do Cliente Red Hat no https://access.redhat.com. Por favor refira-se à
Seção 2.1, “ Portal do Cliente Red Hat” para maiores informações.
Revise as configurações suportadas e garanta de que seu sistema é suportável:
https://access.redhat.com/site/articles/111663.
Certifique-se de que seu sistema está atualizado com a errata e atualizações emitidas pela Red
Hat.
Pré- req u isit o s d o Z IP/In st aller
Privilégios de administração para o diretório de instalação.
Garanta que o JD K escolhido tenha sido extraído (ou instalado). Refira-se à documentação JD K
para maiores informações em como realizar isto.
No Servidor do Microsoft Windows, certifique-se que as variáveis do ambiente PATH e
JAVA_HOME foram configuradas, do contrário os atalhos não funcionarão.
No Hewlett-Packard HP-UX, certifique-se que a utilidade unzi p foi instalada.
Pré- req u isit o s R PM
Registro do servidor no Red Hat Network.
Subscreva o canal de software base do Servi d o r d o R ed Hat Enterpri se Li nux Server
apropriado a sua versão do Red Hat Enterprise Linux.
Subscreva ao sub-canal JBo ss Appl i cati o n P l atafo rm fo r Server no grupo JBo ss
Enterpri se P l atafo rm.
No Red Hat Enterprise Linux 5, o JD K 6 deve ser instalado, mesmo que apenas o JD K 7 seja
usado. No Red Hat Enterprise Linux 6 e versões mais avançadas, apenas o JD K 7 é solicitado.
Isto pode ser obtido pela subscrição ao canal de software suppl ementary para sua instalação
do Red Hat Enterprise Linux. Por exemplo, o canal para a versão 6 instalada na arquitetura i386
do Red Hat Enterprise Linux version 6 é rhel -i 386 -server-suppl ementary-6 .
Pré- req u isit o s p p c6 4
No Red Hat Enterprise Linux 6, subscreva-se ao canal rhel -ppc6 4 -server-o pti o nal -6 .
No Red Hat Enterprise Linux 7, subscreva-se ao repositório rhel -7-server-o pti o nal -rpms7Server.
Reportar um erro
10
⁠Capít ulo 4 . Inst ruções de Inst alação
Capítulo 4. Instruções de Instalação
4 .1. Mét odos de Inst alação do JBoss EAP 6
Existem diversas maneiras de instalar o JBoss EAP 6. Cada método é melhor usado em
determinadas situações. Este tópico fornece uma rápida visão de cada tipo de instalação e os links
às seções que descrevem os processos de instalação relevantes.
T ab ela 4 .1. Mét o d o s d e In st alação
Mét o d o
D escrição
Instalação Z ip
O arquivo Z ip é apropriado em
instalações de todos sistemas
operacionais suportados. Este
processo deve ser usado caso
você deseje extrair a instância
manualmente.
O JAR installer pode ser
executado num console ou
num assistente gráfico. Ambas
as opções fornecem instruções
passo-a-passo de instalação e
configuração da instância do
servidor. A configuração
adicional, incluindo as
Inicializações Rápidas e o
Repositório Maven, é também
viável com o instalador.
O JBosss EAP 6 pode ser
instalado com o instalador
gráfico do pacote RPM
suportado ou com uma
interface da linha de comando.
Este método é adequado para
instalações suportadas do Red
Hat Enterprise Linux 5 e 6.
JAR Installer
Instalação RPM
In st ru çõ es
Seção 4.2.2, “ Instalação do
JBoss EAP 6 (Instalação
Z IP)”
Seção 4.3.2, “ Execução do
Programa de Instalação do
JBoss EAP”
RPM Gráfica)”
RPM baseado em texto)”
Reportar um erro
4 .2. Inst alação Zip
4 .2.1. Download do JBoss EAP 6 (Inst alação Zip)
Pré- req u isit o s:
Seção 3.1, “ Pré-requisitos da Instalação do JBoss EAP 6”
Su mário
O arquivo JBoss EAP 6 Z ip está disponível no Portal do Cliente Red Hat. A instalação do arquivo
Z ip é uma plataforma independente e é a maneira preferida para instalação do JBoss EAP 6 em
todas as plataformas suportadas. Este tópico descreve as etapas para baixar o arquivo.
11
Pro ced imen t o 4 .1. R ealiz e o d o wn lo ad d o arq u ivo Z ip
1. Abra um navegador e entre no Portal do Cliente no https://access.redhat.com.
2. Clique em D o wn lo ad s.
3. Clique em R ed Hat JBo ss Enterpri se Appl i cati o n P l atfo rm na lista D o wnl o ad s
d o P ro d uto .
4. Selecione a versão do JBoss EAP a partir do menu suspenso Versão .
5. Encontre o R ed Hat JBo ss Enterpri se Appl i cati o n P l atfo rm 6 . x.x na lista e
clique na opção D o wnl o ad .
R esu lt ad o
O JBoss EAP 6 foi baixado na sua máquina de destino, pronto para instalação.
Pró ximo Passo em In st alação Z ip
Seção 4.2.2, “ Instalação do JBoss EAP 6 (Instalação Z IP)”
Reportar um erro
4 .2.2. Inst alação do JBoss EAP 6 (Inst alação ZIP)
Passo s An t erio res em In st alação Z ip
Seção 4.2.1, “ D ownload do JBoss EAP 6 (Instalação Z ip)”
Su mário
Este tópico descreve as etapas para instalar o JBoss EAP 6 usando o arquivo Z IP baixado.
Pro ced imen t o 4 .2. In st alação d o Arq u ivo Z IP
1. Mo va o arq u ivo Z IP à lo caliz ação d esejad a.
Mova o arquivo Z IP ao servidor e o diretório onde você planeja instalar o JBoss EAP 6. O
usuário irá iniciar e encerrar o servidor deve possuir acesso de leitura e gravação a este
diretório.
2. U se u m ap licat ivo ap ro p riad o p ara ext rair o arq u ivo Z IP à lo caliz ação d esejad a.
Num ambiente do Red Hat Enterprise Linux, use a utilidade unzi p para extrair os conteúdos
do arquivo Z IP.
Num ambiente do Microsoft Windows, clique no botão direito do mouse e selecione Extrai r
T ud o .
Num ambiente do Hewlett-Packard HP-UX, use a utilidade unzi p para extrair os conteúdos
do arquivo Z IP.
R esu lt ad o
O JBoss EAP 6 foi instalado com êxito. O diretório criado pela extração do arquivo Z IP é o diretório
de nível superior para o servidor. Isto é referido como EAP_HOME.
12
Seção 4.2.3, “ D esinstalação do JBoss EAP 6 (Instalação Z ip)”
Reportar um erro
4 .2.3. Desinst alação do JBoss EAP 6 (Inst alação Zip)
Passo s An t erio res em In st alação Z ip
Pré- req u isit o s
Realize o backup de quaisquer arquivos de configuração modificados e implantações que podem
ser reusadas numa instância mais tarde.
Su mário
Esta seção descreve as etapas requeridas para desinstalar a instalação Z ip do JBoss EAP 6.
Pro ced imen t o 4 .3. D esin t alação d o JB o ss EAP 6 ( In st alação Z ip )
1. D irija-se ao diretório onde você extraiu a pasta do JBoss EAP 6 do arquivo Z ip.
2. R emo va o d iret ó rio d e in st alação .
O JBoss EAP 6 instala num diretório único onde você usa o método de instalação Z ip.
Exclua o diretório de instalação para desinstalar o JBoss EAP 6.
3. O p cio n al: R emo va q u aisq u er scrip t s d e in icializ ação q u e vo cê crio u .
Caso tenha criado os scripts de instalação ou outros scripts que dependem do JBoss EAP 6
sendo instalado em seu computador, exclua-os.
R esu lt ad o
O JBoss EAP é desinstalado do servidor.
Reportar um erro
4 .3. Inst aller
4 .3.1. Download do JBoss EAP 6 (Inst aller)
Su mário
O arquivo do instalador do JBoss EAP 6 está disponível a partir do Portal do Cliente Red Hat. O
arquivo . jar pode ser usado para executar tanto nos instaladores gráficos ou baseados em texto.
Este tópico descreve as etapas para baixar o arquivo.
Pro ced imen t o 4 .4 . D o wn lo ad d o In st aller
13
1. Abra um navegador e entre no Portal do Cliente https://access.redhat.com.
2. Clique em D o wn lo ad s.
3. Clique em R ed Hat JBo ss Enterpri se Appl i cati o n P l atfo rm na lista D o wnl o ad s
d o P ro d uto .
4. Selecione a versão do JBoss EAP a partir do menu suspenso Versão .
5. Encontre R ed Hat JBo ss Enterpri se Appl i cati o n P l atfo rm 6 . x.x Instal l er
na lista e clique na opção D o wnl o ad .
R esu lt ad o
O JBoss EAP foi baixado na sua máquina de destino, pronto para instalação.
Pró ximo Passo em In st aller
Seção 4.3.3, “ D esinstalação do JBoss EAP 6 (Installer)”
Reportar um erro
4 .3.2. Execução do Programa de Inst alação do JBoss EAP
O programa de instalação do JBoss EAP pode ser executado tanto no modo de texto ou gráfico.
Este tópico descreve o comando para executar o programa de instalação no modo gráfico.
Pro ced imen t o 4 .5. Execu ção d o Pro g rama d e In st alação d o JB o ss EAP
1. Abra um terminal e navegue ao diretório contendo o JAR do programa de instalação
baixado.
2. D igite o seguinte comando:
java -jar jboss-eap-6.3.0-installer.jar
3. Siga as instruções da tabela abaixo.
T ab ela 4 .2. T elas d o Pro g rama d e In st alação d o JB o ss EAP
N o me d a t ela
Q u an d o ist o
ap arece
D escrição
Seção B.1, “ Seleção
do Idioma”
Seção B.2, “ Acordo da
Licença do Usuário”
Sempre
Selecione o idioma desejado para o programa
de instalação e clique em O K.
O EULA para o RED HAT JBOSS MID D LEWARE.
Seção B.3, “ Caminho
da Instalação”
Seção B.4, “ Seleção
de Pacotes para
Instalação”
Sempre
14
Sempre
Selecione " Eu aceito os termos do acordo de
licença" e clique em P ró xi ma.
Sempre
Selecione o caminho de instalação para o
JBoss EAP e clique em P ró xi ma. .
Selecione os pacotes para instalação. Os
pacotes requeridos são desabilitados para a
desmarcação.
N o me d a t ela
Q u an d o ist o
ap arece
D escrição
Seção B.5, “ Nova
criação de usuário”
Sempre
Crie um usuário administrativo e determine uma
senha. A senha deve possuir pelo menos oito
caracteres longo, com um caractere
alfanumérico, um dígito e um caractere nãoalfanumérico. Então, clique em P ró xi ma.
Instale as amostras de iniciação rápida. Caso
você deseje instalá-las, selecione Si m e
selecione o caminho de instalação. Caso você
não deseje instalá-las, selecione Não . Então,
clique em P ró xi ma.
O repositório Maven com host público está
disponível para uso com as iniciações rápidas.
As seleções default configuram
automaticamente a sua instalação para uso
deste repositório. Esta é a maneira mais fácil de
executar as iniciações rápidas. Caso você
prefira, especifique o caminho a um repositório
instalado localmente. Especifique um caminho
caso o arquivo de configurações Maven não
esteja na localização default.
D etermine se a instalação usará os bindings de
porta default, configure os bindings de porta
personalizada ou configure os deslocamentos
para todos os bindings default. Caso você
selecione bindings personalizados, selecione
para configuração tanto as portas para o modo
autônomo, domain ou ambos. Caso você
escolha em configurar os deslocamentos de
porta, selecione o deslocamento. Então clique
em P ró xi ma.
Configure as portas e as propriedades de
sistema para vários modos autônomo e clique
em P ró xi ma.
Seção B.6, “ Instalação Sempre
de Iniciação Rápida”
Seção B.7,
“ Configuração do
Repositório Maven”
Caso deseje instalar
as amostras de
iniciação rápida
Seção B.8,
“ Configuração Socket
Binding”
Sempre
Seção B.9, “ Socket
Bindings
Personalizados para
as Configurações
Autônomas”
Seção B.10, “ Socket
Bindings
Personalizados para
as Configurações
D omain”
Seção B.11, “ Início do
Servidor”
Caso opte por
configurar os bindings
de porta
personalizado para o
modo autônomo
Caso deseje
configurar os bindings
de porta
personalizado para o
modo domain.
Sempre
Seção B.12,
“ Configuração dos
Níveis de Logon”
Seção B.13,
Ambiente do Período
de Execução”
Sempre
Sempre
Configure as portas e propriedades para vários
modos domain e clique em P ró xi ma.
Selecione a opção de iniciação na conclusão
do processo de instalação. Então, clique em
P ró xi ma.
Selecione Si m para configurar os níveis do log
ou Não para pular esta configuração. Então,
Selecione Executar a co nfi g uração
d efaul t e clique P ró xi ma para continuar.
15
N o me d a t ela
Q u an d o ist o
ap arece
D escrição
Seção B.14, “ Revisão
dos Componentes de
Instalação”
Seção B.15,
“ Progresso da
Instalação”
Seção B.16,
“ Configuração Vault
de Senha”
Sempre
Revise as suas seleções e clique em P ró xi ma.
Sempre
Quando o progresso da instalação completar,
Caso opte por instalar
o vault numa
configuração
avançada do ambiente
do período da
execução
Caso você deseje
habilitar o SSL de
segurança numa
configuração
do período de
execução
Caso decida por
habilitar a
Configuração LD AO
numa configuração
avançada do período
de execução
Configure a senha vault para armazenar todas
as senhas confidenciais num keystore
criptografado e clique em P ró xi ma. Consulte o
Guia de Configuração e Administração:
" Mascare a Senha Keystore e Inicialize o Vault
da Senha" .
Configure um SSL keystore para assegurar as
interfaces de gerenciamento EAP. D epois, clique
em P ró xi ma. Consulte o Guia de Segurança
" Gerar uma Chave de Criptografia SSL e
Certificado "
Seção B.17,
“ Configuração da
Segurança SSL”
Seção B.18,
“ Configuração LD AP”
Seção B.19,
“ Configuração
Infinispan”
Seção B.20,
Security D omain”
Seção B.21,
JD BC D river”
16
Habilite a autenticação LD AP para uso do
servidor do diretório LD AP como fonte de
autenticação para o Management Console,
Management CLI ou Management API. Quando
houver finalizado, clique em P ró xi ma.
Consulte o Guia de Configuração e
Administração: " Uso do LD AP para Autenticar
as Interfaces de Gerenciamento"
Caso deseje instalar o Crie um cache Infinispan para os dados do
cache Infinispan numa cache de gerenciamento. Forneça um nome
configuração
Infinispan, configure outros campos e clique em
avançada do ambiente P ró xi ma. Consulte o Guia de Configuração e
do período de
Administração: " Capítulo Infinispan 14"
execução
Caso deseje adicionar Configure o security domain para incorporar os
o security domain na
serviços fornecidos pelo PicketBox a uma
configuração
instância do servidor JBoss EAP. A maioria dos
avançada do ambiente campos que são populados com os valores
do período de
default e não precisam de modificações.
execução
Quando houver finalizado, clique em P ró xi ma.
Consulte o Guia de Configuração e
Administração: " Security D omains" para
maiores informações.
Caso deseje instalar o Instale e configure um JD BC driver para
JD BC driver na
converter o seu código de aplicativo ao idioma
configuração
de banco de dados relevante. Escolha o driver
avançada do ambiente apropriado a partir da lista suportada de
do período de
drivers que aparecem na lista suspensa do
execução
" D river Vendor" . Consulte o Guia de
Configuração e Administração: " Gerenciamento
da Fonte de D ados 6" para maiores
informações.
N o me d a t ela
Q u an d o ist o
ap arece
D escrição
Seção B.22,
“ Configuração da
Fonte de D ados”
Caso você escolha
instalar a fonte de
dados numa
configuração
do período de
execução
Sempre
Configure a fonte de dados que pode ser usada
pelos aplicativos. Forneça o nome da fonte de
dados, configure outros campos e clique em
P ró xi ma. Consulte o Guia de Administração e
Configuração: " Configuração da Fonte de
D ados" para maiores informações.
Sempre
P ró xi ma.
Sempre
Clique em G erar arq ui vo d e
pro pri ed ad es e scri pt d e i nstal ação
caso deseje capturar as opções de instalação
selecionada. Então clique em C o ncl ui r.
Seção B.23,
“ Processamento de
Instalação Concluída”
Seção B.24, “ Criação
de Atalhos”
Seção B.25, “ Gerando
o Script de Instalação”
Clique em P ró xi ma quando o processamento
encerrar.
A instalação está concluída.
R esu lt ad o
A instalação foi concluída e o JBoss EAP 6 é instalado na sua máquina de destinação.
Reportar um erro
4 .3.3. Desinst alação do JBoss EAP 6 (Inst aller)
Passo s An t erio res em In st aller
Seção 4.3.1, “ D ownload do JBoss EAP 6 (Installer)”
Su mário
Essa seção descreve as etapas solicitadas para desinstalar uma instância do JBoss EAP 6 que foi
instalada usando tanto o instalador gráfico ou baseado em texto.
Pro ced imen t o 4 .6 . D esin st alação d o JB o ss EAP 6 ( In st alação G ráf ica)
1. D urante a instalação do JBoss EAP 6 na máquina de destinação, foi criado um diretório
chamado Uni nstal l er onde você instalou o JBoss EAP 6. Este diretório contém um
arquivo chamado ui nstal l er. jar. Navegue a este diretório numa janela do terminal.
2. Inicie o desinstalador GUI com o seguinte comando Java:
java -jar uni nstal l er. jar
3. A execução do comando lançará o desinstalador gráfico conforme apresentado na seguinte
figura. Selecione a caixa de seleção caso você deseje excluir o diretório de instalação do
JBoss EAP 6.
17
Fig u ra 4 .1. D esin st alação d o JB o ss EAP 6 u san d o o in st alad o r g ráf ico
4. Pressione o botão D esin st alar para iniciar o processo de desinstalação.
5. Quando o processo de desinstalação for finalizado, pressione o botão Sair para sair do
desinstalador.
6. Após a desinstalação com êxito, você talvez queira remover o diretório Uni nstal l er onde
você iniciou o desinstalador.
Pro ced imen t o 4 .7. Pro cesso d e D esin st alação b asead o em T ext o
1. Num console, navegue ao diretório Uni stal l er criado durante o processo de instalação.
Isto pode ser encontrado um nível acima do EAP_HOME.
2. Inicie o desinstalador baseado em texto com o seguinte comando:
java -jar uni nstal l er. jar -co nso l e
3. Siga as seguintes etapas para desinstalar o JBoss EAP 6.
R esu lt ad o :
O JBoss EAP 6 é desinstalado do seu servidor.
Reportar um erro
4 .4 . Inst alação Gráfica RPM
4 .4 .1. Inst alação do JBoss EAP 6 (Inst alação RPM Gráfica)
Su mário
O método do pacote RPM Gráfico de instalação do JBoss EAP 6 está disponível para o Red Hat
Enterprise Linux 5 e Red Hat Enterprise Linux 6. Este tópico descreve as etapas requeridas para
completar a instalação.
18
Pro ced imen t o 4 .8. In st alação d o JB o ss EAP 6 ( In st alação R PM G ráf ica)
Use o PackageKit para instalar graficamente o JBoss EAP 6 em sua máquina de destino.
1. In icie o Packag eK it
O PackageKit é um software de gerenciamento do pacote open source instalado como parte
do Red Hat Enterprise Linux. Lance o PackageKit da máquina de destinação selecionando o
Sist ema → Ad min ist ração → Ad icio n ar/R emo ver So f t ware.
2. D igite
jboss-eap6
na caixa de busca e pressione o botão Buscar. O pacote JBoss EAP 6 aparecerá na caixa
de resultado.
3. Selecione o pacote JBoss EAP 6 e pressione o botão Apl i car. Consulte a figura abaixo.
Fig u ra 4 .2. In st alação d o Packag eK it JB o ss EAP 6
4. Siga o resto das etapas de instalação do JBoss EAP 6 em sua máquina de destinação.
R esu lt ad o
A instalação é concluída e o JBoss EAP 6 instalado em sua máquina de destinação.
Reportar um erro
4 .5. Inst alação RPM baseada em t ext o
4 .5.1. Inst alação do JBoss EAP 6 (Inst alação RPM baseado em t ext o)
19
Su mário
O método de pacote RPM de instalação do JBoss EAP 6 é apropriado ao Red Hat Enterprise Linux
5, Red Hat Enterprise Linux 6 e Red hat Enterprise Linux 7. Este tópico descreve as etapas
requeridas para instalar uma instância usando a linha de comando.
Pro ced imen t o 4 .9 . Et ap as d a In st alação b asead as em T ext o .
Acesso e instalação ao pacote RPM usando a instalação YUM através do Red Hat Network.
1. In st ale o p aco t e R PM u san d o o YU M e o R ed H at N et wo rk.
Use o YUM para instalar o pacote do grupo do JBoss EAP 6 default usando o comando
g ro upi nstal l .
[user@ host ~]$ yum groupinstall jboss-eap6
2. C o n f ig u re as o p çõ es in it .
A instalação RPM contém os inscripts init para lançar o servidor. A configuração para os
inscripts init estão contidas em diversos arquivos adicionais. Refira-se à Seção A.4, “ Os
Arquivos da Configuração de Instalação para o JBoss EAP 6” para maiores detalhes sobre
esses arquivos e as opções contidas no mesmo.
R esu lt ad o
A instalação está completa. O caminho default EAP_HOME para a instalação RPM é
/usr/share/jbo ssas. Refira-se à Seção A.3, “ Lista do Pacote RPM para o JBoss EAP 6” para
uma lista completa de todos os pacotes instalados.
Reportar um erro
4 .6. Inst alação Aut omat iz ada
4 .6.1. Inst alação de Inst âncias Múlt iplas do JBoss EAP 6 (Inst aller)
Gere um script de instalação automático usando o Instalador Gráfico ou baseado em Texto:
. Seção 4.3.2, “ Execução do Programa de Instalação do JBoss EAP”
Su mário
As instâncias idênticas múltiplas podem ser instaladas usando um script de instalação automático,
gerado durante o processo de instalação, usando tanto o instalador Gráfico ou baseado em Texto.
Este tópico descreve as etapas requeridas para instalar o JBoss EAP 6 usando um script gerado.
Pro ced imen t o 4 .10. In st alação Au t o mat iz ad a
20
Num terminal, execute o seguinte comando para instalar o JBoss EAP 6 usando o script de
instalação automático:
java -jar jbo ss-eap-6 . 3. 0 -i nstal l er. jar auto. xml
Nota
Quando você usa um script de instalação automático (auto.xml) para a instalação
automatizada, o instalador por default gerará uma solicitação para inserção de todas as
senhas.
R esu lt ad o
Uma instância idêntica do JBoss EAP 6 foi instalado, baseado no script de instalação automática.
Reportar um erro
4 .6.2. Uso do Script de Inst alação Aut omát ica (aut o.xml) a part ir de font es
diferent es para inst alação do JBoss EAP 6
O instalador pode usar o script de instalação automática (auto . xml ) a partir de muitas
localizações de rede independentes de onde isto está sendo executado. Portanto, o instalador
(jbo ss-eap-6 . 3. 0 -i nstal l er. jar) e o script de instalação automática (auto . xml ) podem ser
localizados em máquinas diferentes. Este tópico descreve as etapas para instalar o JBoss EAP 6.3
automaticamente a partir de uma localização de rede diferente.
D igite num terminal os seguintes comandos para especificar o inscript de instalação automático
(presentes em uma localização de rede diferente) de sua localização de rede atual:
java -jar jbo ss-eap-6 . 3. 0 -i nstal l er. jar http://network-host/auto.xml
(para HTTP)
java -jar jbo ss-eap-6 . 3. 0 -i nstal l er. jar ftp://network-host/auto.xml
(para FTP)
R esu lt ad o
O JBoss EAP 6 foi instalado em sua máquina.
Reportar um erro
4 .7. Abordagens da Inst alação Aut omat iz ada
4 .7.1. Abordagens da Inst alação Aut omát ica
Execute o instalador e gere um script de instalação automática usando o instalador baseado em
Texto ou Gráfico: Seção 4.3.2, “ Execução do Programa de Instalação do JBoss EAP”
Su mário
21
D uas abordagens podem ser usadas para instalar o JBoss EAP 6 automaticamente usando o script
de instalação automático pelo instalador:
A primeira abordagem é especificar todos os valores de chave/senha necessários para a
instalação automática no arquivo variável de instalação automática.
A segunda abordagem é especificar os valores de chave/senha durante o período de instalação.
Reportar um erro
4 .7.2. Inst alação do JBoss EAP 6 pela pré-configuração de Valores da
Chave/Senha no Arquivo da Variável de Inst alação Aut omát ica
Use o seguinte procedimento para instalação automática do JBoss EAP 6 pela pré-configuração
dos valores de chave/senha no arquivo da variável de instalação automática.
Pro ced imen t o 4 .11.
1. In sira valo res d e ch ave n o arq u ivo d a variável
O JBoss EAP 6 installer cria um script de instalação automática e um arquivo de variável de
instalação automática. O arquivo da variável de instalação automática contém uma lista de
parâmetros de chaves/senha necessárias para a instalação automática. Abra um arquivo de
variável de instalação automática para inserir os valores chave. Preencha um valor de
chave/senha válido em relação a cada parâmetro de chave. Por exemplo:
adminPassword = password#2
vault.keystorepwd = vaultkeystorepw
ssl.password = user12345
2. Execu t e o in st alad o r co m o arg u men t o d o n o me d o arq u ivo d e variab lef ile p ara
in iciar a in st alação au t o mat iz ad a
A instalação EAP pode iniciar a automatização por completo pela execução do instalador
com o argumento auto . xml . vari abl efi l e variablefile. Este argumento fornece os
valores de chave/senha do arquivo da variável (etapa 1) ao instalador. Abra um terminal e
insira o seguinte comando com os nomes de arquivo relevantes para iniciar uma instalação
inteiramente automatizada:
java -jar jbo ss-eap-6 . 3. 0 -i nstal l er. jar auto . xml -variablefile
auto . xml . vari abl efi l e
R esu lt ad o
O JBoss EAP 6 foi instalado em sua máquina.
Reportar um erro
4 .7.3. Inst ale o JBoss EAP 6 aut omat icament e pela especificação dos Valores
de Chave/Senhas durant e o período de inst alação
Use o seguinte procedimento para instalar automaticamente o JBoss EAP 6.3 pela especificação
dos valores de chave/senhas durante o período de instalação.
Pro ced imen t o 4 .12.
22
Execu t ar o in st alad o r co m o arg u men t o d e variáveis
A instalação pode ser iniciada automaticamente pela execução do instalador com o argumento
de variáveis e, então, especificar a lista de variáveis. Este argumento de variáveis o ajudará a
definir as variáveis juntamente com os valores de chave/senha durante o período de instalação.
Abra um terminal e insira o seguinte comando com os nomes de arquivos relevantes para iniciar
o processo de instalação:
java -jar jbo ss-eap-6 . 3. 0 -i nstal l er. jar auto . xml -variables
adminPassword=password#2,vault.keystorepwd=vaultkeystorepw,ssl.password
=user12345
Nota
É importante especificar os nomes de variáveis (adminPassword, keystorepwd and
ssl.password) sem quando espaço em branco para a instalação com êxito.
Reportar um erro
4 .8. Inst alação do Nat ive Component s e Ut ilit ies
O Native Components são componentes opcionais que foram compilados a serem otimizados para
um sistema operacional e arquitetura específicos. O Native Components incluem o suporte native
para o HornetQ (AIO) e Tomcat Native Library.
O Native Utilities são utilidades opcionais específicas para cada sistema operacional e a arquitetura
suportadas. Eles incluem scripts e utilidades para instalação do JBoss EAP 6 como um serviço no
seu sistema operacional e geração dos certificados e chaves criptografadas SSL.
Além do Native Components e Native Utilities, o Webserver Connector Natives são usados para
balanceamento de carga e clustering. Consulte o Guia de Configuração e Administração para
configurar o Webserver Connector Natives.
Reportar um erro
4 .8.1. Inst alação do Nat ive Component s e Nat ive Ut ilit ies (Zip, Inst aller)
Instalação do JBoss EAP 6 usando a instalação Z ip, Instalador Gráfico ou Instalador baseado
em Texto:
Seção 4.3.2, “ Execução do Programa de Instalação do JBoss EAP”
Acesso ao Management CLI ou Management Console para o servidor do JBoss EAP 6. Consulte
Lançar o Management CLI ou Logon ao Management Console no Guia de Configuração e Administração.
Para Native Components:
23
Nos ambientes do Red Hat Enterprise Linux 6 e 7, verifique se as bibliotecas OpenSSL e
Apache Portability Runtime (APR) estão instaladas. Caso deseje usar o Tomcat Native Library
que faz parte do JBoss EAP Native Components, o pacote to mcatjss de sistema operacional
deve ser removido antes da instalação.
O OpenSSLI deve ser instalado num ambiente HP-UX.
Pro ced imen t o 4 .13. B aixe e in st ale o N at ive C o mp o n en t s
1. Baixe o pacote Native Components para o seu sistema operacional e arquitetura a partir do
Portal do Cliente Red Hat. Você pode baixar os pacotes a partir da mesma localização
especificada na Seção 4.2.1, “ D ownload do JBoss EAP 6 (Instalação Z ip)” .
2. Extraia o arquivo zip do Native Components baixado sobre a instalação do JBoss EAP 6.
Você pode verificar uma extradição com êxito checando se há uma nova pasta para o seu
sistema operacional e arquitetura no
EAP_HOME/mo d ul es/system/l ayers/base/o rg /jbo ss/as/web/mai n/l i b/.
3. Habilite o native components para o subsistema da web com o seguinte comando quando
usando o Management CLI:
[standalone@ localhost:9999 /] /subsystem= web: wri teattri bute(name= nati ve,val ue= true)
4. Reinicie o servidor do JBoss EAP 6 para aplicar as alterações.
Pro ced imen t o 4 .14 . B aixe e in st ale o N at ive U t ilit ies
1. Baixe o pacote Native Utilities para seu sistema operacional e arquitetura a partir do Portal
do Cliente Red Hat. Os pacotes podem ser baixados a partir da mesma localização
especificada na Seção 4.2.1, “ D ownload do JBoss EAP 6 (Instalação Z ip)” .
2. Extraia o arquivo zip do Native Components baixado sobre a instalação do JBoss EAP 6.
Pode-se verificar uma extração com êxito checando se há o diretório nati ve no
EAP_HOME/mo d ul es/system/l ayers/base/.
3. Consulte os procedimentos na suite de documentação do JBoss EAP e no Portal do Cliente
Red Hat para configuração de recursos específicos do native utilities.
Reportar um erro
4 .8.2. Inst alação do Nat ive Component s e Nat ive Ut ilit ies (Inst alação RPM)
O uso da instalação RPM para instalação de native components, utilities e todas as dependências
correspondentes pode ser usado apenas se o EAP foi instalado usando o método de instalação
RPM. O método do pacote RPM de instalação natives é apropriado para o Red Hat Enterprise Linux
5, 6 e 7. Este tópico descreve as etapas requeridas para instalação do native components e utilities
usando a linha de comando.
Pro ced imen t o 4 .15. In st alação d o N at ive C o mp o n en t s e N at ive U t ilit ies
24
1. In st ale o n at ive co mp o n en t s e u t ilit ies
Execute o seguinte comando usando sua conta administrativa para instalação do native
components e utilities no Red Hat Enterprise Linux 5, 6 e 7 substituindo o package_name
pelo nome do native component que você deseja instalar:
yum install package_name
O native components a serem instalados podem ser: mo d _cl uster-nati ve, mo d _jk,
mo d _rt, mo d _snmp, apache-co mmo ns-d aemo n-jsvc-eap6 , httpd , httpd -d evel ,
jbo ssas-ho rnetq -nati ve e jbo ssas-jbo ssweb-nati ve.
Importante
O native components jbo ssas-ho rnetq -nati ve e jbo ssas-jbo ssweb-nati ve
são instalados por default quando o comando yum g ro upi nstal l jbo ss-eap6
para instalação do pacote de grupo JBoss EAP 6 é executado. Caso tenha usado a
Seção 4.4.1, “ Instalação do JBoss EAP 6 (Instalação RPM Gráfica)” ou Seção 4.5.1,
“ Instalação do JBoss EAP 6 (Instalação RPM baseado em texto)” para instalação do
JBoss EAP 6, não há necessidade de instalar o jbo ssas-ho rnetq -nati ve e
jbo ssas-jbo ssweb-nati ve.
Nota
É importante fornecer o nome correto de pacote com o objetivo de instalar um native
component específico. No Red Hat Enterprise Linux 7, o nome do pacote httpd é
httpd 22. Portanto, o pacote httpd deve ser substituído por httpd 22 quando você
executar o comando yum i nstal l package_name para instalação do servidor
Apache HTTP no Red Hat Enterprise Linux 7.
2. R ein icie o servid o r
Reinicie o servidor para aplicar as alterações.
Reportar um erro
4 .9. Configuração de Serviço
4 .9.1. Configure o JBoss EAP 6 como um Serviço no Red Hat Ent erprise Linux
(Mét odo RPM)
Instale o JBoss EAP 6 usando o Método RPM (Gráfico ou baseado em Texto).
Seção 4.4.1, “ Instalação do JBoss EAP 6 (Instalação RPM Gráfica)”
Seção 4.5.1, “ Instalação do JBoss EAP 6 (Instalação RPM baseado em texto)”
Privilégios de administrador no servidor são requeridos.
25
Su mário
Use o seguinte procedimento para instalar o JBoss EAP 6 como um serviço no Red Hat Enterprise
Linux quando a instalação é realizada usando o método RHN (RPM).
Pro ced imen t o 4 .16 . C o n f ig u ração d o JB o ss EAP 6 co mo u m Serviço u san d o o Mét o d o
R PM n o R ed H at En t erp rise Lin u x
1. In st ale o JB o ss EAP 6
Instale o JBoss EAP 6 através do método RPM usando uma das etapas listadas nas seções
de pré-requisistos listadas acima.
2. H ab ilit ação d o serviço
O método de instalação RPM para o JBoss EAP 6 instala os arquivos de serviço de requisito
em suas localizações corretas. Tudo o que você precisa fazer é configurar isto como serviço
usando o seguinte comando:
chkconfig jbossas on
Para determiná-lo como um serviço no modo domain, emita o seguinte comando:
chkconfig jbossas-domain on
R esu lt ad o
O JBoss EAP 6 inicia automaticamente quando o Red Hat Enterprise Linux alcança seu nível de
execução default e encerra automaticamente quando o sistema operacional realiza sua rotina de
encerramento.
Reportar um erro
4 .9.2. Configuração do JBoss EAP 6 como um Serviço no Red Hat Ent erprise
Linux (Zip, Inst aller)
em texto:
Seção 4.2.2, “ Instalação do JBoss EAP 6 (Instalação Z IP)” .
Seção 4.3.2, “ Execução do Programa de Instalação do JBoss EAP” .
Su mário
Use o seguinte procedimento para instalar o JBoss EAP 6 como um serviço no Red Hat Enterprise
Linux quando a instalação for realizada tanto com os métodos de zip, texto e gráfico. Este processo
não é aplicado quando a instalação for realizada usando o método RHN (RPM).
Pro ced imen t o 4 .17. D et ermin an d o o Serviço
26
Nota
As etapas abaixo descrevem o JBoss EAP em execução como um servidor no modo
autônomo. Com o objetivo de executar o JBoss EAP 6 como um serviço no modo domain, use
as mesmas etapas porém substitua o jbo ss-as-stand al o ne. sh pelo jbo ss-asd o mai n. sh.
1. Lo caliz e o scrip t d e in iciação e o arq u ivo d e co n f ig u ração
O script de inicialização e um arquivo de configuração associado estão localizados no
diretório EAP_HOME/bi n/i ni t. d /. Abra o arquivo da configuração jbo ss-as. co nf
para editá-lo.
2. Perso n aliz e as o p çõ es d e in iciação n o arq u ivo jbo ss-as. co nf
Existem diversas opções com o arquivo jbo ss-as. co nf. No mínimo, especifique os
valores corretos para as variáveis JBO SS_HO ME e JBO SS_USER . Caso estas variáveis
estiverem ausentes, adicione-as.
3. C o p ie arq u ivo s n o s d iret ó rio s d o sist ema
a. Copie o arquivo de configuração modificado ao diretório /etc/jbo ss-as.
[user@ ho st i ni t. d ]$ sud o mkd i r /etc/jbo ss-as
[user@ ho st i ni t. d ]$ sud o cp jbo ss-as. co nf /etc/jbo ss-as/
b. Copie o script de iniciação ao diretório /etc/i ni t. d .
[user@ ho st i ni t. d ]$ sud o cp jbo ss-as-stand al o ne. sh
/etc/i ni t. d
4. Ad icio n e o scrip t d e in icializ ação co mo u m serviço .
Adicione o novo serviço jbo ss-as-stand al o ne. sh à lista de serviços iniciados
automaticamente, usando o comando de gerenciamento do serviço chkco nfi g .
[user@ ho st i ni t. d ]$ sud o chkco nfi g --ad d jbo ss-as-stand al o ne. sh
5. In icie o serviço .
Teste se o serviço foi iniciado corretamente pelo uso de um dos seguintes comandos para o
Red Hat Enterprise Linux.
A. Para o Red Hat Enterprise Linux 5 e 6:
[user@ ho st bi n]$ sud o servi ce jbo ss-as-stand al o ne. sh start
B. Para o Red Hat Enterprise Linux 7:
[user@ ho st bi n]$ sud o servi ce jbo ss-as-stand al o ne start
27
Caso tudo tenha saído de acordo, aparecerá um sinal verde [OK]. Caso obtenha um erro,
verifique os logs de erro e certifique-se que seus caminhos estão corretos no arquivo da
configuração.
Nota
O sinal verde [OK] não aparece para o Red Hat Enterprise Linux 7.
6. D eixe o serviço co meçar au t o mat icamen t e q u an d o vo cê in iciar o servid o r.
Para adicionar o serviço à lista dos serviços que iniciam automaticamente quando o seu
servidor inicia, emita o seguinte comando.
[user@ ho st i ni t. d ]$ sud o chkco nfi g jbo ss-as-stand al o ne. sh o n
R esu lt ad o
O JBoss EAP 6 inicia automaticamente quando o Red Hat Enterprise Linux alcança seu nível de
execução default e encerra automaticamente quando o sistema operacional realiza sua rotina de
encerramento.
Pro ced imen t o 4 .18. D esin st alação d o serviço d o JB o ss EAP p ara o R ed H at En t erp rise
Lin u x
Caso o serviço estiver sendo executado, primeiro abra um terminal e interrompa o serviço
executando o comando sto p com o nome do serviço:
sud o servi ce jboss-as-standalone.sh sto p
Num terminal, remova o EAP a partir da lista de serviços:
sud o chkco nfi g --d el jbo ss-as-stand al o ne. sh
Num terminal, remova o script de iniciação do serviço /etc/i ni t. d /jbo ss-asstand al o ne. sh (/etc/i ni t. d /jbo ss-as-d o mai n. sh para o domain):
Atenção
O /etc/jbo ss-as não é um diretório default, portanto apenas use este comando se
não houver arquivos além de jbo ss-as. co nf no /etc/jbo ss-as
sud o rm -rf /etc/jbo ss-as/
Caso esteja usando o diretório /etc/jbo ss-as para outras tarefas, use o seguinte:
sud o rm /etc/jbo ss-as/jbo ss-as. co nf
R esu lt ad o
28
O serviço do JBoss EAP foi instalado no servidor.
Reportar um erro
4 .9.3. Configure o JBoss EAP 6 como um Serviço no Servidor do Microsoft
Windows (Zip, Inst aller)
em texto:
Seção 4.2.2, “ Instalação do JBoss EAP 6 (Instalação Z IP)” .
Seção 4.3.2, “ Execução do Programa de Instalação do JBoss EAP”
A variável do ambiente do sistema JAVA_HO ME deve ser configurada.
A instância do servidor do JBoss EAP 6 não deve ser executada.
Importante
Quando determinando as variáveis do ambiente do sistema, o uso do comando set do aviso
do comando do Windows Server não determinará permanentemente o ambiente da variável.
Você deve tanto usar o comando setx ou a interface Si stema no P ai nel d e C o ntro l e.
Su mário
Use os seguintes procedimentos para configurar o JBoss EAP 6 no Servidor do Microsoft Windows.
Pro ced imen t o 4 .19 . C o n f ig u re u m Serviço p ara o JB o ss EAP 6 n o Servid o r d o Micro so f t
Win d o ws.
1. C rie variáveis d o amb ien t e d o sist ema
Crie duas variáveis do ambiente do sistema:
O JBO SS_HO ME apontando ao diretório de instalação do JBoss EAP 6.
NO P AUSE= 1
2. C aso ain d a n ão co n f ig u rad o , realiz e o d o wn lo ad e ext raia o p aco t e N at ive
U t ilit ies p ara su a arq u it et u ra
Caso o Native Utilities para o pacote do Windows Server não tenha sido instalado como
parte da instalação JBoss EAP 6, realize o download do pacote relevante de 32-bites ou 64bites a partir do Portal do Cliente Red Hat no https://access.redhat.com. Extraia o arquivo zip
do Native Utilities na instalação do JBoss EAP 6.
Isto resultará num diretório nati ve na seguinte localização da instalação do JBoss EAP 6:
EAP_HOME\mo d ul es\system\l ayers\base\
3. In st alação d o serviço
29
Abra um terminal e altere os diretórios para
EAP_HOME\mo d ul es\system\l ayers\base\nati ve\sbi n
Um novo serviço pode ser criado com o comando servi ce i nstal l , sem opções
disponíveis apresentadas na seguinte tabela.
T ab ela 4 .3. O p çõ es servi ce i nstal l
Arg u men t o o u
In t erru p t o r
D escrição
/controller
HOST:PORT
/host
[DOMAIN_HOST]
O host e a porta da interface de gerenciamento. Caso omitido, o
default é l o cal ho st: 9 9 9 9 .
Indica que o modo domain será usado especificando
opcionalmente o nome do domain controller. Caso o domain
controller for omitido, o nome default será master.
O nível de log para o serviço, tanto: ER R O R , INFO , WAR N ou
D EBUG . Caso omitido, o default será INFO
O nome do serviço a ser criado não deve conter espaços. Caso
omitido, o default será JBo ssEAP 6
A descrição do serviço. Caso omitido, o default será "JBo ss
Enterpri se Appl i cati o n P l atfo rm 6 "
Especifica o nome da conta pela qual o serviço será executado.
Use o nome da conta no formato DOMAIN\USERNAME. Caso
omitido, o serviço executa como uma conta do Sistema Local.
Senha para a conta /serviceuser.
/loglevel LEVEL
/name
SERVICE_NAME
/desc
" DESCRIPTION"
/serviceuser
DOMAIN\USERNAME
/servicepass
PASSWORD
/jbossuser
USERNAME
/jbosspass
PASSWORD
Opcional, o nome do usuário JBoss EAP 6 a ser usado para o
comando de encerramento.
Senha para a conta /jbossuser, requerida se o /jbossuser for
especificado.
Seguem abaixo amostras básicas de um comando i nstal l para criar um novo serviço
tanto no modo domain ou autônomo. Execute o seguinte comando, ajustando o nível do log
para o serviço conforme requerido:
A. Modo autônomo:
servi ce. bat i nstal l /l o g l evel INFO
B. Modo domain:
Caso você não esteja usando o mestre default para o seu domain controller do JBoss
EAP 6, substitua o master pelo nome de host correto ou alias do domain controller do
JBoss EAP 6.
servi ce. bat i nstal l /ho st master /l o g l evel INFO
Um novo serviço Windows será criado com o nome JBo ssEAP 6 .
4. Verif iq u e o n o vo serviço n o co n so le d e Serviço s.
Execute o seguinte comando num terminal para abrir o console dos Serviços do Windows:
servi ces. msc
30
Caso o nome do serviço default fosse usado, na lista dos serviços do Windows, o novo
serviço terá o nome em exibição: JBo ss Enterpri se Appl i cati o n P l atafo rm 6 . A
partir do console de serviços você pode iniciar e interromper o serviço, como também alterar
suas configurações em como e quando elas iniciam.
5. In ician d o e in t erro mp en d o o serviço d o JB o ss EAP 6 a p art ir d e u m t ermin al
Para iniciar o serviço a partir de um terminal, use o seguinte comando, alterando o nome do
serviço caso necessário:
net start JBossEAP6
Para interromper o serviço a partir de um terminal, use o seguinte comando, alterando o
nome do serviço caso seja necessário:
net sto p JBossEAP6
R esu lt ad o
O serviço do JBoss EAP 6 é configurado no Servidor do Microsoft Windows.
Pro ced imen t o 4 .20. D esin st ale o serviço d o JB o ss EAP 6 a p art ir d o Servid o r Micro so f t
Win d o ws.
Caso o servidor estiver executando, abra primeiro um terminal e interrompa o serviço pela
execução do comando netsto p pelo nome do serviço:
net sto p JBossEAP6
Num terminal, altere os diretórios para
EAP_HOME\mo d ul es\system\l ayers\base\nati ve\sbi n e execute o seguinte comando:
servi ce uni nstal l
R esu lt ad o
O serviço do JBoss EAP 6 foi removido do Servidor Microsoft Windows.
Reportar um erro
31
Capítulo 5. Patching e Atualização do JBoss EAP 6
5.1. Pat ches e At ualiz ações
O Patch no JBoss EAP 6 aplica atualizações que são realizadas a uma versão pequena e
específica do JBoss EAP 6, por exemplo: o JBoss EAP 6.2. Os patches podem conter atualizações
cumulativas ou individuais.
A atualização é o processo de mudar a uma versão mais recente (por exemplo: da versão 5.0 à
versão 6.0) ou uma versão mais inferior (por exemplo: da versão 6.1 à versão 6.2) e não pode ser
realizada através do patching.
Veja t amb ém:
Seção 5.2, “ Realizando o patching ao JBoss EAP 6”
Seção 5.3, “ Atualização do JBoss EAP 6”
Reportar um erro
5.2. Realiz ando o pat ching ao JBoss EAP 6
5.2.1. Mecanismos de Aplicação de Pat ch
Os JBoss patches são distribuídos em duas formas: zip (para todos os produtos) e RPM (para um
subconjunto de produtos).
Importante
A instalação do produto JBoss deve sempre ser atualizada usando um método de patch:
tanto patches zip ou RPM. Apenas os patches cumulativos e de segurança estarão
disponíveis através do RPM e os clientes usando a instalação RPM não poderão efetuar
atualização usando patches de zip.
Os JBoss patches podem tanto ser uma atualização assíncrona ou uma atualização planejada:
Atualizações assíncronas: patches individuais que são lançados fora do ciclo de atualização
normal do produto existente. Isto pode incluir patches de segurança, assim como outros patches
individuais fornecidos pela Red Hat Global Support Services (GSS) para corrigir problemas
específicos.
Atualizações planejadas: estas atualizações incluem patches cumulativos, assim como
atualizações micro, menores ou maiores de um produto existente. Os patches cumulativos
incluem todas as atualizações desenvolvidas anteriormente para a versão do produto.
A decisão de que um patch é ou não lançado como parte de uma atualização planejada ou uma
atualização assíncrona depende na severidade do problema sendo corrigido. Um problema de
baixo impacto é normalmente adiado e é resolvido no próximo patch cumulativo ou do menor
lançamento do produto afetado, contendo uma correção para apenas um problema específico.
32
⁠Capít ulo 5. Pat ching e At ualiz ação do JBoss EAP 6
As atualizações de segurança para os produtos JBoss são fornecidas por uma errata (para ambos
os métodos zip e RPM). A errata encapsula uma lista de falhas resolvidas, sua classificação de
falhas e a referência aos demais patches. As atualizações de correção de bug não são
comunicadas através de errata.
Importante
É importante notar que após um patch ser aplicado, os jars obtidos no período de execução
são obtidos a partir do diretório
EAP_HOME/mo d ul es/system/l ayers/base/. o verl ays/$P AT C H_ID /$MO D ULE. Os
arquivos originais são mantidos no
EAP_HOME/mo d ul es/system/l ayers/base/$MO D ULE. O mecanismo patching desabilita
os arquivos jar originais por motivos de segurança. Isto significa que caso um patch que
atualiza um módulo seja aplicado, os arquivos de jar do módulo original são alterados para
não serem utilizáveis. Caso o patch seja revertido, os arquivos originais serão revertidos de
volta a seu estado utilizável. Isto significa que o procedimento correto de reversão deve ser
usado para reverter qualquer patch aplicado. Consulte a Seção 5.2.2.3, “ Reversão do
Aplicativo de um Patch no Formulário Z ip usando o Patch Management System” para o
procedimento de reversão apropriado.
Maiores informações sobre como a Red Hat avalia as falhas de segurança do JBoss podem ser
encontradas na: Seção 5.2.5, “ Classificação de impacto e gravidade do JBoss Security Patches
(Patches de Segurança JBoss)”
A Red Hat mantém uma lista de correio para notificação aos subscritos sobre a segurança das
falhas relacionadas. Consulte a Seção 5.2.4, “ Subscrição para as Listas de Correio Patch”
Reportar um erro
5.2.2. Realiz ando o pat ching a uma Inst alação ZIP/Inst aller
5 .2 .2 .1 . Pat ch Manage m e nt Syst e m
O JBoss EAP 6 patch management system é usado para aplicar os zip patches downloaded a um
servidor JBoss EAP 6 único. Ele pode ser acessado tanto através do Management CLI pelo uso do
comando patch ou através do Management Console. O patch management system não pode ser
usado para efetuar o patch nas instâncias do servidor JBoss EAP 6 através do managed domain,
porém instâncias de servidor individuais num managed domain podem ser aplicadas o patch de
forma independente.
Importante
As instâncias do servidor JBoss EAP 6 que foram instaladas usando o método RPM não
podem ser atualizadas usando o patch management system. Refira-se à Seção 5.2.3,
“ Realizando uma Instalação RPM” para atualizar os servidores do JBoss EAP instalados
com RPM.
33
Nota
O patch management system pode apenas ser usado com os patches produzidos para as
versões do JBoss EAP 6.2 e mais avançadas. Para os patches de versões anteriores ao 6.2,
você deve referir-se à documentação da versão relevante disponível no
https://access.redhat.com/site/documentation/.
Além de aplicar os patches, o patch management system pode fornecer informação básica no
estado de patches instalados e pode também fornecer uma maneira imediata de reverter o aplicativo
de um patch.
Quando aplicando ou revertendo um patch, o patch management system verificará os módulos e
outros arquivos diversos que está alterando para quaisquer modificações do usuário. Caso uma
modificação do usuário for detectada e a opção de manuseamento de conflito não for especificada,
o patch management system irá ignorar a operação e avisará que existe um conflito. O aviso
incluirá uma lista de módulos e outros arquivos que estão em conflito. Para completar a operação,
isto deve ser retentado com uma opção especificando como resolver o conflito: tanto para preservar
as modificações do usuário ou para substituí-las.
A tabela abaixo lista os argumentos e opções para o comando patch do Management CLI.
T ab ela 5.1. Alt eraçõ es e Arg u men t o s d o C o man d o patch
Arg u men t o o u In t erru p t o r
D escrição
appl y
--o verri d e-al l
Aplica o patch.
Caso haja um conflito, a operação de patch
substitui quaisquer modificações do usuário.
Caso haja conflito como resultado de quaisquer
módulos modificados, esta alteração substitui
aquelas modificações pelos conteúdos da
operação do patch.
Caso existam arquivos diversos apenas, isto
substituirá os arquivos modificados em conflito
com os arquivos na operação patch.
Apenas para os arquivos diversos
especificados, isto preservará os arquivos
modificados em conflito.
D isponível no modo domain, isto especifica o
host que a operação de patch será executada.
Retorna a informação nos patches instalados
no momento.
Retorna informação no histórico do patch.
Reverte o aplicativo de um patch.
Requerido para reversão, a ID do patch para
reversão.
Solicitado para a reversão, isto especifica caso
deseje restaurar os arquivos de configuração
do servidor como parte da operação de
reversão.
--o verri d e-mo d ul es
--o verri d e= path(,path)
--preserve= path(,path)
--ho st= HOST_NAME
i nfo
hi sto ry
ro l l back
--patch-i d = PATCH_ID
--reset-co nfi g urati o n= TRUE| FALSE
34
Arg u men t o o u In t erru p t o r
D escrição
--ro l l back-to
Caso o patch para reversão seja um patch
(one-off) individual, o uso deste argumento
especificará que a operação de reversão
também irá reverter todos os demais patches
que foram aplicados no patch especificado.
Reportar um erro
5 .2 .2 .2 . Inst alação de Pat che s no Fo rm ulário Zip usando o Pat ch Manage m e nt
Syst e m
Su mário
Os Patches que estão no formato zip podem ser instalados usando o JBoss patch management
system através do Management CLI ou Management Console.
Importante
O patch management system é um recurso que foi adicionado no JBoss EAP 6.2. Para as
versões do JBoss EAP anteriores à versão 6.2, o processo para instalar patches no
formulário zip é diferente e recomendamos a consulta à documentação de versão relevante
disponível no https://access.redhat.com/site/documentation/.
Acesso válido e subscrição do Portal do Cliente Red Hat.
A subscrição atual ao produto JBoss instalado no formato zip.
Acesso ao Management CLI ou ao Management Console para o servidor JBoss EAP 6 a ser
atualizado. Refira-se ao Lançamento do Management CLI ou Logon ao Management Console no Guia
de Configuração e Administração.
Atenção
Antes da instalação de um patch, você deve realizar o backup de seu produto JBoss
juntamente com todos os arquivos de configuração personalizados.
Pro ced imen t o 5.1. Ap liq u e o z ip p at ch à in st ân cia d o servid o r JB o ss EAP 6 u san d o o
Man ag emen t C LI
1. Realize o download ao arquivo zip patch a partir do Portal do Cliente
https://access.redhat.com/downloads/
2. Aplique o patch com o seguinte comando, a partir do Management CLI, incluindo o patch
apropriado ao arquivo patch:
35
[standalone@ localhost:9999 /] patch appl y /path/to/downloadedpatch.zip
A ferramenta patch fornecerá um aviso caso haja quaisquer conflitos na tentativa de aplicar
o patch. Refira-se à Seção 5.2.2.1, “ Patch Management System” para disponibilidade das
opções do comando patch para reexecutar o comando para resolver quaisquer conflitos.
3. Reinicie o servidor JBoss EAP para que o patch tenha efeito:
[standalone@ localhost:9999 /] shutd o wn --restart= true
Pro ced imen t o 5.2. Ap liq u e o z ip p at ch à in st ân cia d o servid o r JB o ss EAP 6 u san d o o
Man ag emen t C o n so le
1. Realize o download ao arquivo zip patch a partir do Portal do Cliente
https://access.redhat.com/downloads/
2. No Management Console:
A. Para o servidor autônomo: clique na tab Executar na parte superior da tela, e depois
clique no P atch Manag ement.
B. Para o managed domain: clique na tab D o mai n na parte superior da tela, selecione o
host que você deseja o patch a partir do menu suspenso Ho st e clique em P atch
Manag ement.
3. Clique em Apl i car um No vo P atch.
a. Caso você esteja aplicando o patch num managed domain, selecione na próxima
tela se desejar encerrar os servidores no host e clique em P ró xi ma.
4. Clique no botão naveg ar e selecione o patch downloaded que você deseja aplicar e clique
em P ró xi ma.
a. Caso houver quaisquer conflitos na tentativa de aplicação do patch, um aviso será
exibido. Clique em Vi sual i zar d etal hes d e erro s para verificar o detalhe dos
conflitos. Caso haja um conflito, pode-se tanto cancelar a operação ou selecionar a
caixa de seleção Substi tui r to d o s o s co nfl i to s e clicar em P ró xi ma. A
substituição de conflitos resultará no conteúdo do patch substituindo quaisquer
modificações do usuário.
5. Após o patch ser aplicado com êxito, selecione caso deseje iniciar o servidor do JBoss EAP
6 para que o patch tenha efeito e clique em C o ncl ui r.
R esu lt ad o
A instância do servidor JBoss EAP 6 possui patch com a última atualização.
Reportar um erro
5 .2 .2 .3. Re ve rsão do Aplicat ivo de um Pat ch no Fo rm ulário Zip usando o Pat ch
Manage m e nt Syst e m
Su mário
O JBoss EAP 6 patch management system pode ser usado para reverter o aplicativo de um patch zip
aplicado anteriormente, através tanto do Management CLI ou Management Console.
36
Atenção
A reversão do aplicativo de um patch usando o patch management system não possui como
intenção uma funcionalidade de desinstalação geral. Ela é apenas destinada a ser usada
imediatamente após o aplicativo de um patch que teve consequências desfavoráveis.
Importante
O patch management system é um recurso que foi adicionado ao JBoss EAP 6.2. No caso de
versões do JBoss EAP anteriores à versão 6.2, o processo de reversão de patches no
formulário zip é diferente e você deve referir-se à documentação da versão disponível no
https://access.redhat.com/site/documentation/.
Um patch que foi aplicado anteriormente usando o JBoss EAP 6 patch management system.
Acesso ao Management CLI ou o Management Console para o servidor JBoss EAP 6. Refira-se
ao Lançamento do Management CLI ou Logon ao Management Console no Guia de Configuração e
Administração.
Atenção
Quando seguindo qualquer um dos procedimentos, tenha cautela na especificação da opção
R ed efi ni r C o nfi g uração :
Caso determinado para VER D AD EIR O , o processo de reversão do patch irá reverter também
os arquivos de configuração do servidor JBoss EAP 6 a seus estados de pré-patch.
Quaisquer alterações realizadas aos arquivos de configuração do servidor JBoss EAP 6,
após o patch ser aplicado, serão perdidas.
Caso determinado para FALSO , os arquivos de configuração do servidor não serão
revertidos. Nesta situação, é possível que o servidor não inicie após a reversão, uma vez que
o patch pode ter alterado configurações tais como namespaces, que podem não estar mais
válidos e necessitaram ser corrigidos manualmente.
Pro ced imen t o 5.3. A reversão d e u m p at ch a p art ir d a in st ân cia d o servid o r JB o ss EAP 6
u san d o o Man ag emen t C LI
1. A partir do Management CLI, use o comando patch i nfo para encontrar a ID do patch que
está prestes a ser revertido.
A. Para os patches cumulativos, a ID do patch é o valor do primeiro cumul ati ve-patchi d apresentado no resultado patch i nfo .
B. A segurança individual ou as ID s do patch de correção da bug são listadas como o valor
do primeiro dos patches apresentados no resultado patch i nfo , com o patch
individual aplicado recentemente listado por primeiro.
37
2. A partir do Management CLI, reverta o patch com a ID do patch apropriado a partir da etapa
anterior.
[standalone@ localhost:9999 /] patch ro l l back --patch-i d = PATCH_ID -reset-co nfi g urati o n= TRUE
A ferramenta patch avisará se exite algum conflito na tentativa de reversão do patch. Refirase à Seção 5.2.2.1, “ Patch Management System” para opções de comando patch
disponíveis para reexecutar o comando para resolver quaisquer conflitos.
3. Reinicie o servidor JBoss EAP 6 para que a reversão do patch tenha efeito:
[standalone@ localhost:9999 /] shutd o wn --restart= true
Pro ced imen t o 5.4 . R eversão d o p at ch a p art ir d a in st ân cia d o servid o r JB o ss EAP 6
u san d o o Man ag emen t C o n so le
1. No Management Console:
A. Para o servidor autônomo: clique na tab Execução na parte superior da tela e então
clique P atch Manag ement.
B. Para o managed domain: clique na tab D o mai n na parte superior da tela e selecione o
host relevante do menu suspenso Ho st e clique em P atch Manag ement.
2. Na tabela Hi stó ri co R ecente d o P atch, selecione o patch que você deseja reverter e
clique em R everter.
a. Para o managed domain host, selecione na próxima tela caso deseje encerrar os
servidores no host e clique em P ró xi ma.
3. Selecione suas opções para o processo de reversão e clique em P ró xi ma.
4. Confirme as opções e o patch a ser revertido e clique em P ró xi ma.
a. Caso a opção Substi tui r tud o não tenha sido selecionada e existir quaisquer
conflitos na tentativa de reverter o patch, um aviso será exibido. Clique em
Vi sual i zar d etal hes d e erro para verificar o detalhe dos conflitos. Caso haja
um conflito, você pode tanto cancelar a operação ou clicar em Sel eci o nar
O pçõ es e tentar a operação novamente com a caixa de opção Substi tui r tud o
selecionada. A substituição de conflitos resultará na operação de reversão
substituindo quaisquer modificações.
5. Após o patch ter sido revertido com êxito, selecione caso deseje reiniciar o servidor do JBoss
EAP 6 para que as modificações tenham efeito e clique em C o ncl ui r.
R esu lt ad o
O patch, e opcionalmente os arquivos de configuração do servidor, são revertidos na instância do
servidor do JBoss EAP 6.
Reportar um erro
5.2.3. Realiz ando uma Inst alação RPM
38
Su mário
Os patches do JBoss são distribuídos em duas maneiras: Z IP (para todos os produtos) e RPM
(para o subconjunto de produtos). Esta tarefa descreve as etapas que você precisa para instalar os
patches através do formato RPM.
Uma subscrição válida para o Red Hat Network.
A subscrição atual a um produto JBoss instalado através de um pacote RPM.
Pro ced imen t o 5.5. Ap licar u m p at ch a u m p ro d u t o JB o ss at ravés d o mét o d o R PM.
As atualizações de segurança para os produtos do JBoss são fornecidas por errata (para ambos
métodos zip e RPM). A errata encapsula uma lista de erros resolvidos, seus graus de severidade, os
produtos afetados, a descrição textual de erros e a referência aos patches.
Para as distribuições RPM dos produtos do JBoss, a errata inclui referências aos pacotes RPM
atualizados. O patch pode ser instalado pelo uso do yum.
Atenção
Antes da instalação de um patch, você deve realizar o backup de seu produto do JBoss
juntamente com todos os arquivos de configuração personalizados.
1. Receba informação sobre o patch de segurança tanto sendo subscrito na lista de correio de
vigilância do JBoss ou navegando pelos arquivos da lista de correio de vigilância do
JBoss.
2. Leia a errata para o patch de segurança e certifique-se de que está aplicado a um produto
do JBoss em seu ambiente.
3. Caso o patch de segurança é aplicado a um produto do JBoss no seu ambiente, use o
seguinte link para realização do download do pacote RPM atualizado na errata.
4. Use
yum upd ate
para instalação do patch.
Importante
Quando atualizando uma instalação RPM, o seu produto JBoss é atualizado
cumulativamente com todas as correções lançadas do RPM.
R esu lt ad o
O produto JBoss possui patches com a atualização mais recente usando o formato RPM.
39
Reportar um erro
5.2.4 . Subscrição para as List as de Correio Pat ch
Su mário
A equipe do JBoss no Red Hat mantém uma lista para os anúncios de segurança para os produtos
Red Hat JBoss Middleware. Esta seção descreve o que você precisa para realizar para subscreverse à lista.
Nenhum
Pro ced imen t o 5.6 . Su b scrição à List a d e Vig ilân cia d o JB o ss
1. Clique no seguinte link para ir à página de lista de correio de Vigilância do JBoss: JBoss
Watch Mailing List.
2. Insira o endereço de e-mail na seção Subscri ção ao Jbo ss-watch-l i st
3. [Você pode também desejar inserir o seu nome e selecionar sua senha. Embora isto seja
opcional, é também recomendado.]
4. Pressione o botão Subscrever-se para iniciar o processo de subscrição.
5. Você pode navegar nos arquivos da lista de correio através do: JBoss Watch Mailing List
Archives.
R esu lt ad o
Após a confirmação de seu endereço de e-mail, você estará subscrito para receber as novidades
relacionadas à segurança da lista de correio patch do JBoss.
Reportar um erro
5.2.5. Classificação de impact o e gravidade do JBoss Securit y Pat ches
(Pat ches de Segurança JBoss)
A Red Hat usa uma escala de 4 pontos de gravidade: baixa, moderada, importante e crítica, além de
duas contagens básicas de versão do Common Vulnerability Scoring System (CVSS) que podem ser
usadas para identificar o impacto da falha.
T ab ela 5.2. C lassif icação d e g ravid ad e d o JB o ss Secu rit y Pat ch es
G ravid ad e
D escrição
Crítica
A classificação é dada para as falhas que
poderiam ser facilmente exploradas por um
invasor não identificado e levar a comprometer
o sistema (execução de código arbitrário) sem
requerer a interação do usuário. Existem tipos
de vulnerabilidades que podem ser exploradas.
As falhas que requerem um usuário remoto
autenticado, um usuário local ou uma
configuração improvável não são classificadas
como impacto crítico.
40
G ravid ad e
D escrição
Importante
A classificação é dada às falhas que podem
facilmente comprometer a confidencialidade,
integridade ou habilidade de recursos. Esses
são tipos de vulnerabilidades que permitem
usuários locais ganharem privilégios, permitir
usuários remotos não autenticados a
visualizarem recursos que deveriam ser
protegidos pela autenticação ou permitir
usuários local ou remoto a causarem uma
negação de serviço.
A classificação é dada para as falhas que
poderiam ser dificilmente exploradas, mas
podem comprometer a confidencialidade,
integridade ou disponibilidade de recursos, sob
certas circunstâncias. Existem tipos de
vulnerabilidades que podem possuir um
impacto crítico de falha ou impacto importante,
no entanto não são exploradas com tanta
facilidade devido à avalização técnica da falha
ou por afetarem as configurações
comprometedoras.
A classificação é dada a todos os demais
problemas que um impacto de segurança
possui. Estes são os tipos de vulnerabilidades
que acredita-se requerem circunstâncias
improváveis para estarem aptos a serem
explorados ou onde a exploração com êxito
geraria uma consequência mínima.
Moderada
Baixa
O componente de impacto da contagem CVSS v2 é baseado numa avaliação combinada de três
impactos potenciais: Confidencialidade (C), Integridade (I) e D isponibilidade (D ). Cada um deles
podem ser classificados como Nenhum (N), Parcial (P) ou Completo (C).
Uma vez que o processo do servidor do JBoss executa como um usuário não privilegiado e está
isolado do sistema operacional do host, as falhas de segurança do JBoss são apenas
classificadas como possuindo impactos como tanto Nenhum (N) ou Parcial (P).
Exemp lo 5.1. Mét ricas d o C VSS v2
A amostra abaixo apresenta a pontuação do impacto CVSS v2, onde a exploração da falha não
teria impacto na confiabilidade do sistema, impacto parcial na integridade do sistema e completo
impacto na disponibilidade do sistema (quer dizer, o sistema iria tornar-se completamente
indisponível para qualquer uso, por exemplo: através do travamento do kernel).
C : N/I: P /A: C
As organizações podem tomar decisões informativas sobre o risco de que cada problema influencia
em seu ambiente único e agenda atualizações de acordo, com a combinação da classificação de
gravidade e a pontuação CVSS.
Por favor consulte: CVSS2 Guide para maiores informações a respeito do CVSS2.
Reportar um erro
41
5.3. At ualiz ação do JBoss EAP 6
5.3.1. At ualiz ação da Inst alação ZIP do JBoss EAP 6
Certifique-se que o sistema operacional base está atualizado.
D etermine quais os arquivos foram modificados desde que o JBoss EAP 6 foi instalado.
Realize o backup de quaisquer arquivos de configuração modificados, implantações e todos os
dados do usuário.
Seção 4.2.1, “ D ownload do JBoss EAP 6 (Instalação Z ip)” .
Su mário
Este procedimento descreve a atualização da instalação Z IP do JBoss EAP 6 entre versões
inferiores (por exemplo: a partir do JBoss EAP 6.1 à 6.2). Para as instalações patches para uma
versão inferior. Refira-se à seção Instalação do Patch. A atualização à versão do JBoss EAP 6 solicita
algum trabalho inicial para realizar o backup na instalação existente.
Atenção
Para os managed domains, o Host Controller mestre (ou D omain Controller) deve ser
atualizado primeiramente, antes que cada Host Controller seja atualizado.
Pro ced imen t o 5.7. At u aliz ação à ú lt ima versão d o JB o ss EAP 6
1. Mova para o arquivo Z IP baixado ao local desejado. Recomenda-se que este local seja
diferente ao da instalação do JBoss EAP 6 existente.
Importante
Caso deseje instalar a versão mais recente do JBoss EAP 6 para o mesmo local de
diretório ao da instalação existente, será necessário mover a instalação existente a
um local diferente antes do procedimento. Isto é para prevenir a perda dos arquivos
de configuração modificados, implantações e atualizações.
2. D escomprime o arquivo. Esta a etapa instala uma instância limpa para o lançamento mais
recente do JBoss EAP 6.
3. Copie os diretórios EAP_HOME/domain/ e EAP_HOME/standalone/ da instalação anterior
sobre os novos diretórios de instalação.
42
Nota
Os novos recursos deste lançamento, tais como novos subsistemas, talvez não sejam
ativados caso os arquivos de configuração sejam copiados a partir de uma
instalação do JBoss EAP 6. Para uso desses novos recursos, é necessário comparar
e atualizar os arquivos de configuração antigos com os novos da nova versão.
4. Revise as alterações realizadas ao diretório bi n da instalação anterior e faça as
modificações equivalentes ao novo diretório.
Atenção
Os arquivos no diretório bi n não devem ser substituídos pelos arquivos das versões
anteriores. As alterações devem ser realizadas manualmente.
5. Revise os arquivos modificados restantes da instalação anterior e mova essas alterações à
instalação. Esses arquivos devem incluir:
O diretório wel co me-co ntent.
Os módulos personalizados no diretório mo d ul es.
Os pacotes personalizados no diretório bund l es.
6. O p cio n al: Caso o JBoss EAP 6 tenha sido configurado para executar como um serviço,
remova o serviço existente e configure um novo serviço para a instalação atualizada.
R esu lt ad o
A instalação Z IP do JBoss EAP 6 foi atualizada com êxito ao último lançamento.
Reportar um erro
5.3.2. At ualiz ação da Inst alação RPM do JBoss EAP 6
Certifique-se de que o sistema operacional base está atualizado e que o sistema está subscrito e
habilitado para obtenção de atualização para o canal Base SO.
Certifique-se de que o canal RHN do JBoss EAP é habilitado. Por exemplo, num x86 e arquitetura
de 64 bites, será a Plataforma do Aplicativo JBoss (v 6) para o canal 6Server x86_64
(jbapppl atfo rm-6 -x86 _6 4 -server-6 -rpm).
Realize o backup de quaisquer arquivos de configuração modificados, implantações e todos os
dados do usuário.
Su mário
A atualização para o último lançamento do JBoss EAP 6 requer algum trabalho inicial para realizar
o backup da instalação existente. Este tópico descreve a atualização da instalação RPM através da
Red Hat Network (RHN).
43
Atenção
Para os managed domains, o Host Controller mestre (ou D omain Controller) deve ser
atualizado primeiramente, antes que cada Host Controller seja atualizado.
Pro ced imen t o 5.8. At u aliz ação ao ú lt imo lan çamen t o d o JB o ss EAP 6
1. Execute o seguinte comando num terminal para atualização da instalação:
[user@ host] yum update
2. Mescle manualmente cada arquivo *. rpmnew criado que contém alterações nos arquivos de
configuração de produção.
R esu lt ad o
O JBoss EAP 6 foi atualizado com êxito.
Reportar um erro
5.3.3. At ualiz ação do JBoss EAP Clust er a part ir do 6.2 para o 6.3
Nenhum
Su mário
O JBoss EAP 6.3 não suporta a criação dos clusters onde os nós diferentes são feitos de versões
diferentes dos servidores do JBoss EAP. Portanto, um cluster misto baseado em versões diferentes
não é suportado e todos os nós com um cluster devem ser da mesma versão - 6.3.
Atenção
O processo de atualização para o tráfego de migração a partir de um cluster 6.2 a um cluster
6.3 é então baseado na transferência de todos os tráfegos a um cluster 6.3 e então
encerramento dos servidores ou nós no cluster 6.2.
Pro ced imen t o 5.9 . C o n f ig u ração d o JB o ss EAP C lu st er n a versão 6 .3
1. Refira-se ao capítulo Balanceamento de Carga e HTTP Clustering do Guia de Configuração e
Administração do JBoss EAP 6.3 para instruções de como configurar um JBoss EAP cluster na
versão 6.3.
2. Migre todo o tráfego para este novo cluster usando as etapas descritas no capítulo Tráfego
de Migração entre Clusters do Guia de Configuração e Administração do JBoss EAP 6.3
R esu lt ad o
O seu JBoss EAP 6.2 cluster foi migrado ao cluter baseado no JBoss EAP 6.3.
Reportar um erro
44
Mat erial de Referência
Material de Referência
A.1. Downloads Disponíveis para o JBoss EAP 6
O JBoss EAP 6 inclui um número de diferente tipos de instalação e componentes opcionais, que
estão disponíveis para download no Portal do Cliente Red Hat em https://access.redhat.com/. A
seguinte tabela explica as opções diferentes. Alguns componentes são apenas apropriados para
certos sistemas operacionais e arquiteturas, portanto são apenas disponíveis para essas variações
específicas.
T ab ela A.1. D o wn lo ad s D isp o n íveis
N o me
D escrição
Sist emas d e O p eração
Servidor Apache HTTP
Uma instância do servidor
Apache HTTP autônomo para
cada sistema operacional e
arquitetura suportados. Este
servidor HTTP foi testado e
verificado para trabalhar com o
JBoss EAP 6.
Os componentes que foram
compilados para serem
otimizados à uma plataforma
específica. Por exemplo, os
D LLs são fornecidos para os
ambientes do Servidor do
Microsoft Windows. Às vezes,
os componentes nativos
podem produzir
melhoramentos de
desempenho.
As utilidades específicas para
cada sistema operacional e
arquitetura suportados, tais
como os scripts e utilidades
para a instalação do JBoss
EAP 6 como um serviço no seu
sistema operacional e geração
das chaves da criptografia SSL
e certificados.
Os módulos pré-compilados
para os servidores da web
Oracle iPlanet, Microsoft e
Apache para o balanceamento
de carga e capacidades de alta
disponibilidade.
A documentação para todos os
APIs público expostos pelo
JBoss EAP 6. Você pode
instalá-los em seu servidor
HTTP local ou ID E, ou você
pode visualizá-los em sua
máquina local.
Red Hat Enterprise Linux 5, Red
Hat Enterprise Linux 6,
Microsoft Windows Server
2008, Solaris 10 e 11
Native Components
Native Utilities
Conector Webserver Nativo
Javadocs
2008, Solaris 10 e 11, HewlettPackard HP-UX
Plataforma independente
45
N o me
D escrição
Sist emas d e O p eração
Installer
O Java installer para o JBoss
EAP 6. Inclui as etapas para
instalar as Iniciações Rápidas
e Repositório Maven.
Um repositório Maven pelo
qual você pode baixar e
disponibilizar em seu ambiente
de desenvolvimento local e que
contém artefatos comuns aos
aplicativos construídos sob o
JBoss EAP 6. O repositório
Maven é também disponível
através do JBoss EAP 6
Installer.
Amostra dos aplicativos para
ajudá-lo a iniciar o
desenvolvimento dos
aplicativos Java EE 6 com os
APIs fornecidos com o JBoss
EAP 6. As Iniciações Rápidas
estão também disponíveis
através do JBoss EAP 6
Installer.
O código fonte Java para o
JBoss EAP 6, fornecido para
que você possa recompilá-lo
em seu próprio ambiente ou
auditoriá-lo por conta própria.
O pacote de instalação Z ip,
que pode ser instalado e
executado em toda plataforma
suportada. Isto é a maneira
mais comum de instalar o
JBoss EAP 6.
Repositório Maven
Iniciações Rápidas
Código de Fonte
Application Platform
Importante
Os downloads do método da instalação RPM não estão disponíveis no Portal do Cliente,
porém através do Red Hat Net Work (RHN).
Reportar um erro
A.2. Est rut ura do Diret ório do JBoss EAP 6
Su mário
O JBoss EAP 6 inclui uma estrutura do diretório simplificado quando comparado às versões
anteriores. Este tópico contém uma lista de diretórios e uma descrição de qual diretório ele contém.
Ele também inclui estruturas das pastas stand al o ne/ e d o mai n/.
46
T ab ela A.2. D iret ó rio s e arq u ivo s d e n ível su p erio r
N o me
Pro p ó sit o
appclient/
Contém detalhes da configuração para o
contêiner do cliente do aplicativo.
Contém para os scripts de iniciação para o
JBoss EAP 6 no Red Hat Enterprise Linux e
Microsoft Windows.
Contém os pacotes OSGi que pertencem à
funcionalidade interna do JBoss EAP 6.
Arquivos de licença, esquemas e amostras.
As áreas dos arquivos de configuração,
conteúdo de implantação e gravável usados
como managed domain.
Os módulos que são dinamicamente
carregados pelo JBoss EAP 6 quando os
serviços os solicitarem.
As áreas dos arquivos de configuração,
conteúdo de implantação e gravável usadas
como servidor autônomo.
Contém o conteúdo usado pelo aplicativo da
web de Boas Vindas que está disponível na
porta 8080 de uma instalação default.
O mecanismo bootstrapping que carrega os
módulos.
bin/
bundles/
docs/
domain/
modules/
standalone/
welcome-content/
jbo ss-mo d ul es. jar
T ab ela A.3. O s d iret ó rio s co m o d iret ó rio d o mai n/
N o me
Pro p ó sit o
configuration/
Os arquivos de configuração para o managed
domain. Esses arquivos são modificados pelo
Management Console e Management CLI, sendo
que não devem ser editados diretamente.
A informação a respeito dos serviços
implantados. Os serviços são implantados
usando o Management Console e o
Management CLI ao invés de um scanner de
implantação. Portanto, não posicione arquivos
neste diretório manualmente.
Contém os arquivos de log do período de
execução para o host e controladores do
processo que executam numa instância local.
Contém d ata/, l o g / equivalente e diretórios
tmp/ para cada instância do servidor num
domain, que contém dados similares aos
mesmos diretórios com o diretório d o mai n/ de
nível superior.
Contém dados temporários tais como os
arquivos pertencentes ao mecanismo usado à
chave compartilhada usada pelo Management
CLI para autenticar os usuários locais ao
managed domain.
data/
log/
servers/
tmp/
47
T ab ela A.4 . D iret ó rio s co m o d iret ó rio stand al o ne/
N o me
Pro p ó sit o
configuration/
Os arquivos de configuração para o servidor
autônomo. Esses arquivos são modificados
pelo Management Console e Management CLI,
sendo que não devem ser editados diretamente.
Informação sobre os serviços implantados. O
serviço autônomo inclui um scanner de
implantação, de forma que você pode
posicionar arquivos no diretório a ser
posicionado. No entanto, a abordagem
recomendada é gerenciar implantações usando
o Management Console ou Management CLI.
As bibliotecas externas que pertencem ao modo
de servidor autônomo. O default é vazio.
Contém dados temporários tais como os
arquivos pertencentes ao mecanismo de chave
compartilhada usada pelo Management CLI
para autenticar os usuários locais ao servidor.
deployments/
lib/
tmp/
Reportar um erro
A.3. List a do Pacot e RPM para o JBoss EAP 6
Su mário
O JBoss EAP 6 é instalado no Red Hat Enterprise Linux 6 usando o JBo ss EAP 6 do grupo do
pacote YUM. Aquele grupo é feito dos seguintes pacotes.
T ab ela A.5. List a d e Paco t es
Paco t e
D escrição
jbossas-appclient
jbossas-bundles
jbossas-core
JEE Application Client Container
Pacotes OSGi
Componentes core. Isto é requerido para todas
as configurações.
Configuração domain
Contêiner para os arquivos do JBoss AS
HornetQ
JBoss Enterprise Web Platform
Módulos do JBoss EAP
Componentes de configuração do produto. Isto
personaliza a execução do produto.
Configuração autônoma
Conteúdo de boas-vindas usado nas
mensagens de iniciação e páginas do console
jbossas-domain
jbossas-hornetq-native
jbossas-jbossweb-native
jbossas-modules-eap
jbossas-product-eap
jbossas-standalone
jbossas-welcome-content-eap
48
Importante
O pacote jbo ssas-ho rnetq -nati ve está incluido para a alta disponibilidade no JBoss
EAP 6, mas não está habilitado por default.
Reportar um erro
A.4 . Os Arquivos da Configuração de Inst alação para o JBoss EAP 6
Su mário
A instalação RPM do JBoss EAP 6 inclui os três arquivos de configuração adicionais para a
instalação Z IP. Esses arquivos são usados pelo script init do serviço para especificar o ambiente de
iniciação do servidor do aplicativo. Um desses arquivos é aplicado a todas instâncias do JBoss
EAP 6, enquanto os outros dois substituem os servidores de modo domain e autônomo.
T ab ela A.6 . Arq u ivo s d e C o n f ig u ração R PM Ad icio n al
Arq u ivo
D escrição
Este arquivo é lido primeiramente e aplicado a todas as
instâncias do JBoss EAP 6.
As configurações específicas aos servidores autônomos. Os
valores especificados aqui substituirão os valores no
jbossas.conf quando executados como um servidor autônomo.
/etc/sysco nfi g /jbo ssas- As configurações especificam os servidores de modo domain. Os
d o mai n
valores especificados aqui irão substituir os valores no
jbossas.conf quando executados como servidor de modo
domain.
/etc/jbo ssas/jbo ssas. co
nf
/etc/sysco nfi g /jbo ssas
A seguinte tabela apresenta a lista de propriedades de configuração disponível juntamente com
seus valores default.
T ab ela A.7. Pro p ried ad es d e C o n f ig u ração d a In st alação R PM
Pro p ried ad e
D escrição
JBO SS_USER
A conta do servidor do sistema que o JBoss EAP 6 executa. Este usuário
possuiu propriedade dos arquivos.
Valor default: jbo ss
JBO SS_G R O UP
O grupo do usuário do sistema que os arquivos JBoss EAP 6 pertecem.
Valor default: jbo ss
JBO SS_ST AR T UP _WA
IT
O número de segundos que o script init esperará até confirmar que o
servidor iniciou com êxito após receber o comando start ou restart.
Valor default: 6 0
49
Pro p ried ad e
D escrição
JBO SS_SHUT D O WN_W
AIT
O número de segundos que o script init esperará para que o servidor
encerre antes de continuar quando ele receber o comando sto p ou
restart.
Valor default: 20
JBO SS_C O NSO LE_LO
G
O arquivo que o manuseador de registro CONSOLO será redirecionado.
JAVA_HO ME
O diretório onde o seu Ambiente do Período de Execução do Java é
instalado.
Valor default: /var/l o g /jbo ssas/$JBOSSCONF/co nso l e. l o g
Valor default: /usr/l i b/jvm/jre
JBO SS_HO ME
O diretório onde os arquivos do servidor do aplicativo são instalados.
Valor default: /usr/share/jbo ssas
JAVAP T H
O caminho onde os arquivos Java executáveis são instalados.
Valor default: $JAVA_HOME/bi n
JBO SSC O NF
O modo do servidor para iniciação deste servidor, stand al o ne ou
d o mai n.
Valor default: stand al o ne ou d o mai n dependendo no modo do
servidor.
JBO SSSH
O script do qual é usado para iniciar o servidor.
Valor default: $JBO SS_HO ME/bi n/$JBO SSC O NF. sh
JBO SS_SER VER _C O N
FIG
O arquivo de configuração do servidor para uso.
JBO SS_HO ST _C O NFI
G
Essa propriedade permite um usuário especificar a configuração host
(tal como ho st. xml ). Não existe valor determinado como default.
Reportar um erro
50
Não existe default para esta propriedade. Tanto o stand al o ne. xml ou
d o mai n. xml podem ser definidos no início.
Capt ura de T ela do Inst aller
Captura de Tela do Installer
B.1. Seleção do Idioma
Fig u ra B .1. Seleção d o Id io ma d o Pro g rama d e In st alação d o JB o ss EAP
Reportar um erro
B.2. Acordo da Licença do Usuário
51
Fig u ra B .2. Aco rd o d a Licen ça d o U su ário d o Pro g rama d e In st alação d o JB o ss EAP
Reportar um erro
B.3. Caminho da Inst alação
52
Fig u ra B .3. C amin h o d a In st alação d o Pro g rama d e In st alação d o JB o ss EAP
Reportar um erro
B.4 . Seleção de Pacot es para Inst alação
Selecione ou cancele a seleção dos pacotes para instalação. Os pacotes solicitados são
desabilitados para o cancelamento da seleção.
53
Fig u ra B .4 . Seleção d e Paco t es p ara In st alação d o Pro g rama d e In st alação d o JB o ss
EAP
Reportar um erro
B.5. Nova criação de usuário
54
Fig u ra B .5. C riação d o U su ário Ad min ist rat ivo d o Pro g rama d e In st alação d o JB o ss EAP
Reportar um erro
B.6. Inst alação de Iniciação Rápida
55
Fig u ra B .6 . C o n f ig u ração d e In iciação R áp id a d o Pro g rama d e In st alação d o JB o ss EAP
Reportar um erro
B.7. Configuração do Reposit ório Maven
56
Fig u ra B .7. C o n f ig u ração d o R ep o sit ó rio Maven d o Pro g rama d e In st alação d o JB o ss
EAP
Reportar um erro
B.8. Configuração Socket Binding
D ecida entre usar os default bidings ou configurar os bindings personalizados.
57
Fig u ra B .8. So cket B in d in g s D ef au lt d o Pro g rama d e In st alação d o JB o ss EAP
58
Fig u ra B .9 . So cket B in d in g s d o Po rt al d o C lien t e d o Pro g rama d e In st alação d o JB o ss
EAP
59
Fig u ra B .10. D eslo camen t o d o Pro g rama d a In st alação d o JB o ss EAP p ara o So cket
B in d in g s D ef au lt
Reportar um erro
B.9. Socket Bindings Personaliz ados para as Configurações
Aut ônomas
A seguinte sequência de telas aparece caso decida configurar os bindings do portal personalizado
para o modo autônomo.
60
Fig u ra B .11. C o n f ig u ração So cket B in d in g Au t ô n o mo d o JB o ss EAP In st aller
61
Fig u ra B .12. C o n f ig u ração So cket B in d in g d o H A au t ô n o mo d o JB o ss EAP In st aller
62
Fig u ra B .13. C o n f ig u ração So cket B in d in g Au t ô n o ma d o JB o ss EAP In st aller
In t eiramen t e Au t ô n o mo
63
Fig u ra B .14 . C o n f ig u ração So cket B in d in g Au t ô n o ma d o H A In t eiramen t e Au t ô n o mo d o
JB o ss EAP In st aller
Reportar um erro
B.10. Socket Bindings Personaliz ados para as Configurações Domain
A seguinte sequência de telas aparece caso escolha configurar os bindings da porta personalizada
para o modo domain.
64
Fig u ra B .15. C o n f ig u ração d o So cket B in d in g D o main H o st d o JB o ss EAP In st aller
65
Fig u ra B .16 . C o n f ig u ração So cket B in d in g D o main D ef au lt d o JB o ss EAP In st aller
66
Fig u ra B .17. C o n f ig u ração So cket B in d in g D o main H A d o JB o ss EAP In st aller
67
Fig u ra B .18. C o n f ig u ração So cket B in d in g D o main In t eira d o JB o ss EAP In st aller
68
Fig u ra B .19 . C o n f ig u ração d o So cket B in d in g D o main H A In t eira d o JB o ss EAP In st aller
Reportar um erro
B.11. Início do Servidor
69
Fig u ra B .20. In ício d o Servid o r d o Pro g rama d e In st alação d o JB o ss EAP
Reportar um erro
B.12. Configuração dos Níveis de Logon
70
Fig u ra B .21. N íveis d e Lo g o n d a C o n f ig u ração d o Pro g rama d e In st alação d o JB o ss EAP
Reportar um erro
B.13. Configuração do Ambient e do Período de Execução
Selecione Executar uma co nfi g uração avançad a para personalizar a instalação e
configuração de segurança, caching e opções da fonte de dados.
71
Fig u ra B .22. C o n f ig u ração d o Amb ien t e d o Perío d o d e Execu ção d o Pro g rama d e
In st alação d o JB o ss EAP - D ef au lt
72
Fig u ra B .23. C o n f ig u ração d o Amb ien t e d o Perío d o d e Execu ção d o Pro g rama d e
In st alação d o JB o ss EAP - Avan çad a
Reportar um erro
B.14 . Revisão dos Component es de Inst alação
73
Fig u ra B .24 . C o mp o n en t es Selecio n ad o s p ara a R evisão d o Pro g rama d e In st alação d o
JB o ss EAP
Reportar um erro
B.15. Progresso da Inst alação
74
Fig u ra B .25. Pro g resso d a In st alação d o C o mp o n en t e d o Pro g rama d e In st alação d o
JB o ss EAP
Reportar um erro
B.16. Configuração Vault de Senha
75
Fig u ra B .26 . C o n f ig u ração Vau lt d e Sen h a d o JB o ss EAP In st all
Reportar um erro
B.17. Configuração da Segurança SSL
76
Fig u ra B .27. C o n f ig u ração d a Seg u ran ça SSL d e In st alação d o JB o ss EAP
Reportar um erro
B.18. Configuração LDAP
77
Fig u ra B .28. C o n f ig u ração LD AP d e In st alação d o JB o ss EAP
Reportar um erro
B.19. Configuração Infinispan
78
Fig u ra B .29 . C o n f ig u ração In f in isp an d e In st alação d o JB o ss EAP
Reportar um erro
B.20. Configuração do Securit y Domain
79
80
Fig u ra B .30. C o n f ig u ração d o Secu rit y D o main d e In st alação d o JB o ss EAP
Reportar um erro
B.21. Configuração do JDBC Driver
81
Fig u ra B .31. C o n f ig u ração d o JD B C D river d e In st alação d o JB o ss EAP
Reportar um erro
B.22. Configuração da Font e de Dados
82
Fig u ra B .32. C o n f ig u ração d a Fo n t e d e D ad o s d e In st alação d o JB o ss EAP
Reportar um erro
B.23. Processament o de Inst alação Concluída
83
Fig u ra B .33. Pro cessamen t o d e In st alação C o n clu íd a d o Pro g rama d e In st alação d o
JB o ss EAP
Reportar um erro
B.24 . Criação de At alhos
84
Fig u ra B .34 . C riação d e At alh o s d o JB o ss EAP In st aller
Reportar um erro
B.25. Gerando o Script de Inst alação
85
Fig u ra B .35. G eran d o o Scrip t d e In st alação d o Pro g rama d e In st alação d o JB o ss EAP
Reportar um erro
86
Hist órico de Revisão
Histórico de Revisão
R evisão 6 .3.0- 30
Mo n d ay Au g u st 4 2014
Red Hat JBoss Enterprise Application Platform 6.3.0.GA
San d e G ild a
87