| Apache CXF JAX-WS Failover Demo for OSGi using Blueprint |
| ================= |
| |
| The demo shows a basic usage of the clustering failover feature for JAX-WS |
| services using OSGi environment. |
| |
| Building and running the demo |
| --------------------------------------- |
| The demo consists of two parts: |
| - sample JAX-WS server |
| - sample JAX-WS client which uses failover feature |
| |
| From the base directory of this sample (i.e., where this README file is |
| located), build both projects using Maven using either UNIX or Windows: |
| |
| cd failover_server |
| mvn install |
| |
| cd failover_jaxws_osgi |
| mvn install |
| |
| Starting Karaf (refer to http://karaf.apache.org/manual/latest/quick-start.html) |
| |
| $ bin/karaf |
| __ __ ____ |
| / //_/____ __________ _/ __/ |
| / ,< / __ `/ ___/ __ `/ /_ |
| / /| |/ /_/ / / / /_/ / __/ |
| /_/ |_|\__,_/_/ \__,_/_/ |
| |
| Apache Karaf (4.0.3) |
| |
| Hit '<tab>' for a list of available commands |
| and '[cmd] --help' for help on a specific command. |
| Hit '<ctrl-d>' or type 'system:shutdown' or 'logout' to shutdown Karaf. |
| |
| karaf@root()> |
| |
| In order to install CXF's features, you need to add the CXF's features repo using |
| |
| feature:repo-add cxf 3.n.m |
| |
| where 3.n.m corresponds to a valid CXF version number (e.g., 3.1.5). |
| |
| Install CXF's cxf-jaxws and cxf-features-clustering features: |
| |
| feature:install aries-blueprint cxf-jaxws cxf-features-clustering |
| |
| Install the required bundles: |
| |
| install -s wrap:mvn:org.codeartisans/org.json/20130213 |
| install -s mvn:joda-time/joda-time/2.8.1 |
| install -s mvn:org.qi4j.core/org.qi4j.core.functional/2.1 |
| install -s mvn:org.qi4j.core/org.qi4j.core.api/2.1 |
| install -s mvn:org.qi4j.core/org.qi4j.core.io/2.1 |
| install -s mvn:org.qi4j.core/org.qi4j.core.spi/2.1 |
| install -s mvn:org.qi4j.core/org.qi4j.core.bootstrap/2.1 |
| install -s mvn:org.qi4j.library/org.qi4j.library.jmx/2.1 |
| install -s mvn:org.qi4j.library/org.qi4j.library.circuitbreaker/2.1 |
| |
| Install this demo bundles: |
| install -s mvn:org.apache.cxf.samples/failover_server/3.n.m |
| install -s mvn:org.apache.cxf.samples/failover_jaxws_osgi/3.n.m |
| |
| You can verify if the Apache CXF Blueprint Demo Server and JAX-WS |
| Failover client are installed and started. |
| |
| karaf@root()> list |
| |
| START LEVEL 100 , List Threshold: 50 |
| ID | State | Lvl | Version | Name |
| ----------------------------------------------------------------- |
| 52 | Active | 80 | 3.2.0.SNAPSHOT | Apache CXF Blueprint Demo Server |
| 53 | Active | 80 | 3.2.0.SNAPSHOT | Apache CXF JAX-WS Failover Blueprint Demo |
| |
| karaf@root()> |
| |
| Now, you will be able to access this CXF JAX-WS demo service on your Karaf instance |
| at: |
| |
| http://localhost:8181/cxf/sample |
| |
| The JAX-WS client has been configured to use circuit breaker failover feature and |
| sequential strategy with two addresses: |
| |
| http://localhost:8181/cxf/sample |
| http://localhost:8282/cxf/sample |