Getting Started Guide

Procedure 3.1. Download the JBoss EAP Installation Program from the Customer Portal under the Full Red Hat JBoss Commercial Program

1. Open a browser and log into the Customer Portal at https://access.redhat.com.
2. Click Downloads.
3. Click Red Hat JBoss Enterprise Application Platform in the Product Downloads list.
4. Select the correct JBoss EAP version from the Version drop-down menu.
5. Find Red Hat JBoss Enterprise Application Platform 6.x.x Installer in the list and click the Download option.
6. You are prompted to save the JAR file to a directory of your choice. Choose a directory and save the file.

Procedure 3.2. Download the JBoss EAP Installation Program from jboss.org under the Red Hat JBoss Developer Program

1. Open a browser and access the following URL: http://www.jboss.org/products/eap.
   • To download the installation program for current GA shipping version of the product, click the Download button on the right side of the page.
   • Follow these steps to choose an alternate version, which may include the latest Alpha or Beta releases, as well as previous versions of the product.
     1. Click the Download JBoss EAP link on the left side of the page.
     2. Click the Installer link under the Download column for the correct product version.
2. You are prompted to save the JAR file to a directory of your choice. Choose a directory and save the file.

Procedure 3.3. Run the JBoss EAP Installation Program

1. Open a terminal and navigate to the directory containing the downloaded installation program JAR.
2. Type the following command:

   java -jar jboss-eap-6.x.x-installer.jar

   Copy to Clipboard Toggle word wrap

   Note

   In the Hewlett-Packard HP-UX or Solaris environment, you can specify the required architecture by using the -d32/-d64 switch. Launch the installer by executing either of these commands:

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

   Copy to Clipboard Toggle word wrap

   or

   java -jar -d32 jboss-eap-6.x.x-installer.jar

   Copy to Clipboard Toggle word wrap
3. Follow the instructions in the table below.

Procedure 3.4. Text-based Install Process

1. Open a terminal and navigate to the directory containing the downloaded installation program JAR.
2. Launch the Text-based installer by executing the following command:

   java -jar jboss-eap-6.x.x-installer.jar -console

   Copy to Clipboard Toggle word wrap
3. Follow the steps to install JBoss EAP 6.

Procedure 3.5. Download the ZIP file from the Customer Portal under the Full Red Hat JBoss Commercial Program

1. Open a browser and log into the Red Hat Customer Portal at https://access.redhat.com.
2. Click Downloads.
3. Click Red Hat JBoss Enterprise Application Platform in the Product Downloads list.
4. Select the correct JBoss EAP version from the Version drop-down menu.
5. Find Red Hat JBoss Enterprise Application Platform 6.x.x in the list and click the Download option.
6. You are prompted to save the ZIP file to a directory of your choice. Choose a directory and save the file.

Procedure 3.6. Download the ZIP file from jboss.org under the Red Hat JBoss Developer Program

1. Open a web browser and access this URL: http://www.jboss.org/products/eap/
2. Click the Download JBoss EAP link on the left side of the page.
3. Click the ZIP link under the Download column for the correct product version.
4. You are prompted to save the ZIP file to a directory of your choice. Choose a directory and save the file.

Procedure 3.7. ZIP File Installation

1. Move the ZIP archive to the desired location.

   Move the ZIP file to the server and directory where you plan to install JBoss EAP 6. The user who will start and stop the server must have read and write access to this directory.

2. Use an appropriate application to extract the ZIP archive to the desired location.

   In a Red Hat Enterprise Linux environment, use the unzip utility to extract the contents of the ZIP archive.
   In a Microsoft Windows environment, right-click the file and select Extract All.
   In a Hewlett-Packard HP-UX environment, use the unzip utility to extract the contents of the ZIP archive.

Procedure 3.8. Download the Quickstarts under the Full Red Hat JBoss Commercial Program

1. Open a browser and log into the Red Hat Customer Portal at https://access.redhat.com.
2. Click Downloads.
3. Click Red Hat JBoss Enterprise Application Platform in the Product Downloads list.
4. Select the correct JBoss EAP version from the Version drop-down menu.
5. Find Red Hat JBoss Enterprise Application Platform 6.x.x Quickstarts in the list and click the Download option.
6. You are prompted to save the Zip file to a directory of your choice. Choose a directory and save the file.
7. Unzip the archive in a directory of your choosing.

