This Confluence has been LDAP enabled, if you are an ASF Committer, please use your LDAP Credentials to login. Any problems file an INFRA jira ticket please.

Child pages
  • Installing Tuscany Plugin for Geronimo
Skip to end of metadata
Go to start of metadata
Unable to render {include} The included page could not be found.
Unable to render {include} The included page could not be found.



 

The Tuscany Plugin for Geronimo is being developed and tested on Geronimo v2.1.4.

What this guide is about

TBD

Why use SCA in Geronimo?

TBD

Setup Environment

Installing on Geronimo Tomcat server

Follow the steps below to install the plugin on Geronimo v2.1.4 with Tomcat as the web container.

  1. Edit <GERONIMO_HOME>\var\config\config.xml
    • Add the gbean xml-fragment given in Listing-1 under "org.apache.geronimo.configs/tomcat6-deployer/2.1.4/car" module.
    • Add the gbean xml-fragment given in Listing-2 under "org.apache.geronimo.configs/openejb-deployer/2.1.4/car" module.

      If you are starting with a fresh Geronimo Tomcat 2.1.4 server, you can replace <GERONIMO_HOME>\var\config\config.xml with config.xml available at this link.

  2. Start Geronimo.
  3. Download tuscany-tomcat-1.0-SNAPSHOT.car from http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/tuscany-tomcat/1.0-SNAPSHOT/
  4. Deploy the plugin using the command "<GERONIMO_HOME>\bin\deploy install-plugin tuscany-tomcat-1.0-SNAPSHOT.car". The default username/password to perform the deployment is system/manager.
    Listing-1:
    <gbean name="TomcatWebBuilder">
        <reference name="ModuleBuilderExtensions">
            <pattern>
                <name>TuscanyModuleBuilderExtension</name>
            </pattern>
            <pattern>
               <name>PersistenceUnitBuilder</name>
            </pattern>
            <pattern>
                <name>JspModuleBuilderExtension</name>
            </pattern>
            <pattern>
                <name>MyFacesModuleBuilderExtension</name>
            </pattern>
        </reference>
    </gbean>
    
    Listing-2:
    <gbean name="EJBBuilder">
        <reference name="ModuleBuilderExtensions">
            <pattern>
                <name>Axis2ModuleBuilderExtension</name>
            </pattern>
            <pattern>
                <name>AxisModuleBuilderExtension</name>
            </pattern>
            <pattern>
                <name>CorbaModuleBuilderExtension</name>
            </pattern>
            <pattern>
                <name>TuscanyModuleBuilderExtension</name>
            </pattern>
            <pattern>
                <name>PersistenceUnitBuilder</name>
            </pattern>
            <pattern>
                <name>CXFModuleBuilderExtension</name>
            </pattern>
        </reference>
    </gbean>
    
  5. Download xbean-finder-3.6.jar from http://repo1.maven.org/maven2/org/apache/xbean/xbean-finder/3.6/xbean-finder-3.6.jar and save to <GERONIMO_HOME>\repository\org\apache\xbean\xbean-finder\3.6\ (not needed for Geronimo 2.1.5)
  6. Add the text in Listing-2B to <GERONIMO_HOME>\var\config\artifact-aliases.properties
    Listing-2B:
    org.apache.xbean/xbean-finder/3.5/jar=org.apache.xbean/xbean-finder/3.6/jar
    org.apache.xbean/xbean-finder//jar=org.apache.xbean/xbean-finder/3.6/jar
    
  7. Download openejb-core-3.0.1.jar from this link and replace <GERONIMO_HOME>\repository\org\apache\openejb\openejb-core\3.0.1\openejb-core-3.0.1.jar. Note: This jar is patched to account for OPENEJB-1005. (not needed for Geronimo 2.1.5)

Installing on Geronimo Jetty server

