Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

Guia de Introdução

JBoss Enterprise Application Platform 6.4

Para uso com o JBoss Enterprise Application Platform 6

Nidhi Chaudhary

Lucas Costi

Russell Dickenson

Sande Gilda

Vikram Goyal

Eamon Logue

Darrin Mison

Scott Mumford

David Ryan

Misty Stanley-Jones

Keerat Verma

Tom Wells

Resumo

Este livro fornece as etapas básicas de iniciação com o JBoss EAP 6.

Capítulo 1. Introdução

1.1. Red Hat JBoss Enterprise Application Platform 6

O Red Hat JBoss Enterprise Application Platform 6 (JBoss EAP 6) é uma plataforma de middleware construída nos padrões open source e compatível à especificação Java Enterprise Edition 6. Isto integra o JBoss Application Server 7 com clustering altamente disponível, mensagens, cache distribuído e outras tecnologias.
O JBoss EAP 6 inclui uma estrutura nova e modular que permite o serviço habilitar apenas o que é requerido, melhorando a velocidade de início.
O Management Console e o Management Command Line Interface fazem edições desnecessárias dos arquivos de configuração XML e adicionam a habilidade ao script e de automatizar tarefas.
Além disso, o JBoss EAP inclui APIs e frameworks de desenvolvimento para assegurar o desenvolvimento rápido e escalável dos aplicativos Java EE.

1.2. Portal do Cliente da Red Hat

O Red Hat Customer Portal é uma plataforma centralizada para os recursos de subscrição e conhecimento da Red Hat. Use o Red Hat Customer Portal para realizar o seguinte:
  • Gerenciar e manter os contratos de suporte e direitos da Red Hat.
  • Baixar o software oficialmente suportado.
  • Acessar a documentação do produto e ao Red Hat Knowledgebase.
  • Contactar os Serviços de Suporte Global.
  • Preencher bugs referentes aos produtos Red Hat.
O Portal do Cliente encontra-se disponível no: https://access.redhat.com.

1.3. Red Hat JBoss Developer Program

O Red Hat JBoss Developer Program ("o Programa") permite você implantar, sem custo adicional, certas subscrições da Red Hat para propósitos de desenvolvimento. As Subscrições da Red Hat oferecidas neste Programa não são suportadas e talvez não mencionem vulnerabilidades de segurança conhecidas. Elas podem ser usadas para propósitos de desenvolvimento apenas e não são intencionadas para outros propósitos tais como ambientes de produção ou para acesso de atualizações sem Subscrição(ões) da Red Hat ativa(s). Consulte o http://www.jboss.org/developer-program/termsandconditions para maiores informações sobre o Red Hat JBoss Developer Program.

1.4. Full Red Hat JBoss Commercial Program

O Full Red Hat JBoss Commercial Program o permite implantar em ambientes de produção. Isto fornece direitos adicionais às atualizações e patches de software e acesso ao Red Hat Knowledgebase. Caso tenha interesse em participar deste programa, por favor crie uma conta no Portal do Cliente no https://access.redhat.com/. Consulte a Seção 1.2, “Portal do Cliente da Red Hat” para maiores informações sobre este programa.

1.5. Como Buscar mais Informações

O propósito deste guia é ajudá-lo a usar o Red Hat JBoss Enterprise Application Platform o mais rápido possível. Caso deseje aprender mais, a suíte de documentação completa do JBoss EAP está disponível no Portal do Cliente https://access.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform.

Capítulo 2. Pré-requisitos

2.1. Pré-requisitos da Instalação do JBoss EAP 6

Sumário

O JBoss EAP está disponível no Red Hat JBoss Developer Program ou o Full Red Hat JBoss Commercial Program. Para maiores informações sobre o Red Hat JBoss Developer Program, por favor consulte a Seção 1.3, “Red Hat JBoss Developer Program”. Para maiores informações sobre o Full Red Hat JBoss Commercial Program, por favor consulte a Seção 1.4, “Full Red Hat JBoss Commercial Program”. As seguintes etapas descrevem os prérequisitos para ambos programas.

Pré-requisitos Comuns

  • Revise as configurações suportadas e certifique-se de que seu sistema está suportado: https://access.redhat.com/site/articles/111663.
  • Caso você crie uma conta no Red Hat Customer Portal e esteja participando no Full Red Hat JBoss Commercial Program, certifique-se de que o seu sistema está atualizado com a errata e atualizações emitidas da Red Hat.

Pré-requisitos do ZIP/Installer

  • Você deve conceder privilégios ao diretório de instalação.
  • Garanta que o JDK selecionado foi extraído (ou instalado). Consulte a documentação JDK para maiores informações de como realizar isto.
  • No Servidor do Microsoft Windows, certifique-se que as variáveis do ambiente PATH e JAVA_HOME foram configuradas, do contrário elas funcionaram.
  • No Hewlett-Packard HP-UX, certifique-se que a utilidade unzip foi instalada.

Capítulo 3. Realize o Download e Instalação do Produto

3.1. Visão Geral da Instalação do JBoss EAP

Este guia fornece instruções para auxiliá-lo a iniciar o uso do JBoss EAP o mais rápido possível, num processo simples de instalação. Os processos de instalação completa podem ser encontrados no Installation Guide para o JBoss EAP. Após a instalação do JBoss EAP, é possível configurar o servidor usando o Management CLI ou Management Console. Para maiores informações sobre como configurar o JBoss EAP, consulte o Guia de Administração e Configuração para o JBoss EAP. Ambos os guias estão localizados no Portal do Cliente no https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/.
É possível instalar o JBoss EAP em ambas maneiras abaixo.
  • Você pode instalar o JBoss EAP usando o programa de instalação gráfico.
  • Você pode instalar o JBoss EAP usando o arquivo ZIP.
Siga as seguintes instruções baseadas no seu método preferido de instalação.

