Guia de Instalação
Para uso com o JBoss Enterprise Application Plataform 6
Resumo
Capítulo 1. Introdução
1.1. JBoss Enterprise Application Platform 6
1.2. Portal do Cliente da Red Hat
- Gerenciar e manter os contratos de suporte e direitos da Red Hat:
- Baixar o software oficialmente suportado:
- Acessar outra documentação de produto e conhecimento básico da Red Hat:
- Contato de Serviço de Suporte Global: e
- Submeter bugs em relação aos produtos da Red Hat.
Capítulo 2. Requisitos
2.1. Pré-requisitos da Instalação do JBoss Enterprise Application Plataform 6
Pré-requisitos Comuns
- Crie uma conta no Portal do Cliente da Red Hat no https://access.redhat.com. Refira-se à Seção 1.2, “Portal do Cliente da Red Hat” para maiores informações.
- Revise as configurações suportadas e garanta que seu sistema é suportável: https://access.redhat.com/site/articles/111663.
- Certifique-se de que seu sistema está atualizado com a errata e atualizações emitidas pela Red Hat.
ZIP/Pré-requisitos do Instalador
- Privilégios de administrador para o diretório de instalação.
- Garanta que o JDK escolhido tenha sido extraído (ou instalado). Refira-se à documentação JDK para maiores informações em como realizar isto.
- Certifique-se que o JAVA_HOME e PATH tenham sido determinados nas propriedades do Ambiente para os atalhos funcionarem nos servidores do Microsoft Windows.
Pré-requisitos RPM
- Registro do servidor no Red Hat Network.
- Subscreva o canal de software base do
Servidor do Red Hat Enterprise Linux Serverapropriado a sua versão do Red Hat Enterprise Linux. - Subscreva ao sub-canal
JBoss Application Plataform for Serverno grupoJBoss Enterprise Plataform. - O Java 6 JDK é requerido. Ele pode ser obtido pela subscrição ao canal do software
supplementarypara sua instalação do Red Hat Enterprise Linux. Por exemplo: o canal para o Red Hat Enterprise Linux de versão 6 instalado na arquitetura i386 érhel-i386-server-supplementary-6.Importante
O Java 6 JDK precisa ser instalado mesmo se você desejar usar um Java 7 JDK.
Capítulo 3. Instalação
3.1. Métodos de Instalação do JBoss Enterprise Application Plataform 6
Tabela 3.1. Métodos de Instalação
|
Método
|
Descrição
|
Instruções
|
|---|---|---|
|
Instalação Zip
|
O arquivo Zip é apropriado em instalações de todos sistemas operacionais suportados. Este processo deve ser usado caso você deseje extrair a instância manualmente.
| |
|
Instalador JAR
|
O instalador JAR pode ser executado num console ou num assistente gráfico. Ambas as opções fornecem instruções passo-a-passo de instalação e configuração da instância do servidor. A configuração adicional, incluindo as Inicializações Rápidas e o Repositório Maven, é também viável com o instalador.
| |
|
Instalação RPM
|
O JBoss Enterprise Application Plataform 6 pode ser instalado com o instalador gráfico do pacote RPM suportado ou com uma interface da linha de comando. Este método é apropriado para instalações suportadas do Red Hat Enterprise Linux 6.
|
3.2. Instalação Zip
3.2.1. Download do JBoss Enterprise Application Plataform 6 (Instalação ZIP)
O arquivo Zip do JBoss Enterprise Application Plataform 6 está disponível a partir do https://access.redhat.com. A instalação de arquivo ZIP é uma plataforma independente e é a maneira preferida de instalação do JBoss Enterprise Application Plataform 6 em todas as plataformas suportadas. Este tópico descreve as etapas para realização do download do arquivo.
Pré-requisitos
Procedimento 3.1. Realize o download do arquivo Zip
- Log ao https://access.redhat.com.
- Selecione Downloads → JBoss Enterprise Middleware → Downloads a partir do item de menu.
- Selecione Application Platform a partir do menu suspenso Product.
- Selecione a versão correta do JBoss Enterprise Application Plataform a partir do menu suspenso Version.
- Clique no botão Download próximo à opção
Application Platform 6.1.0.
O JBoss Enterprise Application Plataform 6 foi atualizado com êxito à máquina de destino e está pronto para instalação.
3.2.2. Instalação do JBoss Enterprise Application Plataform 6 (Instalação Zip)
Este tópico descreve as etapas de instalação do JBoss Enterprise Application Plataform 6 usando o arquivo Zip baixado.
Pré-requisitos
Procedimento 3.2. Instalação do Arquivo Zip
Mova o arquivo Zip à localização desejada.
Mova o arquivo ZIP ao servidor e diretório onde deseja instalar o JBoss Enterprise Application Plataform 6. O diretório deve estar acessível pelo usuário que iniciará e interromperá o servidor.Use um aplicativo apropriado para extrair o arquivo Zip à localização desejada.
O comando para extrair o arquivo Zip num ambiente Linux éunzip.Num ambiente do Microsoft Windows, clique no botão direito do mouse e selecione Extract All.
O JBoss Enterprise Application Plataform 6 foi atualizado com sucesso. O diretório criado pela extração do arquivo Zip é o diretório de nível superior para o servidor. Isto é referido como EAP_HOME/.
3.2.3. Desinstalação do JBoss Enterprise Application Plataform 6 (Instalação Zip)
Esta seção descreve as etapas requeridas para desinstalar a instalação Zip do JBoss Enterprise Application Plataform 6
Realize o backup de quaisquer arquivos de configuração modificados e implantações que possam ser reutilizadas numa instância futura.
Procedimento 3.3. Desinstalação do JBoss Enterprise Application Plataform 6 (Instalação Zip)
- Dirija-se ao diretório que você extraiu a pasta do JBoss Enterprise Application Plataform 6 do arquivo zip.
Remova o diretório de instalação.
O JBoss Enterprise Application Plataform 6 instala um diretório único, quando você usa o método de instalação Zip. Exclua o diretório de instalação ao desinstalar o JBoss Enterprise Application Plataform 6.Opcional: Remova quaisquer scripts de inicialização que você criou.
Caso você tenha criado os scripts de inicialização ou outros scripts que dependem do JBoss Enterprise Application Plataform 6 ser instalado no seu computador, remova-os.
O JBoss Enterprise Application Plataform 6 é desinstalado do servidor.
3.3. Instalador Gráfico
3.3.1. Download do JBoss Enterprise Application Plataform 6 (Installer)
O arquivo do instalador do JBoss Enterprise Application Plataform 6 está disponível a partir do https://access.redhat.com. O arquivo .jar pode ser usado para execução tanto dos instaladores baseados em Texto ou Gráfico. Este tópico descreve as etapas para download do arquivo.
Pré-requisitos
Procedimento 3.4. Download do Instalador
- Log ao https://access.redhat.com.
- Selecione Downloads → JBoss Enterprise Middleware → Downloads a partir do item de menu.

