This section contains the environment variables that you can use to set values of certain system properties. System properties set via environment variables are with higher priority than those included in a property file (e.g. default.prs) or in a Config class.
Environment variable |
Format |
Description |
|---|---|---|
For control of the startup process |
||
FWBOOTFILE |
<path_to_boot_ini>[;<path_to_boot_ini>] |
Contains a semi-colon separated list of paths to the basic startup bundles list files. See Customizable Boot Module. |
EXTBOOTFILE |
<path_to_boot_ini>[;<path_to_boot_ini>] |
Contains a semi-colon separated list of paths to extension startup bundles list files, whose bundles will installed after those of the basic startup bundles list file(s). See Customizable Boot Module. |
FWPRS |
<path_to_property_file>[;<path_to_property_file>] |
Contains a semi-colon separated list of paths to the basic system property files. |
EXTPRS |
<path_to_property_file>[;<path_to_property_file>] |
Contains a semi-colon separated list of paths to system property files extending those of the basic property files. |
FWSTORAGE |
<path_to_storage_folder> |
Contains the path to the private storage directory of the OSGi framework. |
VM_ARGS |
<jvm_option>[ <jvm_option>] |
Any options to pass to the JVM. Their syntax depends on the JVM in use. |
VM_DEBUG |
– |
If present,the JVM will be started in debug mode. |
VM_DEBUG_SUSPEND |
y|n |
If set to "y", then JVM's execution will be suspended until a debug client connects. Default is "n". |
VM_DEBUG_PORT |
<port_number> |
Contains the port on which the JVM will communicate debug information a debug client. Default is 8000. |
MBS_SERVER_JAR |
<cp_entry>[;<cp_entry>] |
Contains semi-colon separated classpath entries, that should be added to the boot classpath in the case of active extension support. |
For platform ID |
||
MBS_DEVICE_ID |
|
Contains the ID of the device the framework is being run on. Setting a value to this variable results in setting it to the com.prosyst.mbs.deviceId system property. |
For activation of certain features |
||
FWLAZY |
– |
If defined in the system, turns on lazy initialization support. Setting any value to this variable results in setting the mbs.bundles.lazy system property to true. |
FWLOADER |
– |
If present in the system, activates the Framework Loader (i.e. the framework's own class loader). Setting any value to this variable results in setting the mbs.customFrameworkLoader system property to true. FWLOADER is defined in the server* script and hence the framework's class loader is active by default. |
FWEXT |
– |
If present in the system, fully activates the support of framework extension bundles. Setting any value to this variable results in setting the org.osgi.supports.framework.extension system property to true and to defining the FWLOADER environment variable. |
FWERR |
– |
If present in the system, turns on printing errors to the system output of the framework process. Setting any value to this variable results in setting the mbs.log.errorlevel system property to true. |
FWCLEAN |
– |
If present in the system, the framework will be started with clean storage. Setting any value to this variable results in setting the mbs.storage.delete system property to true. |
FWSECURITY |
– |
If present in the system, fully activates the security of the framework. Setting any value to this variable results in setting the following system properties:
|
FWCERT |
– |
If present in the system, makes the Certificate Manager available in the framework environment. Setting any value to this variable results in setting the mbs.certificates system property to true. |
FWMEASUREMENTS |
– |
If present in the system, activates generation of detailed measurement log in the system output of the framework process. Setting any value to this variable results in setting the mbs.measurements.full system property to true. |
FWUEM |
– |
If present, activates the support for passing uncaught exceptions to an Uncaught Exception Manager module. Setting any value to this variable results in setting the mbs.thread.uem system property to true. |