3.2. Realize o Download e Instalação do JBoss EAP usando o Programa de Instalação Gráfico

3.2.1. Realize o Download do Programa de Instalação do JBoss EAP 6

Sumário

O JBoss EAP está disponível sob o Red Hat JBoss Developer Program ou o Full Red Hat JBoss Commercial Program. Siga o seguinte procedimento abaixo que coincide com a sua escolha de programa.

Procedimento 3.1. Realize o download do Programa de Instalação do JBoss EAP a partir do Portal do Cliente sob o Full Red Hat JBoss Commercial Program

Siga este procedimento caso esteja participando do Red Hat JBoss Commercial Program. Consulte a Seção 1.4, “Full Red Hat JBoss Commercial Program” para maiores informações.
  1. Abra um navegador e entre no Portal do Cliente https://access.redhat.com.
  2. Clique em Downloads.
  3. Clique em Red Hat JBoss Enterprise Application Platform na lista Downloads do Produto.
  4. Selecione a versão do JBoss EAP a partir do menu suspenso Versão.
  5. Encontre Red Hat JBoss Enterprise Application Platform 6.x.x Installer na lista e clique na opção Download.
  6. Você será solicitado a salvar o arquivo JAR a um diretório de sua escolha. Selecione um diretório e salve o arquivo.

Procedimento 3.2. Realize o download do Programa de Instalação do JBoss EAP a partir do jboss.org sob o Red Hat JBoss Developer Program

Siga este procedimento caso esteja participando do Red Hat JBoss Developer Program. Consulte a Seção 1.3, “Red Hat JBoss Developer Program” para maiores informações sobre este programa.
  1. Abra um navegador e acesse o seguinte URL: http://www.jboss.org/products/eap.
    • Clique no botão Download no lado direito da página para realizar o download do programa de instalação para a versão de lançamento GA atual.
    • Siga as seguintes etapas para selecionar uma versão alternativa, que pode incluir os lançamentos Alfa e Beta mais recentes, assim como as versões anteriores do produto.
      1. Clique no link Download JBoss EAP no canto esquerdo da página.
      2. Clique no link Installer sob a coluna Download para a versão de produto correta.
  2. Você será solicitado a salvar o arquivo JAR a um diretório de sua escolha. Selecione um diretório e salve o arquivo.
Resultado

O arquivo JAR do programa de instalação do JBoss EAP 6 foi baixado com êxito à máquina de destino.

3.2.2. Execução do Programa de Instalação do JBoss EAP

O programa de instalação do JBoss EAP pode ser executado tanto no modo de texto ou gráfico. Este tópico descreve o comando para executar o programa de instalação no modo gráfico.
Caso não tenha certeza sobre uma opção, simplesmente use o default. É possível configurar com facilidade o servidor mais tarde. Consulte o Guia de Administração e Configuração do Red Hat JBoss Enterprise Application Platform 6 localizado no Portal do Cliente a partir do https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/.

Procedimento 3.3. Execução do Programa de Instalação do JBoss EAP

  1. Abra um terminal e navegue ao diretório contendo o JAR do programa de instalação baixado.
  2. Digite o seguinte comando:
    java -jar jboss-eap-6.x.x-installer.jar
  3. Siga as instruções da tabela abaixo.

Tabela 3.1. Telas do Programa de Instalação do JBoss EAP

Nome da tela
Quando isto aparece
Descrição
Sempre
Selecione o idioma desejado para o programa de instalação e clique em OK.
Sempre
O EULA para o RED HAT JBOSS MIDDLEWARE.
Selecione "Eu aceito os termos do acordo de licença" e clique em Next.
Sempre
Selecione o caminho de instalação para o JBoss EAP e clique em Next. Será solicitado que você crie um novo diretório, ou que você substitua o diretório nomeado.
Sempre
Selecione os pacotes para instalação. Os pacotes requeridos são desabilitados para a desmarcação.
Sempre
Crie uma um usuário administrativo e determine uma senha. Então, clique em Next.
Sempre
Instale as amostras de iniciação rápida. Selecione Yes e selecione o caminho de instalação. Então, clique em Next.
Caso deseje instalar as amostras de iniciação rápida
Mantenha as seleções default para configurar automaticamente as configurações Maven default e usar o repositório Maven com host publicamente. Então, clique em Next.
Sempre
Mantenha os bindings de porta default e clique em Next.
Sempre
Selecione a opção de iniciação preferida na conclusão do processo de instalação. Então, clique em Next.
Sempre
Selecione No para pular a configuração dos níveis de log. Então, clique em Next.
Sempre
Selecione Perform default configuration e clique Next para continuar.
Sempre
Revise as suas seleções e clique em Next.
Sempre
Quando o progresso da instalação completar, clique em Next.
Sempre
Clique em Next quando o processo encerrar.
Sempre
Aceite o default e clique em Next.
Sempre
Clique em Done.
A instalação está concluída.
Resultado

A instalação foi concluída e o JBoss EAP 6 é instalado na sua máquina de destinação.

3.3. Realize o download e Instalação do JBoss EAP usando o ZIP

3.3.1. Download do JBoss EAP 6 (Instalação ZIP)

Sumário

O JBoss EAP está disponível sob o Red Hat JBoss Developer Program ou o Full Red Hat JBoss Commercial Program. Siga o seguinte procedimento abaixo que coincide com a sua escolha de programa.

Procedimento 3.4. Realize o download do arquivo ZIP a partir do Portal do Cliente sob o Full Red Hat JBoss Commercial Program

Siga este procedimento caso esteja participando do Full Red Hat JBoss Commercial Program. Consulte a Seção 1.4, “Full Red Hat JBoss Commercial Program” para maiores informações.
  1. Abra um navegador e entre no Portal do Cliente Red Hat no https://access.redhat.com.
  2. Clique em Downloads.
  3. Clique em Red Hat JBoss Enterprise Application Platform na lista Product Downloads.
  4. Selecione a versão do JBoss EAP a partir do menu suspenso Version.
  5. Encontre o Red Hat JBoss Enterprise Application Platform 6.x.x na lista e clique na opção Download.
  6. Você será solicitado a salvar o arquivo ZIP a um diretório de sua escolha. Selecione um diretório e salve o arquivo.