Figura 3.1.
- Selecione Application Platform a partir do menu suspenso Product que aparece na próxima tela.
- Selecione o
Application Platform 6.1.0 Installer. - Clique em Download.
o JBoss Enterprise Application Plataform 6 foi baixado à máquina de destino. Ele está pronta para instalação.
3.3.2. Instalação do JBoss Enterprise Application Plataform 6 (Instalador Gráfico)
O Instalador Gráfico permite você instalar JBoss Enterprise Application Plataform 6 na máquina de destino usando as instruções de passo-a-passo do GUI. Este tópico descreve as etapas necessárias para executar o instalador.
Procedimento 3.5. Instalação do JBoss Enterprise Application Plataform 6
- Abra um terminal e navegue aonde o instalador GUI foi baixado.
- Inicie o instalador GUI com o seguinte comando:
java -jar jboss-eap-6.1.0-installer.jar - A execução do comando iniciará a interface gráfica para a instalação e a primeira janela pedirá para você selecionar o idioma para instalação.

Figura 3.2. Instalação do JBoss EAP 6.1.0 - Primeira Etapa
- Siga o resto das etapas para instalação do JBoss Enterprise Application Plataform 6 em sua máquina de destino.
- A etapa final no processo de instalação permitirá você criar um script de Instalação Automática. Este script pode ser usado para instalar o JBoss em outras máquina de destino em sua rede ou de uso futuro. Consulte a figura abaixo. Pressione o botão Generate an automatic installation script caso deseje criar este script XML.

Figura 3.3. Etapa Final da Instalação do JBoss EAP
- Pressione o botão Done para sair da instalação.
A instalação está pronta e o JBoss Enterprise Application Plataform 6 está instalada na sua máquina de destino.
3.3.3. Desinstalação do JBoss Enterprise Application Plataform 6 (Instalador Gráfico)
Esta seção descreve as etapas requeridas para a desinstalação de uma instância do JBoss Enterprise Application Plataform 6 que foi desinstalado usando um instalador gráfico.
Pré-requisitos
- Realize o backup de quaisquer arquivos de configuração modificados e implantações que podem ser reusadas numa instância mais tarde.
Procedimento 3.6. Desinstalação do JBoss Enterprise Application Plataform 6 (Instalação Gráfica)
- Durante a instalação do JBoss Enterprise Application Plataform 6, um diretório chamado
Uninstallerfoi criado. Esse diretório possui um arquivo chamadouninstaller.jar. Navegue a este diretório numa janela de terminal. - Inicie o desinstalador GUI com o seguinte comando Java:
java -jar uninstaller.jar - A execução deste comando iniciará o desinstalador gráfico conforme apresentado na seguinte figura. Selecione a opção que você deseja deletar no diretório
EAP_HOME.
Figura 3.4. Desinstalação do JBoss 6.1 usando o instalador gráfico
- Pressione o botão Uninstall para iniciar o processo de desinstalação.
- Quando o processo de desintalação for finalizado, pressione o botão Quit para sair do desinstalador.
- Após a desinstalação com êxito, você talvez queira remover o diretório
Uninstallerdaonde você inciou o desinstalador.
O JBoss Enterprise Application Plataform 6 é desinstalado de seu servidor.
3.4. O instalador baseado em texto.
3.4.1. Download do JBoss Enterprise Application Plataform 6 (Installer)
O arquivo do instalador do JBoss Enterprise Application Plataform 6 está disponível a partir do https://access.redhat.com. O arquivo .jar pode ser usado para execução tanto dos instaladores baseados em Texto ou Gráfico. Este tópico descreve as etapas para download do arquivo.
Pré-requisitos
Procedimento 3.7. Download do Instalador
- Log ao https://access.redhat.com.
- Selecione Downloads → JBoss Enterprise Middleware → Downloads a partir do item de menu.

