Setup Devices

ipbx supports the following devices for [[auto-provisioning]]. Any other type of device needs to be setup manually and possibly requires console modifications. If you have a device type with which you need help, please contact Taridium or your authorized reseller. Check the [[Add_Unsupported_Phone|How To section]] for examples of manual setups for unsupported phone types.

To access auto-provisioning settings click on '''Configuration''' → '''Advanced Setup''' → '''Devices'''.

Click on the approriate '''configure''' button to enable [[auto-provisioning]] for your selected brand. This procedure might take a couple of minutes depending on the provisioning method. Depending on the phone type provisioning is done via TFTP, FTP or HTTP(S). Many phones will support multiple protocols.

[[Image:warning.gif]] Please take the appropriate precautions when exposing any of the provisioning services to the internet! An attacker could possibly read a configuration file and start making toll calls through your system.



== Aastra ==

* Supported Aastra phones: SIP Load 5xi series
* Default Provisioning Method: HTTP (path: /var/www/html/prov as well as /tftpboot)
* Access Type: anonymous

=== Semi Automated Setup ===

In case you don't have your network configured for automatic provisioning, or if you want configure your phone at a remote location, you can still use the configuration system by telling the phone where to look for the its configuration. 

Press the Settings button, sometimes labeled '''Options''' or a wrench symbol and scroll Down to '''3. Phone Status''' and select it. You should now see the '''1. IP&MAC Addresses''' option, select it and note the IP address.

# Enter this IP address into your web browser's address bar. E.g. http://192.168.12.33. 
# Enter the default username '''admin''' and password '''22222'''.
# Click on the '''Advanced Settings''' → '''Configuration Server''' at the bottom of the menu. 
# Select HTTP as '''Download Protocol'''.
# Enter your ipbx IP address into the '''HTTP Server''' field.
# Enter '''prov''' into the '''HTTP Path''' field.
# Click on '''Save Settings'''.
# Click on '''Operation''' → '''Reset'''.
# Click on '''Restart Phone'''.

The phone will reboot shortly and attempt to retrieve the configuration file from your ipbx system.

== Cisco ==

* Supported Cisco Phones: 79XX Series (SIP only)
* Default Provisioning Method: TFTP (path: /tftpboot)
* Access Type: anonymous

Standard provisioning currently only support non-XML configuration files. This excludes Cisco Unified IP Phone 7965G, 7970G and others. See the [[Adding_Unsupported_Phones|Adding Unsupported Phones]] page for further details.

== Linksys SPA (Cisco Small Business) Phones and ATA's ==
(formerly also known as Sipura)

* Supported Linksys and Linksys by Cisco Phones: SPA series phones and analog telephone adapters, PAP2T-NA etc.
* Default Provisioning Method: HTTP (path: /var/www/html/prov)
* Access Type: anonymous

Cisco/Linksys phones are meant to be provisioned by HTTP, but might initially only pick up the default pre-provisioning file from the TFTP server (default behavior of factory phones). This requires a second reboot.

#Initial boot: Phone or ATA picks up init.cfg file with instructions to use the HTTP profile
#Second boot: Phone/ATA picks up it's actual configuration file.

'''Contents of Pre Provisioning File'''

  <flat-profile>  <!-- Sipura SPA PRE-PROVISIONING -->
  
    <Profile_Rule ua="na"><nowiki>http://%%eth0%%/prov/spa$MAU.cfg</nowiki>
    </Profile_Rule>
  
  </flat-profile>


Where '''%%eth0%%''' is the variable which will automatically be replaced with the IP address of your ipbx system.

You can easily reboot your Linksys ATA or phone by entering the following URL into your webbrowser:

  http://[ip address]/admin/reboot

or

  http://[ip address]/admin/reset

=== Semi Automated Setup ===

In case you don't have your network configured for automatic provisioning, or if you want configure your phone at a remote location, you can still use the configuration system by telling the phone where to look for the its configuration.

Press the Setup button (this button looks like a page symbol) and scroll Down to '''Network''' and select it. You should now see the '''Current IP''' information. 
On ATA's that don't have an interface, connect a phone to telephone port 1 and dial **** (four asterisks) Then dial:  110 # - This will cause the the ATA to readback the IP address acquired via DHCP.

# Enter this IP address into your web browser's address bar. E.g. http://192.168.12.33. 
# Click on the '''Admin Login''' link on the right hand side. The default configuration will require no password.
# Click on the '''advanced''' link on the right hand side. This will expose further configuration options.
# Click on the 'Provisioning' Tab
# Enter The following 'Profile Rule' : http://[ip address of pbx]/prov/spa$MAU.cfg
# Click on 'Submit All Changes' at the bottom of the page.
# Reboot your phone or enter http://[ip address of phone]/admin/resync

The phone will reboot shortly and attempt to retrieve the configuration file.

== Polycom ==

* Supported Polycom Phones: Polycom SoundPoint IP and SoundStation IP
* Default Provisioning Method: FTP (path: /home/PlcmSpIp)
* Access Type: authenticated
* Access User: PlcmSpIp

=== Semi Automated Setup ===

In case you don't have your network configured for automatic provisioning, or if you want configure your phone at a remote location, you can still use the configuration system by telling the phone where to look for the its configuration. 

Polycom phones need to setup directly on the phone for semi-automated provisioning:

# Press the '''Menu''' key.
# Select '''Settings'''.
# Select '''Advanced'''.
# Enter in your admin password to the phone (456). Hit the Enter soft key.
# Select '''Admin Settings'''.
# Select '''Network Configuration'''.
# Select '''Server Menu'''.
# Enter the IP address of your ipbx system.
# Hit the Exit Soft key until you can select '''Save Config'''
# Reboot your phone

=== Resetting your Polycom Phone ===

'''Reset Local Config'''

# Press the '''Menu''' key.
# Select '''Settings'''.
# Select '''Advanced'''.
# Enter in your admin password to the phone (456). Hit the Enter soft key.
# Select '''Admin Settings'''.
# Select '''Reset to Default'''.
# Select '''Reset Local Config'''.

'''Reset Device Settings'''

IP 30x: Hold down the 4, 6, 8 and * keys simultaneously.<br>
IP 430: Hold down the 1, 3, 5 and 7 keys simultaneously.<br>
IP 50x: Hold down the 4, 6, 8 and * keys simultaneously.<br>
IP 60x: Hold down the 4, 6, 8 and * keys simultaneously.

NOTE: This method will require the Administrator Password(456)

== Snom ==

* Supported Snom phones: Snom 3xx/8xx and Snom m3
* Default Provisioning Method: HTTP (path: /var/www/html/prov)
* Access Type: anonymous

== XML Applications ==

For supported XML applications and phones see [[Phone_Browser_XML_Applications|Phone Browser XML Applications]]. Most applications will be listed in the main XML Menu for the corresponding phone type.

=== Queue RSS Feed ===

''This feature is available as of ipbx 2.0.5-i.'' 

The queue RSS feed displays a RSS 2.0 feed for a selected queue. Returned data includes:

* number of available agents
* waiting calls
* connected calls
* agent ratio

The RSS feed script will take a single argument '''queue''' to specify the queue, if not specified the first queue will be returned.

Example calling the Queue RSS feed:

  http://192.168.23.2/ipbx/xml/rss-queue.xml?queue=myQueue