This section provides information about configuring the OSGi framework by updating the following files in the
$SERVER_HOME/lib
directory:
Table 11.8. OSGi Framework Configuration Files
Property File | Description |
---|---|
org.eclipse.virgo.kernel.launch.properties | Configures OSGi framework properties. |
java6-server.profile | Configures the OSGi framework profile. |
You specify the framework properties in the $SERVER_HOME/lib/org.eclipse.virgo.kernel.launch.properties
file. The
properties most relevant to users are described in the following table.
WARNING: We strongly recommend that you update only the osgi.console
and
org.eclipse.virgo.suppress.heap.dumps
properties; updating the other properties could cause VWS
to fail. These properties are documented for your information only.
Table 11.9. Framework Properties
Property | Description |
---|---|
launcher.bundles |
This property lists the bundles that comprise the kernel using file: URIs.
Bundles to be started are tagged with a trailing @start .
|
org.eclipse.virgo.suppress.heap.dumps |
Set to 'false' by default this property will prevent heap dumps being contributed to dumps taken during a
First Failure Data Capture (FFDC) event. When the heap dumps are produced they will be located along with
the other dump artifacts in the $SERVER_HOME/serviceability/dump/ folder.
|
osgi.console | Specifies the port number which the Equinox console will use.
The usual port number is 2401.
If specified, the Equinox console is enabled (with the Equinox Console Extension) during user region start.
If not specified, the Equinox console is not available unless the parameter -Fosgi.console
is passed to the startup script. |
osgi.java.profile |
Specifies the profile to use using a file: URI with default value
file:lib/java6-server.profile .
|
You specify the framework profile in the $SERVER_HOME/lib/java6-server.profile
file. The
properties most relevant to users are described in the following table.
WARNING: We advise you not to change the framework profile unless you are sure you know exactly what you are doing; updating the profile could cause VWS to fail.
Table 11.10. Framework Profile Properties
Property | Description |
---|---|
org.osgi.framework.bootdelegation |
This property specifies the packages which are loaded by delegation to the application class loader.
Bundles can load classes belonging to these packages without importing the packages.
The A common reason for adding packages to this property is to run VWS under a performance profiler. |
org.osgi.framework.system.packages |
This property specifies the packages which are exported by the system bundle.
Although the system bundle is typically imported into the user region, any additional packages will not be
visible in the user region unless you also import them using the
It is very occasionally necessary to extend the set, for example when configuring email logging appenders since the
implementation of
To make the corresponding classes available for loading, the relevant JAR file(s) should be placed in
|