Previous Topic

Next Topic

Book Contents

Book Index

Environment variables

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:

  • mbs.security to jdk12
  • java.security.policy to <mbs_dir>/bin/vms/policy.all
  • mbs.sm to true

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.