Procedure 3.9. Download the Quickstarts under the Red Hat JBoss Developer Program

1. Open a web browser and access this URL: http://www.jboss.org/products/eap/
2. Click the Download JBoss EAP link on the left side of the page to display product download information.
3. Under Download JBoss EAP, click the Quickstarts link to download a Zip archive containing the examples.
4. You are prompted to save the ZIP file to a directory of your choice. Choose a directory and save the file.
5. Unzip the archive in a directory of your choosing.

1. Go to https://www.jboss.org/products/devstudio.html.
2. Click the Download button. You are prompted to save the ZIP file to a directory of your choice.

1. Open a terminal and navigate to the directory containing the downloaded .jar file.
2. Run the following command to launch the GUI installation program:

   java -jar jboss-devstudio-build_version-installer-eap.jar

   Copy to Clipboard Toggle word wrap

   Note

   Alternatively, you may be able to double-click the .jar file to launch the installation program.
3. Click Next to start the installation process.
4. Select I accept the terms of this license agreement and click Next.
5. Adjust the installation path and click Next.

   Note

   If the installation path folder does not exist, a prompt will appear. Click Ok to create the folder.
6. Choose a JVM, or leave the default JVM selected, and click Next.
7. Red Hat JBoss Developer Studio includes Red Hat JBoss Enterprise Application Platform. If it was previously installed, choose No. Otherwise, choose Yes to install and configure it for use with Red Hat JBoss Developer Studio.
8. Review the installation details, and click Next.
9. Click Next when the installation process is complete.
10. Configure the desktop shortcuts for Red Hat JBoss Developer Studio, and click Next.
11. Click Done.

Procedure 4.1. Command to start Red Hat JBoss Developer Studio

1. Open a terminal and navigate to the Red Hat JBoss Developer Studio installation directory.
2. Run the following command to start Red Hat JBoss Developer Studio:
   For Linux:

   [localhost]$ ./jbdevstudio

   Copy to Clipboard Toggle word wrap
   For Microsoft Windows:

   C:\JBDS_INSTALL_DIRECTORY > jbdevstudio.bat

   Copy to Clipboard Toggle word wrap

Procedure 4.2. Add the server

1. Open the Servers tab. If there is no Servers tab, add it to the panel as follows:
   1. Click Window → Show View → Other....
   2. Select Servers from the Server folder and click OK.
2. Click on No servers are available. Click this link to create a new server... or, if you prefer, right-click within the blank Server panel and select New → Server.
   

   Figure 4.1. Add a new server - No servers available

3. Expand JBoss Enterprise Middleware and choose JBoss Enterprise Application Platform 6.1+. Enter a server name, for example, "JBoss Enterprise Application Platform 6.4", then click Next to create the JBoss runtime and define the server. The next time you define a new server, this dialog displays a Server runtime environment selection with the new runtime definition.
   

   Figure 4.2. Define a New Server

4. Create a Server Adapter to manage starting and stopping the server. Keep the defaults and click Next.
   

   Figure 4.3. Create a New Server Adapter

5. Enter a name, for example "JBoss EAP 6.4 Runtime". Under Home Directory, click Browse and navigate to your JBoss EAP install location. Then click Next.
   

   Figure 4.4. Add New Server Runtime Environment

   Note

   Some quickstarts require that you run the server with a different profile or additional arguments. To deploy a quickstart that requires the full profile, you must define a new server and add a Server Runtime Environment that specifies standalone-full.xml for the Configuration file. Be sure to give the new server a descriptive name.
6. Configure existing projects for the new server. Because you do not have any projects at this point, click Finish.
   

   Figure 4.5. Modify resources for the new JBoss server

Procedure 5.1. Import the quickstarts into Red Hat JBoss Developer Studio

1. If you have not yet done so, Section 4.2.4.2, “Configure the Maven Settings for Use with Command Line”.

2. Start Red Hat JBoss Developer Studio.

3. From the menu, select File → Import.

4. In the selection list, choose Maven → Existing Maven Projects, then click Next.
   

   Figure 5.1. Import Existing Maven Projects

