Mike's PBX Cookbook

Provisioning Files

An IP set can be configured via a combination of different files from a (TFTP/HTTP) provisioning server. For example, there may be a system.prv file with generic configuration, and then a 1140e.prv file to enable Bluetooth on 1140e sets only. If a provisioning server is deployed, the IP set receives it's address via DHCP Option 66 (TFTP server). If the server address (or URL) is prefixed with "http://", the IP set will retrieve the files using HTTP instead. Only a single provisioning server is supported.

A summary of each type of provision file is as follows:

From UNIStim firmware release 3.0, the Node and TN values can also be assigned by recognising a particular IP set's MAC address. Use the format: 'reg=MACaddr, CallServerType, ConnectServer, NodeID, TN'. For example, a valid Node and TN provision string that could be included in any .PRV file: reg=CCF954E08A69 CS1K S1 5881 248-0-00-00;

See Info Block Parameters and Auto Provisioning for further details.

An example of using hierarchal provision files using system, zone, and type provisioning files is shown below. Not all parameters need to be specified, only non-default values.

system.prv

# System level provisioning file
# Applies to all phones
file=zt;                             # read <zone>.prv and <type>.prv
zone=headqrtr;                       # Zone id
unid=Main-tower;                     # Unique network identification
menulock=p;                          # Menu lock mode
vq=y;                                # Enable 802.1Q for voice
vcp=3;                               # 802.1Q control p bit for voice
vmp=4;                               # 802.1Q media p bit for voice
vlanf=y;                             # Enable VLAN filter
pc=y;                                # Enable PC port
pcs=a;                               # PC port speed
pcd=a;                               # PC port duplex
dq=y;                                # Enable 802.1Q for PC port
lldp=y;                              # Enable 802.1ab (LLDP)
pk1= ffffffffffffffff;               # force pk1 to ff SMC will update
pk2= ffffffffffffffff;               # force pk2 to ff SMC will update
stickiness=y;                        # Enable stickiness
cachedip=n;                          # Enable cached IP
igarp=n;                             # Ignore GARP
srtp=n;                              # Enable PSK SRTP
eap=peap;                            # Enable 802.1x (EAP)
eapid1=DEV1024;                      # 802.1x (EAP) device
eapid2=TOW2234;                      # 802.1X (EAP) device
eappwd=D3c6v5;                       # 802.1x (EAP) password
cdiff=13;                            # DiffServ code point for control
mdiff=12;                            # DiffServ code point for media
prov=47.11.232.115;                  # Provisioning server IP address
dns=47.11.20.20;                     # Primary DNS server IP address
dns2=47.11.20.21;                    # Secondary DNS server IP address
ct=20;                               # Contrast value
br=18;                               # Brightness value
blt=1;                               # Backlight timer
dim=y;                               # Enable dim
hd=w;                                # Headset type
bold=y                               # Enable font display in bold

headqrtr.prv

# Zone level provisioning file
# Applies to all phones within the headquarters zone
s1ip=47.11.62.20;                    # Primary server IP address
p1=4100;                             # Primary server port number
a1=1;                                # Primary server action code
r1=10;                               # Primary server retry count
s2ip=47.11.62.21;                    # Secondary server IP address
p2=4100;                             # Secondary server port number
a2=1;                                # Secondary server action code
r2=10;                               # Secondary server retry count
xip=47.11.62.147;                    # XAS server IP address
xp=5000;                             # XAS server port number
xa=g;                                # XAS server action code

1140e.prv

# Type level provisioning file specific to IP Phone 1140E 
# Applies to all IP Phone 1140E within the network
bt=y;                                # Enable Bluetooth