Guia de Introdução

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

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

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.

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.

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

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

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.

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.

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

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

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.

1. Dirija-se ao https://www.jboss.org/products/devstudio.html.
2. Clique no botão Download. Você será solicitado a salvar o arquivo ZIP a um diretório de sua escolha.

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.

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

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 Window → Show View → Other....
   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 New → Server.
   

   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.
   

   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.
   

   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.
   

   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.
   

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

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

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 File → Import a partir do menu.

4. Escolha Maven → Existing Maven Projects a partir da lista de seleção e clique em Next.
   

   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.
   

   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.

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.
   

   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.
   

   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.
   

   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

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.
   

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

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

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.