The OSGi Agent is configurable using a properties file.
The following are the supported keys and default values the agent uses at startup. Once the file is read the agent will remove the file. Under certain circumstances the property file is not deleted. If the agent is not being started for the first time, then the property file will only be read if the properties are specified for a new account. If no account name is specified in the properties file, the file is not read or deleted. To force the agent to read this property file again, the OSGiAgentTree.bin and its backup file must be deleted.
Before the agent starts for the first time, you can create a default account. When you first start the agent, it looks for the default account properties file, called osgiagent.properties, in the directory specified with a -D
command line parameter in your invocation of the Virtual Machine (VM) that implements Java specifications. For example, if the account properties file is in the \propertyfile directory, you would use the following -D
parameter in your VM invocation (JVM_ARG):
found in the \eclipse\configuration\config.ini file.
If the -D
parameter is not used, the Java class path is searched for the osgiagent.properties file and that properties file is used. If no properties file is located in the Java class path, the current directory is searched.
When a properties file is found, the agent reads the parameters to create the initial account. When the OSGi agent starts for the first time, if no initial account exists, an initial account named AgentDefaultAccount is automatically created.
Use the following parameter descriptions and the sample file format as a guide if you create an osgiagent.properties file to create an initial account.
Use the following fields to configure the Enterprise Management Agent properties on the first launch of the Lotus® Expeditor for Devices:
Note: Configuring using the OSGi Agent properties file
lists the supported parameters. If unsupported parameters are used, you might receive exceptions when the osgiagent.properties is read by the client.
Table 1. Lotus Expeditor for Devices configurable properties
|Addr||Hostname of Client Management server||http://myserver.com/dmserver/OMADMServletAuthRequired|
|AccountID||AgentDefaultAccount||AgentDefaultAccount must be used or this property should not be included in the file. AgentDefaultAccount will be used by default if not included in the file. |
|UserName||User name for the device|
|LogSize||Specifies the size of message files|
|LogThreshold||Specifies the minimum error type added to the message file||
- 1 for Error
- 2 for Warning
- 3 for Info
- 4 for Debug
|PollingEnabled||Determines if polling is enabled||True or False|
|PollingInterval||Specifies the polling interval in hours and minutes||Time in HH:MM format. For example, 00:05|
Parent topic: Configuring using the OSGi Agent properties file: XPD621