Sangoma Phones Remote Restart and Reconfigure
- Kelli Higdon
Overview
This applies to Sangoma D-series, P310, and P315 model phones.
Remote Restart
Sangoma phones will, typically, automatically restart themselves whenever they receive a configuration parameter that necessitates a full restart.
Otherwise, Sangoma phones, beginning with firmware 1.1.0, may be remotely notified to restart by using a check-sync SIP NOTIFY Event sent from the Asterisk CLI. This feature is enabled by default and is controlled by the:
<setting id="enable_check_sync" value="1"/> |
setting for XML-configured phones or by the enable_check_sync parameter for DPMA-configured phones.
Older versions of Asterisk may not have a properly configured sip_notify.conf file to allow sending the restart notices from the Asterisk CLI. To enable this functionality, add the following lines to pjsip_notify.conf if they are not already present:
; Digium
[digium-check-cfg]
Event=>check-syncFollowing an Asterisk reload or restart, Sangoma phones may then be remotely sent restart notices by executing the following Asterisk CLI command:
pjsip send notify digium-check-cfg <my endpoint identifier, e.g. 1000>Remote Reconfigure
Sangoma phones, when connected to DPMA, can be remotely reconfigured using the Asterisk CLI command:
Or using by using the DigiumPhoneReconfigure AMI Action.
If phones are not connected to DPMA, they can be reconfigured, as opposed to restarted, beginning with firmware 2.3.0, by issuing a new notify command.
Some versions of Asterisk may not have a properly configured pjsip_notify.conf file to allow sending the reconfigure notices from the Asterisk CLI. To enable this functionality, add the following lines to pjsip_notify.conf if they are not already present:
Like the other check-sync Event, this command depends on the phone's enable_check_sync setting being enabled.
Following an Asterisk reload or restart, Sangoma phones may then be remotely sent reconfigure notices by executing the following Asterisk CLI command:
Performing Remote Restart or Reconfigure outside of Asterisk
The SIPp test tool can be used with the following scenario file:
SIPp Reconfigure checksync.xml
to programmatically restart Sangoma phones like:
where 10.24.19.95 represents the IP address of the Sangoma phone to be restarted.
This is also possible using other tools, such as sipsak with the following file:
sipsak reboot.phone restart example file
as executed like:
where 10.1.2.3 represents the IP address of the Sangoma phone to be restarted.