Procedimento 3.5. Realize o download do arquivo ZIP a partir do jboss.org sob o Red Hat JBoss Developer Program

Siga este procedimento caso esteja participando do Red Hat JBoss Developer Program. Consulte a Seção 1.3, “Red Hat JBoss Developer Program” para maiores informações sobre este programa.
  1. Abra um navegador da web e acesse este URL: http://www.jboss.org/products/eap/
  2. Clique no link Download JBoss EAP no canto esquerdo da página.
  3. Clique no link ZIP sob a coluna Download para a versão de produto correta.
  4. Você será solicitado a salvar o arquivo ZIP a um diretório de sua escolha. Selecione um diretório e salve o arquivo.
Resultado

O arquivo ZIP do JBoss EAP foi baixado com êxito à máquina de destino.

3.3.2. Instalação do JBoss EAP 6 (Instalação ZIP)

Sumário

Este tópico descreve as etapas para instalar o JBoss EAP 6 usando o arquivo ZIP baixado.

Procedimento 3.6. Instalação do Arquivo ZIP

  1. Mova o arquivo ZIP à localização desejada.

    Mova o arquivo ZIP ao servidor e diretório onde você planeja instalar o JBoss EAP 6. O usuário que irá iniciar e encerrar o servidor deve possuir acesso de leitura e gravação a este diretório.
  2. Use um aplicativo apropriado para extrair o arquivo ZIP à localização desejada.

    Num ambiente do Red Hat Enterprise Linux, use a utilidade unzip para extrair os conteúdos do arquivo ZIP.
    Num ambiente do Microsoft Windows, clique no botão direito do mouse e selecione Extract All.
    Num ambiente do Hewlett-Packard HP-UX, use a utilidade unzip para extrair os conteúdos do arquivo ZIP.
Resultado

O JBoss EAP 6 foi instalado com êxito. 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.4. Realize o Download das Amostras de Código de Iniciação Rápida

3.4.1. Realize o Download das Iniciações Rápidas

Sumário

O JBoss EAP 6 vem com um conjunto compreensivo de amostras de código de iniciação rápida designadas a ajudar usuários a iniciarem a gravação dos aplicativos usando as tecnologias do Java EE 6.

Caso deseje instalar as amostras de iniciação rápida quando instalando o JBoss EAP, você pode pular este tópico. Do contrário, você pode baixá-las agora sob o Red Hat JBoss Developer Program ou Full Red Hat JBoss Commercial Program. Siga o procedimento abaixo que coincide com a escolha de seu programa.

Procedimento 3.7. Realize o download das Iniciações Rápidas a partir do Full Red Hat JBoss Commercial Program

Siga este procedimento caso esteja participando do Full Red Hat JBoss Commercial Program. Consulte a Seção 1.4, “Full Red Hat JBoss Commercial Program” para maiores informações.
  1. Abra um navegador e entre no Portal do Cliente Red Hat no https://access.redhat.com.
  2. Clique em Downloads.
  3. Clique em Red Hat JBoss Enterprise Application Platform na lista Product Downloads.
  4. Selecione a versão do JBoss EAP a partir do menu suspenso Version.
  5. Encontre Red Hat JBoss Enterprise Application Platform 6.x.x Quickstarts na lista e clique na opção Download.
  6. Você será solicitado a salvar o arquivo Zip a um diretório de sua escolha. Selecione um diretório e salve o arquivo.
  7. Descomprime o arquivo num diretório de sua escolha.

Procedimento 3.8. Realize o download das Iniciações Rápidas a partir do Red Hat JBoss Developer Program

Siga este procedimento caso esteja participando do Red Hat JBoss Developer Program. Consulte a Seção 1.3, “Red Hat JBoss Developer Program” para maiores informações sobre este programa.
  1. Abra um navegador da web e acesse este URL: http://www.jboss.org/products/eap/
  2. Clique no link Download JBoss EAP no canto esquerdo da página para exibir a informação do produto baixado.
  3. Clique no link Quickstarts sob Download JBoss EAP para baixar o arquivo Zip contendo as amostras.
  4. Você será solicitado a salvar o arquivo ZIP a um diretório de sua escolha. Selecione um diretório e salve o arquivo.
  5. Descomprime o arquivo num diretório de sua escolha.

Capítulo 4. Instruções pós-instalação

4.1. Determine o Ambiente de Desenvolvimento

4.1.1. Red Hat JBoss Developer Studio

Este guia fornece instruções para o caminho de instalação mais simples do Red Hat JBoss Developer Studio. Consulte o Installation Guide do Red Hat JBoss Developer Studio no https://access.redhat.com/site/documentation/en-US/Red_Hat_JBoss_Developer_Studio/ para os procedimentos de instalação completa.

4.1.2. Red Hat JBoss Developer Studio

  1. Clique no botão Download. Você será solicitado a salvar o arquivo ZIP a um diretório de sua escolha.

4.1.3. Red Hat JBoss Developer Studio

  1. Abra um terminal e navegue ao diretório contendo o arquivo .jar baixado.
  2. Execute o seguinte comando para iniciar o programa do instalador GUI:
    java -jar jbdevstudio-build_version.jar

    Nota

    Alternativamente, é possível clicar duas vezes no arquivo .jar para iniciar o programa de instalação.
  3. Clique em Next para iniciar o processo de instalação.
  4. Selecione Eu aceito os termos deste acordo de licença e clique em Next.
  5. Ajuste o caminho da instalação e clique em Next.

    Nota

    Caso a pasta do caminho de instalação não existir, um aviso aparecerá. Clique em Ok para criar a pasta.
  6. Escolha um JVM ou saia do JVM default selecionado e clique em Next.
  7. O Red Hat JBoss Developer Studio inclui o Red Hat JBoss Enterprise Application Platform. Caso instalado anteriormente, selecione No. Do contrário, selecione Yes para instalá-lo e configurá-lo para uso com o Red Hat JBoss Developer Studio.
  8. Revise os detalhes de instalação e clique em Next.
  9. Clique em Next quando o processo de instalação for finalizado.
  10. Configure os atalhos para o Red Hat JBoss Developer Studio e clique em Next.
  11. Clique em Done.

