Getting Started

Procedure

1. Navigate to https://developers.redhat.com/launch.

2. Click START.

   The launcher wizard prompts you to log in to your Red Hat account.

3. Click the Log in or register button and then log in.
4. On the Launcher page, click the Deploy an Example Application button.
5. On the Create Example Application page, type the name, fuse-circuit-breaker, in the Create Example Application as field.
6. Click Select an Example.

7. In the Example dialog, select the Circuit Breaker option. A Select a Runtime dropdown menu appears.

   1. From the Select a Runtime dropdown, select Fuse.
   2. From the version dropdown menu, select 7.3.0 (Red Hat Fuse) (do not select the 2.21.2 (Community) version).
   3. Click Save.
8. On the Create Example Application page, click Download.
9. When you see the Your Application is Ready dialog, click Download.zip. Your browser downloads the generated booster project (packaged as a ZIP file).
10. Use an archive utility to extract the generated project to a convenient location on your local file system.

Procedure

1. Open a shell prompt and build the project from the command line, using Maven:

   cd fuse-circuit-breaker

   mvn clean package

   After Maven builds the project, it displays a Build Success message.

2. Open a new shell prompt and start the name service, as follows:

   cd name-service

   mvn spring-boot:run -DskipTests -Dserver.port=8081

   As Spring Boot starts up, you should see output similar to the following:

   ...
   2019-05-06 20:19:59.401  INFO 9553 --- [           main] o.a.camel.spring.SpringCamelContext      : Route: route1 started and consuming from: servlet:/name?httpMethodRestrict=GET
   2019-05-06 20:19:59.402  INFO 9553 --- [           main] o.a.camel.spring.SpringCamelContext      : Total 1 routes, of which 1 are started
   2019-05-06 20:19:59.403  INFO 9553 --- [           main] o.a.camel.spring.SpringCamelContext      : Apache Camel 2.21.0.fuse-730078-redhat-00001 (CamelContext: camel-1) started in 0.287 seconds
   2019-05-06 20:19:59.406  INFO 9553 --- [           main] o.a.c.c.s.CamelHttpTransportServlet      : Initialized CamelHttpTransportServlet[name=CamelServlet, contextPath=]
   2019-05-06 20:19:59.473  INFO 9553 --- [           main] b.c.e.u.UndertowEmbeddedServletContainer : Undertow started on port(s) 8081 (http)
   2019-05-06 20:19:59.479  INFO 9553 --- [           main] com.redhat.fuse.boosters.cb.Application  : Started Application in 5.485 seconds (JVM running for 9.841)

3. Open a new shell prompt and start the greetings service, as follows:

   cd greetings-service

   mvn spring-boot:run -DskipTests

   As Spring Boot starts up, you should see output similar to the following:

   ...
   2019-05-06 20:22:19.051  INFO 9729 --- [           main] o.a.c.c.s.CamelHttpTransportServlet      : Initialized CamelHttpTransportServlet[name=CamelServlet, contextPath=]
   2019-05-06 20:22:19.115  INFO 9729 --- [           main] b.c.e.u.UndertowEmbeddedServletContainer : Undertow started on port(s) 8080 (http)
   2019-05-06 20:22:19.123  INFO 9729 --- [           main] com.redhat.fuse.boosters.cb.Application  : Started Application in 7.68 seconds (JVM running for 12.66)

   The greetings service exposes a REST endpoint at the http://localhost:8080/camel/greetings URL.

4. Invoke the REST endpoint by either opening the URL in a web browser or by opening another shell prompt and typing the following curl command:

   curl http://localhost:8080/camel/greetings

   Here is the response:

   {"greetings":"Hello, Jacopo"}

5. To demonstrate the circuit breaker functionality provided by Camel Hystrix, kill the backend name service by typing Ctrl-C in the shell prompt window where the name service is running.

   Now that the name service is unavailable, the circuit breaker kicks in to prevent the greetings service from hanging when it is invoked.