Figura 3.5.
- Selecione Application Platform a partir do menu suspenso Product que aparece na próxima tela.
- Selecione o
Application Platform 6.1.0 Installer. - Clique em Download.
o JBoss Enterprise Application Plataform 6 foi baixado à máquina de destino. Ele está pronta para instalação.
3.4.2. Instalação do JBoss Enterprise Application Plataform 6 (Instalador baseado em Texto)
O arquivo .JAR do instalador do JBoss Enterprise Application Plataform pode ser usado para tanto uma instalação em Texto ou Gráfica. Este tópico descreve as etapas para instalar o JBoss Enterprise Application Plataform 6.1.0 usando método baseado em texto.
Procedimento 3.8. Instalador baseado em texto.
- Abra um terminal.
- Inicie o instalador do console com o seguinte comando:
java -jar jboss-eap-6.1.0-installer.jar -console - Siga os prompts da instalação.
- O arquivo XML pode ser gerado para uso com o recurso de instalação automático. Isto permite instalações idênticas por todas as instâncias. Caso você deseje criar um script de instalação, selecione
yes.
O JBoss Enterprise Application Plataform 6 foi instalado com êxito na máquina de destino.
3.4.3. Desinstalação do JBoss Enterprise Application Plataform 6 (Instalador baseado em Texto)
Esta seção descreve o processo de desinstalação para o JBoss Enterprise Application Plataform, usando o desinstalador baseado em Texto.
Pré-requisitos
- Realize o backup de quaisquer arquivos de configuração modificados e implantações que possam ser reutilizadas numa instância futura.
Procedimento 3.9. Processo de Desinstalação baseado em Texto
- Navegue ao diretório
Uninstallercriado durante o processo de instalação. Ele pode ser encontrado num nível acima ao do EAP_HOME. - Inicie o desinstalador baseado em Texto com o seguinte comando:
java -jar uninstaller.jar -console - Siga as etapas para desinstalar o JBoss Enterprise Application Plataform 6.
O JBoss Enterprise Application Plataform 6 é desinstalado de seu servidor.
3.5. Instalação Gráfica RPM
3.5.1. Instalação do JBoss Enterprise Application Plataform 6 (Instalador RPM Gráfico)
O método do pacote RPM de instalação do JBoss Enterprise Application Plataform 6 é apropriado para o Red Hat Enterprise Linux 6. Este tópico descreve as etapas requeridas para finalização da instalação.
Pré-requisitos
Procedimento 3.10. Instalação do JBoss Enterprise Application Plataform 6 (Instalador RPM Gráfico)
Inicie o PackageKit
O packageKit é um software de gerenciamento do pacote de código aberto como parte do RHEL6. Inicie o PackageKit na máquina de destino selecionando o System → Administration → Add/Remove Software.- Digite
jboss-eap6
na caixa de busca e pressione o botão Find. O pacote JBoss EAP 6 aparecerá na caixa de resultado. - Selecione o pacote JBoss EAP 6 e pressione o botão Apply. Consulte a figura abaixo.