Follow the steps below to install the plugin on Geronimo v2.1.4 with Jetty as the web container.

  1. Edit <GERONIMO_HOME>\var\config\config.xml
    • Add the gbean xml-fragment given in Listing-3 under "org.apache.geronimo.configs/jetty6-deployer/2.1.4/car" module.
    • Add the gbean xml-fragment given in Listing-2 under "org.apache.geronimo.configs/openejb-deployer/2.1.4/car" module.

      If you are starting with a fresh Geronimo Jetty 2.1.4 server, you can replace <GERONIMO_HOME>\var\config\config.xml with config.xml available at this link. NEED TO UPDATE THE FILE AND LINK

  2. Start Geronimo.
  3. Download tuscany-jetty-1.0-SNAPSHOT.car from http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/tuscany-jetty/1.0-SNAPSHOT/
  4. Deploy the plugin using the command "<GERONIMO_HOME>\bin\deploy install-plugin tuscany-jetty-1.0-SNAPSHOT.car". The default username/password to perform the deployment is system/manager.
    Listing-3:
    <gbean name="JettyWebBuilder">
         <reference name="ModuleBuilderExtensions">
            <pattern>
                <name>TuscanyModuleBuilderExtension</name>
            </pattern>
            <pattern>
                <name>PersistenceUnitBuilder</name>
            </pattern>
            <pattern>
                <name>JspModuleBuilderExtension</name>
            </pattern>
            <pattern>
                <name>MyFacesModuleBuilderExtension</name>
            </pattern>
        </reference>
    </gbean>
    
  5. Download xbean-finder-3.6.jar from http://repo1.maven.org/maven2/org/apache/xbean/xbean-finder/3.6/xbean-finder-3.6.jar and save to <GERONIMO_HOME>\repository\org\apache\xbean\xbean-finder\3.6\
  6. Add the text in Listing-2B to <GERONIMO_HOME>\var\config\artifact-aliases.properties
  7. Download openejb-core-3.0.1.jar from this link and replace <GERONIMO_HOME>\repository\org\apache\openejb\openejb-core\3.0.1\openejb-core-3.0.1.jar. Note: This jar is patched to account for OPENEJB-1005.

Building the plugin from source and installing the plugin

This section assumes that you have Subversion and Maven2 installed.

If you want to build the plugin from source and then install the plugin in Geronimo server, follow the steps below.

  1. Checkout the plugin source from http://svn.apache.org/repos/asf/geronimo/plugins/tuscany/trunk/
  2. Open a command window and change to the directory to which source is checked out.
  3. Build the plugin using the command "mvn install"
  4. Edit <GERONIMO_HOME>\var\config\config.xml
    • In Geronimo Tomcat v2.1.4 server
      • Add the gbean xml-fragment given in Listing-1 under "org.apache.geronimo.configs/tomcat6-deployer/2.1.4/car" module.
      • Add the gbean xml-fragment given in Listing-2 under "org.apache.geronimo.configs/openejb-deployer/2.1.4/car" module.
    • In Geronimo Jetty v2.1.4 server
      • Add the gbean xml-fragment given in Listing-3 under "org.apache.geronimo.configs/jetty6-deployer/2.1.4/car" module.
      • Add the gbean xml-fragment given in Listing-2 under "org.apache.geronimo.configs/openejb-deployer/2.1.4/car" module.
  5. Start the Geronimo server.
  6. Access http://localhost:8080/console and navigate to "Plugins" portlet.
  7. Click "Add Repository" link under Install Geronimo Plugins section.
  8. Enter the URL of your local maven2 repository and click "Add Repository" button.
    • For example, if your local maven2 repository directory is D:\m2repo use the URL file:/D:/m2repo
  9. In the "Repository" dropdown list, select your local maven2 repository added in the previous step and click "Show Plugins in selected repository" button.
  10. Select "Geronimo :: Tuscany Plugin for Geronimo Tomcat" ("Geronimo :: Tuscany Plugin for Geronimo Jetty" in case of Geronimo Jetty server) and click Install.
  11. In the plugin information page, click Install to complete the plugin installation.

If your plugin installation failed in an earlier attempt, make sure that "System Modules" portlet does not list "org.apache.geronimo.plugins/tuscany-tomcat/1.0-SNAPSHOT/car" or "org.apache.geronimo.plugins/tuscany-jetty/1.0-SNAPSHOT/car" configuration. If there is one such entry, uninstall it by clicking on "Uninstall" link.

If you want latest plugin and tuscany dependency jars to be installed during plugin installation, make sure you delete <GERONIMO_HOME>/repository/org/apache/geronimo/plugins/geronimo-tuscany* folders and <GERONIMO_HOME>/repository/org/apache/tuscany/sca folder are deleted before you proceed with the installation.

Sample Applications

Deploy helloworld Application

We have a sample sca contribution (helloworld-service) that has three Helloworld service components. The JSP, Servlet and EJB samples access the services provided by this contribution.

Follow the steps below to deploy the helloworld-service.

  1. Download helloworld-service-1.0-SNAPSHOT.jar from http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-service/1.0-SNAPSHOT/
  2. Access http://localhost:8080/console and navigate to "Deploy New" portlet.
  3. In the Archive field, select helloworld-service-1.0-SNAPSHOT.jar downloaded above.
  4. Click Install to install the sca contribution.

