AppDynamics Application Intelligence Platform

3.8.x Documentation



Release Notes

Skip to end of metadata
Go to start of metadata

Configuring OSGi Containers

The GlassFish application server versions 3.x and later uses OSGi architecture. By default, OSGi containers follow a specific model for bootstrap class delegation. Classes that are not specified in the container's CLASSPATH are not delegated to the bootstrap classloader; therefore you must configure the OSGi containers for the App Server Agent classes.

For more information see GlassFish OSGi Configuration per Domain.

To ensure that the OSGi container identifies the agent, specify the following package prefix:


This prefix follows the regular boot delegation model so that the App Server Agent classes are visible.

If you already have existing boot delegations, add "com.singularity.*" to the existing path separated by a comma. For example:

org.osgi.framework.bootdelegation=com.sun.btrace., com.singularity.

To configure Eclipse Equinox

If running Eclipse Equinox under Glassfish: 

1. Open the config.ini file located at <glassfish-install>/glassfish/osgi/equinox/configuration.

2. Add following package prefix to the config.ini file:


If running Eclipse Equinox with the WebSphere Application Server Liberty profile:

1. Open the file in the JVM directory <WLP_home>/usr/servers/<server_name> for editing.

2. Add the following line:


For more information see Getting Started with Equinox.

To configure Apache Sling

1. Open the file. The location of the varies depending on the Java platform.
In the Sun/Oracle implementation, the file is located at <java.home>/lib.

2. Add following package prefix to the file.


To configure Apache Felix for GlassFish

1. Open the file, located at <glassfish-install>/glassfish/osgi/felix/conf.

2. Add following package prefix to the file.


For GlassFish 3.1.2 



to the boot delegation list in the <GlassFish_Home_Directory>\glassfish\config\ file. For example:

org.osgi.framework.bootdelgation=${eclipselink.bootdelegation}, com.sun.btrace, com.singularity.*

To configure Felix for Jira or Confluence

For JIRA 5.1.8 and newer or Confluence 5.3 and newer:

1. Update the JIRA startup script (e.g. catalina) with the following Java system property:,com.yourkit,com.singularity.*,com.jprofiler,com.jprofiler.*,org.apache.xerces,org.apache.xerces.*,org.apache.xalan,org.apache.xalan.*,sun.*,com.sun.jndi,com.icl.saxon,com.icl.saxon.*,javax.servlet,javax.servlet.*,com.sun.xml.bind.*

2. Update the Java options:

  • For Linux: JAVA_OPTS=
  • For Windows: set JAVA_OPTS=%JAVA_OPTS%

To configure other OSGi-based containers

For other OSGI-based runtime containers, add the following package prefix to the appropriate OSGi configuration.*