5. Browse to the directory of the quickstart you plan to test, for example the helloworld quickstart, and click OK. The Projects list box is populated with the pom.xml file of the selected quickstart project.
   

   Figure 5.2. Select Maven Projects

6. Click Finish.

Procedure 5.2. Build and Deploy the helloworld quickstart

1. If you do not see a Servers tab or have not yet defined a server, follow the instructions here: Section 4.1.5, “Add the JBoss EAP Server Using Define New Server”. If you plan to deploy a quickstart that requires the full profile or additional startup arguments, be sure to create the server runtime environment as noted in the quickstart instructions.
2. Right-click on the jboss-helloworld project in the Project Explorer tab and select Run As. You are provided with a list of choices. Select Run on Server.
   

   Figure 5.3. Run As - Run on Server

3. Select JBoss EAP 6.1+ Runtime Server from the server list and click Next.
   

   Figure 5.4. Run on Server

4. The next screen displays the resources that are configured on the server. The jboss-helloworld quickstart is configured for you. Click Finish to deploy the quickstart.
   

   Figure 5.5. Modify Resources Configured on the Server

5. Review the results.

   • In the Server tab, the JBoss EAP 6.x Runtime Server status changes to [Started, Republish] .
   • The server Console tab shows messages detailing the JBoss EAP 6.x server start and the helloworld quickstart deployment.
   • A helloworld tab appears displaying the URL http://localhost:8080/jboss-helloworld/HelloWorld and the text "Hello World!".
   • The following messages in the Console confirm deployment of the jboss-helloworld.war file:

     JBAS018210: Register web context: /jboss-helloworld
     JBAS018559: Deployed "jboss-helloworld.war" (runtime-name : "jboss-helloworld.war")
     

     Copy to Clipboard Toggle word wrap

     The registered web context is appended to http://localhost:8080 to provide the URL used to access the deployed application.
6. To verify the helloworld quickstart deployed successfully to the JBoss server, open a web browser and access the application at this URL: http://localhost:8080/jboss-helloworld

Procedure 5.3. Run the bean-validation quickstart Arquillian tests

1. Follow the procedure above to import the bean-validation quickstart into Red Hat JBoss Developer Studio.
2. In the Servers tab, right-click on the server and choose Start to start the JBoss EAP server. If you do not see a Servers tab or have not yet defined a server, follow the instructions here: Section 4.1.5, “Add the JBoss EAP Server Using Define New Server”.
3. Right-click on the jboss-bean-validation project in the Project Explorer tab and select Run As. You are provided with a list of choices. Select Maven Build.
4. In the Goals input field of the Edit Configuration dialog, type: clean test -Parq-jbossas-remote
   Then click Run.
   

   Figure 5.6. Edit Configuration

5. Review the results.
   The server Console tab shows messages detailing the JBoss EAP server start and the output of the bean-validation quickstart Arquillian tests.

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

   Copy to Clipboard Toggle word wrap

Procedure 5.4. Build and Deploy the Quickstarts Using a Command Line

1. If you have not yet done so, Section 4.2.4.2, “Configure the Maven Settings for Use with Command Line” .
2. Review the README.html file in the root directory of the quickstarts.
   This file contains general information about system requirements, how to configure Maven, how to add users, and how to run the Quickstarts. Be sure to read through it before you get started.
   It also contains a table listing the available quickstarts. The table lists each quickstart name and the technologies it demonstrates. It gives a brief description of each quickstart and the level of experience required to set it up. For more detailed information about a quickstart, click on the quickstart name.
   Some quickstarts are designed to enhance or extend other quickstarts. These are noted in the Prerequisites column. If a quickstart lists prerequisites, you must install them first before working with the quickstart.
   Some quickstarts require the installation and configuration of optional components. Do not install these components unless the quickstart requires them.
3. Run the helloworld quickstart.
   The helloworld quickstart is one of the simplest quickstarts and is a good way to verify that the JBoss server is configured and running correctly. Open the README.html file in the root of the helloworld quickstart. It contains detailed instructions on how to build and deploy the quickstart and access the running application
4. Run the other quickstarts.
   Follow the instructions in the README.html file located in the root folder of each quickstart to run the example.