4.1.4. Red Hat JBoss Developer Studio

Para iniciar o Red Hat JBoss Developer Studio, é possível clicar duas vezes no atalho do desktop criado durante a instalação ou você pode iniciá-lo na linha de comando. Este tópico descreve como iniciar o Red Hat JBoss Developer Studio usando a linha de comando.

Procedimento 4.1. O comando para iniciar o Red Hat JBoss Developer Studio

  1. Abra um terminal e navegue ao diretório de instalação do Red Hat JBoss Developer Studio.
  2. Execute o seguinte comando para iniciar o Red Hat JBoss Developer Studio:
    No Linux:
    [localhost]$ ./jbdevstudio
    No Microsoft Windows
    C:\JBDS_INSTALL_DIRECTORY > jbdevstudio.bat

4.1.5. Adição do JBoss EAP Server usando o Servidor Novo de Definição

Essas instruções assumem que esta é a sua primeira introdução ao Red Hat JBoss Developer Studio e você ainda não adicionou quaisquer servidores do Red Hat JBoss Enterprise Application Platform. O procedimento abaixo adiciona o servidor JBoss EAP usando o assistente Define New Server.

Procedimento 4.2. Adição do servidor

  1. Abra a tab Servers. Caso não haja uma tab Servers, adicione-a ao painel conforme abaixo:
    1. Clique em WindowShow ViewOther....
    2. Selecione Servers a partir da pasta Server e clique OK.
  2. Clique em No servers are available. Click this link to create a new server... ou, caso prefira, clique no botão direito do mouse com o painel do Servidor em branco e selecione NewServer.
    Adição de um novo servidor - Não existem servidores disponíveis

    Figura 4.1. Adição de um novo servidor - Não existem servidores disponíveis

  3. Expanda o JBoss Enterprise Middleware e selecione JBoss Enterprise Application Platform 6.1+. Insira um nome do servidor, por exemplo: "JBoss Enterprise Application Platform 6.4" e clique em Next para criar o período de execução do JBoss e definir o servidor. A próxima vez que você definir um novo servidor, este diálogo irá exibir uma seleção Server runtime environment com a nova definição do período de execução.
    Defina um Novo Servidor

    Figura 4.2. Defina um Novo Servidor

  4. Crie um Adaptador de Servidor para gerenciar a iniciação e interrupção do servidor. Mantenha os defaults e clique em Next.
    Criação de um Novo Adaptador do Servidor

    Figura 4.3. Criação de um Novo Adaptador do Servidor

  5. Insira um nome, por exemplo "JBoss EAP 6.4 Runtime". Sob Home Directory, clique em Browse e navegue a sua localização de instalação do JBoss EAP. Clique em Next.
    Adição de um Novo Ambiente do Período de Execução do Servidor

    Figura 4.4. Adição de um Novo Ambiente do Período de Execução do Servidor

    Nota

    Algumas iniciações rápidas requerem que você execute o servidor com um perfil diferente ou argumentos adicionais. Com o objetivo de implantar a iniciação rápida que requer o perfil full, você deve definir um novo servidor e adicionar um Server Runtime Environment que especifica standalone-full.xml para o Configuration file. Certifique-se de fornecer ao novo servidor um nome descritivo.
  6. Configure os projetos existentes para o novo servidor. Uma vez que você não possui quaisquer projetos neste momento, clique em Finish.
    Modificação dos recursos para o novo servidor do JBoss

    Figura 4.5. Modificação dos recursos para o novo servidor do JBoss

Resultado

O JBoss EAP Runtime Server está listado na tab Servers.

O servidor aparece na lista do servidor

Figura 4.6. O servidor aparece na lista do servidor

4.2. Configure o Maven

4.2.1. Maven

O Apache Maven é uma ferramenta de construção distribuída, usada no desenvolvimento do aplicativo para criar, gerenciar e construir projetos de software. O Maven usa os arquivos de configuração padrão chamados Modelo do Objeto do Projeto, ou POM, que são arquivos para definição de projetos e gerenciamento do processo de construção. Os POMs descrevem o módulo e as dependências do componente, ordem de construção, alvos do empacotamento do projeto resultante e saída usando um arquivo XML. Isto garante que o projeto é construído numa forma correta e uniforme.
O Maven atinge isto pelo uso de um repositório. Um repositório Maven armazena as bibliotecas, plug-ins e outros artefatos de construção do Java. O repositório público default público é Maven 2 Central Repository, no entanto os repositórios podem ser privados e internos numa empresa com o objetivo de compartilhar artefatos comuns entre as equipes de desenvolvimento. Os repositórios estão também disponíveis a partir de parceiros. O JBoss EAP inclui um repositório Maven que contém muitas das solicitações que os desenvolvedores do Java EE normalmente usam para construir aplicativos no JBoss EAP.
Consulte Welcome to Apache Maven para maiores informações sobre o Maven.
Consulte Apache Maven Project - Introduction to Repositories para maiores informações dos repositórios Maven.
Para maiores informações sobre como usar o Maven no JBoss EAP, consulte o capítulo nomeado Maven Guide no Development Guide para o Red Hat JBoss Enterprise Application Platform localizado no Customer Portal a partir do https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/.

4.2.2. Configurações do Maven

