Red Hat JBoss EnterpriseApplication Platform 7.0
Guia de Instalação
For Use with Red Hat JBoss Enterprise Application Platform 7.0
Last Updated: 2018-01-05
Red Hat JBoss Enterprise Application Platform 7.0 Guia deInstalaçãoFor Use with Red Hat JBoss Enterprise Application Platform 7.0
Nota LegalCopyright © 2018 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a CreativeCommons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation ofCC-BY-SA is available athttp://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it,you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not toassert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, OpenShift, Fedora, theInfinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United Statesand other countries.
Linux ® is the registered trademark of Linus Torvalds in the United States and othercountries.
Java ® is a registered trademark of Oracle and/or its affiliates.
XFS ® is a trademark of Silicon Graphics International Corp. or its subsidiaries in theUnited States and/or other countries.
MySQL ® is a registered trademark of MySQL AB in the United States, the EuropeanUnion and other countries.
Node.js ® is an official trademark of Joyent. Red Hat Software Collections is not formallyrelated to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack ® Word Mark and OpenStack logo are either registeredtrademarks/service marks or trademarks/service marks of the OpenStack Foundation, inthe United States and other countries and are used with the OpenStack Foundation'spermission. We are not affiliated with, endorsed or sponsored by the OpenStackFoundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
ResumoThis book is a guide to the installation of Red Hat JBoss Enterprise Application Platform7.0.
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ÍndiceCAPÍTULO 1. VISÃO GERAL DO PRODUTO
1.1. SOBRE O RED HAT JBOSS ENTERPRISE APPLICATION PLATFORM 71.2. SOBRE O PORTAL DO CONSUMIDOR RED HAT1.3. SOBRE O USO DO EAP_HOME NESTE DOCUMENTO
CAPÍTULO 2. PREPARANDO PARA A INSTALAÇÃO2.1. SELECIONANDO O MÉTODO DE INSTALAÇÃO DO JBOSS EAP2.2. PRÉ-REQUISITOS PARA A INSTALAÇÃO DO JBOSS EAP
CAPÍTULO 3. INSTALANDO O JBOSS EAP3.1. INSTALAÇÃO ZIP
3.1.1. Baixando o JBoss EAP (Instalação ZIP)3.1.2. Instalando o JBoss EAP (Instalação ZIP)
3.2. INSTALAÇÃO DO INSTALADOR3.2.1. Baixando o JBoss EAP (Instalação do Instalador)3.2.2. Executando o Instalador do JBoss EAP
3.3. INSTALAÇÃO RPM3.3.1. Escolhendo um Repositório
3.3.1.1. Subscrevendo-se ao Repositório com a Versão Atual do JBoss EAP 73.3.1.2. Subscrevendo a um Repositório com as Versões de Manutenção do JBoss EAP 7
3.3.2. Instalando o JBoss EAP (Instalação RPM)3.3.3. Alterando os Repositórios
3.4. INSTALAÇÃO AUTOMATIZADA DO INSTALADOR3.4.1. Instalação Automatizada Autônoma do Instalador
CAPÍTULO 4. CONFIGURANDO O JBOSS EAP PARA SER EXECUTADO COMO UM SERVIÇO4.1. CONFIGURANDO O JBOSS EAP COMO UM SERVIÇO NO RED HAT ENTERPRISE LINUX(INSTALAÇÕES ZIP E DO INSTALADOR)4.2. CONFIGURANDO O JBOSS EAP COMO UM SERVIÇO NO RED HAT ENTERPRISE LINUX(INSTALAÇÃO RPM)4.3. CONFIGURANDO O JBOSS EAP COMO UM SERVIÇO NO MICROSOFT WINDOWS SERVER4.4. CONFIGURANDO O JBOSS EAP COMO UM SERVIÇO USANDO JSVC
CAPÍTULO 5. DESINSTALANDO O JBOSS EAP5.1. DESINTALANDO O JBOSS EAP (INSTALAÇÃO ZIP)5.2. DESINSTALANDO O JBOSS EAP (INSTALAÇÃO DO INSTALADOR)5.3. DESINSTALANDO O JBOSS EAP (INSTALAÇÃO RPM)
3333
555
7777788
2424252525262727
30
30
313234
40404041
Índice
1
CAPÍTULO 1. VISÃO GERAL DO PRODUTO
1.1. SOBRE O RED HAT JBOSS ENTERPRISE APPLICATIONPLATFORM 7O Red Hat JBoss Enterprise Application Platform 7 (JBoss EAP) é uma plataforma demiddleware construída em padrões abertos e compatível com a especificação JavaEnterprise Edition 7. Ele integra o WildFly Application Server 10 com um sistema demensagens, clusterização de alta disponibilidade e outras tecnologias.
O JBoss EAP oferece uma estrutura modular que permite a habilitação de serviços apenasquando necessário, melhorando a velocidade da inicialização.
O Console de Gerenciamento e a CLI (Interface de Linha de Comando) de Gerenciamentotornam as edições dos arquivos de configuração XML desnecessárias e agregam ahabilidade de utilizar script e automatizar tarefas.
O JBoss EAP fornece dois modos de operação para as instâncias do JBoss EAP: o servidorautônomo ou o domínio gerenciado. O modo de operação do servidor autônomo representao JBoss EAP em execução como uma instância de servidor único. O modo de operação dodomínio gerenciado permite o gerenciamento de múltiplas instâncias do JBoss EAP a partirde um ponto de controle único.
Além disso, o JBoss EAP inclui APIs e estruturas para o desenvolvimento rápido deaplicativos Java EE seguros e escaláveis.
1.2. SOBRE O PORTAL DO CONSUMIDOR RED HATO Portal do Consumidor Red Hat é uma plataforma centralizada para os recursos desubscrição e conhecimento da Red Hat. Acesse o Portal do Consumidor Red Hat pararealizar o seguinte:
Gerenciar e manter os contratos de suporte e direitos da Red Hat.
Baixar software com suporte oficial.
Acessar as documentações de produtos e o banco de dados de conhecidmento daRed Hat.
Contactar os Serviços de Suporte Global.
Arquivar erros dos produtos Red Hat.
O Portal do Consumidor está disponível aqui: https://access.redhat.com.
1.3. SOBRE O USO DO EAP_HOME NESTE DOCUMENTONeste documento, a variável EAP_HOME é usada para denotar o caminho para a instalaçãodo JBoss EAP. Substitua esta variável pelo caminho atual da sua instalação do JBoss EAP 7.
Caso você tenha instalado o JBoss EAP usando o método de instalação ZIP, odiretório de instalação será o diretório jboss-eap-7.0, de onde você extraiu oarquivo ZIP.
Caso você tenha instalado o JBoss EAP usando o método de instalação RPM, o
CAPÍTULO 1. VISÃO GERAL DO PRODUTO
3
diretório de instalação será /opt/rh/eap7/root/usr/share/wildfly/.
Caso você tenha usado o instalador para instalar o JBoss EAP, o caminho padrãopara o EAP_HOME será ${user.home}/EAP-7.0.0:
Para o Red Hat Enterprise Linux, Solaris e HP-UX: /home/USER_NAME/EAP-7.0.0/
Para o Microsoft Windows: C:\Users\USER_NAME\EAP-7.0.0\
Caso você tenha usado o instalador do JBoss Developer Studio para instalar econfigurar o servidor do JBoss EAP, o caminho padrão para o EAP_HOME será ${user.home}/jbdevstudio/runtimes/jboss-eap:
Para o Red Hat Enterprise Linux: /home/USER_NAME/jbdevstudio/runtimes/jboss-eap/
Para o Microsoft Windows: C:\Users\USER_NAME\jbdevstudio\runtimes\jboss-eap oo C:\Documents e Settings\USER_NAME\jbdevstudio\runtimes\jboss-eap\
NOTA
O EAP_HOME não é uma variável de ambiente. Já o JBOSS_HOME é a variável deambiente usada em scripts.
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação
4
CAPÍTULO 2. PREPARANDO PARA A INSTALAÇÃO
2.1. SELECIONANDO O MÉTODO DE INSTALAÇÃO DO JBOSSEAPExitem várias formas diferentes de instalar o JBoss EAP. Cada método serve para umadeterminada situação. A tabela abaixo oferece uma visão geral de cada tipo de instalação efornece links para as seções que cobrem os processos de instalação relevantes.
NOTA
Se você planeja usar o JBoss ON para implantar e instalar as correções doJBoss EAP, as instâncias de destino do JBoss EAP devem ser instaladas usandoo método de instalação ZIP.
Tabela 2.1. Métodos de Instalação
Método Descrição
Instalação ZIP O arquivo ZIP é adequado para a instalação em todos ossistemas operacionais com suporte. Este método deve serusado se você deseja extrair a instância manualmente.
A instalação ZIP fornece uma instalação padrão do JBoss EAP etoda a configuração deve ser feita após a instalação.
Instalador JAR O instalador JAR pode ser executado em um console ou comoum assistente gráfico. Ambas as opções fornecem instruçõespasso a passo para a instalação e a configuração da instânciado servidor. Este é o método preferencial para instalar o JBossEAP em todas as plataformas com suporte.
Configurações adicionais, incluindo os Inícios Rápidos e oRepositório do Maven, também são possíveis com o instalador.
Instalação RPM O JBoss EAP pode ser instalado usando os pacotes RPM nasinstalações com suporte do Red Hat Enterprise Linux 6 e RedHat Enterprise Linux 7.
2.2. PRÉ-REQUISITOS PARA A INSTALAÇÃO DO JBOSS EAPCada método de instalação possui um número de pré-requisitos. A tabela abaixo apresentaos requisitos comuns, assim como, aqueles específicos a cada método de instalação.
Tabela 2.2. Pré-requisitos para a Instalação do JBoss EAP
Tipo de Instalação Pré-requisitos
CAPÍTULO 2. PREPARANDO PARA A INSTALAÇÃO
5
Pré-requisitos ComunsConfigure uma conta no Portal do Consumidor Red Hat.
Revise as configurações do JBoss EAP 7 com suporte ecertifique-se de que o seu sistema possua suporte.
Certifique-se de que o seu sistema esteja em dia comas atualizações e erratas emitidas pela Red Hat.
Pré-requisitos doInstalador/ZIP Certifique-se de que um Kit de Desenvolvimento Java
(JDK) com suporte tenha sido instalado.
No Microsoft Windows Server, certifique-se de que asvariáveis do ambiente, JAVA_HOME e PATH, tenhamsido definidas, caso contrário os atalhos nãofuncionarão.
No HP-UX da Hewlett-Packard, certifique-se de que umutilitário de descompactação tenha sido instalado.
Pré-requisitos RPMRegistre o servidor do Red Hat Enterprise Linux usandoo Gerenciador de Subscrição Red Hat.
Certifique-se de que um Kit de Desenvolvimento Java(JDK) com suporte tenha sido instalado.
Tipo de Instalação Pré-requisitos
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação
6
CAPÍTULO 3. INSTALANDO O JBOSS EAP
3.1. INSTALAÇÃO ZIP
3.1.1. Baixando o JBoss EAP (Instalação ZIP)
Pré-requisitos
Pré-requisitos de Instalação do JBoss EAP
O arquivo ZIP do JBoss EAP está disponível no Portal do Consumidor Red Hat. A instalaçãodo arquivo ZIP é independente da plataforma.
Baixando o Arquivo ZIP do JBoss EAP
1. Abra um navegador e faça o login no Portal do Consumidor Red Hat emhttps://access.redhat.com.
2. Clique em Downloads.
3. Clique em Red Hat JBoss Enterprise Application Platform na lista Downloadsde Produtos.
4. Selecione a versão correta do JBoss EAP a partir do menu suspenso Versão.
5. Localize o Red Hat JBoss Enterprise Application Platform 7. x.x na lista e cliqueno link Download.
3.1.2. Instalando o JBoss EAP (Instalação ZIP)Depois que o arquivo ZIP de instalação do JBoss EAP for baixado, ele pode ser instaladoextraindo os conteúdos do pacote.
1. Se necessário, mova o arquivo ZIP para o servidor e o local onde o JBoss EAP deveser instalado.
O usuário que executará o JBoss EAP deve ter acesso de leitura e gravação paraeste diretório.
2. Extraia o arquivo ZIP.
$ unzip jboss-eap-7.x.x.zip
NOTA
Para o Windows Server, clique com o botão direito do mouse no arquivoZIP e selecione Extrair Todos.
O diretório criado extraindo o arquivo ZIP é o diretório de nível superior para a instalaçãodo JBoss EAP. Ele é referido como EAP_HOME.
3.2. INSTALAÇÃO DO INSTALADOR
CAPÍTULO 3. INSTALANDO O JBOSS EAP
7
3.2.1. Baixando o JBoss EAP (Instalação do Instalador)
Pré-requisitos
Pré-requisitos de Instalação do JBoss EAP
O instalador JAR do JBoss EAP está disponível no Portal do Consumidor Red Hat. O arquivo .jar pode ser usado para executar instaladores gráficos ou baseados em texto. Oinstalador é a maneira preferencial de instalar o JBoss EAP em todas as plataformas comsuporte.
Baixando o Instalador do JBoss EAP
1. Abra um navegador e faça o login no Portal do Consumidor Red Hat emhttps://access.redhat.com.
2. Clique em Downloads.
3. Clique em Red Hat JBoss Enterprise Application na lista Downloads deProdutos .
4. Selecione a versão correta do JBoss EAP a partir do menu suspenso Versão.
5. Localize o Red Hat JBoss Enterprise Application 7.x.x Installer na lista e cliqueno link Download.
3.2.2. Executando o Instalador do JBoss EAPVocê pode executar o instalador JAR do JBoss EAP no modo gráfico ou baseado em texto.
Executando o Instalador Gráfico do JBoss EAP
1. Abra um terminal e navegue até o diretório contendo o arquivo JAR do Instalador doJBoss EAP baixado.
2. Execute o instalador gráfico usando o seguinte comando:
java -jar jboss-eap-7.x.x-installer.jar
NOTA
No HP-Ux da Hewlett-Packard ou em ambientes Solaris, você podeespecificar a arquitetura necessária usando a opção -d32 ou -d64.Inicie o instalador executando um dos comandos a seguir:
java -jar -d32 jboss-eap-7.x.x-installer.jar
ou
java -jar -d64 jboss-eap-7.x.x-installer.jar
3. Siga as instruções da tabela abaixo:
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação
8
Tabela 3.1. Telas do Instalador do JBoss EAP
Nome da Tela Quando aparece Descrição
Seleção de Idioma Sempre Selecione o idioma desejado para oinstalador e clique em OK.
Contrato deLicença
Sempre O EULA (Contrato de Licença de UsuárioFinal) para o RED HAT JBOSSMIDDLEWARE.
Selecione "Aceito os termos deste contratode licença" e clique em Próximo.
Caminho deInstalação
Sempre Selecione o caminho de instalação para oJBoss EAP e clique em Próximo.
Seleção deComponentes
Sempre Selecione os componentes para instalar.Os componentes necessários estãodesabilitados para o cancelamento deseleção.
Figura 3.1. Instalador do JBoss EAP - Tela de Seleção deComponentes
Criação do UsuárioAdmin
Sempre Crie um usuário administrativo eespecifique uma senha. Depois, clique emPróximo.
Visão Geral daInstalação
Sempre Revise as suas opções de instalação edepois clique em Próximo.
Instalação deComponentes
Sempre Quando o progresso da instalação estivercompleto, clique em Próximo.
CAPÍTULO 3. INSTALANDO O JBOSS EAP
9
Configure oAmbiente deTempo deExecução
Sempre Você pode selecionar uma configuraçãopadrão para a sua instalação do JBoss EAPou optar por desempenhar umaconfiguração avançada com o instalador.Observe que, mesmo que você escolhauma configuração padrão, você aindapode alterar depois a sua configuraçãousando as interfaces de gerenciamento doJBoss EAP.
Selecione Desempenhar configuraçãopadrão ou selecione Desempenharconfiguração avançada e selecione ositens a serem configurados e, depois,clique em Próximo.
Figura 3.2. Instalador do JBoss EAP - Configure a Tela doAmbiente de Tempo de Execução
Configure o Cofrede Senhas
Caso opte porinstalar um cofrede senhas em umaconfiguraçãoavançada doambiente do tempode execução.
Configure a password vault to store allyour sensitive passwords in an encryptedkeystore, then click Next. For moreinformation, see the password vaultdocumentation in the How To ConfigureServer Security guide.
Nome da Tela Quando aparece Descrição
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação
10
Figura 3.3. Instalador do JBoss EAP - Configure a Tela doCofre de Senhas
Nome da Tela Quando aparece Descrição
CAPÍTULO 3. INSTALANDO O JBOSS EAP
11
Segurança SSL Caso você decidahabilitar aSegurança SSL naconfiguraçãoavançada doambiente do tempode execução.
Specify an SSL keystore and the keystorepassword for securing the JBoss EAPmanagement interfaces, then click Next.For more information, see thedocumentation on securing themanagement interfaces in the How ToConfigure Server Security guide.
ATENÇÃO
Red Hat recommendsthat SSLv2, SSLv3, andTLSv1.0 be explicitlydisabled in favor ofTLSv1.1 or TLSv1.2 inall affected packages.
Configuração LDAP Caso você decidahabilitar aautenticação LDAPna configuraçãoavançada doambiente do tempode execução.
Enable LDAP authentication to use anLDAP directory server as theauthentication source for the managementconsole, management CLI, andmanagement API. When you are done,click Next. For more information, see theLDAP documentation in the How toConfigure Identity Management guide.
Nome da Tela Quando aparece Descrição
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação
12
Figura 3.4. Instalador do JBoss EAP - Tela de ConfiguraçãoLDAP
Configuração LDAPdo Realm deSegurança
Caso você decidahabilitar aautenticação LDAPna configuraçãoavançada doambiente do tempode execução.
Um novo realm de segurança será criado eassociado às interfaces de gerenciamento,usando a conexão LDAP definida na etapaanterior.
Specify the values for your LDAPenvironment, then click Next. For moreinformation, see the LDAP documentationin the How to Configure IdentityManagement guide.
Nome da Tela Quando aparece Descrição
CAPÍTULO 3. INSTALANDO O JBOSS EAP
13
Figura 3.5. Instalador do JBoss EAP - Tela de ConfiguraçãoLDAP do Realm de Segurança
ConfiguraçãoInfinispan
Caso opte porinstalar um cacheInfinispan naconfiguraçãoavançada doambiente do tempode execução.
Create an Infinispan cache for managingcached data. Give an Infinispan name andconfigure the other fields, then click Next.For more information, see the Infinispandocumentation in the Configuration Guide.
Nome da Tela Quando aparece Descrição
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação
14
Figura 3.6. Instalador do JBoss EAP - Tela de ConfiguraçãoInfinispan
Configuração doDomínio deSegurança
Caso opte poradicionar umdomínio desegurança naconfiguraçãoavançada doambiente do tempode execução.
Configure a security domain for the JBossEAP server instance. Most of the fields arealready populated with default values anddo not need modification. When you aredone, click Next. For more information,see Security Domains in the SecurityArchitecture Guide.
Nome da Tela Quando aparece Descrição
CAPÍTULO 3. INSTALANDO O JBOSS EAP
15
Figura 3.7. Instalador do JBoss EAP - Tela de Configuraçãodo Domínio de Segurança
Configuração JSSE Caso opte poradicionar umdomínio desegurança naconfiguraçãoavançada doambiente do tempode execução.
Configure o JSSE (Extensão de SoqueteSeguro para Java) para o domínio desegurança definido na etapa anterior,usando um armazenamento de chave ouum armazenamento de confiança. Quandovocê concluir, clique em Próximo.
Nome da Tela Quando aparece Descrição
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação
16
Figura 3.8. Instalador do JBoss EAP - Tela de ConfiguraçãoJSSE
Inícios Rápidos Caso opte porinstalar iníciosrápidos naconfiguraçãoavançada doambiente do tempode execução.
Selecione o caminho de instalação doinício rápido e clique em Próximo.
Configuração doRepositório doMaven
Caso opte porinstalar iníciosrápidos naconfiguraçãoavançada doambiente do tempode execução.
Selecione o seu arquivo de configurações eo repositório do Maven.
Nome da Tela Quando aparece Descrição
CAPÍTULO 3. INSTALANDO O JBOSS EAP
17
Figura 3.9. Instalador do JBoss EAP - Tela de Configuraçãodo Repositório do Maven
Nome da Tela Quando aparece Descrição
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação
18
Associações deSoquete
Caso opte porconfigurar asassociações deporta do servidorna configuraçãoavançada doambiente do tempode execução.
Determine se a instalação usará ou não asassociações de porta padrão, configure osdeslocamentos de porta para todas asassociações padrão ou configure asassociações de porta personalizadas.
Caso opte por configurar os deslocamentosde porta, selecione o número dedeslocamento.
Caso opte por configurar as associaçõespersonalizadas, selecione se desejaconfigurar as portas para o modoautônomo, o modo de domínio ou ambos.
Se o host estiver configurado para IPv6apenas, selecione a caixa de verificaçãoHabilitar a configuração IPv6 pura e oinstalador aplicará as alterações deconfiguração necessárias.
Clique em Próximo.
Figura 3.10. Instalador do JBoss EAP - Tela de Associaçõesde Soquete
Nome da Tela Quando aparece Descrição
CAPÍTULO 3. INSTALANDO O JBOSS EAP
19
Associações deSoquetePersonalizadaspara ConfiguraçõesAutônomas
Caso opte porconfigurar asassociações deportapersonalizadaspara o modoautônomo.
Configure as portas e as propriedades dosistema para cada configuração autônoma(standalone, standalone ha, standalone full, standalone full-ha) e clique em Próximo.
Figura 3.11. Instalador do JBoss EAP - Associações deSoquete Personalizadas para a Tela de Configurações
Autônomas
Associações deSoquetePersonalizadaspara Configuraçõesde Domínio
Caso opte porconfigurar asassociações deportapersonalizadaspara o modo dedomínio.
Configure as portas e as propriedades dosistema para a configuração do host(domain host) e cada perfil de domínio(domain default, domain ha, domain full, domain full-ha) e clique emPróximo.
Nome da Tela Quando aparece Descrição
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação
20
Figura 3.12. Instalador do JBoss EAP - Associações deSoquete Personalizadas para a Tela de Configurações de
Domínio
Opções de Registroem Log
Caso opte porconfigurar os níveisde registro em logna configuraçãoavançada doambiente do tempode execução.
Selecione os níveis de registro em logdesejados e clique em Próximo.
Nome da Tela Quando aparece Descrição
CAPÍTULO 3. INSTALANDO O JBOSS EAP
21
Configuração doDriver JDBC
Caso opte porinstalar um driverJDBC naconfiguraçãoavançada doambiente do tempode execução.
Install and setup a JDBC driver. Choose theappropriate driver vendor from the dropdown list and specify the driver JARlocation(s). When you are done, clickNext. For more information, see thedatasource JDBC driver section in theConfiguration Guide.
Figura 3.13. Instalador do JBoss EAP - Tela deConfiguração do Driver JDBC
Configuração daFonte de Dados
Caso opte porinstalar um driverJDBC e uma fontede dados naconfiguraçãoavançada doambiente do tempode execução.
Configure a datasource which can be usedby applications. Provide a datasourcename and configure the other options,then click Next. For more information, seethe details of datasource management inthe Configuration Guide.
Nome da Tela Quando aparece Descrição
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação
22
Figura 3.14. Instalador do JBoss EAP - Tela deConfiguração da Fonte de Dados
Configure oServidor
Sempre Quando o progresso de configuraçãoestiver completo, clique em Próximo.
Configuração deAtalhos
Sempre Selecione a caixa de verificação CriarAtalhos no Menu Iniciar para criaratalhos. São permitidos somentecaracteres alfanuméricos e os caracteres'traço' (-) e 'sublinhado' (_). No MicrosoftWindows, os caracteres 'barra' (/) e 'barrainvertida' (\) também são permitidos.Clique em Próximo.
InstalaçãoConcluída
Sempre Clique em Gerar script de instalação earquivo de propriedades, caso desejecapturar as opções de instalaçãoselecionadas para uma instalaçãoautomatizada futura, e clique emConcluído.
A instalação está completa agora. Odiretório criado pelo instalador é odiretório de nível superior para o servidor.Isto é referido como EAP_HOME.
Nome da Tela Quando aparece Descrição
Executando o Instalador Baseado em Texto do JBoss EAP
CAPÍTULO 3. INSTALANDO O JBOSS EAP
23
Executando o Instalador Baseado em Texto do JBoss EAP
1. Abra um terminal e navegue até o diretório contendo o JAR do Instalador do JBossEAP baixado.
2. Execute o instalador baseado em texto usando o seguinte comando:
java -jar jboss-eap-7.x.x-installer.jar -console
3. Siga os prompts para instalar o JBoss EAP. O diretório criado pelo instalador é odiretório de nível superior para o servidor. Isto é referido como EAP_HOME.
3.3. INSTALAÇÃO RPM
NOTA
For users wanting to manage JBoss EAP installations using Red Hat Satellite:although Red Hat Satellite 6 is recommended for managing JBoss EAP 7installations, the following Red Hat Network (RHN) channels are also providedspecifically for Satellite 5 users:
For Red Hat Enterprise Linux 6:
jbappplatform-7.0-i386-server-6-rpm
jbappplatform-7.0-x86_64-server-6-rpm
For Red Hat Enterprise Linux 7:
jbappplatform-7.0-x86_64-server-7-rpm
Red Hat Satellite 6 users can use the repositories shown in Choosing aRepository.
NOTA
From Red Hat Enterprise Linux 7, the term channel was replaced with theterm repository. In these instructions only the term repository is used.
3.3.1. Escolhendo um RepositórioA Instalação do JBoss EAP via RPM requer subscrição para ambos, o repositório do softwarebase do Red Hat Enterprise Linux Server e um repositório específico do JBoss EAP .
Para o repositório do JBoss EAP, você deve subscrever-se para o repositório com a versãoatual ou para um repositório com versões de manutenção do JBoss EAP.
Repositório com a Versão Atual do JBoss EAPO repositório com a versão atual fornece o último lançamento do JBoss EAP 7. Aoatualizar a sua instalação do JBoss EAP, você receberá todas as atualizações para o JBossEAP 7, incluindo upgrades secundários.Por exemplo, a atualização deste repositório incluirá upgrades do JBoss EAP 7 ao JBossEAP 7.1, caso seja lançado.
Repositório com Versões de Manutenção do JBoss EAP
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação
24
Um repositório com versões de manutenção fornece um lançamento de manutençãoespecífico do JBoss EAP 7 e todos os patches aplicáveis. Isto permite que vocêpermaneça com a mesma versão de manutenção do JBoss EAP e mantenha-se, aomesmo tempo, atualizado quanto aos patches de segurança e de alta gravidade.Por exemplo, a atualização deste respositório incluirá patches e atualizações desegurança para a versão de manutenção do JBoss EAP, mas não incluirá upgrades doJBoss EAP 7.0 ao JBoss EAP 7.1, caso seja lançado.
NOTA
For production environments, we recommend that you use the minor JBossEAP repository. This reduces the risk of unexpected changes in subsystemmodules or necessary configuration changes caused by unexpected JBoss EAPupgrades. You can always change repositories at a later date if you want toreceive an upgrade.
3.3.1.1. Subscrevendo-se ao Repositório com a Versão Atual do JBoss EAP7
1. Ensure that your Red Hat Enterprise Linux system is registered to your accountusing Red Hat Subscription Manager. For more information, see the Red HatSubscription Management documentation.
2. Ao acessar o Red Hat Subscription Manager, subscreva-se para o repositório com aversão 'atual' do JBoss EAP 7 usando o comando a seguir. Substitua RHEL_VERSIONpor 6 ou 7 dependendo da sua versão do Red Hat Enterprise Linux.
subscription-manager repos --enable=jb-eap-7-for-rhel-RHEL_VERSION-server-rpms
3.3.1.2. Subscrevendo a um Repositório com as Versões de Manutenção doJBoss EAP 7
1. Ensure that your Red Hat Enterprise Linux system is registered to your accountusing Red Hat Subscription Manager. For more information, see the Red HatSubscription Management documentation.
2. Ao acessar o Red Hat Subscription Manager, subscreva-se para um repositório comas versões de manutenção do JBoss EAP 7 usando o comando a seguir. Certifique-sede que:
Voê substitua EAP_MINOR_VERSION por sua versão de manutenção desejada doJBoss EAP. Por exemplo, para esta versão de manutenção do lançamento, insira: 7.0.
Você substitua RHEL_VERSION por 6 ou 7, dependendo da sua versão do Red HatEnterprise Linux.
subscription-manager repos --enable=jb-eap-EAP_MINOR_VERSION-for-rhel-RHEL_VERSION-server-rpms
3.3.2. Instalando o JBoss EAP (Instalação RPM)
CAPÍTULO 3. INSTALANDO O JBOSS EAP
25
Pré-requisitos
Pré-requisitos de Instalação do JBoss EAP
Subscreva-se para um repositório do JBoss EAP
1. Instale o JBoss EAP a partir do seu repositório subscrito usando o seguinte comando:
yum groupinstall jboss-eap7
A sua instalação está concluída. O caminho padrão EAP_HOME para a instalação RPM é /opt/rh/eap7/root/usr/share/wildfly.
3.3.3. Alterando os RepositóriosDurante o tempo de vida de uma instalação do JBoss EAP, você pode querer alterar asubscrição do software de um repositório do JBoss EAP para outro. A alteração derepositórios possui suporte, mas apenas dentro das seguintes condições:
Alterando do repositório com a versão 'atual' para um repositório com as versõesde manutenção
Com suporte, se alterando para o repositório com as versões de manutenção maisrecentes.
Alterando de um repositório com versões de manutenção para outro repositóriocom versões de manutenção
Com suporte, se alterando para a próxima versão de manutenção do JBoss EAP. Porexemplo, a alteração do JBoss EAP 7.0 para o JBoss EAP 7.1 possui suporte, mas aalteração do JBoss EAP 7.0 para o JBoss EAP 7.2 não possui suporte.
Alterando de um repositório com versões de manutenção para o respositório coma versão 'atual'
Com suporte, se alterando do repositório com versões de manutenção mais recentes.
Pré-requisitos
Instale o JBoss EAP como uma instalação RPM.
Escolha um repositório para fazer a alteração e certifique-se de que você esteja emconformidade com as condições de alteração com suporte apresentadas acima.
Alterando o Repositório do JBoss EAP
1. Antes de alterar o repositório, certifique-se de que a instalação do JBoss EAP tenhatodas as atualizações aplicáveis:
yum update
2. Ao acessar o Red Hat Subscription Manager, cancele a subscrição do repositórioexistente e subscreva-se para o novo repositório, para o qual o você deseja fazer aalteração. No comando abaixo, substitua EXISTING_REPOSITORY e NEW_REPOSITORYpelos nomes dos respectivos repositórios.
subscription-manager repos --disable=EXISTING_REPOSITORY --enable=NEW_REPOSITORY
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação
26
3.4. INSTALAÇÃO AUTOMATIZADA DO INSTALADORCaso você utilize o instalador JAR para instalar o JBoss EAP, você pode usar um script deinstalação gerado de uma instalação anterior para automatizar futuras instalações com amesma configuração.
ATENÇÃO
O instalador automatizado não é compatível com versões anteriores.Você não pode usar um script de instalação gerado a partir de umaversão anterior do JBoss EAP com o instalador automatizado. Você deveusar somente os scripts gerados pela mesma versão de manutenção doJBoss EAP, por exemplo o JBoss EAP 7.0.
Pré-requisitos
Use o Instalador JAR para gerar um script de instalação automática. O script deinstalação automática é um arquivo XML.
Instalação Automatizada do Instalador
1. Abra um terminal e navegue até o diretório contendo o arquivo JAR do Instalador doJBoss EAP baixado.
2. Execute o comando a seguir para instalar o JBoss EAP usando o arquivo XML doscript de instalação automática:
java -jar jboss-eap-7.x.x-installer.jar auto.xml
Por padrão, o instalador solicitará que você insira as senhas necessárias para aconfiguração do JBoss EAP. Você pode aplicar uma instalação autônomapredefinindo as senhas para a instalação.
NOTA
Você pode armazenar o arquivo XML do script de instalação automáticaem um host de rede e usar HTTP ou FTP para indicar ao instalador queele deve ser usado em uma instalação. Por exemplo:
java -jar jboss-eap-7.x.x-installer.jar http://network-host.local/auto.xml
java -jar jboss-eap-7.x.x-installer.jar ftp://network-host.local/auto.xml
3.4.1. Instalação Automatizada Autônoma do Instalador
Pré-requisitos
CAPÍTULO 3. INSTALANDO O JBOSS EAP
27
Use o Instalador JAR para gerar um script de instalação automática. O script deinstalação automática é um arquivo XML.
Para realizar uma instalação automatizada autônoma do instalador, você deve predefinir assenhas necessárias para a instalação do JBoss EAP.
Quando o arquivo XML do script de instalação é gerado a partir de uma instalação anteriordo instalador, um arquivo incompleto das variáveis do script de instalação também égerado. Ele possui o mesmo nome de arquivo que o arquivo do script de instalação, mascom um sufixo .variables.
Este arquivo de variáveis contém uma lista dos parâmetros de senhas e chaves necessáriospara uma instalação automatizada autônoma.
Você pode fornecer as senhas necessárias como um arquivo de variáveis completo ou comoum argumento quando estiver executando o comando do instalador.
Instalação Automatizada Autônoma do Instalador Usando um Arquivo deVariáveis
1. Abra o arquivo .variables em um editor de texto e forneça um valor da senha paracada chave. Por exemplo:
adminPassword = password#2vault.keystorepwd = vaultkeystorepwssl.password = user12345
2. Execute o instalador usando o arquivo XML do script de instalação automática. Oinstalador detecta o arquivo de variáveis automaticamente, caso o arquivo devariáveis completo esteja no mesmo diretório que o arquivo XML do script deinstalação e você não tenha modificado o nome do aquivo.
java -jar jboss-eap-7.x.x-installer.jar auto.xml
Checking for corresponding .variables fileVariables file detected: auto.xml.variables[ Starting automated installation ]...
Alternativamente, você pode especificar o caminho para o arquivo de variáveisusando -variablefile:
java -jar jboss-eap-7.x.x-installer.jar auto.xml -variablefile auto.xml.variables
Instalação Automatizada Autônoma do Instalador Usando o Argumento -variables
1. Execute o instalador usando o arquivo XML do script de instalação automática eespecifique as senhas necessárias como os pares chave/valor usando o argumento -variables. Por exemplo:
java -jar jboss-eap-7.x.x-installer.jar auto.xml -variables adminPassword=password#2,vault.keystorepwd=vaultkeystorepw,ssl.password=user12345
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação
28
NOTA
É importante que você não coloque espaço ao especificar os paresvalor/chave do argumento -variables.
CAPÍTULO 3. INSTALANDO O JBOSS EAP
29
CAPÍTULO 4. CONFIGURANDO O JBOSS EAP PARA SEREXECUTADO COMO UM SERVIÇO
4.1. CONFIGURANDO O JBOSS EAP COMO UM SERVIÇO NORED HAT ENTERPRISE LINUX (INSTALAÇÕES ZIP E DOINSTALADOR)
Pré-requisitos
Instale o JBoss EAP como uma instalação ZIP ou do Instalador.
Privilégios de administrador no servidor.
Configurando o JBoss EAP como um Serviço no Red Hat Enterprise Linux
1. Personalize as opções de inicialização no arquivo jboss-eap.conf.O script de inicialização e o arquivo de configuração associado a ele estãolocalizados no diretório EAP_HOME/bin/init.d/. Abra jboss-eap.conf em um editorde texto e defina as opções para a sua instalação do JBoss EAP.
Há várias opções no arquivo jboss-eap.conf e você deve fornecer pelo menos osvalores corretos para o JBOSS_HOME e o JBOSS_USER.
You can customize the other options provided in the configuration file byuncommenting and editing the respective lines. If you do not, the service willdefault to starting a standalone JBoss EAP server using the default configuration file, standalone.xml.
NOTA
If you want the service to start JBoss EAP as a managed domain, add JBOSS_MODE=domain to jboss-eap.conf.
To specify custom domain configuration files, add JBOSS_DOMAIN_CONFIG=DOMAIN_CONFIG_FILE.xml and JBOSS_HOST_CONFIG=HOST_CONFIG_FILE.xml. By default, JBoss EAPuses domain.xml and host.xml as the domain configuration files.
2. Copie os arquivos de serviço nos diretórios do sistema.
a. Copie o arquivo de configuração do serviço modificado ao diretório /etc/default.
sudo cp EAP_HOME/bin/init.d/jboss-eap.conf /etc/default
b. Copie o script de inicialização do serviço no diretório /etc/init.d e dê a elepermissões para execução:
sudo cp EAP_HOME/bin/init.d/jboss-eap-rhel.sh /etc/init.dsudo chmod +x /etc/init.d/jboss-eap-rhel.sh
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação
30
3. Adicione o novo serviço jboss-eap-rhel.sh à lista dos serviços iniciadosautomaticamente, usando o comando de gerenciamento do serviço chkconfig.
sudo chkconfig --add jboss-eap-rhel.sh
4. Verifique se o serviço foi instalado corretamente usando um dos seguintescomandos:
a. Para o Red Hat Enterprise Linux 6:
sudo service jboss-eap-rhel.sh start
b. Para o Red Hat Enterprise Linux 7:
sudo service jboss-eap-rhel start
O serviço será iniciado. Caso você obtenha um erro, verifique os logs de erro ecertifique-se de que as opções no arquivo de configuração estejam definidascorretamente.
5. Para que o serviço seja iniciado automaticamente ao iniciar o servidor do Red HatEnterprise Linux, execute o seguinte comando:
sudo chkconfig jboss-eap-rhel.sh on
Caso deseje remover o serviço do JBoss EAP, use o procedimento a seguir:
Removendo o Serviço do JBoss EAP no Red Hat Enterprise Linux
1. Caso o serviço esteja em execução, abra um terminal e interrompa o serviço comum dos seguintes comandos:
a. Para o Red Hat Enterprise Linux 6:
sudo service jboss-eap-rhel.sh stop
b. Para o Red Hat Enterprise Linux 7:
sudo service jboss-eap-rhel stop
2. Remova o JBoss EAP da lista de serviços:
sudo chkconfig --del jboss-eap-rhel.sh
3. Exclua o arquivo de configuração do serviço e o script de inicialização:
sudo rm /etc/init.d/jboss-eap-rhel.shsudo rm /etc/default/jboss-eap.conf
4.2. CONFIGURANDO O JBOSS EAP COMO UM SERVIÇO NORED HAT ENTERPRISE LINUX (INSTALAÇÃO RPM)
CAPÍTULO 4. CONFIGURANDO O JBOSS EAP PARA SER EXECUTADO COMO UM SERVIÇO
31
Pré-requisitos
Instale o JBoss EAP como uma instalação RPM.
Privilégios de administrador no servidor.
An RPM installation of JBoss EAP installs everything that is required to run JBoss EAP as aservice. Use one of the following commands to activate the JBoss EAP service to startautomatically at system boot.
For the commands below, replace EAP_SERVICE_NAME with either eap7-standalone for astandalone JBoss EAP server, or eap7-domain for a managed domain.
Para o Red Hat Enterprise Linux 6:
chkconfig EAP_SERVICE_NAME on
Para o Red Hat Enterprise Linux 7:
systemctl enable EAP_SERVICE_NAME.service
To start or stop an RPM installation of JBoss EAP on demand, see the RPM instructions in theJBoss EAP Configuration Guide.
NOTA
See the RPM service configuration files appendix in the JBoss EAPConfiguration Guide for further details and options.
4.3. CONFIGURANDO O JBOSS EAP COMO UM SERVIÇO NOMICROSOFT WINDOWS SERVER
Pré-requisitos
Instale o JBoss EAP como uma instalação ZIP ou do Instalador.
Privilégios de administrador no servidor.
A variável de ambiente do sistema JAVA_HOME deve ser definida.
A instância do servidor do JBoss EAP não deve estar em execução.
IMPORTANTE
O uso do comando set para a definição das variáveis de ambiente do sistemaem um prompt de comando do Windows Server não definirápermanentemente a variável de ambiente. Você deve usar o comando setx oua interface do Sistema no Painel de Controle.
Configurando o JBoss EAP como um Serviço no Microsoft Windows Server
1. Crie duas variáveis de ambiente do sistema:
JBOSS_HOME apontando para o diretório de instalação do JBoss EAP.
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação
32
NOPAUSE=1
2. Instale o Pacote Jsvc no JBoss Core ServicesCaso não esteja configurado ainda, baixe e extraia o pacote Jsvc do JBoss CoreServices.
a. Open a browser and log in to the Red Hat Customer Portal JBoss SoftwareDownloads page.
b. Select Apache Jsvc in the Product drop-down menu.
c. Selecione a versão mais recente no menu suspenso Versão.
d. Find Red Hat JBoss Core Services Apache Jsvc in the list, ensuring that youselect the correct platform and architecture for your system, and click theDownload link.
e. Extraia o arquivo ZIP baixado no diretório contendo o seu diretório de instalaçãodo JBoss EAP.Isto resultará em um diretório jbcs-jsvc-<VERSION> com a mesmaprofundidade que o seu diretório de instalação do JBoss EAP. Por exemplo:
C:\Program Files├── jboss-eap-7.0│ ├── bin│ └── ...└── jbcs-jsvc-<VERSION>
3. Instale o ServiçoAbra um terminal e mude os diretórios para EAP_HOME\bin.
Seguem abaixo exemplos de um comando básico service.bat install para acriação de um novo serviço tanto para um servidor autônomo como para umservidor em um domínio gerenciado. Para uma lista de todas as opções possíveis,execute service.bat, sem argumento algum.
Execute o comando a seguir, ajustando o nível de log para o serviço comonecessário:
a. Para um servidor autônomo:
service.bat install /loglevel INFO
b. Para um servidor em domínio gerenciado:Use the /host parameter to specify the name of the JBoss EAP host controllerbeing controlled by the service. You can see valid values for the name byexecuting ls /host in the management CLI.
Replace EAP_HOST_NAME in the command below with your JBoss EAP hostcontroller name. If you specify the /host parameter without providing a JBossEAP host controller name, the name defaults to master.
service.bat install /host EAP_HOST_NAME /loglevel INFO
Um novo serviço do Windows será criado com o nome JBossEAP7.
CAPÍTULO 4. CONFIGURANDO O JBOSS EAP PARA SER EXECUTADO COMO UM SERVIÇO
33
4. Verifique o novo serviço no console de ServiçosAbra o console do Windows Services (services.msc) e verifique se o serviço foicriado.
Caso o nome do serviço padrão tenha sido usado, o novo serviço terá o nome deexibição na lista de serviços do Windows como: JBossEAP7. A partir do console deServiços, é possível iniciar e interromper o serviço, assim como alterar as suasconfigurações de como e quando ele deve ser iniciado.
5. Iniciando e Interrompendo o Serviço do JBoss EAP a partir de um TerminalPara iniciar o serviço a partir de um terminal, use o seguinte comando, alterando onome do serviço caso necessário:
net start JBossEAP7
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 stop JBossEAP7
Caso deseje remover o serviço do JBoss EAP, use o procedimento a seguir:
Removendo o Serviço do JBoss EAP no Microsoft Windows Server
1. Caso o serviço esteja em execução, primeiro abra um terminal e interrompa oserviço executando o comando net stop com o nome do serviço:
net stop JBossEAP7
2. Em um terminal, mude os diretórios para EAP_HOME\bin e execute o seguintecomando:
service.bat uninstall
4.4. CONFIGURANDO O JBOSS EAP COMO UM SERVIÇOUSANDO JSVCThe Apache Jsvc component of the JBoss Core Services collection can be used to run JBossEAP as a background service on Red Hat Enterprise Linux and Solaris.
NOTA
No Red Hat Enterprise Linux, recomendamos que você use native methodspara executar o JBoss EAP como um serviço.
O Jsvc é um conjunto de bibliotecas e aplicativos que permite a execução de aplicativosJava em plataformas do tipo UNIX como um serviço em segundo plano. Isto permite que osaplicativos executem operações como um usuário privilegiado e, depois, troquem aidentidade para um usuário não privilegiado.
O Jsvc usa três processos: um processo inicializador, um processo controlador e umprocesso controlado. O processo controlado também é o thread principal do Java. Se o JVMfalha, o processo controlador reinicia-o dentro de 60 segundos. O Jsvc é um processo
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação
34
daemon e, para o JBoss EAP, ele deve ser iniciado por um usuário privilegiado.
Instale o Pacote Jsvc no JBoss Core Services
Para as instalações ZIP ou do instalador:
1. Open a browser and log in to the Red Hat Customer Portal JBoss SoftwareDownloads page.
2. Select Apache Jsvc in the Product drop-down menu.
3. Selecione a versão mais recente no menu suspenso Versão.
4. Find Red Hat JBoss Core Services Apache Jsvc in the list, ensuring that youselect the correct platform and architecture for your system, and click theDownload link.
5. Extraia o arquivo ZIP baixado no diretório contendo o seu diretório de instalação doJBoss EAP.Isto resultará em um diretório jbcs-jsvc-<VERSION> com a mesma profundidadeque o seu diretório de instalação do JBoss EAP. Por exemplo:
/var/opt/├── jboss-eap-7.0│ ├── bin│ └── ...└── jbcs-jsvc-<VERSION>
6. The command examples for using Jsvc to start JBoss EAP assume that a jboss userhas been created. If you have not already created a user for JBoss EAP, run thefollowing commands to create the jboss user and group:
# groupadd -f -g 185 -r jboss# useradd -r -u 185 -g jboss -d EAP_HOME -s /sbin/nologin -c "JBoss" jboss
Para as instalações RPM no Red Hat Enterprise Linux:
1. Faça o login no Red Hat Subscription Manager.
2. Clique em Sistemas no Inventário do Assinante.
3. Subscreva-se para os repositórios CDN do JBoss Core Services para a arquitetura eversão do seu sistema operacional:
a. Para o Red Hat Enterprise Linux 6:
jb-coreservices-1-for-rhel-6-server-rpms
b. Para o Red Hat Enterprise Linux 7:
jb-coreservices-1-for-rhel-7-server-rpms
4. Execute o seguinte comando, como usuário root, para instalar o Jsvc:
# yum groupinstall jbcs-jsvc
CAPÍTULO 4. CONFIGURANDO O JBOSS EAP PARA SER EXECUTADO COMO UM SERVIÇO
35
NOTA
Be sure to set the JAVA_HOME system environment variable.
Usando o Jsvc para Iniciar o JBoss EAP como um Servidor AutônomoOs comandos a seguir são usados para iniciar e interromper o JBoss EAP em um modoautônomo usando o Jsvc. As tabelas abaixo apresentam os caminhos necessários para oscomandos para uma instalação ZIP/do instalador do JBoss EAP ou uma instalação RPM.
Tabela 4.1. Localizações do Arquivo Jsvc para Instalações ZIP/do instalador -Servidor Autônomo
Referência de Arquivo emInstruções
Localização do Arquivo
JSVC_BIN EAP_HOME/../jbcs-jsvc-<VERSION>/sbin/jsvc
JSVC_JAR EAP_HOME/../jbcs-jsvc-<VERSION>/lib/commons-daemon.jar
CONF_DIR EAP_HOME/standalone/configuration
LOG_DIR EAP_HOME/standalone/log
Tabela 4.2. Localizações do Arquivo Jsvc para Instalações RPM - ServidorAutônomo
Referência de Arquivo emInstruções
Localização do Arquivo
JSVC_BIN /usr/bin/jbcs-jsvc/jsvc
JSVC_JAR /usr/bin/jbcs-jsvc/commons-daemon.jar
CONF_DIR /opt/rh/eap7/root/usr/share/wildfly/standalone/configuration
LOG_DIR /opt/rh/eap7/root/usr/share/wildfly/standalone/log
Inicie um servidor autônomo do JBoss EAP usando o Jsvc:
JSVC_BIN \ -outfile LOG_DIR/jsvc.out.log \ -errfile LOG_DIR/jsvc.err.log \ -pidfile LOG_DIR/jsvc.pid \ -user jboss \ -D[Standalone] -XX:+UseCompressedOops -Xms1303m \ -Xmx1303m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação
36
-Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true \ -Dorg.jboss.boot.log.file=LOG_DIR/server.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -cp EAP_HOME/jboss-modules.jar:JSVC_JAR \ -Djboss.home.dir=EAP_HOME \ -Djboss.server.base.dir=EAP_HOME/standalone \ @org.jboss.modules.Main -start-method main \ -mp EAP_HOME/modules \ -jaxpmodule javax.xml.jaxp-provider \ org.jboss.as.standalone
Interrompa um servidor autônomo do JBoss EAP usando o Jsvc:
JSVC_BIN \ -stop \ -outfile LOG_DIR/jsvc.out.log \ -errfile LOG_DIR/jsvc.err.log \ -pidfile LOG_DIR/jsvc.pid \ -user jboss \ -D[Standalone] -XX:+UseCompressedOops -Xms1303m \ -Xmx1303m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true \ -Dorg.jboss.boot.log.file=LOG_DIR/server.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -cp EAP_HOME/jboss-modules.jar:JSVC_JAR \ -Djboss.home.dir=EAP_HOME \ -Djboss.server.base.dir=EAP_HOME/standalone \ @org.jboss.modules.Main -start-method main \ -mp EAP_HOME/modules \ -jaxpmodule javax.xml.jaxp-provider \ org.jboss.as.standalone
Usando o Jscv para Iniciar o JBoss EAP como um Domínio GerenciadoOs comandos a seguir são usados para iniciar e interromper o JBoss EAP em um domíniogerenciado usando o Jsvc. As tabelas abaixo apresentam os caminhos necessários para oscomandos para uma instalação ZIP/do instalador do JBoss EAP ou uma instalação RPM.
Tabela 4.3. Localizações do Arquivo Jsvc para Instalações ZIP/do instalador -Domínio Gerenciado
Referência de Arquivo emInstruções
Localização do Arquivo
JSVC_BIN EAP_HOME/../jbcs-jsvc-<VERSION>/sbin/jsvc
JSVC_JAR EAP_HOME/../jbcs-jsvc-<VERSION>/lib/commons-daemon.jar
CAPÍTULO 4. CONFIGURANDO O JBOSS EAP PARA SER EXECUTADO COMO UM SERVIÇO
37
CONF_DIR EAP_HOME/domain/configuration
LOG_DIR EAP_HOME/domain/log
Referência de Arquivo emInstruções
Localização do Arquivo
Tabela 4.4. Localizações do Arquivo Jsvc para Instalações RPM - DomínioGerenciado
Referência de Arquivo emInstruções
Localização do Arquivo
JSVC_BIN /usr/bin/jbcs-jsvc/jsvc
JSVC_JAR /usr/bin/jbcs-jsvc/commons-daemon.jar
CONF_DIR /opt/rh/eap7/root/usr/share/wildfly/domain/configuration
LOG_DIR /opt/rh/eap7/root/usr/share/wildfly/domain/log
Before you issue the following command, be sure to set the JAVA_HOME system environmentvariable.
Inicie o JBoss EAP em um domínio gerenciado usando o Jsvc:
JSVC_BIN \ -outfile LOG_DIR/jsvc.out.log \ -errfile LOG_DIR/jsvc.err.log \ -pidfile LOG_DIR/jsvc.pid \ -user jboss \ -nodetach -D"[Process Controller]" -server -Xms64m \ -Xmx512m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true \ -Dorg.jboss.boot.log.file=LOG_DIR/process-controller.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -cp "EAP_HOME/jboss-modules.jar:JSVC_JAR" \ org.apache.commons.daemon.support.DaemonWrapper \ -start org.jboss.modules.Main -start-method main \ -mp EAP_HOME/modules org.jboss.as.process-controller \ -jboss-home EAP_HOME -jvm "${JAVA_HOME}"/bin/java \ -mp EAP_HOME/modules -- \ -Dorg.jboss.boot.log.file=LOG_DIR/host-controller.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -server -Xms64m -Xmx512m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação
38
-Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true -- -default-jvm "${JAVA_HOME}"/bin/java \&
Interrompa o JBoss EAP em um domínio gerenciado usando o Jsvc:
JSVC_BIN \ -stop \ -outfile LOG_DIR/jsvc.out.log \ -errfile LOG_DIR/jsvc.err.log \ -pidfile LOG_DIR/jsvc.pid \ -user jboss \ -nodetach -D"[Process Controller]" -server -Xms64m \ -Xmx512m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true \ -Dorg.jboss.boot.log.file=LOG_DIR/process-controller.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -cp "EAP_HOME/jboss-modules.jar:JSVC_JAR" \ org.apache.commons.daemon.support.DaemonWrapper \ -start org.jboss.modules.Main -start-method main \ -mp EAP_HOME/modules org.jboss.as.process-controller \ -jboss-home EAP_HOME -jvm $JAVA_HOME/bin/java \ -mp EAP_HOME/modules -- \ -Dorg.jboss.boot.log.file=LOG_DIR/host-controller.log \ -Dlogging.configuration=file:CONF_DIR/logging.properties \ -Djboss.modules.policy-permissions \ -server -Xms64m -Xmx512m -XX:MaxPermSize=256m \ -Djava.net.preferIPv4Stack=true \ -Djboss.modules.system.pkgs=org.jboss.byteman \ -Djava.awt.headless=true -- -default-jvm $JAVA_HOME/bin/java
CAPÍTULO 4. CONFIGURANDO O JBOSS EAP PARA SER EXECUTADO COMO UM SERVIÇO
39
CAPÍTULO 5. DESINSTALANDO O JBOSS EAP
5.1. DESINTALANDO O JBOSS EAP (INSTALAÇÃO ZIP)1. Certifique-se de realizar o backup de todos os arquivos de configuração modificados
e de implantações que podem ter sido reutilizadas.
2. O método de instalação ZIP instala o JBoss EAP em um único diretório. Exclua odiretório de instalação para desinstalar o JBoss EAP.
3. Exclua também todos os outros scripts que dependiam do JBoss EAP ser instalado nasua máquina.
5.2. DESINSTALANDO O JBOSS EAP (INSTALAÇÃO DOINSTALADOR)Caso você tenha instalado o JBoss EAP usando o instalador, você pode desinstalá-lo usandoo desinstalador no modo gráfico ou de texto.
Executando o Desinstalador Gráfico do JBoss EAP
1. Abra um terminal e navegue até o EAP_HOME/Uninstaller.
2. Execute o desinstalador gráfico usando o seguinte comando:
java -jar uninstaller.jar
O desinstalador gráfico é semelhante à figura a seguir. Selecione a caixa de seleçãocaso deseje excluir o diretório de instalação do JBoss EAP.
Figura 5.1. Desinstalador Gráfico do JBoss EAP
3. Clique em Desinstalar para iniciar o processo de desinstalação.
4. Quando o processo de desinstalação estiver concluído, clique em Encerrar para sairdo desinstalador.
Executando o Desinstalador Baseado em Texto do JBoss EAP
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação
40
1. Abra um terminal e navegue até o EAP_HOME/Uninstaller.
2. Execute o desinstalador baseado em texto usando o seguinte comando:
java -jar uninstaller.jar -console
3. Siga os seguintes prompts para desinstalar o JBoss EAP.
5.3. DESINSTALANDO O JBOSS EAP (INSTALAÇÃO RPM)
ATENÇÃO
A desinstalação de uma instalação do JBoss EAP feita com o método RPMnão é recomendável.
Because of the nature of RPM package management, it cannot beguaranteed that all installed packages and dependencies will becompletely removed, or that the system will not be left in an inconsistentstate caused by missing package dependencies.
Revised on 2018-01-05 08:50:37 EST
CAPÍTULO 5. DESINSTALANDO O JBOSS EAP
41