Access helloworld From JSP

The sample web application helloworld-jsp has a JSP that defines an SCA reference using SCA JSP tag library. The reference is wired in web.composite. The reference is injected at runtime.

Follow the steps below to run the sample application.

  1. Download helloworld-jsp-1.0-SNAPSHOT.war from http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-jsp/1.0-SNAPSHOT/ and save as helloworld-jsp.war.
  2. Access http://localhost:8080/console and navigate to "Deploy New" portlet.
  3. In the Archive field, select helloworld-jsp.war downloaded above.
  4. Click Install to install the web application.
  5. Access http://localhost:8080/helloworld-jsp/

Access helloworld From Servlet

The sample web application helloworld-servlet has a HelloworldServlet with @Reference, @Property, @Context and @ComponentName annotations. The references are wired in web.composite. The annotated fields are injected at runtime.

Follow the steps below to run the sample application.

  1. Download helloworld-servlet-1.0-SNAPSHOT.war from http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-servlet/1.0-SNAPSHOT/ and save as helloworld-servlet.war
  2. Access http://localhost:8080/console and navigate to "Deploy New" portlet.
  3. In the Archive field, select helloworld-servlet.war downloaded above.
  4. Click Install to install the web application.
  5. Access http://localhost:8080/helloworld-servlet/

anchor:Access helloworld From a session EJB

The sample EJB application helloworld-ejb has a Stateless session bean HelloworldServiceBean with @Reference, @Property, @Context and @ComponentName annotations. The references are wired in ejb-jar.composite. The annotated fields are injected at runtime. The sample web application helloworld-web has a HelloworldEjbServlet that invokes HelloworldServiceBean.

Follow the steps below to run the sample application.

  1. Download helloworld-ejb-1.0-SNAPSHOT.jar from http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-ejb/1.0-SNAPSHOT/
  2. Download helloworld-web-1.0-SNAPSHOT.war from http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-web/1.0-SNAPSHOT/ and save as helloworld-web.war.
  3. Access http://localhost:8080/console and navigate to "Deploy New" portlet.
  4. In the Archive field, select helloworld-ejb-1.0-SNAPSHOT.jar downloaded above.
  5. Click Install to install the ejb application.
  6. In the Archive field, select helloworld-web.war downloaded above.
  7. Click Install to install the web application.
  8. Access http://localhost:8080/helloworld-web/

Access an SCA service from an MDB

The sample EJB application helloworld-mdb-ejb has a message-driven-bean HelloworldMDB that listens on a JMS queue named NamesQueue. HelloworldMDB has @Reference, @Property, @Context and @ComponentName annotations. The references are wired in ejb-jar.composite. The annotated fields are injected at runtime. The sample web application helloworld-mdb-web has a HelloworldMdbServlet that sends the name entered in the webpage as a message to the NamesQueue. Output from HelloworldMDB can be seen in Geronimo console window.

Follow the steps below to run the sample application.

  1. Download jms-resources.xml
  2. Download helloworld-mdb-ejb-1.0-SNAPSHOT.jar from http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-mdb-ejb/1.0-SNAPSHOT/
  3. Download helloworld-mdb-web-1.0-SNAPSHOT.war from http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-mdb-web/1.0-SNAPSHOT/
  4. Access http://localhost:8080/console and navigate to "Deploy New" portlet.
  5. In the Archive field, select <GERONIMO_HOME>\repository\org\apache\geronimo\modules\geronimo-activemq-ra\2.1.4\geronimo-activemq-ra-2.1.4.rar
  6. In the Plan field, select jms-resources.xml downloaded above.
  7. Click Install to complete creating JMS resources.
  8. In the Archive field, select helloworld-mdb-ejb-1.0-SNAPSHOT.jar downloaded above.
  9. Click Install to install the ejb application.
  10. In the Archive field, select helloworld-mdb-web-1.0-SNAPSHOT.war downloaded above.
  11. Click Install to install the web application.
  12. Access http://localhost:8080/helloworld-mdb-web/

Access an SCA service from a Filter

*Note: explain why this is useful from user's prespective. Would users do this?

The sample web application helloworld-filter has a filter HelloworldFilter with @Reference, @Property, @Context and @ComponentName annotations. The references are wired in web.composite. The annotated fields are injected at runtime.