Os artefatos e dependências necessárias para construir e implantar os aplicativos ao JBoss EAP 6 contém host num repositório público. Você deve direcionar o Maven para usar este repositório quando construindo seus aplicativos. A maneira de como você realiza isto depende se você planeja usar a linha de comando do Maven ou Red Hat JBoss Developer Studio para construir e implantar os seus aplicativos.
O Red Hat JBoss Developer Studio inclui Maven, de forma que não é necessário realizar o download e instalá-lo separadamente. Caso planeje em usar o Red Hat JBoss Developer Studio para construir e implantar os seus aplicativos, use as seguintes instruções para configurar as configurações do Maven: Seção 4.2.3.1, “Configuração Maven para uso com o Red Hat JBoss Developer Studio”
Caso deseje usar a linha de comando do Maven para construir e implantar os seus aplicativos, você deve primeiramente realizar o download e instalar o Maven usando as seguintes instruções: Seção 4.2.4.1, “Download e Instalação do Maven”. Em seguida, siga essas instruções para configurar as configurações do Maven: Seção 4.2.4.2, “Configuração Maven para Uso com a Linha de Comando”

4.2.3. Configuração do Maven para o Red Hat JBoss Developer Studio

4.2.3.1. Configuração Maven para uso com o Red Hat JBoss Developer Studio

Os artefatos e dependências necessárias para construir e implantar os aplicativos ao Red Hat JBoss Enterprise Application Platform contém host num repositório público. Você deve direcionar o Maven para usar este repositório quando construindo seus aplicativos. Este tópico descreve as etapas para configurar o Maven caso você planeje construir e implantar o aplicativo usando o Red Hat JBoss Developer Studio.
Caso deseje usar a linha de comando Maven para construção e implantação de aplicativos, você pode pular este tópico. Do contrário, por favor siga as seguintes instruções: Seção 4.2.4.2, “Configuração Maven para Uso com a Linha de Comando”.
O Maven é distribuído com o Red Hat JBoss Developer Studio, portanto não é necessário instalá-lo separadamente. No entanto, é necessário configurar o Maven para uso do assistente Java EE Web Project para implantações ao JBoss EAP. O procedimento abaixo demonstra como configurar o Maven para uso com o JBoss EAP pela edição do arquivo de configuração Maven a partir do Red Hat JBoss Developer Studio.

Procedimento 4.3. Configuração do Maven no Red Hat JBoss Developer Studio

  1. Clique em WindowPreferences, expanda o JBoss Tools e selecione JBoss Maven Integration.
    Click Window→Preferences, expand JBoss Tools and select JBoss Maven Integration.

    Figura 4.7. Painel de Integração do JBoss Maven na Janela de Preferências

  2. Clique em Configure Maven Repositories.
  3. Clique em Add Repository para configurar o repositório Maven do JBoss GA Tech Preview. Complete o diálogo Add Maven Repository conforme abaixo:
    1. Determine os valores Profile ID, Repository ID e Repository Name para jboss-ga-repository.
    2. Determine o valor Repository URL para http://maven.repository.redhat.com/techpreview/all.
    3. Selecione a opção Active by default para habilitar o repositório Maven.
    4. Clique em OK.
    Enter Maven profile and repository values.

    Figura 4.8. Adição do Repositório Maven - JBoss Tech Preview

  4. Clique em Add Repository para configurar o repositório Maven do JBoss Early Access. Complete o diálogo Add Maven Repository conforme abaixo:
    1. Determine os valores Profile ID, Repository ID e Repository Name para jboss-earlyaccess-repository.
    2. Determine o valor Repository URL para http://maven.repository.redhat.com/earlyaccess/all/.
    3. Selecione a opção Active by default para habilitar o repositório Maven.
    4. Clique em OK.
    Enter Maven profile and repository values.

    Figura 4.9. Adição do Repositório Maven - JBoss Early Access

  5. Revise os repositórios e clique em Finish.
    Review Maven profile and repository values.

    Figura 4.10. Revisão dos Repositórios Maven

  6. A pergunta "Are you sure you want to update the file 'MAVEN_HOME/settings.xml'?" irá aparecer. Clique em Yes para atualização das configurações. Clique em OK para encerrar o diálogo.
    O repositório Maven do JBoss EAP está agora configurado para uso com o Red Hat JBoss Developer Studio.

4.2.4. Configuração do Maven para a Linha de Comando

4.2.4.1. Download e Instalação do Maven

Caso deseje usar a linha de comando do Maven e implantar os seus aplicativos ao JBoss EAP, você deverá realizar o download e instalar o Maven. Caso planeje usar o Red Hat JBoss Developer Studio para construir os seus aplicativos, é possível pular este procedimento uma vez que o Maven é distribuído com o Red Hat JBoss Developer Studio.
  1. Dirija-se ao Apache Maven Project - Download Maven e realize o download da distribuição mais recente do seu sistema operacional.
  2. Consulte a documentação Maven para informações de como realizar o download e instalar o Apache Maven para seu sistema operacional.

4.2.4.2. Configuração Maven para Uso com a Linha de Comando

Os artefatos e dependências necessárias para construir e implantar aplicativos ao JBoss EAP 6 possuem host num repositório público. Caso deseje planejar o uso do Red Hat JBoss Developer Studio para construir e implantar os aplicativos, você pode ignorar este tópico. Do contrário, siga as seguintes instruções: Seção 4.2.3.1, “Configuração Maven para uso com o Red Hat JBoss Developer Studio”. No entanto, caso planeje usar a linha de comando do Maven, você deve direcionar o Maven para uso do JBoss EAP 6 Maven Repository por todos os seus projetos usando as configurações do Maven.
Existem duas maneiras de configurar as configurações para uso com a linha de comando do Maven.
  • Você pode copiar o arquivo settings.xml pré-configurado que lança as iniciações rápidas.
  • Você pode editar manualmente o arquivo settings.xml Maven.
