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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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” 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)” 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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. Pró ximo Passo em In st alação Z ip 12 Capít ulo 4 . Inst ruções de Inst alação Pró ximo Passo em In st alação Z ip 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 Seção 4.2.2, “ Instalação do JBoss EAP 6 (Instalaçã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) Pré- req u isit o s: Seção 3.1, “ Pré-requisitos da Instalação do JBoss EAP 6” 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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. Capít ulo 4 . Inst ruções de Inst alaçã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, “ Configuração do 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, clique em P ró xi ma. Selecione Executar a co nfi g uração d efaul t e clique P ró xi ma para continuar. 15 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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, clique em P ró xi ma. 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 avançada do ambiente 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, “ Configuração do Security D omain” Seção B.21, “ Configuração do 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. Capít ulo 4 . Inst ruções de Inst alação 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 avançada do ambiente 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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) Pré- req u isit o s: Seção 3.1, “ Pré-requisitos da Instalação do JBoss EAP 6” 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 Capít ulo 4 . Inst ruções de Inst alação 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação Pré- req u isit o s: Seção 3.1, “ Pré-requisitos da Instalação do JBoss EAP 6” 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) Pré- req u isit o s 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 Capít ulo 4 . Inst ruções de Inst alação 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 Pré- req u isit o s 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capít ulo 4 . Inst ruções de Inst alação 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) Pré- req u isit o s Instalação do JBoss EAP 6 usando a instalação Z ip, Instalador Gráfico ou Instalador baseado 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” 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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. Pré- req u isit o s Seção 3.1, “ Pré-requisitos da Instalação do JBoss EAP 6” 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 Capít ulo 4 . Inst ruções de Inst alação 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) Pré- req u isit o s 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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) Pré- req u isit o s Instalação do JBoss EAP 6 usando a instalação Z ip, Instalador Gráfico ou Instalador baseado 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” . Privilégios de administrador no servidor são requeridos. 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 Capít ulo 4 . Inst ruções de Inst alação 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capít ulo 4 . Inst ruções de Inst alação 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) Pré- req u isit o s Instalação do JBoss EAP 6 usando a instalação Z ip, Instalador Gráfico ou Instalador baseado 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” Privilégios de administrador no servidor são requeridos. 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capít ulo 4 . Inst ruções de Inst alação 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capít ulo 5. Pat ching e At ualiz ação do JBoss EAP 6 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 Pré- req u isit o s: Seção 3.1, “ Pré-requisitos da Instalação do JBoss EAP 6” 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/. Pré- req u isit o s 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação [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 Capít ulo 5. Pat ching e At ualiz ação do JBoss EAP 6 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/. Pré- req u isit o s 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Pré- req u isit o s: 38 Capít ulo 5. Pat ching e At ualiz ação do JBoss EAP 6 Seção 3.1, “ Pré-requisitos da Instalação do JBoss EAP 6” 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. Pré- req u isit o s 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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. Pré- req u isit o s 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 Capít ulo 5. Pat ching e At ualiz ação do JBoss EAP 6 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Pré- req u isit o s 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 Capít ulo 5. Pat ching e At ualiz ação do JBoss EAP 6 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 Pré- req u isit o s 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Pré- req u isit o s 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 Red Hat Enterprise Linux 5, Red Hat Enterprise Linux 6, Microsoft Windows Server 2008, Solaris 10 e 11, HewlettPackard HP-UX Red Hat Enterprise Linux 5, Red Hat Enterprise Linux 6, Microsoft Windows Server 2008, Solaris 10 e 11, HewlettPackard HP-UX Red Hat Enterprise Linux 5, Red Hat Enterprise Linux 6, Microsoft Windows Server 2008, Solaris 10 e 11, HewlettPackard HP-UX Plataforma independente 45 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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. Plataforma independente Repositório Maven Iniciações Rápidas Código de Fonte Application Platform Plataforma independente Plataforma independente Plataforma independente Plataforma independente 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 Mat erial de Referência 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Mat erial de Referência 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capt ura de T ela do Inst aller 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capt ura de T ela do Inst aller 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capt ura de T ela do Inst aller 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capt ura de T ela do Inst aller 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capt ura de T ela do Inst aller 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capt ura de T ela do Inst aller 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capt ura de T ela do Inst aller 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capt ura de T ela do Inst aller 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capt ura de T ela do Inst aller 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capt ura de T ela do Inst aller 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capt ura de T ela do Inst aller 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capt ura de T ela do Inst aller 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capt ura de T ela do Inst aller 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capt ura de T ela do Inst aller 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 80 Capt ura de T ela do Inst aller 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capt ura de T ela do Inst aller 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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 Capt ura de T ela do Inst aller 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 JBoss Ent erprise Applicat ion Plat form 6 .3 G uia de Inst alação 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