+ All Categories
Home > Documents > Red Hat JBoss Enterprise Application Platform 7.0 Guia de ... · Guia de Instalação ... No...

Red Hat JBoss Enterprise Application Platform 7.0 Guia de ... · Guia de Instalação ... No...

Date post: 10-Feb-2019
Category:
Upload: hoangmien
View: 213 times
Download: 0 times
Share this document with a friend
45
Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação For Use with Red Hat JBoss Enterprise Application Platform 7.0 Last Updated: 2018-01-05
Transcript

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

Red Hat JBoss Enterprise Application Platform 7.0 Guia de Instalação

2

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


Recommended