Este tópico descreve ambos os métodos. Caso você tenha baixado as iniciações rápidas, o primeiro procedimento é a maneira mais simples de realizar as configurações.
Pré-requisitos

Você deve instalar o Maven antes de configurar as configurações. Consulte: Seção 4.2.4.1, “Download e Instalação do Maven” para maiores informações.

Procedimento 4.4. Configure o Maven usando as Configurações lançadas com as Amostras de Iniciação Rápida

As Iniciações Rápidas do Red Hat JBoss Enterprise Application Platform lançam um arquivo settings.xml que é configurado para uso online do repositório Maven do JBoss EAP. Caso tenha baixado as iniciações rápidas, esta é a maneira mais fácil de realizar as configurações.
  1. Este procedimento sobrescreve o arquivo de configurações do Maven existente, de forma que você deve realizar o backup do arquivo settings.xml Maven.
    1. Encontre o diretório de instalação para o seu sistema operacional. Ele normalmente é instalado no diretório USER_HOME/.m2/.
      • Para o Linux ou Mac, ele é: ~/.m2/
      • Para o Windows, ele é: \Documents and Settings\USER_NAME\.m2\ ou \Users\USER_NAME\.m2\
    2. Caso possua um arquivo USER_HOME/.m2/settings.xml existente, renomeie-o ou realize uma cópia de forma que você pode restaurá-lo mais tarde.
  2. Caso você não tenha baixado as iniciações rápidas, siga as seguintes instruções: Seção 3.4.1, “Realize o Download das Iniciações Rápidas”.
  3. Copie o arquivo QUICKSTART_HOME/settings.xml ao diretório USER_HOME/.m2/.
  4. Caso você modifique o arquivo settings.xml enquanto o Red Hat JBoss Developer Studio estiver sendo executado, siga o procedimento no final deste tópico nomeado Refresh the Red Hat JBoss Developer Studio User Settings.

Procedimento 4.5. Edição manual e Configurações Maven para uso online do Repositório Maven do JBoss EAP

É possível adicionar manualmente os perfis do JBoss EAP a um arquivo de configurações Maven existente.
  1. Encontre o diretório de instalação para o seu sistema operacional. Ele normalmente é instalado no diretório USER_HOME/.m2/.
    • Para o Linux ou Mac, ele é ~/.m2/
    • Para o Windows, ele é \Documents and Settings\USER_NAME\.m2\ ou \Users\USER_NAME\.m2\
  2. Caso você não encontrar um arquivo settings.xml, copie o arquivo settings.xml a partir do diretório USER_HOME/.m2/conf/ no diretório USER_HOME/.m2/.
  3. Copie o seguinte XML ao elemento <profiles> do arquivo.
    <!-- Configure the JBoss GA Maven repository -->
    <profile>
      <id>jboss-ga-repository</id>
      <repositories>
        <repository>
          <id>jboss-ga-repository</id>
          <url>http://maven.repository.redhat.com/techpreview/all</url>
          <releases>
            <enabled>true</enabled>
          </releases>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
        </repository>
      </repositories>
      <pluginRepositories>
        <pluginRepository>
          <id>jboss-ga-plugin-repository</id>
          <url>http://maven.repository.redhat.com/techpreview/all</url>
          <releases>
            <enabled>true</enabled>
          </releases>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
        </pluginRepository>
      </pluginRepositories>
    </profile>
    <!-- Configure the JBoss Early Access Maven repository -->
    <profile>
      <id>jboss-earlyaccess-repository</id>
      <repositories>
        <repository>
          <id>jboss-earlyaccess-repository</id>
          <url>http://maven.repository.redhat.com/earlyaccess/all/</url>
          <releases>
            <enabled>true</enabled>
          </releases>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
        </repository>
      </repositories>
      <pluginRepositories>
        <pluginRepository>
          <id>jboss-earlyaccess-plugin-repository</id>
          <url>http://maven.repository.redhat.com/earlyaccess/all/</url>
          <releases>
            <enabled>true</enabled>
          </releases>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
        </pluginRepository>
      </pluginRepositories>
    </profile>
    
    
    Copie o seguinte XML no elemento <activeProfiles> do arquivo settings.xml.
    <activeProfile>jboss-ga-repository</activeProfile>
    <activeProfile>jboss-earlyaccess-repository</activeProfile>
    
    
  4. Caso você modifique o arquivo settings.xml enquanto o Red Hat JBoss Developer Studio estiver sendo executado, siga o procedimento no final deste tópico nomeado Refresh the Red Hat JBoss Developer Studio User Settings.

Procedimento 4.6. Atualize as Configurações do Usuário do Red Hat JBoss Developer Studio

Caso você modificar o arquivo settings.xml enquanto o Red Hat JBoss Developer Studio estiver sendo executado, você deve atualizar as configurações do usuário.
  1. A partir do menu, selecione WindowPreferences.
  2. Na Janela Preferences, expanda o Maven e selecione User Settings.
  3. Clique no botão Update Settings para atualizar as configurações do usuário Maven no Red Hat JBoss Developer Studio.
    Atualização das Configurações do Usuário Maven

    Figura 4.11. Atualização das Configurações do Usuário Maven

Importante

Caso o seu repositório Maven possuir artefatos desatualizados, é possível encontrar um dos seguintes erros de mensagens do Maven quando construindo ou implantando o seu projeto.
  • Falta o artefato ARTIFACT_NAME
  • [ERROR] Falha ao executar a meta no projeto PROJECT_NAME; Não foi possível resolver as dependências para PROJECT_NAME
Para resolver este problema, exclua a versão com cache de seu repositório local para forçar um download dos artefatos Maven mais recentes. O repositório com cache está localizado no seu subdiretório ~/.m2/repository/ no Linux ou no subdiretório %SystemDrive%\Users\USERNAME\.m2\repository\ no Windows.

Capítulo 5. Experimente Isto

5.1. Execução das Iniciações Rápidas

