Initial work toward supporting SY on Karaf is taking place on the master branches:
This work is based on Guillaume's initial PRs. We have the initial work merged into master. This page exists to track work in progress, known issues, and TODOs.
Usage
- Download and install Karaf 2.4.x from the Karaf Downloads page.
- Edit $KARAF_HOME/etc/config.properties and add sun.misc to org.osgi.framework.system.packages.extra
- Edit $KARAF_HOME/etc/org.ops4j.pax.url.mvn.cfg and add the following repository to org.ops4j.pax.url.mvn.repositories
- Start karaf with 'bin/karaf’
- Add the SwitchYard features with the following command:
- features:addurl mvn:org.switchyard.karaf/switchyard/2.0.0-SNAPSHOT/xml/features
- Install a quickstart to test our your installation:
- 'features:install switchyard-quickstart-bean-service’ (you can use tab completion to select the quickstart you want)
NB. If you don't have a local build of SwitchYard then you will also need to add https://repository.jboss.org/nexus/content/repositories/snapshots/@snapshots@noreleases@id=jboss-snapshot to the property 'org.ops4j.pax.url.mvn.repositories' in 'apache-karaf-2.4.0/etc/org.ops4j.pax.url.mvn.cfg'
If installing on Fuse, the above instructions apply, however the features url is: mvn:org.switchyard.karaf/switchyard/2.0.0-SNAPSHOT/xml/core-features
The main difference between this features file and the one above is that it does not include repository url's for dependencies. This allows those dependencies to be resolved from the features url's configured with Fuse. (This features file can also be used with Karaf, but you'll need to add the features url's (or chooseurl) for the required dependencies. SY 2.0 is compatible with Fuse 6.2.
TODOs
- Figure out how quickstarts will support Karaf and EAP - two different versions?
- JNDI prefix "osgi:service" is mandatory on karaf so it can't be same as eap's
- Maybe -Pdeploy-karaf or something is needed to be added with using this - http://karaf.apache.org/manual/latest/developers-guide/karaf-maven-plugin.html
Known Issues - as of 2.0.0.Alpha2
- Persistence with jBPM is not working
- Smooks transforms are not working
- MQTT binding is not working
Work in Progress
Feature | Owner | Status | Notes |
---|---|---|---|
Implementations | |||
CDI | Keith | Done | SWITCHYARD-2067 |
Rules | David | Done | SWITCHYARD-2068 |
BPM | David | Done | SWITCHYARD-2069 |
Camel (XML and Java) | Keith | Done | SWITCHYARD-2070 |
BPEL | Rob | Done | SWITCHYARD-2071 |
Bindings | |||
Atom | Tom | Done | SWITCHYARD-2072 |
File | Magesh | Done | SWITCHYARD-2073 |
FTP | Magesh | Done | SWITCHYARD-2074 |
JMS | Tomo | Done | [SWITCHYARD-2055] SwitchYard conflicts with ActiveMQ on karaf - JBoss Issue Tracker |
JPA | Tomo | Done | |
Tom | Done | SWITCHYARD-2064, Also see https://issues.apache.org/jira/browse/CAMEL-6979 after installing the mail quickstart, but that appears to be a JDK 7 issue. | |
Netty (TCP and UDP) | David | Done | SWITCHYARD-2078 |
Quartz | Tomo | Done | SWITCHYARD-2079 |
RSS | Tom | Done | SWITCHYARD-2080 |
SAP | Tomo | Done | Following is needed to be added to the "org.ops4j.pax.url.mvn.repositories" in the $KARAF_HOME/etc/org.ops4j.pax.url.mvn.cfg: https://repository.jboss.org/nexus/content/repositories/fs-releases@id=fusesource.release, \ |
SQL | Tomo | Done | SWITCHYARD-2082 |
SCA | Keith | Done | SWITCHYARD-2083 |
REST | Magesh | Done | SWITCHYARD-2084 |
SOAP | Magesh | Done | SWITCHYARD-2085 |
HTTP | Magesh | Done | SWITCHYARD-2086 |
Runtime | |||
Security Policy | David | Done | SWITCHYARD-2087 |
Transaction Policy | Tomo | Done | SWITCHYARD-2088 |
Transformation | Tomo | Done | SWITCHYARD-2089 |
Validation | Tomo | Done | SWITCHYARD-2091 |
Admin (JMX) | Rob | Done | SWITCHYARD-2092 |
Other | |||
Bindy | Tom | Done | SWITCHYARD-2095 |
HL7 | Tom | Done | SWITCHYARD-2096 |
Fuse | |||
Fuse Management Console | Rob | ||
Fabric endpoints/clustering | Keith | Clustering is done. | |
Blueprint | Keith | ||
OSGi Declarative Services | Keith | ||
ActiveMQ | Tomo | Web Console is available by default at http://localhost:8181/activemqweb/ caution: [SWITCHYARD-2055] SwitchYard conflicts with ActiveMQ on karaf - JBoss Issue Tracker | |
Release Module | Doug | Done | Add module to release project for Karaf artifacts. |
Tooling | |||
Bundle Packaging | Brian | Done | SWITCHYARD-2094 |
Quickstart Status
- Identify and test quickstarts used with SY on Karaf
- Working without modification
- bpel-jms-binding
- bpel-loan-approval
- bpel-say-hello
- bpel-simple-correlation
- bpm-service
- bean-service
- camel-amqp-binding
- camel-atom-binding
- camel-binding
- camel-bindy
- camel-bus-cdi
- camel-ftp-binding
- camel-hl7
- camel-jaxb
- camel-jms-binding
- camel-jpa-binding
- camel-mail-binding
- camel-netty-binding
- camel-quartz-binding
camel-rss-binding
camel-sap-binding
- camel-saxon
- camel-service
camel-sql-binding
- http-binding
- remote-invoker
- rest-binding
- rules-camel-cbr
- rules-interview
- rules-interview-container
- rules-interview-dtable
- soap-addressing
- soap-attachment
- soap-binding-rpc
- soap-mtom
- transform-dozer
- transform-jaxb
- transform-json
- transform-smooks
- transform-xslt
- validate-xml
- demos/policy-security-basic
- demos/policy-security-cert
demos/policy-transaction
- Not Working
- Working without modification
- camel-soap-proxy (no feature definition, soap reference not working on Fuse)
- transform-smooks (fixed after alpha2)
- demos/helpdesk
- demos/multiApp
- demos/policy-security-basic-propagate
- demos/policy-security-wss-signencrypt
- demos/policy-security-wss-username
- Excluded
- bpel-xts-subordinate-wsba
- bpel-xts-wsat
- ear-deployment
- jca-inflow-activemq
- jca-inflow-hornetq
- jca-outbound-activemq
- jca-outbound-hornetq
- demos/cluster
- demos/transaction-propagation
- demos/orders
- demos/policy-security-saml
- demos/webapp-deploy
Comments