Follow the steps below to run the sample application.

  1. Download helloworld-filter-1.0-SNAPSHOT.war from http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-filter/1.0-SNAPSHOT/
  2. Access http://localhost:8080/console and navigate to "Deploy New" portlet.
  3. In the Archive field, select helloworld-filter-1.0-SNAPSHOT.war downloaded above.
  4. Click Install to install the web application.
  5. Access http://localhost:8080/helloworld-filter/

Access an SCA service from an Event Listener

*Note: explain why users would od this?*

The sample web application helloworld-listener has a ServletContextListener, a ServletContextAttributeListener, a ServletRequestListener, a ServletRequestAttributeListener, an HttpSessionListener, and an HttpSessionAttributeListener with @Reference, @Property, @Context and @ComponentName annotations. The references are wired in web.composite. The annotated fields are injected at runtime.

Follow the steps below to run the sample application.

  1. Download helloworld-listener-1.0-SNAPSHOT.war from http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-listener/1.0-SNAPSHOT/
  2. Access http://localhost:8080/console and navigate to "Deploy New" portlet.
  3. In the Archive field, select helloworld-listener-1.0-SNAPSHOT.war downloaded above.
  4. Click Install to install the web application.
  5. Access http://localhost:8080/helloworld-listener/

Access an SCA service from a JSF managed bean

The sample JSF application helloworld-jsf has a controller class HelloWorldController with @Reference, @Property, @Context and @ComponentName annotations. The references are wired in web.composite. The annotated fields are injected at runtime.

Follow the steps below to run the sample application.

  1. Download helloworld-jsf-1.0-SNAPSHOT.war from http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-jsf/1.0-SNAPSHOT/
  2. Access http://localhost:8080/console and navigate to "Deploy New" portlet.
  3. In the Archive field, select helloworld-jsf-1.0-SNAPSHOT.war downloaded above.
  4. Click Install to install the web application.
  5. Access http://localhost:8080/helloworld-jsf/

A sample that demonstrates a mix of the above features – IN PROGRESS

This sample demonstrates the following features:

  1. An SCA reference in a JSP is wired to an (external) webservice using binding.ws
  2. An SCA reference in a servlet is injected with proxy to a service provided by a regular SCA component which is within the web application.
  3. References in the regular SCA component are wired to other components in the SCA domain and to external webservice using binding.ws
  4. SCA references injected into a session bean.
  • No labels

