{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"6"},"outline":{"value":"false"},"style":{"value":"none"},"type":{"value":"list"},"printable":{"value":"false"}},"macroMetadata":{"macroId":{"value":"8ad701d7-ec46-4fa1-a2fc-205528874417"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"d6479d34-7095-4c3e-8812-6577e720b983"}},{"type":"paragraph"},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Server Logs","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"When seeking support, it will often be helpful to know what shows up in the log files found in ","type":"text"},{"text":"/var/log/asterisk/sangomartapi/","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"By default, the log levels in these files are set to 'warn'. There will be times when these will need to be set to debug.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The level settings for the log files can be found in ","type":"text"},{"text":"/etc/asterisk/sangomartapi-logger.conf","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"After adjusting these, the sangomartapi service will need to be reloaded with \"fwconsole reload\" or \"fwconsole pm2 --restart sangomartapi\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When debugging is no longer needed, it is recommended to set the levels back to \"warn\" to avoid wasted disk space.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Troubleshoot Client Login Issues","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Logins fail due to \"","type":"text"},{"text":"Invalid Credentials","type":"text","marks":[{"type":"strong"}]},{"text":"\". This message is expected if:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The sangomaconnect module license is invalid/expired","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The user does not have the webrtc option enabled in their user settings, in the sangomaconnect tab","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enabling this setting should create an entry in the ","type":"text"},{"text":"webrtc_clients","type":"text","marks":[{"type":"strong"}]},{"text":" database table, so make sure this exists. The device number(shadow extension) is the 98(prefix)+extension","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The shadow extension should be included in ","type":"text"},{"text":"/etc/asterisk/pjsip.endpoint.conf","type":"text","marks":[{"type":"strong"}]},{"text":", which will have webrtc=yes","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The login credentials are not valid","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure the user can log into UCP with the same credentials used when trying to log in to the Sangoma Phone desktop client. While UCP access is not required, this can be a helpful test when trying to test user login credentials.","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"To further troubleshoot unexpected login failures that may or may not result in an \"Invalid Credentials\" error: ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure you are not seeing \"Invalid status code 500\" related to dphoneApiProxy in ","type":"text"},{"text":"/var/log/asterisk/sangomartapi/rtapi.log","type":"text","marks":[{"type":"strong"}]},{"text":". One cause of this could be when the dphone API from the restapps module is not working correctly. For example: ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"example of rtapi.log","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"}]},{"type":"codeBlock","content":[{"text":"2021-11-08T19:10:59.882Z app req: SID-1001 {\"method\":\"login\",\"params\":{\"extension\":\"301\",\"password\":\"301\",\"generateJwt\":true},\"id\":1,\"jsonrpc\":\"2.0\"}\n2021-11-08T19:11:00.831Z auth.login() error for extension [301]: Error: Invalid status code 500\n at ClientRequest. (/usr/src/freepbx/sangomartapi/node/lib/dphoneApiProxy.js:91:12)\n at Object.onceWrapper (events.js:315:30)\n at emitOne (events.js:116:13)\n at ClientRequest.emit (events.js:211:7)\n at HTTPParser.parserOnIncomingClient [as onIncoming] (_http_client.js:552:21)\n at HTTPParser.parserOnHeadersComplete (_http_common.js:119:17)\n at TLSSocket.socketOnData (_http_client.js:454:20)\n at emitOne (events.js:116:13)\n at TLSSocket.emit (events.js:211:7)\n at addChunk (_stream_readable.js:263:12)\n at readableAddChunk (_stream_readable.js:250:11)\n at TLSSocket.Readable.push (_stream_readable.js:208:10)\n at TLSWrap.onread (net.js:601:20)\nFrom previous event:\n at Object.module.exports.send (/usr/src/freepbx/sangomartapi/node/lib/dphoneApiProxy.js:59:9)\n at /usr/src/freepbx/sangomartapi/node/lib/rtapi/lib/session.js:88:26\nFrom previous event:\n at _authenticate (/usr/src/freepbx/sangomartapi/node/lib/rt api/lib/session.js:84:27)\n at module.exports.authenticate (/usr/src/freepbx/sangomartapi/node/lib/rtapi/lib/session.js:34:10)\n at module.exports.login (/usr/src/freepbx/sangomartapi/node/lib/rtapi/lib/auth.js:93:18)\n at executeFn (/usr/src/freepbx/sangomartapi/node/lib/rtapi/index.js:169:16)\n at bound (domain.js:301:14)\n at runBound (domain.js:314:12)\n at runCallback (timers.js:810:20)\n at tryOnImmediate (timers.js:768:5)\n at processImmediate [as _immediateCallback] (timers.js:745:5)\nFrom previous event:\n at exec1 (/usr/src/freepbx/sangomartapi/node/lib/rtapi/lib/jsonrpc.js:115:4)\n at module.exports.execute (/usr/src/freepbx/sangomartapi/node/lib/rtapi/lib/jsonrpc.js:90:11)\n at RealTimeApi.self.execute (/usr/src/freepbx/sangomartapi/node/lib/rtapi/index.js:531:13)\n at EventEmitter. (/usr/src/freepbx/sangomartapi/node/rtapi/rtapi.js:142:10)\n at emitTwo (events.js:126:13)\n at EventEmitter.emit (events.js:214:7)\n at WebSocket. (/usr/src/freepbx/sangomartapi/node/rtapi/wsif.js:60:11)\n at emitOne (events.js:116:13)\n at WebSocket.emit (events.js:211:7)\n at Receiver.receiverOnMessage (/usr/src/freepbx/sangomartapi/node/node_modules/ws/lib/websocket.js:834:20)\n at emitOne (events.js:116:13)\n at Receiver.emit (events.js:211:7)\n at Receiver.dataMessage (/usr/src/freepbx/sangomartapi/node/node_modules/ws/lib/receiver.js:437:14)\n at Receiver.getData (/usr/src/freepbx/sangomartapi/node/node_modules/ws/lib/receiver.js:367:17)\n at Receiver.startLoop (/usr/src/freepbx/sangomartapi/node/node_modules/ws/lib/receiver.js:143:22)\n at Receiver._write (/usr/src/freepbx/sangomartapi/node/node_modules/ws/lib/receiver.js:78:10)\n at doWrite (_stream_writable.js:396:12)\n at writeOrBuffer (_stream_writable.js:382:5)\n at Receiver.Writable.write (_stream_writable.js:290:11)\n2021-11-08T19:11:00.832Z app res: {\"sessionId\":\"SID-1001\",\"response\":{\"jsonrpc\":\"2.0\",\"error\":{\"code\":-32602,\"message\":\"Invalid method parameter(s) for: l\nogin\",\"data\":\"Login failed.\"},\"id\":1}}","type":"text"}]},{"type":"paragraph","content":[{"text":"To troubleshoot this:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure the restapps module is up to date and enabled","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Look at the /var/log/asterisk/dpmapps.log(needs to be enabled in Advanced Options) for clues","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Try other dphoneApps to see if they are also having problems","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure the Realtime API is reachable over the secure restapps port from a web browser, by going to:","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"https://[Sangoma Phone Desktop Client Host Address]:[Sangoma Phone Desktop Client Service Port]/rtapiws","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Going to that address from a browser should lead you to a page where you only see text saying \"Bad Request\". This means the connection to the realtime api is working, but you get that message since no request is being made.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you don't see that message, it could be a port forwarding issue, but first it's worth trying to restart apache, and sangomartapi","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"# apachectl restart","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"# fwconsole pm2 --restart sangomartapi","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You should also check the contents of ","type":"text"},{"text":"/etc/httpd/conf.d/ssl.conf","type":"text","marks":[{"type":"strong"}]},{"text":". You should see the following lines included in the VirtualHost entry for the port you have selected to be your Sangoma Phone Desktop Client Service secure port.","type":"text"}]},{"type":"paragraph","content":[{"text":"Snippet /etc/httpd/conf.d/ssl.conf","type":"text","marks":[{"type":"strong"}]}]}]}]}]}]},{"type":"codeBlock","content":[{"text":"\n RequestHeader set X-Real-IP %{REMOTE_ADDR}s\n \n ProxyPass ws://127.0.0.1:6006/rtapiws disablereuse=on\n ProxyPassReverse ws://127.0.0.1:6006/rtapiws\n\n \n\n RequestHeader set X-Real-IP %{REMOTE_ADDR}s\n \n ProxyPass ws://127.0.0.1:6006/sipws disablereuse=on\n ProxyPassReverse ws://127.0.0.1:6006/sipws\n","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure sangomartapi and the related modules listed above are up-to-date and enabled.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"At this time, those modules include the list found here: ","type":"text"},{"text":"How to Setup Sangoma Phone Desktop on the PBX#Modules","type":"text","marks":[{"type":"link","attrs":{"href":"https://sangomakb.atlassian.net/wiki/spaces/SS1/pages/31162639"}}]}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Incoming Calls to Sangoma Phone Fails","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Consider checking the system's hostname.","type":"text"}]},{"type":"paragraph","content":[{"text":"Symptoms","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Login is successful on the Sangoma Phone app. Outbound calls work fine.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Inbound calls fail. A packet trace will show a 503 unavailable response.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"asterisk will show a registration for the shadow extension/contact (98 + ext), but the status will be unavailable:","type":"text"}]},{"type":"paragraph","content":[{"text":"pjsip show aors","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"codeBlock","content":[{"text":"97932482*CLI> pjsip show aors\n \n Aor: \n Contact: \n==========================================================================================\n \n Aor: 98313 1\n Contact: 98313/sip:ufqe1ren@127.0.0.1:51200;transport ab20fc67b9 Unavail","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A shadow extension registration will look successful, but it will quickly get a status of Unavailable. For the shadow extension, registrations will come from 127.0.0.1 since they are being proxied by sangomartapi","type":"text"}]},{"type":"paragraph","content":[{"text":"pjsip set logger host 127.0.0.1","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"== WebSocket connection from '127.0.0.1:44066' for protocol 'sip' accepted using version '13'\n<--- Received SIP request (647 bytes) from WS:127.0.0.1:44066 --->\nREGISTER sip:97932.dep.pbxacttest.com:2443 SIP/2.0\nVia: SIP/2.0/WSS 48kraflecjhs.invalid;branch=z9hG4bK1561605\nMax-Forwards: 69\nTo: \nFrom: ;tag=j6tijnm3j3\nCall-ID: b6fcclj6rnrth92ed62uj1\nCSeq: 1 REGISTER\nContact: ;+sip.ice;reg-id=1;+sip.instance=\"\";expires=600\nExpires: 600\nAllow: INVITE,ACK,CANCEL,BYE,UPDATE,MESSAGE,OPTIONS,REFER,INFO,NOTIFY\nSupported: path,gruu,outbound\nUser-Agent: Sangoma macOS Softphone 3.1.0\nContent-Length: 0\n \n \n<--- Transmitting SIP response (505 bytes) to WS:127.0.0.1:44066 --->\nSIP/2.0 401 Unauthorized\nVia: SIP/2.0/WSS 48kraflecjhs.invalid;rport=44066;received=127.0.0.1;branch=z9hG4bK1561605\nCall-ID: b6fcclj6rnrth92ed62uj1\nFrom: ;tag=j6tijnm3j3\nTo: ;tag=z9hG4bK1561605\nCSeq: 1 REGISTER\nWWW-Authenticate: Digest realm=\"asterisk\",nonce=\"1639073091/e083eb3aa29c15917184ff0bde5cd151\",opaque=\"371c195c0e4dfb12\",algorithm=md5,qop=\"auth\"\nServer: FPBX-15.0.17.63(16.20.0)\nContent-Length: 0\n \n \n<--- Received SIP request (939 bytes) from WS:127.0.0.1:44066 --->\nREGISTER sip:97932.dep.pbxacttest.com:2443 SIP/2.0\nVia: SIP/2.0/WSS 48kraflecjhs.invalid;branch=z9hG4bK3934304\nMax-Forwards: 69\nTo: \nFrom: ;tag=j6tijnm3j3\nCall-ID: b6fcclj6rnrth92ed62uj1\nCSeq: 2 REGISTER\nAuthorization: Digest algorithm=MD5, username=\"98313\", realm=\"asterisk\", nonce=\"1639073091/e083eb3aa29c15917184ff0bde5cd151\", uri=\"sip:97932.dep.pbxacttest.com:2443\", response=\"3d3256eb5800698295cb7f7a2953e0ad\", opaque=\"371c195c0e4dfb12\", qop=auth, cnonce=\"2a75nkl08g4m\", nc=00000001\nContact: ;+sip.ice;reg-id=1;+sip.instance=\"\";expires=600\nExpires: 600\nAllow: INVITE,ACK,CANCEL,BYE,UPDATE,MESSAGE,OPTIONS,REFER,INFO,NOTIFY\nSupported: path,gruu,outbound\nUser-Agent: Sangoma macOS Softphone 3.1.0\nContent-Length: 0\n \n \n -- Added contact 'sip:i981r73s@127.0.0.1:44066;transport=WS' to AOR '98313' with expiration of 600 seconds\n<--- Transmitting SIP response (466 bytes) to WS:127.0.0.1:44066 --->\nSIP/2.0 200 OK\nVia: SIP/2.0/WSS 48kraflecjhs.invalid;rport=44066;received=127.0.0.1;branch=z9hG4bK3934304\nCall-ID: b6fcclj6rnrth92ed62uj1\nFrom: ;tag=j6tijnm3j3\nTo: ;tag=z9hG4bK3934304\nCSeq: 2 REGISTER\nDate: Thu, 09 Dec 2021 18:04:52 GMT\nContact: ;expires=599\nExpires: 600\nServer: FPBX-15.0.17.63(16.20.0)\nContent-Length: 0\n \n \n<--- Transmitting SIP request (450 bytes) to WS:127.0.0.1:44066 --->\nOPTIONS sip:i981r73s@127.0.0.1:44066;transport=WS SIP/2.0\nVia: SIP/2.0/WS 127.0.0.1:8088;rport;branch=z9hG4bKPjc6d376a0-e46e-46f8-86d5-d9c6fbd46d68;alias\nFrom: ;tag=69826e43-4f00-4c82-8b90-9a0360b0861c\nTo: \nContact: \nCall-ID: 424f2716-27ba-41ee-b540-27bf1f24f0e7\nCSeq: 43613 OPTIONS\nMax-Forwards: 70\nUser-Agent: FPBX-15.0.17.63(16.20.0)\nContent-Length: 0\n \n \n<--- Transmitting SIP request (661 bytes) to WS:127.0.0.1:44066 --->\nNOTIFY sip:i981r73s@127.0.0.1:44066;transport=WS SIP/2.0\nVia: SIP/2.0/WS 127.0.0.1:8088;rport;branch=z9hG4bKPj70bb8160-9c06-4075-b9ba-f94e1f01cd7a;alias\nFrom: ;tag=abfa1acf-68aa-41ed-b160-840ea24b8ec1\nTo: \nContact: \nCall-ID: cfe9c9b4-aa0b-473b-91d2-5b78c3cbcf94\nCSeq: 63330 NOTIFY\nSubscription-State: terminated\nEvent: message-summary\nAllow-Events: presence, dialog, message-summary, refer\nMax-Forwards: 70\nUser-Agent: FPBX-15.0.17.63(16.20.0)\nContent-Type: application/simple-message-summary\nContent-Length: 48\n \nMessages-Waiting: no\nVoice-Message: 0/0 (0/0)\n \n \n \n -- Contact 98313/sip:i981r73s@127.0.0.1:44066;transport=WS is now Unreachable. RTT: 0.000 msec\n97932*CLI>","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"The reason the shadow extension would get an Unreachable status is because the OPTIONS packet that is sent after registration never got an OK response. When looking at the packet trace above, look at the host values in the From and Contact header of the OPTIONS packet. Notice that it only has \"97932\", instead of \"","type":"text"},{"text":"97932.dep.pbxacttest.com","type":"text","marks":[{"type":"link","attrs":{"href":"http://97932.dep.pbxacttest.com"}}]},{"text":"\" like the other packets. This particular issue was resolved by setting the full HOSTNAME. While the problem was happening, the system only had \"97932\" in Admin→System Admin→Hostname(and /etc/hosts). Changing the Hostname value to \"","type":"text"},{"text":"97932.dep.pbxacttest.com","type":"text","marks":[{"type":"link","attrs":{"href":"http://97932.dep.pbxacttest.com"}}]},{"text":"\" resolved the issue.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Troubleshoot Issues with Contact Searching, or Playing Voicemail","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"If searching for Contacts unexpectedly leads to no results, or there are issues playing Voicemail messages:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure \"Sangoma Phone Desktop Client Host Address\" is set to a valid address, found in Admin→SangomaConnect→Settings","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Contacts must exist for the Internal/External groups in Admin→Contact Manager","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check that the user is entering the same Host Address that is set in SangomaConnect's Settings when logging in","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Login Host should be ","type":"text"},{"text":"[Sangoma Phone Desktop Client Host Address]:[Sangoma Phone Desktop Client Service port]","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure the PBX's HTTPS SSL certificate's common name also matches the Sangoma Phone Desktop Client Host Address","type":"text"}]}]}]}]}]}],"version":1}

Browser not supported