Figura 3.6. Instalação do PackageKit JBoss EAP 6
- Siga o resto das etapas para instalação do JBoss Enterprise Application Plataform 6 em sua máquina de destino.
A instalação está pronta e o JBoss Enterprise Application Plataform 6 está instalada na sua máquina de destino.
3.6. Instalação RPM baseada em texto.
3.6.1. Instalação do JBoss Enterprise Application Plataform 6 (Instalação RPM baseada em Texto)
O método do pacote RPM de instalação do JBoss Enterprise Application Plataform 6 é apropriado para o Red Hat Enterprise Linux 6. Este tópico descreve as etapas requeridas para instalar uma instância usando a linha de comando.
Pré-requisitos
Procedimento 3.11. Etapas da Instalação baseadas em Texto.
Instale o pacote RPM usando o YUM e o Red Hat Network.
Use o YUM para instalar o pacote do grupo do JBoss Enterprise Application Plataform 6 usando o comandogroupinstall.[user@host ~]$ yum groupinstall jboss-eap6
Configure as opções init.
A instalação RPM contém os inscripts init para lançar o servidor. A configuração para os inscripts init estão contidas em diversos arquivos adicionais. Refira-se à Seção A.4, “Arquivos de Configuração de Instalação RPM para o JBoss Enterprise Application Plataform 6” para maiores detalhes sobre esses arquivos e as opções contidas no mesmo.
A instalação está completa. O caminho default EAP_HOME para a instalação RPM é /usr/share/jbossas. Refira-se à Seção A.3, “Lista de Pacote RPM para o JBoss Enterprise Application Plataform 6” para uma lista completa de todos os pacotes instalados.
3.7. Instalação de Patch
3.7.1. Mecanismos de Aplicação de Patch
- Atualizações planejadas: conforme parte de uma atualização micro, pequena ou maior de um produto existente.
- Atualizações assíncronas: patch único que é lançado fora do ciclo de atualização normal de um produto existente.
- Qual a facilidade de uma falha ser explorada?
- Qual tipo de danos pode ser feito caso a falha seja explorada?
- Existem normalmente outros fatores envolvidos que reduzem o impacto de uma falha (tal como firewalls, Security-Enhanced Linux, diretivas de compilador ou outros)?
3.7.2. Subscrição para as Listas de Correio Patch
A equipe do JBoss na Red Hat mantém uma lista de correio de segurança para comunicados de segurança sobre os produtos do Red Hat JBoss Enterprise. Este tópico descreve o que você precisa realizar para subscrever-se a esta lista.
Pré-requisitos
- Nenhum
Procedimento 3.12. Subscrição à Lista de Vigilância do JBoss
- Clique no seguinte link para ir à página de lista de correio de Vigilância do JBoss: JBoss Watch Mailing List.
- Insira o endereço de e-mail na seção Subscribing to Jboss-watch-list
- [Você pode optar em inserir o seu nome e selecionar uma senha. Isto é opcional, porém recomendável.]
- Pressione o botão Subscribe para iniciar o processo de subscrição.
- Você pode navegar nos arquivos da lista de correio através do: JBoss Watch Mailing List Archives.
Após confirmação de sua conta de e-mail, você estará subscrito para receber os comunicados relacionados à segurança da lista de correio patch do JBoss.
3.7.3. Instalação de Patches na forma zip
Os patches de segurança do JBoss são distribuídos em duas formas: zip (para todos os produtos) e RPM (para um subconjunto de produtos). Os patches de correção de bug do JBoss são apenas distribuídos em formato zip. Esta tarefa descreve as etapas que você precisa efetuar para instalar os patches (segurança ou correções de bug) através do formato zip.
Pré-requisitos
- Acesso válido e subscrição do Portal do Cliente Red Hat.
- A subscrição atual a um produto do JBoss instalado num formato zip.
Procedimento 3.13. Aplicação de um patch a um produto do JBoss através do método zip.
Atenção
- Obtenha informações sobre o patch de segurança tanto pela subscrição da lista de correio de vigilância do JBoss ou pela navegação nos arquivos da lista de correio de vigilância do JBoss.
Nota
Apenas patches de segurança são comunicados na lista de correio de vigilância do JBoss. - Leia a errata para o patch de segurança e certifique-se de que está aplicado a um produto do JBoss em seu ambiente.
- Caso o patch de segurança for aplicado a um produto do JBoss em seu ambiente, siga as instruções do link para baixar o patch do Portal do Cliente Red Hat.
- O arquivo zip que pode ser baixado a partir do portal do cliente terá todos os arquivos solicitados para corrigir o problema de segurança ou bug. Baixe este arquivo zip do patch na mesma localização do seu produto JBoss.
- Desfaça o zip do arquivo patch na mesma localização onde o produto JBoss é instalado. As versões patch substituem os arquivos existentes.
O produto JBoss possui patches com a atualização mais recente usando o formato zip.
3.7.4. Instalação de Patches na forma RPM
Os patches do JBoss são distribuídos em duas formas: zip (para todos os produtos) e RPM (para um subconjunto de produtos). Esta tarefa descreve as etapas que você precisa efetuar para instalar os patches através do formato RPM. Este método de atualização RPM é usado para lançar patches assíncronos de segurança e atualizações micro, pequena e maior de produto apenas.
Pré-requisitos
- Uma subscrição válida para o Red Hat Network.
- A subscrição atual a um produto JBoss instalado através de um pacote RPM.
Procedimento 3.14. Aplicar um patch a um produto JBoss através do método RPM.
Atenção
- Receba informação sobre o patch de segurança tanto sendo subscrito na lista de correio de vigilância do JBoss ou navegando pelos arquivos da lista de correio de vigilância do JBoss.
- Leia a errata para o patch de segurança e certifique-se de que está aplicado a um produto do JBoss em seu ambiente.
- Caso o patch de segurança for aplicado a um produto JBoss em seu ambiente, siga instruções do link para baixar o pacote RPM atualizado que está incluso na errata.
- Use
ou um comando similar para instalar o patch.yum update
O produto JBoss possui patches com a atualização mais recente usando o formato RPM.
3.7.5. Classificação de impacto e gravidade do JBoss Security Patches
Tabela 3.2. Classificação de gravidade do JBoss Security Patches
| Gravidade | Descrição |
|---|---|
| Crítica |
A classificação é dada para as falhas que poderiam ser facilmente exploradas por um invasor não identificado e levar a comprometer o sistema (execução de código arbitrário) sem requerer a interação do usuário. Existem tipos de vulnerabilidades que podem ser exploradas. As falhas que requerem um usuário remoto autenticado, um usuário local ou uma configuração improvável não são classificadas como impacto crítico.
|
| Importante |
A classificação é dada às falhas que podem facilmente comprometer a confidencialidade, integridade ou habilidade de recursos. Esses são tipos de vulnerabilidades que permitem usuários locais ganharem privilégios, permitir usuários remotos não autenticados a visualizarem recursos que deveriam ser protegidos pela autenticação ou permitir usuários local ou remoto a causarem uma negação de serviço.
|
| Moderada |
A classificação é dada para as falhas que poderiam ser dificilmente exploradas, mas podem comprometer a confidencialidade, integridade ou disponibilidade de recursos, sob certas circunstâncias. Existem tipos de vulnerabilidades que podem possuir um impacto crítico de falha ou impacto importante, no entanto não são exploradas com tanta facilidade devido à avalização técnica da falha ou por afetarem as configurações comprometedoras.
|
| Baixa |
A classificação é dada a todos os demais problemas que um impacto de segurança possui. Estes são os tipos de vulnerabilidades que acredita-se requerem circunstâncias improváveis para estarem aptos a serem explorados ou onde a exploração com êxito geraria uma consequência mínima.
|
Exemplo 3.1. Métricas do CVSS v2
C:N/I:P/A:C3.8. Instalação Automatizada
3.8.1. Instalação de Múltiplas Instâncias do JBoss Enterprise Application Plataform 6 (Instalador)
As instâncias idênticas múltiplas do JBoss Enterprise Application Plataform 6 podem ser instaladas usando um script automático durante o processo de instalação, usando tanto o instalador baseado em Texto ou Gráfico. Este tópico descreve as etapas requeridas para instalação do JBoss Enterprise Application Plataform 6 usando um script gerado.
Pré-requisitos
- Gere um script automatizado usando o Instalador baseado em Texto ou Gráfico:
Procedimento 3.15. Instalação Automatizada
- Num terminal, execute o seguinte comando para instalar o JBoss Enterprise Application Plataform 6 usando um script automatizado:
java -jar jboss-eap-6.1.0-installer.jarSCRIPT_NAME.xml
Uma instância idêntica do JBoss Enterprise Application Plataform 6 foi instalado, baseado no script gerado automaticamente.
3.9. Configuração de Serviço
3.9.1. Configuração do JBoss Enterprise Application Plataform como um Serviço no Red Hat Enterprise Linux (Método RPM)
Use o seguinte procedimento para instalar o JBoss Enterprise Application Plataform 6 como um serviço no Red Hat Enterprise Linux quando a instalação foi realizada usando o método RHN (RPM).
Pré-requisitos
- Instalação do JBoss Enterprise Application Plataform 6 usando o Método RPM (Gráfico ou baseado em Texto).
- Privilégios de administrador no servidor são requeridos.
Procedimento 3.16. Configure o JBoss Enterprise Application Plataform como um Serviço usando o Método RPM no Red Hat Enterprise Linux
Instalação do Servidor do JBoss Enterprise Application Plataform 6
Instalação do Servidor do JBoss Enterprise Application Plataform 6 através do método RPM usando uma das etapas listadas nas seções de pré-requisitos listadas acima.Ativação do serviço
O método de instalação do RPM para o JBoss Enterprise Application Plataform 6 instala os arquivos de serviço requisitados nas localizações corretas. Tudo o que você precisa realizar para configurá-lo como serviço é emitir o seguinte comando:chkconfig jbossas on
O JBoss Enterprise Application Plataform 6 inicia automaticamente quando o Red Hat Enterprise Linux alcança seu nível de rodagem default e encerra automaticamente quando o sistema de operação passa por sua rotina de encerramento.
3.9.2. Configuração do JBoss Enterprise Application Plataform como um Serviço no Red Hat Enterprise Linux (ZIp, Instalador)
Use o seguinte procedimento para instalar o JBoss Enterprise Application Plataform 6 como um serviço no Red Hat Enterprise Linux quando a instalação for realizada com os métodos gráfico, de texto ou zip. Esse processo não é válido quando a instalação for realizada usando o método RHN (RPM).
Pré-requisitos
- Instalação do JBoss Enterprise Application Plataform 6 usando a instalação Zip, Instalador Gráfico ou Instalador baseado em Texto:
- Privilégios de administrador no servidor são requeridos.
Procedimento 3.17. Configure o Serviço
Copie o script da inicialização para o diretório
/etc/init.d/O script de inicialização e um arquivo de configuração associado estão localizados no diretórioEAP_HOME/bin/init.d/. Abra o arquivo da configuraçãojboss-as.confpara editá-lo.Personalize as opções de iniciação no arquivo
jboss-as.confExistem diversas opções com o arquivojboss-as.conf. No mínimo, especifique os valores corretos para as variáveisJBOSS_HOMEeJBOSS_USER. Caso estas variáveis estiverem ausentes, adicione-as.Arquivos Diretórios
- Copie o script da inicialização para o diretório
/etc/jboss-as.[user@host init.d]$sudo mkdir /etc/jboss-as[user@host init.d]$sudo cp jboss-eap-6.1/bin/init.d/jboss-as.conf /etc/jboss-as/ - Copie o arquivo de configuração modificado ao diretório
/etc/init.d.[user@host init.d]$sudo cp jboss-as-standalone.sh /etc/init.d
Adicione o script de inicialização como um serviço.
Adicione o novo serviçojboss-as-standalone.shà lista de serviços iniciados automaticamente, usando o comando de gerenciamento do serviçochkconfig.[user@host init.d]$sudo chkconfig --add jboss-as-standalone.shInicie o serviço.
Teste se o serviço foi instalado corretamente usando a sintaxe default para iniciação dos serviços do Red Hat Enterprise Linux.[user@host bin]$sudo service jboss-as-standalone.sh startCaso tudo tenha saído de acordo, você obterá um sinal verde [OK]. Caso obtenha um erro, verifique os logs de erro e certifique-se que seus caminhos estão corretos no arquivo da configuração.
O JBoss Enterprise Application Plataform 6 inicia automaticamente quando o Red Hat Enterprise Linux alcança seu nível de rodagem default e encerra automaticamente quando o sistema de operação passa por sua rotina de encerramento.
Capítulo 4. Atualização para o mais Recente Lançamento
4.1. Atualização do JBoss Enterprise Application Plataform 6 com Instalação ZIP
A atualização do JBoss Enterprise Application Plataform 6 requer algum trabalho inicial para fazer o backup da instalação existente. Este tópico descreve a atualização da instalação ZIP.
Pré-requisitos
- Certifique-se que o sistema operacional base está atualizado.
- Determine quais arquivos foram modificados desde que o JBoss Enterprise Application Plataform 6 foi instalado.
- Realize o backup de quaisquer arquivos de configuração modificados, implantações e todos os dados do usuário.
Atenção
Procedimento 4.1. Realize a atualização para a versão mais recente do JBoss Enterprise Application Plataform 6
- Mova o arquivo ZIP à localização desejada. Recomendamos que isto seja uma localização diferente à da instalação do JBoss Enterprise Application Plataform 6.
Importante
Caso você deseje instalar a versão mais recente do JBoss Enterprise Application Plataform 6 à mesma localização da instalação existente, você precisará mover a instalação existente a uma localização diferente antes do procedimento. Isto é para prevenir a perda dos arquivos de configuração modificados, implantações e atualizações. - Desfaça o zip do arquivo. Esta etapa instala uma instância de limpeza do lançamento mais recente do JBoss Enterprise Application Plataform.
- Copie os diretórios
EAP_HOME/domain/eEAP_HOME/standalone/da instalação anterior para os novos diretórios. - Revise as alterações realizadas ao diretório
binda instalação anterior e faça as modificações equivalentes ao novo diretório.Atenção
Os arquivos no diretóriobinnão devem ser substituídos pelos arquivos das versões anteriores. As alterações devem ser realizadas manualmente. - Revise os arquivos modificados restantes da instalação anterior e mova essas alterações à instalação. Esses arquivos devem incluir:
- O diretório
welcome-content. - Os módulos personalizados no diretório
modules. - Os pacotes personalizados no diretório
bundles.
A instalação ZIP do JBoss Enterprise Application Plataform 6 foi atualizada com sucesso ao lançamento mais recente.
4.2. Atualização do JBoss Enterprise Application Plataform 6 com Instalação RPM
A atualização para o último lançamento do JBoss Enterprise Application Plataform 6 requer algum trabalho inicial para realização do backup da instalação 6.0.0 existente. Esta etapa descreve a atualização da instalação RPM através do Red Hat Network (RHN - Rede da Red Hat).
Pré-requisitos
- Certifique-se de que o sistema de operação base está atualizado e que o sistema está subscrito e ativado para obtenção de atualização para o canal Base SO.
- Certifique-se de que o canal RHN do JBoss Enterprise Application Plataform está ativado. Por exemplo, numa arquitetura x86 de 64 bites, esta será o JBoss Application Plataform (v 6) para o canal x86_64 do 6Server (
jbappplatform-6-x86_64-server-6-rpm). - Realize o backup de quaisquer arquivos de configuração modificados, implantações e todos os dados do usuário.
Atenção
Procedimento 4.2. Atualiza ao lançamento do JBoss Enterprise Application Plataform 6
- Execute o seguinte comando num terminal para atualização da instalação:
[user@host] yum update
- Mescle manualmente cada arquivo
*.rpmnewcriado que contém alterações nos arquivos de configuração de produção.
O JBoss Enterprise Application Plataform 6 foi atualizado com êxito.
4.3. Atualização do Cluster do Servidor do JBoss Enterprise Application Plataform da versão 6.0 à 6.1
O JBoss Enterprise Application Plataform 6.1 não suporta a criação de clusters onde diferente nós são feitos por versões diferentes dos JBoss Enterprise Application Plataform Servers. Portanto, o cluster misto baseado em versões diferentes não é suportado e todos os nós com um cluster devem ser da mesma versão - 6.1.
Atenção
Pré-requisitos
- Nenhum
Procedimento 4.3. Configure um JBoss Enterprise Application Server Cluster na versão 6.1
- Refira-se ao capítulo HTTP Clustering e Balanceamento de Carga do Guia de Configuração e Administração do JBoss Enterprise Application Plataform 6.1 para maiores instruções de como configurar o cluster do Servidor do JBoss Enterprise Application Plataform na versão 6.1.
- Migre todo o tráfego para este novo cluster usando as etapas descritas no capítulo Migração de Tráfego entre Clusters do Guia de Configuração e Administração do JBoss Enterprise Application Plataform 6.1
O seu JBoss Enterprise Application Plataform Server 6.0 cluster foi migrado a um cluster baseado no JBoss Enterprise Application Plataform Server 6.1.
Apêndice A. Informações adicionais
A.1. Downloads disponíveis ao JBoss Enterprise Application Plataform 6
Tabela A.1. Downloads Disponíveis
| Nome | Descrição | Sistemas de Operação |
|---|---|---|
| Servidor Apache HTTP |
A instância do servidor Apache HTTP para cada arquitetura e sistema operacional suportado. Este servidor HTTP foi testado e verificado para funcionar com o JBoss Enterprise Application Plataform 6.
|
Red Hat Enterprise Linux 5, Red Hat Enterprise Linux 6, Microsoft Windows Server 2008, Solaris 10 e 11
|
| Native Components |
Os componentes que foram compilados para serem otimizados à uma plataforma específica. Por exemplo, os DDL são fornecidos para os ambientes do Servidor do Microsoft Windows. Às vezes, os componentes native podem produzir melhoramentos de desempenho.
|
Red Hat Enterprise Linux 5, Red Hat Enterprise Linux 6, Microsoft Windows Server 2008, Solaris 10 e 11
|
| Native Utilities |
As utilidades específicas para cada sistema operacional suportado e arquitetura, tais como scripts e utilidades para instalação do JBoss Enterprise Application Plataform como um serviço no seu sistema operacional e gereção das chaves criptografadas SSL e certificados.
|
Red Hat Enterprise Linux 5, Red Hat Enterprise Linux 6, Microsoft Windows Server 2008, Solaris 10 e 11
|
| Webserver Connector Natives |
Os módulos pré-compilados para Apache, Microsoft e servidores da web Oracle iPlanet, para recursos de alta disponibilidade e balanceamento de carga HTTP. Essas binárias são extensivamente testadas e conhecidas para funcionarem bem com o JBoss Enterprise Application Plataform 6.
|
Red Hat Enterprise Linux 5, Red Hat Enterprise Linux 6, Microsoft Windows Server 2008, Solaris 10 e 11
|
| Javadocs |
A documentação para os APIs públicos expostos pelo JBoss Enterprise Application Plataform 6. Você pode instalá-los no seu servidor HTTP local ou IDE, ou você pode visualizá-los na sua máquina local.
|
Plataforma independente
|
| Instalador |
Instalador Java para o JBoss Enterprise Application Plataform 6. As etapas de instalação do Quickstarts e Repositório Maven estão incluídas.
|
Plataforma independente
|
| Repositório Maven |
O repositório Maven que você pode baixar e disponibilizar em seu ambiente de desenvolvimento local, pelo qual contém artefatos comuns aos aplicativos construídos sob o JBoss Enterprise Application Plataform 6. O repositório Maven encontra-se também disponível através do Instalador do JBoss Enterprise Application Plataform 6.
|
Plataforma independente
|
| Quickstarts |
Os aplicativos de amostra para auxiliá-lo a inciar o desenvolvimento dos aplicativos Java EE 6 com os APIs fornecidos com o JBoss Enterprise Application Plataform 6. Os Quickstarts estão também disponíveis através do JBoss Enterprise Application Plataform 6 Installer.
|
Plataforma independente
|
| Código de Fonte |
O código fonte Java para o JBoss Enterprise Application Plataform 6, fornecido de forma que você pode recompilá-lo em seu próprio ambiente ou auditorá-lo.
|
Plataforma independente
|
| Application Platform |
O pacote de instalação ZIP que pode ser instalado e executado em cada plataforma suportada. Esta é a maneira mais simples de instalar o JBoss Enterprise Application Plataform 6.
|
Plataforma independente
|
Importante
A.2. Estrutura do Diretório do JBoss Enterprise Application Plataform 6
O JBoss Enterprise Application Plataform 6 inclui uma estrutura do diretório simplificada às versões futuras. Este tópico contém uma listagem de diretórios e uma descrição do que cada diretório contém.
standalone/ e domain/.
Tabela A.2. Diretórios e arquivos de nível superior
| Nome | Propósito |
|---|---|
| appclient/ | Contém detalhes da configuração para o contêiner do cliente do aplicativo. |
| bin/ | Contém os inscripts de inicialização para o JBoss Enterprise Application Plataform 6 no Red Hat Enterprise Linux e Microsoft Windows. |
| bundles/ | Contém os bundles OSGi pertencentes à funcionalidade interna do JBoss Enterprise Application Plataform 6. |
| docs/ | Arquivos de licença, esquemas e amostras. |
| domain/ | Arquivos de configuração, conteúdo de implantação e áreas graváveis quando o JBoss Enterprise Application Plataform 6 rodar como uma managed domain. |
| modules/ | Os módulos são dinamicamente carregados pelo JBoss Enterprise Application Plataform quando os serviços os solicitarem. |
| standalone/ | Arquivos de configuração, conteúdo de implantação e áreas gravadas usadas quando o JBoss Enterprise Application Plataform 6 executar como um servidor autônomo. |
| welcome-content/ | Contém o conteúdo usado pelo aplicativo da web de Boas Vindas que está disponível na porta 8080 de uma instalação default. |
jboss-modules.jar
| O mecanismo bootstrapping que carrega os módulos. |
Tabela A.3. Os diretórios com o diretório domain/
| Nome | Propósito |
|---|---|
| configuration/ | Os arquivos de configuração para o storaged domain. Esses arquivos são modificados pelo Management Console e Management CLI, sendo que não devem ser editados diretamente. |
| data/ | A informação a respeito dos serviços implantados. Os serviços são implantados usando o Management Console e o Management CLI ao invés de um scanner de implantação. Portanto, não posicione arquivos neste diretório manualmente. |
| log/ | Contém os arquivos de log do período de execução para o host e controladores do processo que executam numa instância local. |
| servers/ | Contém data/, log/ equivalente e diretórios tmp/ para cada instância do servidor num domain, que contém dados similares aos mesmos diretórios com o diretório domain/ de nível superior. |
| tmp/ | Contém dados temporários tais como os arquivos pertencentes ao mecanismo usado à chave compartilhada usada pelo Management CLI para autenticar os usuários locais ao managed domain. |
Tabela A.4. Diretórios com o diretório standalone/
| Nome | Propósito |
|---|---|
| configuration/ | Os arquivos de configuração para o servidor autônomo. Esses arquivos são modificados pelo Management Console e Management CLI, sendo que não devem ser editados diretamente. |
| deployments/ | Informação sobre os serviços implantados. O serviço autônomo inclui um scanner de implantação, de forma que você pode posicionar arquivos no diretório a ser posicionado. No entanto, a abordagem recomendada é gerenciar implantações usando o Management Console ou Management CLI. |
| lib/ | As bibliotecas externas que pertencem ao modo de servidor autônomo. O default é vazio. |
| tmp/ | Contém dados temporários tais como os arquivos pertencentes ao mecanismo de chave compartilhada usada pelo Management CLI para autenticar os usuários locais ao servidor. |
A.3. Lista de Pacote RPM para o JBoss Enterprise Application Plataform 6
O JBoss Enterprise Application Plataform 6 é instalado no Red Hat Enterprise Linux usando o grupo de pacote YUM JBoss EAP 6. Este grupo é feito dos seguintes pacotes.
Tabela A.5. Lista de Pacotes
| Pacote | Descrição |
|---|---|
| jbossas-appclient | JEE Application Client Container |
| jbossas-bundles | OSGi bundles |
| jbossas-core | Componentes core. Isto é requerido para todas as configurações. |
| jbossas-domain | Configuração domain |
| jbossas-hornetq-native | Contêiner para os arquivos do JBoss AS HornetQ |
| jbossas-jbossweb-native | JBoss Enterprise Web Platform |
| jbossas-modules-eap | Módulos do Enterprise Application Plataform |
| jbossas-product-eap | Componentes de configuração do produto. Isto personaliza a execução do produto. |
| jbossas-standalone | Configuração autônoma |
| jbossas-welcome-content-eap | Conteúdo de boas-vindas usado nas mensagens de iniciação e páginas do console |
Importante
jbossas-hornetq-native é incluído para a alta disponibilidade do JBoss Enterprise Application Plataform 6, mas não é ativado por default.
A.4. Arquivos de Configuração de Instalação RPM para o JBoss Enterprise Application Plataform 6
A instalação RPM do JBoss Enterprise Application Plataform 6 inclui três arquivos adicionais à instalação ZIP. Esses arquivos são usados pelo serviço de script de iniciação para especificar o ambiente de lançamento do servidor do aplicativo. Um desses arquivos são válidos a todas as instâncias do JBoss Enterprise Application Plataform 6, enquanto os outros dois fornecem substituição para os servidores de modo domain e autônomo.
Tabela A.6. Arquivos de Configuração RPM Adicional
| Arquivo | Descrição |
|---|---|
/etc/jbossas/jbossas.conf | Esse arquivo é de leitura primeiramente e é aplicado a todas as instâncias do JBoss Enterprise Application Plataform 6. |
/etc/sysconfig/jbossas | As configurações específicas aos servidores autônomos. Os valores especificados aqui substituirão os valores no jbossas.conf quando executados como um servidor autônomo. |
/etc/sysconfig/jbossas-domain | As configurações especificam os servidores de modo domain. Os valores especificados aqui irão substituir os valores no jbossas.conf quando executados como servidor de modo domain. |
Tabela A.7. Propriedades de Configuração da Instalação RPM
| Propriedade | Descrição |
|---|---|
JBOSS_USER |
A conta do usuário do sistema que o JBoss Enterprise Application Plataform 6 roda. Esse usuário é proprietário desses arquivos.
Valor default:
jboss
|
JBOSS_GROUP |
O grupo do usuário do sistema que os arquivos do JBoss Enterprise Application Plataform pertencem.
Valor default:
jboss
|
JBOSS_STARTUP_WAIT |
O número de segundos que o script init esperará até confirmar que o servidor tenha lançado com êxito após receber um comando
start ou restart.
Valor default:
60
|
JBOSS_SHUTDOWN_WAIT |
O número de segundos que o script init esperará para que o servidor encerre antes de continuar quando ele receber o comando
stop ou restart.
Valor default:
20
|
JBOSS_CONSOLE_LOG |
O arquivo que o manuseador de registro CONSOLO será redirecionado.
Valor default:
/var/log/jbossas/$JBOSSCONF/console.log
|
JAVA_HOME |
O diretório onde o seu Ambiente do Período de Execução do Java é instalado.
Valor default:
/usr/lib/jvm/jre
|
JBOSS_HOME |
O diretório onde os arquivos do servidor do aplicativo são instalados.
Valor default:
/usr/share/jbossas
|
JAVAPTH |
O caminho onde os arquivos Java executáveis são instalados.
Valor default:
$JAVA_HOME/bin
|
JBOSSCONF |
O modo do servidor para lançamento deste servidor,
standalone ou domain
Valor default:
standalone ou domain dependendo no modo do servidor.
|
JBOSSSH |
O script do qual é usado para lançar o servidor.
Valor default:
$JBOSS_HOME/bin/$JBOSSCONF.sh
|
JBOSS_SERVER_CONFIG |
O arquivo de configuração do servidor para uso.
Não existe default para esta propriedade. Tanto o
standalone.xml ou domain.xml podem ser definidos no início.
|
| JBOSS_HOST_CONFIG | Essa propriedade permite um usuário especificar a configuração host (tal como host.xml). Não existe valor determinado como default. |
Apêndice B. Histórico de Revisão
| Histórico de Revisões | |||
|---|---|---|---|
| Revisão 1.0.0-2 | Mon Oct 13 2014 | CS Builder Robot | |
| |||