5.1.1. Execução das Iniciações Rápidas no Red Hat JBoss Developer Studio

Esta seção descreve como usar o Red Hat JBoss Developer Studio para implantar as iniciações rápidas e executar os testes Arquillian.

Procedimento 5.1. Importação das iniciações rápidas ao Red Hat JBoss Developer Studio

Cada iniciação rápida lança com o arquivo POM (Project Object Model) que contém informação de configuração e projeto para a iniciação rápida. Usando o arquivo POM, você pode importar facilmente a iniciação rápida ao Red Hat JBoss Developer Studio.

Importante

Caso a pasta do projeto de iniciação rápida estiver localizada no espaço de trabalho IDE quando você importá-la ao Red Hat JBoss Developer Studio, o IDE gera um nome de projeto e o nome do arquivo WAR. Certifique-se de que sua pasta do projeto de iniciação rápida está localizada fora do espaço de trabalho antes de você iniciar!
  1. Caso ainda não tenha realizado, por favor realize os procedimentos descritos na Seção 4.2.4.2, “Configuração Maven para Uso com a Linha de Comando”.
  2. Inicie o Red Hat JBoss Developer Studio.
  3. Selecione FileImport a partir do menu.
  4. Escolha MavenExisting Maven Projects a partir da lista de seleção e clique em Next.
    Importação dos Projetos Maven Existentes

    Figura 5.1. Importação dos Projetos Maven Existentes

  5. Navegue ao diretório da iniciação rápida que você planeja para o teste, por exemplo a iniciação rápida do helloworld e clique em OK. A caixa de lista de Projects é preenchida com o arquivo pom.xml do projeto de iniciação rápida selecionado.
    Seleção dos Projetos Maven

    Figura 5.2. Seleção dos Projetos Maven

  6. Clique em Finish.

Procedimento 5.2. Construção e implementação da iniciação rápida helloworld.

A iniciação rápida helloworld é uma das iniciações rápidas mais simples e é uma ótima maneira de verificar que o servidor do JBoss está configurado e executando corretamente.
  1. Caso você não consiga visualizar a tab Servers ou não tenha definido um servidor, siga as instruções da Seção 4.1.5, “Adição do JBoss EAP Server usando o Servidor Novo de Definição”. Caso planeje implantar uma iniciação rápida que requer o perfil full ou os argumentos de iniciação adicional, certifique-se de criar um servidor no ambiente do período de execução, conforme descrito nas instruções de iniciação rápida.
  2. Clique no botão direito do mouse no projeto jboss-helloworld da tab Project Explorer e selecione Run As. A lista de opções será fornecida. Selecione Run on Server.
    Executar como - Execução no Servidor

    Figura 5.3. Executar como - Execução no Servidor

  3. Selecione JBoss EAP 6.1+ Runtime Server a partir da lista de servidor e clique em Next.
    Execução no Servidor

    Figura 5.4. Execução no Servidor

  4. A próxima tela exibe os recursos que são configurados no servidor. A iniciação rápida jboss-helloworld é configurada. Clique em Finish para implantar a iniciação rápida.
    Modificação dos Recursos Configurados no Servidor

    Figura 5.5. Modificação dos Recursos Configurados no Servidor

  5. Revise os resultados.
    • Na tab Server, o status do JBoss EAP 6.x Runtime Server altera para [Started, Republish].
    • A tab Console do servidor apresenta mensagens detalhando o servidor JBoss EAP 6.x e a implantação da iniciação rápida helloworld.
    • A tab helloworld aparece exibindo o URL http://localhost:8080/jboss-helloworld/HelloWorld e o texto "Hello World!".
    • As seguintes mensagens no Console confirmam a implantação do arquivo jboss-helloworld.war:
      JBAS018210: Register web context: /jboss-helloworld
      JBAS018559: Deployed "jboss-helloworld.war" (runtime-name : "jboss-helloworld.war")
      
      O contexto da web registrado é anexado ao http://localhost:8080 para fornecer acesso ao aplicativo implantado pelo URL usado.
  6. Para certificar-se que a iniciação rápida helloworld foi implantada com êxito ao servidor do JBoss, abra um navegador da web e acesse o aplicativo neste URL: http://localhost:8080/jboss-helloworld

Procedimento 5.3. Execute os testes Arquillian de iniciação rápida bean-validation

Algumas iniciações rápidas não fornecem uma camada de interface e ao invés disto fornecem os testes Arquillian para demonstrar as amostras de código. A iniciação rápida bean-validation é uma amostra de iniciação rápida que fornece testes Arquillian.
  1. Siga o procedimento acima para importar a iniciação rápida do bean-validation no Red Hat JBoss Developer Studio.
  2. Na tab Servers, clique no botão direito do mouse e selecione Start para inciar o servidor JBoss EAP. Caso não possa visualizar a tab Servers ou não tenha definido um servidor, siga as seguintes instruções da Seção 4.1.5, “Adição do JBoss EAP Server usando o Servidor Novo de Definição”.
  3. Clique no botão direito do mouse no projeto jboss-bean-validation tab Project Explorer e selecione Run As. Uma lista de opções será fornecida. Selecione Maven Build.
  4. No campo de entrada Goals do diálogo Edit Configuration, digite: clean test -Parq-jbossas-remote
    Clique em Run.
    Edição da configuração

    Figura 5.6. Edição da configuração

  5. Revise os resultados.
    A tab Console do servidor apresenta mensagens detalhando o início do servidor JBoss EAP e o resultado dos testes Arquillian de iniciação rápida bean-validation.
    -------------------------------------------------------
     T E S T S
    -------------------------------------------------------
    Running org.jboss.as.quickstarts.bean_validation.test.MemberValidationTest
    Tests run: 5, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 2.189 sec
    
    Results :
    
    Tests run: 5, Failures: 0, Errors: 0, Skipped: 0
    
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------
    

5.1.2. Execução das Iniciações Rápidas usando uma Linha Comando

