{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"This applies to Sangoma D-series, P310, and P315 model phones.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Remote Restart","type":"text"}]},{"type":"paragraph","content":[{"text":"Sangoma phones will, typically, automatically restart themselves whenever they receive a configuration parameter that necessitates a full restart.","type":"text"}]},{"type":"paragraph","content":[{"text":"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:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"b067f022-4a03-471b-b039-114f5634107f"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"codeBlock","content":[{"text":"","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"setting for XML-configured phones or by the ","type":"text"},{"text":"enable_check_sync","type":"text","marks":[{"type":"strong"}]},{"text":" parameter for DPMA-configured phones.","type":"text"}]},{"type":"paragraph","content":[{"text":"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:","type":"text"}]},{"type":"codeBlock","content":[{"text":"; Sangoma\n\n[digium-check-cfg]\nEvent=>check-sync","type":"text"}]},{"type":"paragraph","content":[{"text":"Following an Asterisk reload or restart, Sangoma phones may then be remotely sent restart notices by executing the following Asterisk CLI command:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pjsip send notify digium-check-cfg ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Remote Reconfigure","type":"text"}]},{"type":"paragraph","content":[{"text":"Sangoma phones, when connected to DPMA, can be remotely reconfigured using the Asterisk CLI command:","type":"text"}]},{"type":"codeBlock","content":[{"text":"digium_phones reconfigure phone ","type":"text"}]},{"type":"paragraph","content":[{"text":"Or using by using the ","type":"text"},{"text":"DigiumPhoneReconfigure AMI Action","type":"text","marks":[{"type":"link","attrs":{"href":"https://sangomakb.atlassian.net/wiki/spaces/Phones/pages/19991904"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"paragraph","content":[{"text":"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:","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"codeBlock","content":[{"text":"; Sangoma\n\n[digium-check-reconfig]\nEvent=>check-sync-reconfig","type":"text"}]},{"type":"paragraph","content":[{"text":"Like the other check-sync Event, this command depends on the phone's ","type":"text"},{"text":"enable_check_sync","type":"text","marks":[{"type":"strong"}]},{"text":" setting being enabled.","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Following an Asterisk reload or restart, Sangoma phones may then be remotely sent reconfigure notices by executing the following Asterisk CLI command:","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"codeBlock","content":[{"text":"pjsip send notify digium-check-reconfig ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Performing Remote Restart or Reconfigure outside of Asterisk","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"SIPp test tool","type":"text","marks":[{"type":"link","attrs":{"href":"http://sipp.sourceforge.net/"}}]},{"text":" can be used with the following scenario file:","type":"text"}]},{"type":"paragraph","content":[{"text":" SIPp Reconfigure checksync.xml","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n \n ;tag=[call_number]\n To: \n Contact: \n Call-ID: [call_id]@[local_ip]:[local_port]\n CSeq: 102 NOTIFY\n User-Agent: Asterisk PBX SVN-branch-11-r377355\n Date: Mon, 10 Dec 2012 16:23:50 GMT\n Allow: INVITE, ACK, CANCEL, OPTIONS, BYE, REFER, SUBSCRIBE, NOTIFY, INFO, PUBLISH\n Supported: replaces, timer\n Subscription-State: terminated\n Event: check-sync\n Content-Length: 0\n ]]>\n\n","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"to programmatically restart Sangoma phones like:","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","content":[{"text":"./sipp 10.24.19.95 -sf checksync.xml -m 1\n","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"where 10.24.19.95 represents the IP address of the Sangoma phone to be restarted.","type":"text"}]},{"type":"paragraph","content":[{"text":"This is also possible using other tools, such as ","type":"text"},{"text":"sipsak","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/sipwise/sipsak"}}]},{"text":" with the following file:","type":"text"}]},{"type":"paragraph","content":[{"text":" sipsak reboot.phone restart example file","type":"text"}]},{"type":"codeBlock","content":[{"text":"NOTIFY sip:10.1.2.3 SIP/2.0\nTo: sip:10.1.2.3\nFrom: sip:asterisk@10.1.2.3\nCSeq: 10 NOTIFY\nCall-ID: 1234@10.1.2.3\nEvent: check-sync","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"as executed like:","type":"text"}]},{"type":"codeBlock","content":[{"text":"./sipsak -f reboot.phone -s sip:101@10.1.2.3","type":"text"}]},{"type":"paragraph","content":[{"text":"where 10.1.2.3 represents the IP address of the Sangoma phone to be restarted.","type":"text"}]},{"type":"paragraph"}],"version":1}

Browser not supported