Phone Provisioning
From Taridium
(→Channel Templates) |
(→Pre-Requisites) |
||
| (11 intermediate revisions not shown) | |||
| Line 1: | Line 1: | ||
== Pre-Requisites == | == Pre-Requisites == | ||
| - | Make sure that you have followed the instructions for [[Setup Devices|Device Type Setup]]. | + | ipbx supports most SIP compliant phones from vendors such as Aastra, Cisco, Polycom and Linksys. Make sure that you have followed the instructions for [[Setup Devices|Device Type Setup]] prior to attempting to provision your phones. |
| - | + | ||
== Channel Templates == | == Channel Templates == | ||
| - | Channel templates tell ipbx how to communicate with your phones. Channel Templates are supported for both SIP and IAX technologies. Support for many popular phone brands is included and ready for auto-provisioning. | + | Channel templates tell ipbx how to communicate with your phones. Channel Templates are supported for both SIP and IAX technologies. Support for many popular phone brands is included and ready for [[auto-provisioning]]. |
Phones can be connected to ipbx with or without a device definition. Devices need to have a MAC address associated and are usually created automatically when creating a new user. Devices are always based on a Channel Template which instructs ipbx how to create any provisioning files. | Phones can be connected to ipbx with or without a device definition. Devices need to have a MAC address associated and are usually created automatically when creating a new user. Devices are always based on a Channel Template which instructs ipbx how to create any provisioning files. | ||
| Line 13: | Line 12: | ||
=== Editing Channel Templates === | === Editing Channel Templates === | ||
| - | Navigate to '''System''' → '''SIP/IAX | + | Navigate to '''System''' → '''SIP/IAX Channels''' → '''Templates''' and edit or create a new template. |
| + | |||
| + | '''Device Configuration''' allows you to specify the way ipbx creates text based configuration files. ipbx can create up to two separate configuration files based off the stored template text. To edit the template text click on '''edit''' or upload a prepared file. | ||
| + | |||
| + | See Also [[Channels]] | ||
| + | |||
| + | === Device Template Variables === | ||
| + | |||
| + | Variables are always enclosed in double percentage signs. Device template text and destination strings can contain the following variables: | ||
| + | |||
| + | * '''%%mac%%''' lower case MAC address | ||
| + | * '''%%MAC%%''' upper case MAC address | ||
| + | * '''%%username%%''' (channel username) | ||
| + | * '''%%secret%%''' (channel password) | ||
| + | * '''%%accountcode%%''' (channel accountcode) | ||
| + | * '''%%mailbox%%'''(mailbox number) | ||
| + | * '''%%nat%%''' (yes/no) | ||
| + | * '''%%host%%''' (host name) | ||
| + | * '''%%callerid%%''' (caller ID "{name}" <{number}>) | ||
| + | * '''%%calleridnum%%''' (caller ID number only) | ||
| + | * '''%%calleridname%%''' (caller ID name only) | ||
| + | * '''%%eth[0-3]%%''' IP Addresses of eth[0-3] (ipbx server) | ||
| + | * '''%%gmtoffsetsec%%''' GMT/UTC Offset in seconds (ipbx server) | ||
| + | * '''%%gmtoffsetmin%%''' GMT/UTC Offset in minutes (ipbx server) | ||
| + | |||
| + | These variables will be replaced upon user/channel creation with the appropriate value. | ||
Latest revision as of 22:54, 24 February 2010
Contents |
Pre-Requisites
ipbx supports most SIP compliant phones from vendors such as Aastra, Cisco, Polycom and Linksys. Make sure that you have followed the instructions for Device Type Setup prior to attempting to provision your phones.
Channel Templates
Channel templates tell ipbx how to communicate with your phones. Channel Templates are supported for both SIP and IAX technologies. Support for many popular phone brands is included and ready for auto-provisioning.
Phones can be connected to ipbx with or without a device definition. Devices need to have a MAC address associated and are usually created automatically when creating a new user. Devices are always based on a Channel Template which instructs ipbx how to create any provisioning files.
Editing Channel Templates
Navigate to System → SIP/IAX Channels → Templates and edit or create a new template.
Device Configuration allows you to specify the way ipbx creates text based configuration files. ipbx can create up to two separate configuration files based off the stored template text. To edit the template text click on edit or upload a prepared file.
See Also Channels
Device Template Variables
Variables are always enclosed in double percentage signs. Device template text and destination strings can contain the following variables:
- %%mac%% lower case MAC address
- %%MAC%% upper case MAC address
- %%username%% (channel username)
- %%secret%% (channel password)
- %%accountcode%% (channel accountcode)
- %%mailbox%%(mailbox number)
- %%nat%% (yes/no)
- %%host%% (host name)
- %%callerid%% (caller ID "{name}" <{number}>)
- %%calleridnum%% (caller ID number only)
- %%calleridname%% (caller ID name only)
- %%eth[0-3]%% IP Addresses of eth[0-3] (ipbx server)
- %%gmtoffsetsec%% GMT/UTC Offset in seconds (ipbx server)
- %%gmtoffsetmin%% GMT/UTC Offset in minutes (ipbx server)
These variables will be replaced upon user/channel creation with the appropriate value.
