Jump to: navigation, search

Difference between revisions of "Virgo/FAQ"

(Why is there both a config and a configuration directory?)
(Why is there both a config and a configuration directory?)
Line 95: Line 95:
 
= Why is there both a config and a configuration directory? =
 
= Why is there both a config and a configuration directory? =
  
The <tt>config</tt> directory has always contained Virgo configuration files. When Virgo Nano and its support for p2 provisioning was introduced, a <tt>configuration</tt> directory was added (see [https://bugs.eclipse.org/bugs/show_bug.cgi?id=324991 bug 324991] for details). The directory name <tt>configuration</tt> is hard-coded in p2.
+
The <tt>config</tt> directory has always contained Virgo configuration files. When Virgo Nano and its support for p2 provisioning was introduced in Virgo 3.5.0, a <tt>configuration</tt> directory was added (see [https://bugs.eclipse.org/bugs/show_bug.cgi?id=324991 bug 324991] for details). The directory name <tt>configuration</tt> is hard-coded in p2.
  
 
The Configuration chapter of the Virgo User Guide makes it clear which configuration goes in each directory.
 
The Configuration chapter of the Virgo User Guide makes it clear which configuration goes in each directory.

Revision as of 11:13, 3 January 2012

How can I diagnose class loading problems?

Use the class loading commands in Virgo as described in this blog.

What's a uses constraint and what can I do if one is violated?

Uses constraints are explained in this blog.

Virgo typically produces helpful diagnostics for uses constraint violations. To solve uses constraint violations, see Rob Harrop's blog and Neil Bartlett's blog.

How can I import a package into someone else's bundle without hacking the manifest?

See this blog.

What support does Virgo have for thread context class loaders?

See this blog.

Are Virgo bundles published to a Maven Repo anywhere.

Yes, they are available over http from http://build.eclipse.org/rt/virgo/maven/bundles/

How can I get a graphical application to work in Virgo?

To get GUI apps to work in Virgo, you have to edit lib/java6-server.profile in order to add some packages to the org.osgi.framework.bootdelegation property.

On Mac, you need to add some Apple packages:

org.osgi.framework.bootdelegation = \
 org.eclipse.virgo.osgi.extensions.*,\
 org.eclipse.virgo.osgi.launcher.*,\
 org.eclipse.virgo.kernel.authentication,\
 com.sun.*,\
 javax.xml.*,\
 org.apache.xerces.jaxp.*,\
 org.w3c.*,\
 org.xml.*,\
 sun.*,\
 apple.*,\
 com.apple.*

On Windows, you just need to add com.sun.* as sun.* is already in the list.

org.osgi.framework.bootdelegation = \
 org.eclipse.virgo.osgi.extensions.*,\
 org.eclipse.virgo.osgi.launcher.*,\
 org.eclipse.virgo.kernel.authentication,\
 com.sun.*,\
 javax.xml.*,\
 org.apache.xerces.jaxp.*,\
 org.w3c.*,\
 org.xml.*,\
 sun.*,\
 com.sun.*

How can I change the version of Spring framework in the user region?

You can upgrade or downgrade the version of Spring framework in the user region provided the new version satisfies the version range required by Virgo. Virgo 3.0.x can use 3.0.x versions of Spring framework.

To upgrade or downgrade, delete the Spring framework bundles and .libd file in repository/ext and then add the corresponding bundles and .libd file for the replacement version of Spring framework. The Spring framework bundles are listed in the .libd file if you are uncertain about which they are. Then re-start Virgo with the -clean switch and the user region should now run with the replacement version of Spring framework.

Here's an example of upgrading Spring framework on a UNIX system:

cd repository/ext/
rm org.springframework.*-3.0.5.RELEASE.*
cp /.../spring-framework-3.0.6/dist/org.springframework.* .

Note that it is not necessary to change the version of Spring framework used by the Virgo kernel as that version is independent of the version of Spring framework used by the user region.

If you want to use Spring framework version less than 3.0 (for instance 2.5.6.SEC2) you will have to use Virgo 2.1.x or Virgo Jetty Server 3.0. The reason for this is that Virgo Tomcat Server 3.0.x ships with Tomcat 7 and Servlet 3.0, while Spring framework 2.5.6 import range allows maximum Servlet 2.5 and this makes the two incompatible.

How can I programmatically deploy applications to Virgo?

This can be achieved using the MBeans registered by Virgo. It's best to explore them first using something like JConsole. The deployer MBean can be used to specify an artifact with a URI that should be deployed (installed and started). Prefixes "file:" and "repository:" can be used. In the case of repository a URL of the form "repository://type/name[/version]" will refer to an artifact in a provisioning repository. The square brackets indicate that the trailing "/version" is optional, in which case Virgo uses the highest version available, and are not part of the URL. In the case of a bundle, "type" is "bundle" and "name" is the bundle symbolic name (and if "version" is specified, it is the bundle version).

Note that you can also install bundles using BundleContext.installBundle and they will be installed in the same region as the bundle whose bundle context was used to perform the install. However, bundles installed in this way will not pass through the Virgo deployment pipeline and will not be subject to the transformations normally applied to bundles as they are deployed in Virgo.

My Web Application Bundle stopped working when I moved to Virgo 3.x. What happened?

Virgo Tomcat Server 3.0 conforms more strictly to the OSGi web applications specification and does not apply default values to some of the manifest headers of a WAB like it used to in Virgo 2.x.

You can easily check whether this is the problem as follows.

As a migration aid, which may be removed in future releases, the previous behaviour may be re-instated by configuring the Web Integration Layer. Please note there is a known issue with certain WAR files which may be worked around using this migration aid.

Should I put Spring XML files in META-INF/spring or WEB-INF?

You should put Spring application context XML configuration files in the WEB-INF directory of a web application bundle and in the META-INF/spring directory of a non-web bundle.

Putting these files in the META-INF/spring directory of a web application bundle is a common mistake and produces unpredictable results since Spring DM will attempt to build an application context independently of, and asynchronously from, the web application.

Why is there both a config and a configuration directory?

The config directory has always contained Virgo configuration files. When Virgo Nano and its support for p2 provisioning was introduced in Virgo 3.5.0, a configuration directory was added (see bug 324991 for details). The directory name configuration is hard-coded in p2.

The Configuration chapter of the Virgo User Guide makes it clear which configuration goes in each directory.