Red Hat Training

A Red Hat training course is available for Red Hat Fuse

Chapter 4. Getting Started with Fuse on JBoss Enterprise Application Platform

4.1. Log in to the Customer Portal

Before you can download the required packages, you need an account on Red Hat’s Customer Portal which has a Red Hat Fuse subscription. Using this account, log in to the portal at https://access.redhat.com/login.

4.2. Download the required packages

Click each of the Download buttons to get the required packages from the Customer Portal:

get started with fuse on eap download devstudio download jboss eap download fuse on eap

4.3. Install and configure Fuse on JBoss EAP

To install and configure Fuse on JBoss EAP, perform the following steps:

  1. Run the JBoss EAP installer from a shell prompt, as follows: 

    java -jar DOWNLOAD_LOCATION/jboss-eap-7.1.0-installer.jar

  2. During installation:

    1. Accept the terms and conditions.
    2. Choose your preferred installation path, EAP_INSTALL, for the JBoss EAP runtime.
    3. Create an administrative user and make a careful note of these administrative user credentials for later.
    4. You can accept the default settings on the remaining screens.
  3. Open a shell prompt and change directory to EAP_INSTALL.

  4. From the EAP_INSTALL directory, run the Fuse on EAP installer, as follows: 

    java -jar DOWNLOAD_LOCATION/fuse-eap-installer-7.2.0.fuse-720018-redhat-00002.jar

4.4. Set up your development environment

To set up your development environment, perform the following steps:

  1. Run the Developer Studio installer, as follows: 

    java -jar DOWNLOAD_LOCATION/devstudio-12.9.0.GA-installer-standalone.jar

  2. During installation:

    1. Accept the terms and conditions.
    2. Choose your preferred installation path.
    3. Select the Java 8 JVM.
    4. At the Select Platforms and Servers step, configure the JBoss EAP runtime by clicking Add and browsing to the location of the EAP_INSTALL directory (see Section 4.3, “Install and configure Fuse on JBoss EAP”).
    5. At the Select Additional Features to Install step, select Red Hat Fuse Tooling.
  3. Developer Studio starts up. When the Searching for runtimes dialog appears, click OK to create the JBoss EAP runtime.

  4. (Optional) In order to use Apache Maven from the command line, you need to install and configure Maven as described in Appendix A, Preparing to use Maven.

    Note

    If you are using Developer Studio exclusively, it is not strictly necessary to install Maven, because Developer Studio has Maven pre-installed and configured for you. But if you plan to invoke Maven from the command line, it is necessary to perform this step.

4.5. Build your first application

To build your first application with Fuse on JBoss EAP, perform the following steps:

  1. In Developer Studio, create a new project, as follows:

    1. Select File→New→Fuse Integration Project.
    2. Enter eap-camel in the Project Name field.
    3. Click Next.

    4. In the Select a Target Environment pane, choose the following settings:

      • Select Standalone as the deployment platform.
      • Select Wildfly/Fuse on EAP as the runtime environment and use the Runtime (optional) dropdown menu to select the JBoss EAP 7.x Runtime server as the target runtime.
    5. After selecting the target runtime, the Camel Version is automatically selected for you and the field is grayed out.
    6. Click Next.
    7. In the Advanced Project Setup pane, select the Spring Bean - Spring DSL template.
    8. Click Finish.
    9. If prompted to open the associated Fuse Integration perspective, click Yes.

    10. Wait while Developer Studio downloads required artifacts and builds the project in the background.

      Important

      If this is the first time you are building a Fuse project in Developer Studio, it will take several minutes for the wizard to finish generating the project, as it downloads dependencies from remote Maven repositories. Do not attempt to interrupt the wizard or close Developer Studio while the project is building in the background.

  2. Deploy the project to the server, as follows:

    1. In the Servers view (bottom left corner of the Fuse Integration perspective), if the server is not already started, select the Red Hat JBoss EAP 7.1 Runtime server and click the green arrow to start it.

    2. Wait until you see a message like the following in the Console view: 

      12:02:25,467 INFO  [org.jboss.as] (Controller Boot Thread) JBAS015874: JBoss EAP 6.4.0.GA (AS 7.5.0.Final-redhat-21) started in 9494ms - Started 480 of 518 services (69 services are lazy, passive or on-demand)
    3. After the server has started, switch back to the Servers view, right-click on the server and select Add and Remove from the context menu.
    4. In the Add and Remove dialog, select the eap-camel project and click the Add > button.
    5. Click Finish.

  3. Verify that the project is working, as follows:

    1. Browse to the following URL to access the service running in the eap-camel project: http://localhost:8080/camel-test-spring?name=Kermit
    2. The browser window should show the response Hello Kermit.

  4. Undeploy the project, as follows:

    1. In the Servers view, select the Red Hat JBoss EAP 7.1 Runtime server.
    2. Right-click on the server and select Add and Remove from the context menu.
    3. In the Add and Remove dialog, select your eap-camel project and click the < Remove button.
    4. Click Finish.