Configuring JBoss Developer Studio for use with JBoss EAP and JBoss Web Framework Kit

Updated -

Red Hat JBoss Developer Studio supports application development and deployment with Red Hat JBoss Enterprise Application Platform and Red Hat JBoss Web Framework Kit. However, you must initially configure JBoss Developer Studio to use it with JBoss EAP and JBoss Web Framework Kit.

Configuring JBoss Developer Studio for JBoss EAP and JBoss Web Framework Kit is essential for using the enterprise versions of the example Maven projects provided in JBoss Central. These projects are intended for deployment to JBoss EAP and necessitate IDE access to the JBoss EAP and JBoss Web Framework Kit Maven repositories.

This article is intended for new and existing JBoss Developer Studio users who need to configure a fresh install of JBoss Developer Studio or upgrade the versions of JBoss EAP or JBoss Web Framework Kit in use. Instructions are provided for the following tasks:

  1. Set up JBoss EAP for use in JBoss Developer Studio in one of three different ways

  2. Configure Maven for JBoss EAP and JBoss Web Framework Kit Maven repositories

1. Set Up JBoss EAP

To set up JBoss EAP for use in JBoss Developer Studio, you must direct the IDE to the local or remote runtime servers. This establishes a communication channel between the IDE and the JBoss EAP server for efficient deployment and server management workflows.

Depending on your circumstance, you can set up the JBoss EAP server in one of three ways:

A. If you are installing a new instance of JBoss Developer Studio, you can use the combined installer to download, install, and set up JBoss Developer Studio and JBoss EAP.

B. If JBoss Developer Studio is already installed but JBoss EAP is not, you can download, install, and set up JBoss EAP from within the IDE.

C. If JBoss Developer Studio and JBoss EAP are already installed, you can use runtime detection to set up JBoss EAP from within the IDE.

A. Download, Install and Set Up JBoss Developer Studio and JBoss EAP using a Single Installer

If you are installing a new instance of JBoss Developer Studio, you can use the combined installer to download, install, and set up JBoss Developer Studio and JBoss EAP. A specific JBoss EAP version is packaged in the installer; for details of the JBoss EAP version see https://access.redhat.com/site/articles/427493.

Note: If you want to install a different JBoss EAP version, you must first install JBoss Developer Studio and then you can download, install, and set up JBoss EAP from within the IDE as detailed later.

To install JBoss Developer Studio and JBoss EAP using a single installer, perform the following steps:

  1. Log onto the Red Hat Customer Portal at https://access.redhat.com.

  2. Locate the downloads for Red Hat JBoss Developer Studio 8.0.0.

  3. Download the Red Hat JBoss Developer Studio 8.0.0 Installer With EAP.jar file.

  4. On the command line, navigate to the downloaded installer .jar file and enter:
    java -jar jboss-devstudio-version-installer-eap.jar
    where version is the version of the .jar file.

  5. In the Red Hat JBoss Developer Studio wizard, click Next.

  6. In the End User License Agreement window, read the terms of the End User License Agreement, click I accept the terms of this license agreement, and then click Next.

  7. In the Select Target Folder window, click Browse to select the location where you want to install JBoss Developer Studio and click Next.

  8. When you are prompted about the specified location being created (or overwritten), review the message and, if satisfied, click OK (or Yes).

  9. In the Select Java VM window, select the appropriate option for your Java VM preference and then click Next:

    • To select the default Java VM that is listed in the disabled field below, click Default Java VM.
    • To select a different Java VM, click Specifc Java VM and then click Browse to locate the Java VM.
  10. In the Select Platforms and Servers window, with reference to installing JBoss EAP, click Yes, and have it ready for use in JBoss Developer Studio and click Next.

    Select Platforms and Servers window confirming the installation of JBoss EAP and having it ready for use from within JBoss Developer Studio

  11. Review the information in the Summary Information window and click Next.

  12. The Installation window opens showing the installation progress. Once the installation is complete click Next.

  13. In the Setup Shortcuts window, click the desired shortcut options and click Next.

  14. In the Finish window, click Done to complete the installation. JBoss Developer Studio starts.

  15. In the Workspace Launcher window, in the Workspace field type the path for a new or existing workspace or click Browse to navigate to a workspace and click OK.

  16. When prompted to allow Red Hat to receive anonymous usage statistics, select the appropriate option.

  17. Click Get started with JBoss Central to begin working with JBoss Developer Studio. The server is listed in the Servers view in stopped mode.

B. Download, Install and Set Up JBoss EAP from within JBoss Developer Studio

If JBoss Developer Studio is already installed, you can download, install, and set up JBoss EAP from within the IDE. With this option, you can choose from a range of supported JBoss EAP versions; for details of supported JBoss EAP versions see https://access.redhat.com/site/articles/427493.