Procedimento 5.4. Construa e Implante as Iniciações Rápidas usando uma Linha Comando

Você pode construir e implantar as iniciações rápidas usando uma linha de comando. Perceba que, quando usando uma linha de comando, você é responsável por iniciar o servidor do JBoss caso seja solicitado.
  1. Caso ainda não realizado, por favor realize as seguintes etapas da Seção 4.2.4.2, “Configuração Maven para Uso com a Linha de Comando”.
  2. Revise o arquivo README.html no diretório raiz das iniciações rápidas.
    Este arquivo contém informações gerais sobre as solicitações do sistema, como configurar o Maven, como adicionar usuários e como executar Iniciações Rápidas. Certifique-se de ler todo este conteúdo antes de começar.
    Além disso, este arquivo contém uma tabela listando as iniciações rápidas disponíveis. A tabela lista cada nome da iniciação rápida e as tecnologias que demonstra. Ela fornece uma descrição rápida de cada iniciação rápida e o nível de experiência requerido para configurá-las. Clique no nome iniciação rápida para maiores informações sobre a iniciação rápida.
    Algumas iniciações rápidas são designadas para aprimorar ou estender outras iniciações rápidas. Essas estão descritas na coluna Prerequisites. Caso uma iniciação rápida listar pré-requisitos, você deverá instalá-las antes de trabalhar com a iniciação rápida.
    Algumas iniciações rápidas requerem a instalação e configuração de componentes opcionais. Não instale componentes a não ser que a iniciação rápida os solicite.
  3. Execute a iniciação rápida helloworld.
    A iniciação rápida helloworld é uma das iniciações rápidas mais simples e é uma ótima maneira de verificar se o servidor do JBoss está configurado e executando corretamente. Abra o arquivo README.html na raiz da iniciação rápida helloworld. Ele contém informações detalhadas de como construir e implantar a iniciação rápida e acessar o aplicativo de execução.
  4. Execute outras iniciações rápidas.
    Siga as seguintes instruções no arquivo README.html localizado na pasta de cada iniciação rápida para executar a amostra.

Apêndice A. Imagens da Tela do Programa de Instalação

A.1. Seleção do Idioma

Choose the desired language for the installation program.

Figura A.1. Seleção do Idioma do Programa de Instalação do JBoss EAP

A.2. Acordo da Licença do Usuário

Agree to the End User License Agreement to continue.

Figura A.2. Acordo da Licença do Usuário do Programa de Instalação do JBoss EAP

A.3. Caminho da Instalação

Define the installation path for the JBoss EAP instance.

Figura A.3. Caminho da Instalação do Programa de Instalação do JBoss EAP

A.4. Seleção de Pacotes para Instalação

Selecione ou cancele a seleção dos pacotes para instalação. Os pacotes solicitados são desabilitados para o cancelamento da seleção.
Seleção de Pacotes para Instalação do Programa de Instalação do JBoss EAP

Figura A.4. Seleção de Pacotes para Instalação do Programa de Instalação do JBoss EAP

A.5. Nova criação de usuário

Create an administrative user.

Figura A.5. Criação do Usuário Administrativo do Programa de Instalação do JBoss EAP

A.6. Instalação de Iniciação Rápida

Install the JBoss EAP quickstarts.

Figura A.6. Configuração de Iniciação Rápida do Programa de Instalação do JBoss EAP

A.7. Configuração do Repositório Maven

Configuração do Repositório Maven do Programa de Instalação do JBoss EAP

Figura A.7. Configuração do Repositório Maven do Programa de Instalação do JBoss EAP

A.8. Configuração Socket Binding

Decida entre usar os default bidings ou configurar os bindings personalizados.
Use the default bindings for standalone and domain mode.

Figura A.8. Socket Bindings Default do Programa de Instalação do JBoss EAP

A.9. Início do Servidor

Select the startup option desired on completion of the installation process.

Figura A.9. Início do Servidor do Programa de Instalação do JBoss EAP

A.10. Configuração dos Níveis de Log

Choose No to skip configuration of logging level.

Figura A.10. A imagem demonstra a ação ignorando a Configuração do Nível de Log do Programa de Instalação do JBoss EAP

A.11. Configuração do Ambiente do Período de Execução

Configuração do Ambiente do Período de Execução do Programa de Instalação do JBoss EAP - Default

Figura A.11. Configuração do Ambiente do Período de Execução do Programa de Instalação do JBoss EAP - Default

A.12. Revisão dos Componentes de Instalação

Review the list of selected components. Click the Next to continue or Previous to go back and make changes.

Figura A.12. Componentes Selecionados para a Revisão do Programa de Instalação do JBoss EAP

A.13. Progresso da Instalação

When the installation progress completes, click Next.

Figura A.13. Progresso da Instalação do Componente do Programa de Instalação do JBoss EAP

A.14. Processamento de Instalação Concluída

Processamento de Instalação Concluída do Programa de Instalação do JBoss EAP

Figura A.14. Processamento de Instalação Concluída do Programa de Instalação do JBoss EAP

A.15. Criação de Atalhos

Choose whether to create shortcuts and how to configure them. Then click Next.

Figura A.15. Criação de Atalhos do JBoss EAP Installer

A.16. Gerando o Script de Instalação

Choose whether to generate an installation script containing the selected install options. Then click Done to finish.

Figura A.16. Gerando o Script de Instalação do Programa de Instalação do JBoss EAP

Apêndice B. Histórico de Revisão

Histórico de Revisões
Revisão 6.4.0-10.1Tue Jun 02 2015Leticia de Lima
Tradução e prova de leitura concluídos da versão do JBoss EAP 6.4
Revisão 6.4.0-10Tuesday April 14 2015Lucas Costi
Red Hat JBoss Enterprise Application Platform 6.4.0.GA

Nota Legal

Copyright © 2015 Red Hat, Inc..
This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, 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, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.