CodeReady Studio

You may install 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 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 and then click OK.

      

6. Click Finish.

   

7. Answer Yes when asked about updating the settings.xml file.

B. Install 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.

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.

Figure 2.2. Download Runtimes Window Listing Available JBoss EAP Versions

5. In the Credentials window, enter your credentials and click Next.

6. In the Runtime JBoss EAP_version window, read the terms and conditions, and then click I accept the terms of the license agreement and then click Next. Note that if you have previously accepted the terms and conditions in the IDE or through the jboss.org website, this window is skipped.

7. In the Download Runtime window, in the Install Folder field, click Browse and choose a location in which to install JBoss EAP and click Finish. The Download JBoss EAP window shows the progress of the download.

8. Click Apply and Close to close the Preferences window.

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

To verify that CodeReady Studio and JBoss EAP are working correctly, deploy and execute the helloworld quickstart application in the JBoss EAP server you will now create and configure:

In CodeReady Studio, Open the Red Hat Central view.

1. Note: If the Red Hat Central view is not visible, click the

    icon on the main menu bar.

2. Type helloworld into the search box and click the helloworld-rs quickstart 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 tell you that 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.

   

6. 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 and 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.

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 with a Java EE backend using REST. The series walks you through each step of the application development lifecycle, from start to finish.