To download, install and set up JBoss EAP from within JBoss Developer Studio, perform the following steps:

  1. Start JBoss Developer Studio.

  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 JBoss Developer Studio.

    Download Runtimes window listing JBoss EAP versions available for downloading and installing

  5. In the JBoss.org Credentials window, in the Username and Password fields, enter your username and password and click Next. Note that if you do not have a JBoss.org account, you must click please sign up here.

  6. In the JBoss.org Terms and Conditions window, read the terms and conditions, from the Please choose the country of use list, select your country of use, and then click Accept Now. If you have previously accepted the terms and conditions in JBoss Developer Studio or through the jboss.org website, this window is skipped.

  7. Click Next.

  8. Read the General Public License, click I accept the terms of the license agreement, and then click Next.

  9. For the Install Folder field, click Browse and choose a location in which to install JBoss EAP and click Finish.

  10. Click Apply and click OK to close the Preferences window. The download and installation starts and may take some time to complete. Once finished, the server is listed in the Servers view in stopped mode.

C. Use Runtime Detection to Set Up JBoss EAP from within JBoss Developer Studio

If JBoss Developer Studio and JBoss EAP are already installed, you can use runtime detection to set up JBoss EAP from within the IDE. The runtime detection feature automatically identifies the JBoss EAP instance installed on your local system and generates a corresponding default server setup for use in JBoss Developer Studio. This feature makes getting started with a default JBoss EAP server very quick.

Note: Specific JBoss EAP versions are supported by each JBoss Developer Studio release; for details of supported JBoss EAP versions see https://access.redhat.com/site/articles/427493.

To use runtime detection to set up JBoss EAP for use in the JBoss Developer Studio, perform the following steps:

  1. Start JBoss Developer Studio.

  2. Click Window > Preferences, expand JBoss Tools, and then select JBoss Runtime Detection.

  3. Click Add.

  4. Navigate to path/to/jboss-eap and click OK. JBoss Server Tools recursively scans the path searching for installed servers and displays a list of those it finds.

  5. Ensure the jboss-eap-version check box is selected, where version denotes the JBoss EAP version, and click OK.

    Searching for runtimes window listing the JBoss EAP version selected for creation

  6. Click Apply and click OK to close the Preferences window. The server is listed in the Servers view in stopped mode.

2. Configure Maven for JBoss EAP and JBoss Web Framework Kit Maven Repositories

To configure Maven to use the JBoss EAP and JBoss Web Framework Kit Maven repositories when working inside JBoss Developer Studio, you must ensure that the IDE knows the location of your Maven configuration settings.xml file and that the necessary profiles for the JBoss EAP and JBoss Web Framework Kit Maven repositories are contained in that file. This ensures that Maven knows where to search for project dependencies when it is called to build Maven projects from within the IDE.

Specify Maven settings.xml File Location

If you have multiple Maven settings.xml files or you are using a shared settings.xml file, then this file may not be in the default location expected by JBoss Developer Studio. In this case, you must inform the IDE of the file location.

To specify the Maven settings.xml file location, perform the following steps:

  1. Start JBoss Developer Studio.

  2. Click Window > Preferences, expand Maven, and then click User Settings.

  3. For the User Settings field, click Browse and locate the settings.xml file.

  4. Click Update Settings.

  5. Click Apply and then click OK.

Specify JBoss EAP and JBoss Web Framework Kit Maven Repositories Locations

If you have not previously used these versions of JBoss EAP and JBoss Web Framework Kit, you must configure your Maven settings.xml file to use the associated product Maven repositories. You can manually edit your settings.xml file in a text editor or use the JBoss Developer Studio Maven integration feature to automatically detect the JBoss repositories and appropriately edit your settings.xml file.

Note: The JBoss EAP and JBoss Web Framework Kit Maven repositories must be already obtained from the Red Hat Customer Portal and located on a system that you can access.

To specify the JBoss EAP and JBoss Web Framework Kit Maven repositories locations using JBoss Developer Studio, perform the following steps:

  1. Start JBoss Developer Studio.

  2. Click Window > Preferences, expand JBoss Tools, and then click JBoss Maven Integration.

  3. Click Configure Maven Repositories.

  4. Click Add Repository.

  5. Click Recognize JBoss Maven Enterprise Repositories.

  6. Navigate to path/to/jboss-eap-maven-repository and click OK. JBoss Maven Tools recursively scans the path searching for a Maven repository.

  7. Modify the information in the ID and Name fields as desired, ensure the Active by default check box is selected, and then click OK.

    Add Maven Repository window showing the details of the selected JBoss EAP version Maven repository

  8. Repeat steps 4 - 7, this time navigating to path/to/jboss-wfk-maven-repository.

  9. Click Finish and at the prompt asking if you are sure you want to update the Maven configuration file click Yes. If the specified configuration file does not exist, JBoss Maven Tools creates it.

  10. Click Apply and click OK to close the Preferences window.

Comments