When configuring a phone through the PBX, the MAC of the device is assigned to the extension allowing the creation of a config file which is downloaded to the phone, telling it how to be programmed. There are two methods to configure a phone to the PBX:
This method involves some PBX programming and selections at the phone itself to configure the phone.
- Create an extension in the PBX and set Phone Type to the model of phone you wish to provision; Save and Apply Changes
- Navigate in the PBX to PBX Setup=>General; ensure that Autoprovisioning is Running (click ON if it is currently Stopped)
- At the phone, press Menu
- Select System Settings
- Select Advanced Settings
- Press OK when prompted for a password as there is no password
- Select SIP
- Select Auto Prov
- Navigate to Extension Number and press the softkey for Modify
- Enter the Extension Number
- Press OK
- Press Done
This method involves scanning the network with AutoDiscovery and assigning the extensions to the phones from the PBX.
- Create an extension in the PBX
- Navigate to Destinations=>Extensions
- Select AutoDiscovery=>Scan Network
- Find the MAC of the phone you wish to configure
- Change the Assigned dropdown from None to the extension you want to configure to that phone
- Put a check mark in the box next to this phone
- Select the Commands tab at the top of the page
- Click Assign, Configure, and Restart button
Ring Tone Music Files
You can send and store a music file on the IPitomy HD phone for playback during ringing. To do so the file MUST be formatted:
Wave file (*.wav), 711-aLaw, 8KHz, 64kbps, Mono, and less than 300kb size, file name should be small (mine is 8-characters)
- Once the file is created (I like Goldwave Audio Editing software.) Load it onto the telephone:
- Open browser
- Navigate to the phone IP (this operation cannot be done from the PBX)
- Navigate to Phone Maintenance / Auto Provisioning
- Uncheck the box at Auto Download Config File (this will keep the PBX from loading setting that don't include your loaded file)
- Click Submit
- Navigate to Audio
- Click the Browse button
- locate your wav file on your PC and select it (Windows/MAC, command)
- Click Upload
- If it doesn't succeed, fix the problem.
- Navigate to Audio (again)
- Under Audio / Ring / Ring Type select the file which should appear in the list
- Click Submit
- Call the phone - it should play your file as ring tone
A Note on Changing the Global Template
Due to the current implementation of the global template, if you wish to update your configuration file with new parameters provided in a PBX software update, you will need to reset your template and then make your configuration customizations again after the update. Note the template only currently changes on PBX software upgrades, not on phone firmware updates. Be sure to check if your customizations are now supported in a feature in the release notes, as this may effect how your customizations are applied.
It is our goal to support new parameters in the configuration files by supporting ensuring that their absence in the configuration file results in the feature using a default value which should ensure no change in behavior due to the presence of the feature.
Note that omitting a node from a configuration file will result in the default values for settings defined therein being used. If you change these values through the phone and they are not present in the global template, then they should not be changed by downloading a configuration file. However, you cannot delete a setting that is being set specifically by the server as it will simply replace it. (These settings should be obvious like, sip user, proxy, and other settings on the phone configuration page).
Static IP vs DHCP
IPitomy supports configuring phones using DHCP and this is the best option for almost every network. If you would like to statically set IP addresses, we recommend that you use DHCP reservations to do this. In the vast majority of routers and DHCP servers there is an ability to assign a static IP address to a MAC address. While this process of assigning may be tedious, it is no less so than going to each individual phone and manually configuring the IP address (Static IP). In the end it eliminates any difficult modifications that you will need to make to configuration files and is just a way easier method to use for accomplishing the same task.
If having this information, the phone still must be manually set to static IP addresses then you will need to understand the following information. You have several options for performing this configuration:
Configure then Disable Configuration Updates
- Automatically Configure the phones using DHCP
- Go to phone's web page (root/root to log in) Navigate to Phone Maintenance->Auto Provision and uncheck the box that says Auto Download Config File.
- set the IP address to the desired static address
- The phone should keep it's original configuration and any changes made to phone configuration will now have to be done through the phone web interface. The exception to this is that you can change the phone keys in this configuration, just do NOT press Save and Configure. Press Save then Apply changes. The phone will update the keys at night when it downloads it's key configuration.
Change Configuration File Template
The second option is more difficult to initially configure but is easier because you can still change phone settings. You should only do this if you are familiar with XML as you can break the configuration files by making changes here that lead to invalid XML.
- Go to PBXSetup->Phone Global
- Under "HD Phone Configuration Template" click "Reset Template to Default"
- Now click Edit Template. Under Networks - delete the entire Node called "network"
- Now phones should keep whatever you manually set them to.
- Note with this method that when you upgrade the PBX software you should be aware that we may make changes to the default template and you may have to reset the template and remake the changes in order to support additional functionality that is added in future releases.
The final option here is to just manually configure the phone. This works but if you call tech support with an issue they will probably have you default and reconfigure the phone through the PBX as we change a number of options when we provision the phones to the PBX.
Under PBX Setup=>Phone Global you will find buttons that allow you to reset the Global Template for the HD phones to default, or to modify the template itself. The template is what is used to create configuration files for each phone that is provisioned to the PBX. The template itself is in XML format and contains all of the settings available in the phone. Making incorrect changes could cause issues with phones functioning correctly. If you are unsure or have any questions about making changes to the global template, you are encouraged to contact IPitomy Technical Support for assistance. If you feel you have made changes that are incorrect, you can always click the Reset to Default button.
If you need to use vLAN to control what IP addresses the phones pull from DHCP you can modify the Phone Configuration Template in the PBX. VLANs logically isolate network traffic, the do not necessarily physically isolate it. It is typically going to be used because there are more devices on the network then there are IP Addresses in a single subnet. Or in order to implement security.
- Navigate to PBX Setup=>Phone Global
- Click Edit Current Template
- Find the following section in the template pertains to vLAN, this is how it appears by default
<VLANs> <Vlan LocalEnableVlan="0" PCEnableVlan="0" LocalVID="0" PCVID="0" LocalPriority="0" PCPriority="0" EnableVlan="0"/> </VLANs>
|LocalEnableVlan||Controls if the LAN port is using vLAN tagging||0 = Disabled, 1 = Enabled|
|PCEnableVlan||Controls if the PC port is using vLAN tagging||0 = Disabled, 1 = Enabled|
|LocalVID||Defines what vLAN tag the LAN port is using||Set to the vLAN ID|
|PCVID||Defines what vLAN tag the PC port is using||Set to the vLAN ID|
|LocalPriority||Not Used||Leave at 0|
|PC Priority||Not Used||Leave at 0|
|EnableVlan||Global setting to toggle vLAN on PC and LAN port||0 = Disabled, 1 = Enabled|
- In the following example the LAN port will use vLAN 5 and the PC port will use vLAN 8, allowing the Phone and PC to get different IP addresses from the DHCP server:
<VLANs> <Vlan LocalEnableVlan="1" PCEnableVlan="1" LocalVID="5" PCVID="5" LocalPriority="0" PCPriority="0" EnableVlan="1"/> </VLANs>
- When done modifying the template Save, Apply Changes, and now any phones that are configured to the PBX will have their configuration file modified to match the template changes.
HD Phone WATS (current draw expressed in WATS)
|Phone Model||Phone Only||With 1 IPX32||With 2 IPX32||With 3 or more IPX32|
- Provision the phone locally as you would any other phone
- Configure the PBX Site router with port forwards of 5060 UDP and 10k-20k TCP/UDP. The port forwards should point at the LAN address of the PBX
- Navigate to PBX Setup=>SIP and enter the Public IP address of the PBX under External IP, Save
- Navigate to System=>Access Control=>Access Control List
- Configure so that the IP address for the remote phone can communicate to the PBX in one of two ways:
- Add the Public IP address of the remote location if its static (eg. 22.214.171.124/32)
- Delete the SIP service from the ACL if the remote phone will not have a static IP. If you use this method, we advise to enable Log Watch & Ban (found under PBX Setup=>General) after you have verified the remote phone works.
- Navigate to the PBX Settings for the Extension
- Click the blue Advanced link
- Change the Location from LAN to WAN, Save and Apply Changes
- Navigate to PBX Setup=>SIP (Optional setting for remote programming)
- Ensure that Phone Download Enabled and Phone Auth Enabled are set to Yes (Optional setting for remote programming)
- Navigate to the Phone Settings for the Extension
- Click SIP/Network Settings
- Change the SIP Location from LAN to WAN
- Change the Time Server Location from Use PBX as Time Server to Use PBX Time Server
- Under Configuration Updates change from TFTP to HTTP (Optional setting for remote programming)
- Click Save and Configure
Optional Settings for Remote Programming
The steps above that read (Optional setting for remote programming) are not necessary to do unless you desire to be able to program a remote phone via the PBX. The Port that is used (80 by default) will need to be forwarded to the PBX from the router. Once everything is configured and the phone is installed at the remote location, programming changes will go as follows:
- Make the changes in the PBX, Save and Apply Changes
- Reboot the remote phone, allowing it to download its updated config file