6. Invoke the greetings REST endpoint by either opening http://localhost:8080/camel/greetings in a web browser or by typing the following curl command in another shell prompt window:

   curl http://localhost:8080/camel/greetings

   Here is the response:

   {"greetings":"Hello, default fallback"}

   In the window where the greetings service is running, the log shows the following sequence of messages:

   2019-05-06 20:24:16.952  INFO 9729 --- [-CamelHystrix-2] route2                                   :  Try to call name Service
   2019-05-06 20:24:16.956  INFO 9729 --- [-CamelHystrix-2] o.a.c.httpclient.HttpMethodDirector      : I/O exception (java.net.ConnectException) caught when processing request: Connection refused (Connection refused)
   2019-05-06 20:24:16.956  INFO 9729 --- [-CamelHystrix-2] o.a.c.httpclient.HttpMethodDirector      : Retrying request
   2019-05-06 20:24:16.957  INFO 9729 --- [-CamelHystrix-2] o.a.c.httpclient.HttpMethodDirector      : I/O exception (java.net.ConnectException) caught when processing request: Connection refused (Connection refused)
   2019-05-06 20:24:16.957  INFO 9729 --- [-CamelHystrix-2] o.a.c.httpclient.HttpMethodDirector      : Retrying request
   2019-05-06 20:24:16.957  INFO 9729 --- [-CamelHystrix-2] o.a.c.httpclient.HttpMethodDirector      : I/O exception (java.net.ConnectException) caught when processing request: Connection refused (Connection refused)
   2019-05-06 20:24:16.957  INFO 9729 --- [-CamelHystrix-2] o.a.c.httpclient.HttpMethodDirector      : Retrying request
   2019-05-06 20:24:16.964  INFO 9729 --- [-CamelHystrix-2] route2                                   :  We are falling back!!!!

7. For more information about this example, open the Circuit Breaker - Red Hat Fuse page at http://localhost:8080/ (while the greetings-service is running). This page includes a link to the Hystrix dashboard that monitors the state of the circuit breaker.

Procedure

1. Unpack the downloaded .zip archive file for Fuse on Apache Karaf to a convenient location on your file system, FUSE_INSTALL.

2. Add an administrator user to the Fuse runtime.

   1. Open the FUSE_INSTALL/etc/users.properties file in a text editor.
   2. Delete the # character at the start of the line that starts with #admin = admin.
   3. Delete the # character at the start of the line that starts with #g\:admingroup.

   4. Customize the username, USERNAME, and password, PASSWORD, of the user entry, so that you have a user entry and an admin group entry like the following (on consecutive lines):

      USERNAME = PASSWORD,_g_:admingroup
      _g_\:admingroup = group,admin,manager,viewer,systembundles,ssh

   5. Save the etc/users.properties file.

3. Run the CodeReady Studio installer as follows:

   java -jar DOWNLOAD_LOCATION/codereadystudio-12.12.0.GA-installer-standalone.jar

4. 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 Fuse on Karaf runtime by clicking Add and browsing to the location of the FUSE_INSTALL directory.
   5. At the Select Additional Features to Install step, select Red Hat Fuse Tooling.
5. CodeReady Studio starts up. When the Searching for runtimes dialog appears, click OK to create the Fuse on Karaf runtime.

6. (Optional) In order to use Apache Maven from the command line, you need to install and configure Maven.

   Note

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

Procedure

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

   1. Select File→New→Fuse Integration Project.
   2. Enter fuse-camel-cbr 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 Karaf/Fuse on Karaf as the runtime environment and use the Runtime (optional) dropdown menu to select the Red Had JBoss Middleware> Red Hat Fuse 7+ 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 Beginner→Content Based Router - Blueprint DSL template.
   8. Click Finish.
   9. If prompted to open the associated Fuse Integration perspective, click Yes.

   10. Wait while CodeReady 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 CodeReady 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 CodeReady 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 fuse-karaf-7.4.0.fuse-740028-redhat-00001 Runtime Server server and click the green arrow to start it.

      Note

      If you see the dialog, Warning: The authenticity of host 'localhost' can’t be established., click Yes to connect to the server and access the Karaf console.

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

      Karaf started in 1s. Bundle stats: 12 active, 12 total

   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 fuse-camel-cbr project and click the Add > button.
   5. Click Finish.

   6. You can check whether the project’s OSGi bundle has started up by going to the Terminal view and entering bundle:list | tail. You should see some output like the following:

      ...
      228 │ Active │  80 │ 1.0.0.201505202023          │ org.osgi:org.osgi.service.j
      232 │ Active │  80 │ 1.0.0.SNAPSHOT              │ Fuse CBR Quickstart

