SwitchYard on Karaf

Version 32

    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

     

    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

     

    FeatureOwnerStatusNotes

    Implementations

    CDIKeithDoneSWITCHYARD-2067
    RulesDavidDoneSWITCHYARD-2068
    BPMDavidDoneSWITCHYARD-2069
    Camel (XML and Java)KeithDoneSWITCHYARD-2070
    BPELRobDoneSWITCHYARD-2071

    Bindings

    AtomTomDoneSWITCHYARD-2072
    FileMageshDoneSWITCHYARD-2073
    FTPMageshDoneSWITCHYARD-2074
    JMSTomoDone

    [SWITCHYARD-2055] SwitchYard conflicts with ActiveMQ on karaf - JBoss Issue Tracker

    SWITCHYARD-2075

    JPA

    TomoDone

    SWITCHYARD-2076

    https://issues.apache.org/jira/browse/KARAF-2188

    MailTomDone

    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.

    SWITCHYARD-2077

    Netty (TCP and UDP)DavidDoneSWITCHYARD-2078
    QuartzTomoDoneSWITCHYARD-2079
    RSSTomDoneSWITCHYARD-2080
    SAPTomoDone

    SWITCHYARD-2081

    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, \

    SQLTomoDoneSWITCHYARD-2082
    SCAKeith DoneSWITCHYARD-2083
    RESTMageshDoneSWITCHYARD-2084
    SOAPMageshDoneSWITCHYARD-2085
    HTTPMageshDoneSWITCHYARD-2086

    Runtime

    Security PolicyDavidDoneSWITCHYARD-2087
    Transaction PolicyTomoDoneSWITCHYARD-2088
    TransformationTomoDoneSWITCHYARD-2089
    ValidationTomoDoneSWITCHYARD-2091
    Admin (JMX)RobDoneSWITCHYARD-2092
    Other
    BindyTomDoneSWITCHYARD-2095
    HL7TomDoneSWITCHYARD-2096

    Fuse

    Fuse Management ConsoleRob
    Fabric endpoints/clusteringKeithClustering is done.
    BlueprintKeith
    OSGi Declarative ServicesKeith
    ActiveMQTomo

    Web Console is available by default at http://localhost:8181/activemqweb/

    caution: [SWITCHYARD-2055] SwitchYard conflicts with ActiveMQ on karaf - JBoss Issue Tracker

    Release ModuleDougDone

    Add module to release project for Karaf artifacts.

    SWITCHYARD-2093

    Tooling
    Bundle PackagingBrianDoneSWITCHYARD-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
        • 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