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:
- System level file:
SYSTEM.PRV- System specific provisioning information
- The 'file' parameter indicates which other files (if any) are to be downloaded via TFTP.
phone type (t), device (d) and zone (z) files will all be pulled via TFTP with: file=tdz;
- Model level file:
TTTT.PRV- Phone type specific provisioning information, eg - to turn on/off Bluetooth on all 1140E sets
- TTTT replaced by phone model, e.g. 1140e.prv
- 1110,1120E,1140E,1150E,2007,1210,1220,1230 as valid options
- Zone level file:
ZZZZZ.PRV- Zone specific provisioning information, where ZZZZZ is the one to eight character Zone ID
- Zone ID can be set manually, via DHCP or via "zone" parameter in SYSTEM.PRV
- Device level file:
XXXXXXXXXXXX.PRV- Device specific provisioning information, where XX... is the MAC address of the device, i.e. CCF954E08A69.prv
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