3. In the Project Explorer view, click Refresh to see the newly created work/cbr/input directory.
4. Copy the files you find in the project’s src/main/data directory to the work/cbr/input directory.

5. Wait a few moments and then refresh the Project Explorer view again to see the same files organized by country under the work/cbr/output directory:

   1. order1.xml in work/cbr/output/others
   2. order2.xml and order4.xml in work/cbr/output/uk
   3. order3.xml and order5.xml in work/cbr/output/us

6. Undeploy the project, as follows:

   1. In the Servers view, select the Red Hat Fuse 7+ Runtime Server 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 fuse-camel-cbr project and click the < Remove button.
   4. Click Finish.

Procedure

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

   java -jar DOWNLOAD_LOCATION/jboss-eap-7.2.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, apply JBoss EAP 7.2 Update 01. For example:

   bin/jboss-cli.sh "patch apply jboss-eap-7.2.1-patch.zip"

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

   java -jar DOWNLOAD_LOCATION/fuse-eap-installer-7.4.0.jar

6. Run the CodeReady Studio installer, as follows:

   java -jar DOWNLOAD_LOCATION/codereadystudio-12.12.0.GA-installer-standalone.jar

7. 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.
   5. At the Select Additional Features to Install step, select Red Hat Fuse Tooling.
8. CodeReady Studio starts up. When the Searching for runtimes dialog appears, click OK to create the JBoss EAP runtime.

9. (Optional) In order to use Apache Maven from the command line, you need to install and configure Maven.

   Note

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

Procedure

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

   1. Select File→New→Fuse Integration Project.
   2. In the Project Name field, enter eap-camel.
   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.

      Important

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

   9. If prompted to open the associated Fuse Integration perspective, click Yes.
   10. Wait while CodeReady Studio downloads required artifacts and builds the project 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.2 Runtime server and click the green arrow to start it.

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

      14:47:07,283 INFO  [org.jboss.as] (Controller Boot Thread) WFLYSRV0025: JBoss EAP 7.2.0.GA (WildFly Core 6.0.11.Final-redhat-00001) started in 13948ms - Started 495 of 680 services (326 services are lazy, passive or on-demand)

   3. After the server has started, switch back to the Servers view, right-click 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 Add >.
   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.2 Runtime server.
   2. Right-click 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 < Remove.
   4. Click Finish.

Procedure

1. Download the latest version of Maven from the Maven download page.

2. Ensure that your system is connected to the Internet.

   While building a project, the default behavior is that Maven searches external repositories and downloads the required artifacts. Maven looks for repositories that are accessible over the Internet.

   You can change this behavior so that Maven searches only repositories that are on a local network. That is, Maven can run in an offline mode. In offline mode, Maven looks for artifacts in its local repository. See Section 4.3, “Using local Maven repositories”.

Procedure

1. In the project directory that contains the pom.xml file, download a repository for a Maven project by running a command such as the following:

   mvn org.apache.maven.plugins:maven-dependency-plugin:3.1.0:go-offline -Dmaven.repo.local=/tmp/my-project

   In this example, Maven dependencies and plug-ins that are required to build the project are downloaded to the /tmp/my-project directory.

2. Edit the etc/org.ops4j.pax.url.mvn.cfg file to set org.ops4j.pax.url.mvn.offline to true. This enables offline mode:

   ##
   # If set to true, no remote repository will be accessed when resolving artifacts
   #
   org.ops4j.pax.url.mvn.offline = true

3. Distribute this customized Maven offline repository internally to any machines that do not have an Internet connection.