The following list of system properties can be provided to the OSGi Provisioning Bundle for tuning the behavior of SDK's ready provisioning info providers, UDP multicast discovery agent or the general specifics of the provisioning process. The system properties are grouped in the following way:
System Property |
Type |
Default Value |
Description |
|---|---|---|---|
General Provisioning Properties |
|||
prm.prv.fwstart |
boolean |
true |
Determines if provisioning must wait until the framework is started. |
prm.reprovision.onstart |
boolean |
false |
Determines if the provisioning agent should try to make provisioning on every start. Otherwise, once the device is provisioned, the provisioning process will not be repeated. |
prm.debug |
boolean |
false |
Determines if provisioning agent should print debug and error information on the console. |
prm.remote.debug |
boolean |
false |
Determines if provisioning agent should send debug and error information to a remote Log Service on the backend. |
prm.provisioning.logfile |
String |
- |
Specifies the path to a log file for saving debug information about provisioning. A relative path should start from the working directory of the OSGi Runtime, i.e. from bin/vms/<vm_name>. |
prm.send.trace |
boolean |
false |
If true, the provisioning agent will send stack traces of logged exceptions to the backend. This property is useful, if the prm.prv.log provisioning property is set. |
prm.provisioning.reAfterPrvFailure.disabled |
boolean |
false |
If true, the provisioning agent will not attempt reprovisioning after a failure. |
prm.provisioning.reAfterPrvFailure.a |
int |
60000 |
Define the time intervals to execute reprovisioning: The first period to wait before reprovisioning is (prm.provisioning.reAfterPrvFailure.a + prm.provisioning.reAfterPrvFailure.b). In case of failure, reprovisioning is tried again each (prm.provisioning.reAfterPrvFailure.a + prm.provisioning.reAfterPrvFailure.b) milliseconds until prm.provisioning.reAfterPrvFailure.changePeriod expires. If provisioning is still not achieved, next the provisioning agent makes attempts each (prm.provisioning.reAfterPrvFailure.a + 2*prm.provisioning.reAfterPrvFailure.b) milliseconds until prm.provisioning.reAfterPrvFailure.changePeriod expires. The next step is to change the reprovisioning attempt period to (prm.provisioning.reAfterPrvFailure.a + 3*prm.provisioning.reAfterPrvFailure.b), etc., until (prm.provisioning.reAfterPrvFailure.a + n*prm.provisioning.reAfterPrvFailure.b) becomes greater than prm.provisioning.reAfterPrvFailure.maxperiod. If provisioning is still not successful, the attempt period is permanently set to (prm.provisioning.reAfterPrvFailure.a + (n-1)*prm.provisioning.reAfterPrvFailure.b) until the provisioning agent contacts the management system. |
prm.provisioning.reAfterPrvFailure.b |
int |
60000 |
|
prm.provisioning.reAfterPrvFailure.changePeriod |
int |
300000 |
|
prm.provisioning.reAfterPrvFailure.maxperiod |
int |
3600000 |
|
prm.close.zip |
boolean |
false |
If true, the ZIP file passed to the addInformation method of the OSGi Provisioning Service will be closed after reading. |
For the UDP Multicast Discovery Agent |
|||
mbs.multicast |
boolean |
true |
When set to "false", it disables multicast support for OSGi provisioning agent (UDP port is not opened). |
mbs.multicast.host |
String |
255.0.0.0 |
Determines the multicast host for the UDP multicast discovery. |
mbs.multicast.port |
String |
255.0.0.0 |
Determines multicast port for the UDP multicast discovery. |
prm.packet.timeout |
int |
10000 |
Specifies the timeout in milliseconds to receive a datagram packet from the remote management system. |
For the HTTP Info Provider |
|||
prm.http.provider.allowed |
boolean |
true |
Defines if the Provisioning Service should use the HTTP Info Provider, that is, if provisioning properties can be pushed to the service over HTTP, as described in the "Setting Properties in the HTTP Provisioning Info Provider" section. |
prm.http.provider.secure |
boolean |
false |
If set to true, the initial connection for pushing provisioning properties must be over HTTPS, and no HTTP connections will be accepted. |
prm.require.auth |
boolean |
true |
Defines if authentication through an administrator account will be requested from the backend. |
For the File Info Provider |
|||
prm.file.provider.allowed |
boolean |
true |
Defines if the Provisioning Service should use the File Info Provider, that is, if provisioning properties can be defined in a text file within the Initial Provisioning bundle JAR file, as described in the "Setting Properties in the File Provisioning Info Provider" section of the Provisioning Service. |
prm.file.load.once |
boolean |
true |
Defines if the file provider will load provisioning properties only the first time it is started. |
prm.file.provider.specfile.location |
String |
- |
Specifies the location of a props.txt file outside the JAR file of the Initial Provisioning Bundle. |
For the Environment Info Provider |
|||
prm.env.provider.allowed |
boolean |
true |
Defines if the Provisioning Service should use the Environment Info Provider, that is, if provisioning properties can be defined as system properties to the JVM. |
CM Provisioning Storage |
|||
prm.cm.support |
boolean |
false |
If false, provisioning properties will not be retrieved from or stored as a configuration in the OSGi Configuration Admin. Use it for faster startup in the case of active lazy support in the OSGi Runtime. |
For RSH URL Handler |
|||
prm.debug.rsh |
boolean |
false |
If true, turns on generation of debug information about the RSH Handler operation. |