Examples working as Karaf features

Author: grgrzybek

README.md

@@ -1,18 +1,18 @@
 <!--
 
-    Copyright 2005-2015 Red Hat, Inc.
+     Copyright 2005-2015 Red Hat, Inc.
 
-    Red Hat licenses this file to you under the Apache License, version
-    2.0 (the "License"); you may not use this file except in compliance
-    with the License.  You may obtain a copy of the License at
+     Red Hat licenses this file to you under the Apache License, version
+     2.0 (the "License"); you may not use this file except in compliance
+     with the License.  You may obtain a copy of the License at
 
-       http://www.apache.org/licenses/LICENSE-2.0
+        http://www.apache.org/licenses/LICENSE-2.0
 
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-    implied.  See the License for the specific language governing
-    permissions and limitations under the License.
+     Unless required by applicable law or agreed to in writing, software
+     distributed under the License is distributed on an "AS IS" BASIS,
+     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+     implied.  See the License for the specific language governing
+     permissions and limitations under the License.
 
 -->
 # Description
@@ -329,6 +329,31 @@ consult the solution [on IBM website](http://www-01.ibm.com/support/docview.wss?
 
 # JBoss Fuse installation and configuration
 
+1. Unzip the `jboss-fuse-full-6.2.0.redhat-060.zip` archive distribution. The target directory `jboss-fuse-6.2.0.redhat-060` will
+    be referred to as `$JBOSS_FUSE_HOME`.
+2. Add the following credentials to `$JBOSS_FUSE_HOME/etc/users.properties`:
+
+        admin=admin,admin,manager,viewer,Operator,Maintainer,Deployer,Auditor,Administrator,SuperUser
+
+3. Start JBoss Fuse:
+
+        $JBOSS_FUSE_HOME/bin/fuse
+
+4. Make sure only one `transaction` bundle is installed:
+
+        JBossFuse:karaf@root> osgi:list -t 0 -s | grep transaction
+        [ 163] [Active     ] [            ] [       ] [   30] org.apache.aries.transaction.manager (1.1.0)
+        [ 164] [Active     ] [Created     ] [       ] [   30] org.apache.aries.transaction.blueprint (1.0.1)
+        [ 190] [Active     ] [            ] [       ] [   50] org.apache.aries.transaction.manager (1.0.0)
+
+    If the above is the case, please uninstall all versions except `1.1.0`:
+
+        JBossFuse:karaf@root> osgi:uninstall 190
+        You are about to access system bundle 190.  Do you wish to continue (yes/no): yes
+
+    (This problem should be fixed in the next version of JBoss Fuse 6.2)
+
+
 # Examples
 
 ## Camel route with 2 transaction managers
@@ -341,6 +366,78 @@ This example is comprised of the following projects:
 
 Ensure you have installed and configured a database server of choice (currently: PostgreSQL)
 
+1. `cd $PROJECT_HOME`
+2. `mvn clean install -Ppostgresql` (or other DB, like `mariadb`, `h2`, `derby`, `db2`, `oracle`)
+3. install features repository:
+
+        features:addurl mvn:org.jboss.fuse.examples.camel-persistence-part2/features/6.2/xml/features
+
+4. install `reportincident-jpa-two` feature:
+
+        features:install -v reportincident-jpa-two
+
+5. make sure relevant bundles are installed:
+
+        JBossFuse:karaf@root> list | grep Examples
+        [ 309] [Active     ] [Created     ] [       ] [   80] JBoss Fuse :: Examples :: Fuse ESB & Persistence :: Datasource (6.2.0)
+        [ 310] [Active     ] [Created     ] [       ] [   80] JBoss Fuse :: Examples :: Fuse ESB & Persistence :: DAO (6.2.0)
+        [ 311] [Active     ] [Created     ] [       ] [   80] JBoss Fuse :: Examples :: Fuse ESB & Persistence :: Camel - 2 Tx Managers (6.2.0)
+
+6. Start PostgreSQL client and observe `REPORT.T_INCIDENT` table:
+
+        $ docker exec -ti fuse-postgresql-server /bin/bash
+        root@b052efff5a53:/# psql -d reportdb -U fuse
+        psql (9.4.0)
+        Type "help" for help.
+
+        reportdb=# select * from report.t_incident order by incident_id asc;
+         incident_id | incident_ref |    incident_date    | given_name | family_name |       summary        |                  details                  |           email           |     phone      |      creation_date      | creation_user
+        -------------+--------------+---------------------+------------+-------------+----------------------+-------------------------------------------+---------------------------+----------------+-------------------------+---------------
+                   1 | 001          | 2015-01-23 00:00:00 | Charles    | Moulliard   | incident webinar-001 | This is a report incident for webinar-001 | [email protected] | +111 10 20 300 |                         |
+                   2 | 002          | 2015-01-24 00:00:00 | Charles    | Moulliard   | incident webinar-002 | This is a report incident for webinar-002 | [email protected] | +111 10 20 300 |                         |
+                   3 | 003          | 2015-01-25 00:00:00 | Charles    | Moulliard   | incident webinar-003 | This is a report incident for webinar-003 | [email protected] | +111 10 20 300 |                         |
+                   4 | 004          | 2015-01-26 00:00:00 | Charles    | Moulliard   | incident webinar-004 | This is a report incident for webinar-004 | [email protected] | +111 10 20 300 |                         |
+        (5 rows)
+
+        reportdb=#
+
+7. Launch JConsole (inside $JAVA_HOME/bin) and connect using the following information:
+
+    * Remote process: `service:jmx:rmi://localhost:44444/jndi/rmi://localhost:1099/karaf-root`
+    * Username: `admin`
+    * Password: `admin`
+
+8. Switch to the MBeans tab at the top. On the left pane, expand the `org.apache.activemq` domain, then
+    navigate to: Broker > amq > Queue. You will see the `incident` and `rollback` queues. The `registerCall`
+    queue will appear when it is first used. For these queues, you will be interested in tracking the
+    `EnqueueCount` attribute.
+
+9. Copy the following files to `$JBOSS_FUSE_HOME/datainsert` and notice the effect in the `registerCall` queue and the `REPORT.T_INCIDENT` table:
+
+    * `$PROJECT_HOME/data/csv-one-record-allok.txt`:
+        * `REPORT.T_INCIDENT` table: new record
+        * `incident` queue: new message enqueued
+        * `rollback` queue: no new messages
+        * `registerCall` queue: new message enqueued
+
+    * `$PROJECT_HOME/data/csv-one-record-failjms-dbok.txt`:
+        * `REPORT.T_INCIDENT` table: new record
+        * `incident` queue: new message enqueued
+        * `rollback` queue: no new messages
+        * `registerCall` queue: no new messages
+
+    * `$PROJECT_HOME/data/csv-one-record-jmsok-faildb.txt`:
+        * `REPORT.T_INCIDENT` table: no record inserted
+        * `incident` queue: no new messages
+        * `rollback` queue: new message enqueued
+        * `registerCall` queue: new message enqueued
+
+    * `$PROJECT_HOME/data/csv-one-record-failjms-faildb.txt`:
+        * `REPORT.T_INCIDENT` table: no record inserted
+        * `incident` queue: no new messages
+        * `rollback` queue: new message enqueued
+        * `registerCall` queue: no new messages
+
 ## Camel route with 1 global transaction manager
 
 This example is comprised of the following projects:
@@ -353,11 +450,20 @@ Ensure you have installed and configured a database server of choice (currently:
 
 To install and test, assuming that you have previously run the "Camel Route with 2 Tx Managers" example above:
 
-1. First uninstall the reportincident-jpa-two feature (TODO)
+1. First uninstall the `reportincident-jpa-two` feature:
+
+        features:uninstall reportincident-jpa-two
+
+2. Install the reportincident-jpa-one feature:
+
+        features:install -v reportincident-jpa-one
 
-2. Install the reportincident-jpa-one feature (TODO)
+3. make sure relevant bundles are installed:
 
-3. Execute the "list" command in the ESB shell and check that the following bundles are Active (TODO)
+        JBossFuse:karaf@root> list | grep Examples
+        [ 314] [Active     ] [Created     ] [       ] [   80] FuseSource :: Examples :: Fuse ESB & Persistence :: Datasource (6.2.0)
+        [ 315] [Active     ] [Created     ] [       ] [   80] FuseSource :: Examples :: Fuse ESB & Persistence :: DAO - JTA (6.2.0)
+        [ 316] [Active     ] [Created     ] [       ] [   80] FuseSource :: Examples :: Fuse ESB & Persistence :: Camel - 1 Tx Manager (6.2.0)
 
 4. Copy the following files to `$JBOSS_FUSE_HOME/datainsert` and notice the new behaviour in the second and third cases, in terms of the registerCall queue and the REPORT.T_INCIDENT table:
 
@@ -368,19 +474,19 @@ To install and test, assuming that you have previously run the "Camel Route with
         * `registerCall` queue: new message enqueued
 
     * `$PROJECT_HOME/data/csv-one-record-failjms-dbok.txt`:
-        * `REPORT.T_INCIDENT` table: new record
+        * `REPORT.T_INCIDENT` table: no record inserted
         * `incident` queue: new message enqueued
         * `rollback` queue: no new messages
         * `registerCall` queue: no new messages
 
-    * `$PROJECT_HOME/data/csv-one-record-failjms-faildb.txt`:
-        * `REPORT.T_INCIDENT` table: new record
+    * `$PROJECT_HOME/data/csv-one-record-jmsok-faildb.txt`:
+        * `REPORT.T_INCIDENT` table: no record inserted
         * `incident` queue: no new messages
         * `rollback` queue: new message enqueued
         * `registerCall` queue: no new messages
 
-    * `$PROJECT_HOME/data/csv-one-record-jmsok-faildb.txt`:
-        * `REPORT.T_INCIDENT` table: new record
+    * `$PROJECT_HOME/data/csv-one-record-failjms-faildb.txt`:
+        * `REPORT.T_INCIDENT` table: no record inserted
         * `incident` queue: no new messages
         * `rollback` queue: new message enqueued
         * `registerCall` queue: no new messages

aggregator/pom.xml

@@ -28,7 +28,7 @@
 
     <groupId>com.fusesource.examples.camel-persistence-part2</groupId>
     <artifactId>aggregator</artifactId>
-    <name>FuseSource :: Examples :: Fuse ESB &amp; Persistence :: Camel - Aggregator</name>
+    <name>JBoss Fuse :: Examples :: Fuse ESB &amp; Persistence :: Camel - Aggregator</name>
 
     <dependencies>
         <dependency>

dao-jta/pom.xml

@@ -1,19 +1,19 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 
-    Copyright 2005-2015 Red Hat, Inc.
+     Copyright 2005-2015 Red Hat, Inc.
 
-    Red Hat licenses this file to you under the Apache License, version
-    2.0 (the "License"); you may not use this file except in compliance
-    with the License.  You may obtain a copy of the License at
+     Red Hat licenses this file to you under the Apache License, version
+     2.0 (the "License"); you may not use this file except in compliance
+     with the License.  You may obtain a copy of the License at
 
-       http://www.apache.org/licenses/LICENSE-2.0
+        http://www.apache.org/licenses/LICENSE-2.0
 
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-    implied.  See the License for the specific language governing
-    permissions and limitations under the License.
+     Unless required by applicable law or agreed to in writing, software
+     distributed under the License is distributed on an "AS IS" BASIS,
+     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+     implied.  See the License for the specific language governing
+     permissions and limitations under the License.
 
 -->
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
@@ -31,7 +31,7 @@
     <artifactId>dao-jta</artifactId>
     <packaging>bundle</packaging>
 
-    <name>FuseSource :: Examples :: Fuse ESB &amp; Persistence :: DAO - JTA</name>
+    <name>JBoss Fuse :: Examples :: Fuse ESB &amp; Persistence :: DAO - JTA</name>
 
     <properties>
         <database />

dao-jta/src/main/resources-filtered/postgresql/META-INF/persistence.xml

@@ -1,19 +1,19 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 
-    Copyright 2005-2015 Red Hat, Inc.
+     Copyright 2005-2015 Red Hat, Inc.
 
-    Red Hat licenses this file to you under the Apache License, version
-    2.0 (the "License"); you may not use this file except in compliance
-    with the License.  You may obtain a copy of the License at
+     Red Hat licenses this file to you under the Apache License, version
+     2.0 (the "License"); you may not use this file except in compliance
+     with the License.  You may obtain a copy of the License at
 
-       http://www.apache.org/licenses/LICENSE-2.0
+        http://www.apache.org/licenses/LICENSE-2.0
 
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-    implied.  See the License for the specific language governing
-    permissions and limitations under the License.
+     Unless required by applicable law or agreed to in writing, software
+     distributed under the License is distributed on an "AS IS" BASIS,
+     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+     implied.  See the License for the specific language governing
+     permissions and limitations under the License.
 
 -->
 <persistence xmlns="http://java.sun.com/xml/ns/persistence"

dao-jta/src/main/resources/OSGI-INF/blueprint/dao-jta.xml

@@ -1,19 +1,19 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 
-    Copyright 2005-2015 Red Hat, Inc.
+     Copyright 2005-2015 Red Hat, Inc.
 
-    Red Hat licenses this file to you under the Apache License, version
-    2.0 (the "License"); you may not use this file except in compliance
-    with the License.  You may obtain a copy of the License at
+     Red Hat licenses this file to you under the Apache License, version
+     2.0 (the "License"); you may not use this file except in compliance
+     with the License.  You may obtain a copy of the License at
 
-       http://www.apache.org/licenses/LICENSE-2.0
+        http://www.apache.org/licenses/LICENSE-2.0
 
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-    implied.  See the License for the specific language governing
-    permissions and limitations under the License.
+     Unless required by applicable law or agreed to in writing, software
+     distributed under the License is distributed on an "AS IS" BASIS,
+     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+     implied.  See the License for the specific language governing
+     permissions and limitations under the License.
 
 -->
 <blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0"

dao/pom.xml

@@ -1,19 +1,19 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 
-    Copyright 2005-2015 Red Hat, Inc.
+     Copyright 2005-2015 Red Hat, Inc.
 
-    Red Hat licenses this file to you under the Apache License, version
-    2.0 (the "License"); you may not use this file except in compliance
-    with the License.  You may obtain a copy of the License at
+     Red Hat licenses this file to you under the Apache License, version
+     2.0 (the "License"); you may not use this file except in compliance
+     with the License.  You may obtain a copy of the License at
 
-       http://www.apache.org/licenses/LICENSE-2.0
+        http://www.apache.org/licenses/LICENSE-2.0
 
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-    implied.  See the License for the specific language governing
-    permissions and limitations under the License.
+     Unless required by applicable law or agreed to in writing, software
+     distributed under the License is distributed on an "AS IS" BASIS,
+     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+     implied.  See the License for the specific language governing
+     permissions and limitations under the License.
 
 -->
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
@@ -31,14 +31,13 @@
     <artifactId>dao</artifactId>
     <packaging>bundle</packaging>
 
-    <name>FuseSource :: Examples :: Fuse ESB &amp; Persistence :: DAO</name>
+    <name>JBoss Fuse :: Examples :: Fuse ESB &amp; Persistence :: DAO</name>
 
     <properties>
         <database />
         <persistence-file>META-INF/persistence.xml</persistence-file>
         <osgi-import-pkg>
-            *,
-            org.apache.openjpa.util
+            *
         </osgi-import-pkg>
         <osgi-export-pkg>
             org.jboss.fuse.examples.persistence.part2.model,

dao/src/main/resources-filtered/postgresql/META-INF/persistence.xml

@@ -1,19 +1,19 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 
-    Copyright 2005-2015 Red Hat, Inc.
+     Copyright 2005-2015 Red Hat, Inc.
 
-    Red Hat licenses this file to you under the Apache License, version
-    2.0 (the "License"); you may not use this file except in compliance
-    with the License.  You may obtain a copy of the License at
+     Red Hat licenses this file to you under the Apache License, version
+     2.0 (the "License"); you may not use this file except in compliance
+     with the License.  You may obtain a copy of the License at
 
-       http://www.apache.org/licenses/LICENSE-2.0
+        http://www.apache.org/licenses/LICENSE-2.0
 
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-    implied.  See the License for the specific language governing
-    permissions and limitations under the License.
+     Unless required by applicable law or agreed to in writing, software
+     distributed under the License is distributed on an "AS IS" BASIS,
+     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+     implied.  See the License for the specific language governing
+     permissions and limitations under the License.
 
 -->
 <persistence xmlns="http://java.sun.com/xml/ns/persistence"