Red Hat Summit Red Hat SummitSuporteConsoleDesenvolvedoresComeçar um testeContato

Capítulo 3. Instalando o JBoss EAP

3.1. Instalação Zip
Copiar o link

3.1.1. Baixando o JBoss EAP (Instalação ZIP)
Copiar o link

Pré-requisitos

O arquivo ZIP do JBoss EAP está disponível no Portal do Consumidor Red Hat. A instalação do 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 em https://access.redhat.com.
  2. Clique em Downloads.
  3. Clique em Red Hat JBoss Enterprise Application Platform na lista Downloads de 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 clique no link Download.

3.1.2. Instalando o JBoss EAP (Instalação ZIP)
Copiar o link

Depois que o arquivo ZIP de instalação do JBoss EAP for baixado, ele pode ser instalado extraindo os conteúdos do pacote.

  1. Se necessário, mova o arquivo ZIP para o servidor e o local onde o JBoss EAP deve ser instalado.

    • O usuário que executará o JBoss EAP deve ter acesso de leitura e gravação para este diretório.

  2. Extraia o arquivo ZIP. 

    $ unzip jboss-eap-7.x.x.zip
    Copy to Clipboard Toggle word wrap
    Nota

    Para o Windows Server, clique com o botão direito do mouse no arquivo ZIP e selecione Extrair Todos.

O diretório criado extraindo o arquivo ZIP é o diretório de nível superior para a instalação do JBoss EAP. Ele é referido como EAP_HOME.

3.2. Instalação do Instalador
Copiar o link

3.2.1. Baixando o JBoss EAP (Instalação do Instalador)
Copiar o link

Pré-requisitos

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. O instalador é a maneira preferencial de instalar o JBoss EAP em todas as plataformas com suporte.

Baixando o Instalador do JBoss EAP

  1. Abra um navegador e faça o login no Portal do Consumidor Red Hat em https://access.redhat.com.
  2. Clique em Downloads.
  3. Clique em Red Hat JBoss Enterprise Application na lista Downloads de 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 7.x.x Installer na lista e clique no link Download.

3.2.2. Executando o Instalador do JBoss EAP
Copiar o link

