1. Set up your Dev Environment - 10 minutes

You may install Red Hat CodeReady Studio standalone (A), or also install it with Red Hat JBoss Enterprise Edition (B).

A. Install CodeReady Studio standalone

  1. Install the Java SE Development Kit (JDK) version 8. We recommend using the OpenJDK or the Oracle JDK.
  2. Download the CodeReady Studio standalone installer.

  3. Run the CodeReady Studio installer.

    1. For Mac/Windows development hosts:

      1. Navigate to the folder that contains the downloaded CodeReady Studio JAR file.

      2. Right-click the downloaded installer named 

        codereadystudio-0.0.0.GA-installer-standalone.jar

         (0.0.0 will be replaced by the version number of the installer you downloaded)

      3. Select Open With → Jar Launcher.

    2. For Linux development hosts:

      1. Navigate to the folder that contains the CodeReady Studio JAR file.

      2. Execute the installer (replace the 0.0.0 below with the version number of the installer you downloaded):

        $ java -jar codereadystudio-0.0.0.GA-installer-standalone.jar
    3. Follow the on-screen instructions to continue the installation process.

  4. Start CodeReady Studio. See CodeReady Studio Installation documentation for details.

  5. Configure Maven:

    1. In CodeReady Studio, click Window → Preferences.

    2. Type 'Maven' in the text box to view options related to Maven.

    3. In the results, expand JBoss Tools and click JBoss Maven Integration.

    4. Click Configure Maven Repositories.

    5. Click Add Repository and then click the downward-facing arrow in the Profile ID: field to view the available Maven repositories.

    6. Select redhat-ga-repository from the drop-down list profile as shown in Figure 1. then click OK.

      Select redhat-ga-repository from the drop-down list profile.
      Figure 1. Select redhat-ga-repository from the drop-down list profile.
  6. Click Finish. (Figure 2.)

    Click Finish.
    Figure 2. Click Finish.
  7. Answer Yes when asked about updating the settings.xml file.

B. Install Red Hat JBoss EAP

Once CodeReady Studio is installed (above), you can download, install, and set up JBoss EAP from within the IDE.

To download, install, and set up JBoss EAP from within the IDE:

  1. Start the IDE.
  2. Click Window → Preferences, expand JBoss Tools, and then click JBoss Runtime Detection.
  3. In the Paths pane, click Download.
  4. In the Download Runtimes window from the Download Runtimes table, select the JBoss EAP version that you want to download and click Next. (Figure 3.)

Note: For JBoss EAP 6.1.x and later, continue to follow the steps given here. For JBoss EAP 6.0.x and earlier, follow the on-screen instructions for downloading JBoss EAP from the Red Hat Customer Portal and after JBoss EAP is installed, continue to use runtime detection to set up JBoss EAP from within the IDE.

Download Runtimes Window listing available JBoss EAP versions.
Figure 3. Download Runtimes Window listing available JBoss EAP versions.
  1. In the Credentials window, enter your credentials and click Next.
  2. In the Runtime JBoss EAP_version window, read the terms and conditions, and then click I accept the terms of the license agreement then click Next. Note that if you have previously accepted the terms and conditions in the IDE or through the jboss.org website, you can skip this window.
  3. In the Download Runtime window in the Install Folder field, click Browse and choose a location in which to install JBoss EAP. Click Finish. The Download JBoss EAP window shows the progress of the download.
  4. Click Apply and close.

Result: The server is listed in the Servers view in stopped mode.

 

2. Install, Configure, and Verify - 5 minutes

  1. Note: If the Red Hat Central view is not visible, click the Red Hat icon on the main menu bar.

  2. Type helloworld into the search box and click the helloworld-rs quickstart shown in the result. (Figure 4.)

    Type helloworld into the search box and click the helloworld-rs quick start shown in the result.
    Figure 4. Type helloworld into the search box and click the helloworld-rs quick start shown in the result.
  3. Click Finish. This downloads the helloworld application and its Maven dependencies.

  4. Once all the dependencies are downloaded, a dialog appears to indicate your project is ready. Click Finish.

  5. In the Servers tab, select Red Hat JBoss EAP 7.0 [Stopped] and click the Start the Server icon to start the JBoss EAP server. (Figure 5.)

Click the Start the Server icon to start the JBoss EAP server.
Figure 5. Click the Start the Server icon to start the JBoss EAP server.
  1. Once the server starts, right-click the jboss-helloworld application in the Project Explorer view.

    1. From the menu that appears, select Run as.. and then Run on Server.

    2. Select the newly created JBoss EAP server, click OK then Finish.

This will build, deploy, and run the helloworld application in the JBoss EAP server. The application opens in the internal default CodeReady Studio web browser and presents the Hello World! Success page.

 

3. Build your first CodeReady Studio application - 20 minutes

Follow the below series to build your first application. You will build some simple examples as well as build a TicketMonster Application using JBoss EAP. The TicketMonster application shows you how to build a modern HTML application that communicates using REST. The series walks you through each step of the application development life cycle, from start to finish.

What is JBoss EAP?

JBoss Enterprise Application Platform Overview

Start exploring TicketMonster

Tutorial

 

Want to know more about what you can do with CodeReady Studio?