Capítulo 3. Instalando o JBoss EAP

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.

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

   Nota

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

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.

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

   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

   ou

   java -jar -d64 jboss-eap-7.x.x-installer.jar

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

   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 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.
   	Figura 3.1. Instalador do JBoss EAP - Tela de Seleção de Componentes
   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.
   	Figura 3.2. Instalador do JBoss EAP - Configure a Tela do Ambiente de Tempo de Execução
   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.
   	Figura 3.3. Instalador do JBoss EAP - Configure a Tela do Cofre de Senhas
   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.
   	Figura 3.4. Instalador do JBoss EAP - Tela de Configuração LDAP
   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.
   	Figura 3.5. Instalador do JBoss EAP - Tela de Configuração LDAP do Realm de Segurança
   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.
   	Figura 3.6. Instalador do JBoss EAP - Tela de Configuração Infinispan
   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.
   	Figura 3.7. Instalador do JBoss EAP - Tela de Configuração do Domínio de Segurança
   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.
   	Figura 3.8. Instalador do JBoss EAP - Tela de Configuração JSSE
   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.
   	Figura 3.9. Instalador do JBoss EAP - Tela de Configuração do 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.
   	Figura 3.10. Instalador do JBoss EAP - Tela de Associações de Soquete
   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.
   	Figura 3.11. Instalador do JBoss EAP - Associações de Soquete Personalizadas para a Tela de Configurações Autônomas
   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.
   	Figura 3.12. Instalador do JBoss EAP - Associações de Soquete Personalizadas para a Tela de Configurações de Domínio
   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.
   	Figura 3.13. Instalador do JBoss EAP - Tela de Configuração do Driver JDBC
   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.
   	Figura 3.14. Instalador do JBoss EAP - Tela de Configuração da Fonte de Dados
   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

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.

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

   yum groupinstall jboss-eap7

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

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

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

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 ]
   ...

   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

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

   Nota

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