Você 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 do JBoss EAP baixado.

  2. Execute o instalador gráfico usando o seguinte comando: 

    java -jar jboss-eap-7.x.x-installer.jar
    Copy to Clipboard Toggle word wrap
    Nota

    No HP-Ux da Hewlett-Packard ou em ambientes Solaris, você pode especificar 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
    Copy to Clipboard Toggle word wrap

    ou 

    java -jar -d64 jboss-eap-7.x.x-installer.jar
    Copy to Clipboard Toggle word wrap

  3. Siga as instruções da tabela abaixo:

    Expand
    Tabela 3.1. Telas do Instalador do JBoss EAP
    Nome da TelaQuando apareceDescrição

    Seleção de Idioma

    Sempre

    Selecione o idioma desejado para o instalador e clique em OK.

    Contrato de Licença

    Sempre

    O EULA (Contrato de Licença de Usuário Final) para o RED HAT JBOSS MIDDLEWARE.

    Selecione "Aceito os termos deste contrato de licença" e clique em Próximo.

    Caminho de Instalação

    Sempre

    Selecione o caminho de instalação para o JBoss EAP e clique em Próximo.

    Seleção de Componentes

    Sempre

    Selecione os componentes para instalar. Os componentes necessários estão desabilitados para o cancelamento de seleção.

    Criação do Usuário Admin

    Sempre

    Crie um usuário administrativo e especifique uma senha. Depois, clique em Próximo.

    Visão Geral da Instalação

    Sempre

    Revise as suas opções de instalação e depois clique em Próximo.

    Instalação de Componentes

    Sempre

    Quando o progresso da instalação estiver completo, clique em Próximo.

    Configure o Ambiente de Tempo de Execução

    Sempre

    Você pode selecionar uma configuração padrão para a sua instalação do JBoss EAP ou optar por desempenhar uma configuração avançada com o instalador. Observe que, mesmo que você escolha uma configuração padrão, você ainda pode alterar depois a sua configuração usando as interfaces de gerenciamento do JBoss EAP.

    Selecione Desempenhar configuração padrão ou selecione Desempenhar configuração avançada e selecione os itens a serem configurados e, depois, clique em Próximo.

    Configure o Cofre de Senhas

    Caso opte por instalar um cofre de senhas em uma configuração avançada do ambiente do tempo de execução.

    Configure a password vault to store all your sensitive passwords in an encrypted keystore, then click Next. For more information, see the password vault documentation in the How To Configure Server Security guide.

    Segurança SSL

    Caso você decida habilitar a Segurança SSL na configuração avançada do ambiente do tempo de execução.

    Specify an SSL keystore and the keystore password for securing the JBoss EAP management interfaces, then click Next. For more information, see the documentation on securing the management interfaces in the How To Configure Server Security guide.

    Atenção

    Red Hat recommends that SSLv2, SSLv3, and TLSv1.0 be explicitly disabled in favor of TLSv1.1 or TLSv1.2 in all affected packages.

    Configuração LDAP

    Caso você decida habilitar a autenticação LDAP na configuração avançada do ambiente do tempo de execução.

    Enable LDAP authentication to use an LDAP directory server as the authentication source for the management console, management CLI, and management API. When you are done, click Next. For more information, see the LDAP documentation in the How to Configure Identity Management guide.

    Configuração LDAP do Realm de Segurança

    Caso você decida habilitar a autenticação LDAP na configuração avançada do ambiente do tempo de execução.

    Um novo realm de segurança será criado e associado às interfaces de gerenciamento, usando a conexão LDAP definida na etapa anterior.

    Specify the values for your LDAP environment, then click Next. For more information, see the LDAP documentation in the How to Configure Identity Management guide.

    Configuração Infinispan

    Caso opte por instalar um cache Infinispan na configuração avançada do ambiente do tempo de execução.

    Create an Infinispan cache for managing cached data. Give an Infinispan name and configure the other fields, then click Next. For more information, see the Infinispan documentation in the Configuration Guide.

    Configuração do Domínio de Segurança

    Caso opte por adicionar um domínio de segurança na configuração avançada do ambiente do tempo de execução.

    Configure a security domain for the JBoss EAP server instance. Most of the fields are already populated with default values and do not need modification. When you are done, click Next. For more information, see Security Domains in the Security Architecture Guide.

    Configuração JSSE

    Caso opte por adicionar um domínio de segurança na configuração avançada do ambiente do tempo de execução.

    Configure o JSSE (Extensão de Soquete Seguro para Java) para o domínio de segurança definido na etapa anterior, usando um armazenamento de chave ou um armazenamento de confiança. Quando você concluir, clique em Próximo.

    Inícios Rápidos

    Caso opte por instalar inícios rápidos na configuração avançada do ambiente do tempo de execução.

    Selecione o caminho de instalação do início rápido e clique em Próximo.

    Configuração do Repositório do Maven

    Caso opte por instalar inícios rápidos na configuração avançada do ambiente do tempo de execução.

    Selecione o seu arquivo de configurações e o repositório do Maven.

    Associações de Soquete

    Caso opte por configurar as associações de porta do servidor na configuração avançada do ambiente do tempo de execução.

    Determine se a instalação usará ou não as associações de porta padrão, configure os deslocamentos de porta para todas as associações padrão ou configure as associações de porta personalizadas.

    Caso opte por configurar os deslocamentos de porta, selecione o número de deslocamento.

    Caso opte por configurar as associações personalizadas, selecione se deseja configurar as portas para o modo autônomo, o modo de domínio ou ambos.

    Se o host estiver configurado para IPv6 apenas, selecione a caixa de verificação Habilitar a configuração IPv6 pura e o instalador aplicará as alterações de configuração necessárias.

    Clique em Próximo.

    Associações de Soquete Personalizadas para Configurações Autônomas

    Caso opte por configurar as associações de porta personalizadas para o modo autônomo.

    Configure as portas e as propriedades do sistema para cada configuração autônoma (standalone, standalone ha, standalone full, standalone full-ha) e clique em Próximo.

    Associações de Soquete Personalizadas para Configurações de Domínio

    Caso opte por configurar as associações de porta personalizadas para o modo de domínio.

    Configure as portas e as propriedades do sistema 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 em Próximo.

    Opções de Registro em Log

    Caso opte por configurar os níveis de registro em log na configuração avançada do ambiente do tempo de execução.

    Selecione os níveis de registro em log desejados e clique em Próximo.

    Configuração do Driver JDBC

    Caso opte por instalar um driver JDBC na configuração avançada do ambiente do tempo de execução.

    Install and setup a JDBC driver. Choose the appropriate driver vendor from the drop down list and specify the driver JAR location(s). When you are done, click Next. For more information, see the datasource JDBC driver section in the Configuration Guide.

    Configuração da Fonte de Dados

    Caso opte por instalar um driver JDBC e uma fonte de dados na configuração avançada do ambiente do tempo de execução.

    Configure a datasource which can be used by applications. Provide a datasource name and configure the other options, then click Next. For more information, see the details of datasource management in the Configuration Guide.

    Configure o Servidor

    Sempre

    Quando o progresso de configuração estiver completo, clique em Próximo.

    Configuração de Atalhos

    Sempre

    Selecione a caixa de verificação Criar Atalhos no Menu Iniciar para criar atalhos. São permitidos somente caracteres alfanuméricos e os caracteres 'traço' (-) e 'sublinhado' (_). No Microsoft Windows, os caracteres 'barra' (/) e 'barra invertida' (\) também são permitidos. Clique em Próximo.

    Instalação Concluída

    Sempre

    Clique em Gerar script de instalação e arquivo de propriedades, caso deseje capturar as opções de instalação selecionadas para uma instalação automatizada futura, e clique em Concluído.

    A instalação está completa agora. O diretório criado pelo instalador é o diretório de nível superior para o servidor. Isto é referido como EAP_HOME.

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 JBoss EAP baixado.

  2. Execute o instalador baseado em texto usando o seguinte comando: 

    java -jar jboss-eap-7.x.x-installer.jar -console
    Copy to Clipboard Toggle word wrap
  3. Siga os prompts para instalar o JBoss EAP. O diretório criado pelo instalador é o diretório de nível superior para o servidor. Isto é referido como EAP_HOME.

