Configuring Noojee Provision
The configuration of Noojee Provision is controlled by the configuration file noojeeprovision.xml. The Noojee Provision.xml is stored in the config directory e.g. /usr/lib/noojeeprovision/config/noojeeprovision.xml.
noojeeprovision.xml
Noojee Provision
Database
Specifies how Noojee Provision will connect to the Asterisk realtime database.
Type
The name of the database type (e.g. MySQL). Currently this can be any value.
Class
The JDBC class used to connect to the database. See your database provider for the appropriate name.
Server
The IP address of the database server
Name
The name of the database which contains the Asterisk realtime tables.
Username
The account used to connect to the database.
Password
The password used to connect to the database.
Services
Specifies what protocols are available for the handsets to download settings files. Currently HTTP and TFTP are supported. You can enable one or both, but at least one must be supported.
TemplateRoot
The root of the directory where the settings file templates will be stored. This is normally set to /usr/lib/noojeeprovision/config
KillPort
The IP port used by the Kill application to shutdown Noojee Provision. To stop the PlugN service run:
java -cp noojeeprovision.jar au/com/asteriskit/noojeeprovision/AppKiller/main
HTTP
Controls how the Noojee Provision HTTP service operates.
Enabled
Set the value to 'True' to enable the HTTP service and False to disable it.
IPAddress
The ip address the HTTP services listens for requests on. Leave blank to allow it to listen on all addresses.
Port
The port number the HTTP services listens for requests on. Leave blank to have it listen on port 80. Note: make certain that you don't have another HTTP services running from the same IP address.
TFTP
Controls how the Noojee Provision TFTP services operates. Note TFTP is a UDP based protocol.
Enabled
Set the value to 'True' to enable the TFTP service and False to disable it.
IPAddress
The ip address the TFTP services listens for requests on. Leave blank to allow it to listen on all addresses.
Port
The port number the TFTP services listens for requests on. Leave blank to have it listen on the default port 69. Note: make certain that you don't have another TFTP services running from the same IP address.
Manufacturers
Provides settings for each manufacturer supported by Noojee Provision. Additional manufacturers can be added by adding another Manufacturer section with the appropriate settings. Noojee Provision has no specialized code for a manufacturer, all operations are controlled from the noojeeprovision.xml configuration file.
Manufacturer
Specifies the configuration details for a specific manufacturer.
Name
The name of the manufacturer. There is no real significance in this entry, it is only used as convenience to identify actions and problems associated with a specific manufactures settings and handsets.
MACPrefix
The prefix used by all handsets manufactured by this manufacturer. This is generally the first 6 digits from the mac address found on the back of a handsets.
TemplatePath
The path, relative to the TemplateRoot where the settings files for this manufacturer can be found. This should generally be something like:
\name\templates
Where name is the same name you used in the Name element above.
TemplateFile
Mame of the settings file used to configure handsets for this manufacturer.
SIP
Controls how the Asterisk realtime SIP details are configured for each handset added to the Asterisk server.
Context
The Asterisk context for the SIP record.
DTMFmode
The DTMF mode
Allow
The set of codes to allow for the handset.
Range
The range of extensions to allocate to handsets for this manufacturer.
First
The first extension number to allocate
Last
The last extension number to allocate.
Properties
Allows you to create a set of properties which can be used in the template file. You may choose any set of names and values and then reference them in the template file. The section just provides a simple way of defining values in a single location which may be used through out your handset settings template. To insert a property value in your settings template insert the string:
$PropertyName
where 'PropertyName' is the Name one of the properties you have defined in the noojeeprovision.xml configuration file for the manufacturer.
Property
Denotes a user defined property.
Name
The name of the property
Value
The value of the property.