Noojee Provision Configuration

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

Allows the definition of one ore more MacPrefix elements. The prefix used by 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.