3.3. Instalação RPM
Copiar o link

Nota

For users wanting to manage JBoss EAP installations using Red Hat Satellite: although Red Hat Satellite 6 is recommended for managing JBoss EAP 7 installations, the following Red Hat Network (RHN) channels are also provided specifically 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 a Repository.

Nota

From Red Hat Enterprise Linux 7, the term channel was replaced with the term repository. In these instructions only the term repository is used.

3.3.1. Escolhendo um Repositório
Copiar o link

A Instalação do JBoss EAP via RPM requer subscrição para ambos, o repositório do software base 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ão atual ou para um repositório com versões de manutenção do JBoss EAP.

Repositório com a Versão Atual do JBoss EAP

O repositório com a versão atual fornece o último lançamento do JBoss EAP 7. Ao atualizar a sua instalação do JBoss EAP, você receberá todas as atualizações para o JBoss EAP 7, incluindo upgrades secundários.

Por exemplo, a atualização deste repositório incluirá upgrades do JBoss EAP 7 ao JBoss EAP 7.1, caso seja lançado.

Repositório com Versões de Manutenção do JBoss EAP

Um repositório com versões de manutenção fornece um lançamento de manutenção especí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, ao mesmo 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 de segurança para a versão de manutenção do JBoss EAP, mas não incluirá upgrades do JBoss EAP 7.0 ao JBoss EAP 7.1, caso seja lançado.

Nota

For production environments, we recommend that you use the minor JBoss EAP repository. This reduces the risk of unexpected changes in subsystem modules or necessary configuration changes caused by unexpected JBoss EAP upgrades. You can always change repositories at a later date if you want to receive an upgrade.

3.3.1.1. Subscrevendo-se ao Repositório com a Versão Atual do JBoss EAP 7
Copiar o link

  1. Ensure that your Red Hat Enterprise Linux system is registered to your account using Red Hat Subscription Manager. For more information, see the Red Hat Subscription Management documentation.

  2. Ao acessar o Red Hat Subscription Manager, subscreva-se para o repositório com a versão 'atual' do JBoss EAP 7 usando o comando a seguir. Substitua RHEL_VERSION por 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
    Copy to Clipboard Toggle word wrap
  1. Ensure that your Red Hat Enterprise Linux system is registered to your account using Red Hat Subscription Manager. For more information, see the Red Hat Subscription Management documentation.

  2. Ao acessar o Red Hat Subscription Manager, subscreva-se para um repositório com as versões de manutenção do JBoss EAP 7 usando o comando a seguir. Certifique-se de que:

    • Voê substitua EAP_MINOR_VERSION por sua versão de manutenção desejada do JBoss 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 Hat Enterprise Linux. 
    subscription-manager repos --enable=jb-eap-EAP_MINOR_VERSION-for-rhel-RHEL_VERSION-server-rpms
    Copy to Clipboard Toggle word wrap

3.3.2. Instalando o JBoss EAP (Instalação RPM)
Copiar o link

Pré-requisitos

  1. Instale o JBoss EAP a partir do seu repositório subscrito usando o seguinte comando: 

    yum groupinstall jboss-eap7
    Copy to Clipboard Toggle word wrap

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órios
Copiar o link

Durante o tempo de vida de uma instalação do JBoss EAP, você pode querer alterar a subscrição do software de um repositório do JBoss EAP para outro. A alteração de repositó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ões de manutenção
Com suporte, se alterando para o repositório com as versões de manutenção mais recentes.
Alterando de um repositório com versões de manutenção para outro repositório com versões de manutenção
Com suporte, se alterando para a próxima versão de manutenção do JBoss EAP. Por exemplo, a alteração do JBoss EAP 7.0 para o JBoss EAP 7.1 possui suporte, mas a alteraçã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 com a versão 'atual'
Com suporte, se alterando do repositório com versões de manutenção mais recentes.