3 Comments

  1. Hi,

    I have tried installing the above in a Windows environment and I keep getting:

    org.apache.tuscany.sca.contribution.service.ContributionException: java.lang.StringIndexOutOfBoundsException: String index out of range: -1

    With some digging I found the following JIRA, TUSCANY-3165, mentioned that a workaround is available. I was wondering can you share this workaround with me?

  2. Hi,

    The only way I found to workaround the above issue is to compile Gerinom 2.1.4 with the openEJB set to 3.0.2-SNAPSHOT. After that was done I tried to deploy the sample apps, I tried "Access helloworld From a session EJB" as describe above and I get the following exception:

    2009-12-09 15:25:01,772 ERROR [OpenEJB] The bean instance sample.ejb3.HelloworldServiceBean@1fff5e4 threw a system exception:java.lang.NullPointerException
    java.lang.NullPointerException
            at sample.ejb3.HelloworldServiceBean.init(HelloworldServiceBean.java:114)
            at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
            at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
            at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
            at java.lang.reflect.Method.invoke(Method.java:597)
            at org.apache.openejb.core.interceptor.ReflectionInvocationContext$Invocation.invoke(ReflectionInvocationContext.java:158)
            at org.apache.openejb.core.interceptor.ReflectionInvocationContext$LifecycleInvocation.invoke(ReflectionInvocationContext.java:189)
            at org.apache.openejb.core.interceptor.ReflectionInvocationContext.proceed(ReflectionInvocationContext.java:141)
            at org.apache.openejb.core.interceptor.InterceptorStack.invoke(InterceptorStack.java:67)
            at org.apache.openejb.core.stateless.StatelessInstanceManager.getInstance(StatelessInstanceManager.java:190)
            at org.apache.openejb.core.stateless.StatelessContainer.invoke(StatelessContainer.java:156)
            at org.apache.openejb.core.ivm.EjbObjectProxyHandler.businessMethod(EjbObjectProxyHandler.java:217)
            at org.apache.openejb.core.ivm.EjbObjectProxyHandler._invoke(EjbObjectProxyHandler.java:77)
            at org.apache.openejb.core.ivm.BaseEjbProxyHandler.invoke(BaseEjbProxyHandler.java:286)
            at org.apache.openejb.util.proxy.Jdk13InvocationHandler.invoke(Jdk13InvocationHandler.java:49)
            at $Proxy61.getGreetings(Unknown Source)
            at sample.HelloworldEjbServlet.service(HelloworldEjbServlet.java:45)
            at javax.servlet.http.HttpServlet.service(HttpServlet.java:806)
            at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:290)
            at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)
            at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:233)
            at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:191)
            at org.apache.geronimo.tomcat.valve.DefaultSubjectValve.invoke(DefaultSubjectValve.java:56)
            at org.apache.geronimo.tomcat.GeronimoStandardContext$SystemMethodValve.invoke(GeronimoStandardContext.java:406)
    

    Looking at the code, I believe it is due to the fact that the SCA arctifacts (Helloworld) was not found in the the classloader even though I have deploy helloworld-service. Can you help me with this issue?

    1. I have realized that I haven't added the Tomcat deployer extensions properly. Once this is done, I don't have the above exception anymore however I am getting this exception instead:

      2009-12-09 17:37:55,772 WARN  [EmbeddedRuntimeGBean] EmbeddedRuntimeGBean failed. Name=test/helloworld-web/1.0/car?J2EEApplication=null,WebModule=test/helloworld-web/1.0/car,j2eeType=GBean,name=EmbeddedRuntime
      2009-12-09 17:37:55,772 ERROR [GBeanInstanceState] Error while starting; GBean is now in the FAILED state: abstractName=
      "test/helloworld-web/1.0/car?J2EEApplication=null,WebModule=test/helloworld-web/1.0/car,j2eeType=GBean,name=EmbeddedRuntime"
      java.lang.NullPointerException
              at org.apache.tuscany.sca.assembly.builder.impl.BaseConfigurationBuilderImpl.constructBindingURI(BaseConfigurationBuilderImpl.java:1332)
              at org.apache.tuscany.sca.assembly.builder.impl.BaseConfigurationBuilderImpl.constructBindingURI(BaseConfigurationBuilderImpl.java:1313)
              at org.apache.tuscany.sca.assembly.builder.impl.BaseConfigurationBuilderImpl.configureBindingURIs(BaseConfigurationBuilderImpl.java:1151)
              at org.apache.tuscany.sca.assembly.builder.impl.BaseConfigurationBuilderImpl.configureBindingURIsAndNames(BaseConfigurationBuilderImpl.java:906)
              at org.apache.tuscany.sca.assembly.builder.impl.CompositeBindingURIBuilderImpl.build(CompositeBindingURIBuilderImpl.java:65)
              at org.apache.tuscany.sca.assembly.builder.impl.CompositeBuilderImpl.build(CompositeBuilderImpl.java:250)
              at org.apache.tuscany.sca.node.impl.RuntimeBootStrapper.buildComposite(RuntimeBootStrapper.java:255)
              at org.apache.tuscany.sca.host.embedded.impl.EmbeddedSCADomain.buildComposite(EmbeddedSCADomain.java:102)
              at org.apache.geronimo.tuscany.EmbeddedRuntimeGBean.doStart(EmbeddedRuntimeGBean.java:107)
              at org.apache.geronimo.gbean.runtime.GBeanInstance.createInstance(GBeanInstance.java:998)
              at org.apache.geronimo.gbean.runtime.GBeanInstanceState.attemptFullStart(GBeanInstanceState.java:268)
              at org.apache.geronimo.gbean.runtime.GBeanInstanceState.start(GBeanInstanceState.java:102)
              at org.apache.geronimo.gbean.runtime.GBeanInstanceState.startRecursive(GBeanInstanceState.java:124)
              at org.apache.geronimo.gbean.runtime.GBeanInstance.startRecursive(GBeanInstance.java:555)
              at org.apache.geronimo.kernel.basic.BasicKernel.startRecursiveGBean(BasicKernel.java:379)
              at org.apache.geronimo.kernel.config.ConfigurationUtil.startConfigurationGBeans(ConfigurationUtil.java:456)
              at org.apache.geronimo.kernel.config.KernelConfigurationManager.start(KernelConfigurationManager.java:188)
              at org.apache.geronimo.kernel.config.SimpleConfigurationManager.startConfiguration(SimpleConfigurationManager.java:563)
      

      Which lead me to believe, that the SCA artifacts, that is needed by HelloworldServiceBean, still can't be resolved. Can you help me with this issue?