View source for OTEquinox/Config Ini

{{warning|OTDT &le; 2.2|This page is relevant for OTDT version &le; 2.2.<br/>
Starting with version 2.3 no more changes are required in config.ini}}

==OT-Specific Declarations in config.ini==

The file <code>configuration/config.ini</code> contains fundamental settings for an OSGi installation. OT/Equinox adds a few additional declarations to this file, which are described here.

==Mandatory declarations:==
Adding mandatory declarations to the file <code>config.ini</code> is done through the "touchpoint" mechanism of the [[:Category:Equinox_p2|p2 provisioning system]], so everything happens automatically while installing the OTDT. This section only gives background for those who want to know what's going on behind the scenes.

<ul><li valign="top"><pre>osgi.hook.configurators.include=org.objectteams.eclipse.transformer.hook.HookConfigurator
osgi.framework.extensions=org.objectteams.eclipse.transformer.hook</pre><br>
These two declarations announce the OT/J bytecode transformers to the OSGi framework, by using the hooks described in [[Adaptor Hooks]].</li></ul>

*<pre> osgi.classloader.lock=classname</pre>
:This line is also recommended in order to tell the framework to use a new locking strategy for all classloaders, which is known to work best for OT/Equinox. 

* <pre>ot.equinox=1</pre>
:This simple flag is needed to tell the OTRE that it runs inside OSGi.

==Optional application specific declarations==

See [[OTEquinox/Forced Export|Forced Export]]

==OT-Specific Declarations in eclipse.ini==

Due to the top voted bug reported against the Sun JVM (see  https://bugs.eclipse.org/121737) additionally two vendor-specific options need to be passed to the JVM (not on MacOS, where these options would cause the VM to crash), which happens by the following entries in <code>eclipse.ini</code> (after -vmargs):<br>
<pre>-XX:+UnlockDiagnosticVMOptions
-XX:+UnsyncloadClass</pre>
When running on Java 7 or greater these options should no longer be needed.

[[Category:OTEquinox|Config Ini]]