Pré-requisitos

Alterando o Repositório do JBoss EAP

  1. Antes de alterar o repositório, certifique-se de que a instalação do JBoss EAP tenha todas as atualizações aplicáveis: 

    yum update
    Copy to Clipboard Toggle word wrap

  2. Ao acessar o Red Hat Subscription Manager, cancele a subscrição do repositório existente e subscreva-se para o novo repositório, para o qual o você deseja fazer a alteração. No comando abaixo, substitua EXISTING_REPOSITORY e NEW_REPOSITORY pelos nomes dos respectivos repositórios. 

    subscription-manager repos --disable=EXISTING_REPOSITORY --enable=NEW_REPOSITORY
    Copy to Clipboard Toggle word wrap

3.4. Instalação Automatizada do Instalador
Copiar o link

Caso você utilize o instalador JAR para instalar o JBoss EAP, você pode usar um script de instalação gerado de uma instalação anterior para automatizar futuras instalações com a mesma 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 uma versão anterior do JBoss EAP com o instalador automatizado. Você deve usar somente os scripts gerados pela mesma versão de manutenção do JBoss 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 de instalaçã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 do JBoss EAP baixado.

  2. Execute o comando a seguir para instalar o JBoss EAP usando o arquivo XML do script de instalação automática: 

    java -jar jboss-eap-7.x.x-installer.jar auto.xml
    Copy to Clipboard Toggle word wrap

    Por padrão, o instalador solicitará que você insira as senhas necessárias para a configuração do JBoss EAP. Você pode aplicar uma instalação autônoma predefinindo as senhas para a instalação.

    Nota

    Você pode armazenar o arquivo XML do script de instalação automática em um host de rede e usar HTTP ou FTP para indicar ao instalador que ele deve ser usado em uma instalação. Por exemplo: 

    java -jar jboss-eap-7.x.x-installer.jar http://network-host.local/auto.xml
    Copy to Clipboard Toggle word wrap 
    java -jar jboss-eap-7.x.x-installer.jar ftp://network-host.local/auto.xml
    Copy to Clipboard Toggle word wrap

3.4.1. Instalação Automatizada Autônoma do Instalador
Copiar o link

Pré-requisitos

  • Use o Instalador JAR para gerar um script de instalação automática. O script de instalação automática é um arquivo XML.

Para realizar uma instalação automatizada autônoma do instalador, você deve predefinir as senhas 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 anterior do 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, mas com um sufixo .variables.

Este arquivo de variáveis contém uma lista dos parâmetros de senhas e chaves necessários para uma instalação automatizada autônoma.

Você pode fornecer as senhas necessárias como um arquivo de variáveis completo ou como um argumento quando estiver executando o comando do instalador.

Instalação Automatizada Autônoma do Instalador Usando um Arquivo de Variáveis

  1. Abra o arquivo .variables em um editor de texto e forneça um valor da senha para cada chave. Por exemplo: 

    adminPassword = password#2
vault.keystorepwd = vaultkeystorepw
ssl.password = user12345
    Copy to Clipboard Toggle word wrap

  2. Execute o instalador usando o arquivo XML do script de instalação automática. O instalador detecta o arquivo de variáveis automaticamente, caso o arquivo de variáveis completo esteja no mesmo diretório que o arquivo XML do script de instalaçã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 file
Variables file detected: auto.xml.variables
[ Starting automated installation ]
...
    Copy to Clipboard Toggle word wrap

    Alternativamente, você pode especificar o caminho para o arquivo de variáveis usando -variablefile: 

    java -jar jboss-eap-7.x.x-installer.jar auto.xml -variablefile auto.xml.variables
    Copy to Clipboard Toggle word wrap

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 e especifique 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
    Copy to Clipboard Toggle word wrap
    Nota

    É importante que você não coloque espaço ao especificar os pares valor/chave do argumento -variables.

Red Hat logoGithubredditYoutubeTwitter

Aprender

Experimente, compre e venda

Comunidades

Sobre a documentação da Red Hat

Ajudamos os usuários da Red Hat a inovar e atingir seus objetivos com nossos produtos e serviços com conteúdo em que podem confiar. Explore nossas atualizações recentes.

Tornando o open source mais inclusivo

A Red Hat está comprometida em substituir a linguagem problemática em nosso código, documentação e propriedades da web. Para mais detalhes veja o Blog da Red Hat.

Sobre a Red Hat

Fornecemos soluções robustas que facilitam o trabalho das empresas em plataformas e ambientes, desde o data center principal até a borda da rede.

Theme

© 2026 Red HatVoltar ao topo