- Freeswitch-docs - FreeSWITCH Mailing Lists

FS1.6 instalaion instruction on CentOS7 and RHEL7
by Sergey Safarov 16 Feb '16

16 Feb '16

I has write instalation instruction <https://freeswitch.org/confluence/pages/viewpage.action?pageId=10289546> for CentOS7 and RHEL7 Please replace CentOS 7 <page https://freeswitch.org/confluence/display/FREESWITCH/CentOS+7> by new Sergey

2 2

Confluence UML diagrams
by Bote Man 01 Feb '16

01 Feb '16

After Luis Quiroz suggested UML diagrams to document call flow I checked and discovered that Confluence has the PlantUML add-on installed. I created a couple examples on the Standards page. https://freeswitch.org/confluence/display/FREESWITCH/Confluence+Wiki+Standar ds+and+Guidelines#ConfluenceWikiStandardsandGuidelines-UMLDiagrams They are very nice with lots of options for color and formatting. I made a very trivial start to FreeSWITCH call flow on the Life Cycle page, but I don't have a good enough understanding to make it useful. Feel free to improve the diagram. --- Bote FreeSWITCH Docs Janitor http://freeswitch.org/confluence

2 2

Provider equada GmbH
by Oliver Jörg 29 Jan '16

29 Jan '16

Hi, We are a german SIP provider and would like to be published in your "Providers ITSPs" section. Hereafter you can find the needed settings for registering and suggestions for inbound and outbound rules. The userspecific values are colored in orange. If you need any further inforamtion, please do not hesitate to contact us. Thanks in advance. Heading: equada (DE) equada.xml (File in /etc/freeswitch/sip_profiles/external") <include> <gateway name="equada-trunk"> <param name="username" value="SIP-Account"/> <param name="realm" value="SIP-Domain/Realm"/> <param name="password" value="SIP-Password"/> <param name="outbound-proxy" value="trunking.pbx-network.de"/> <param name="register-proxy" value="trunking.pbx-network.de"/> <param name="expire-seconds" value="800"/> <param name="register" value="true"/> <param name="retry-seconds" value="20"/> <param name="ping" value="10"/> <param name="context" value="public"/> </gateway> </include> equada-outbound.xml (File in "/etc/freeswitch/dialplan/default) <include> <extension name="equada-outbound"> <condition field="destination_number" expression="(\d+)$"> <action application="set" data="effective_caller_id_number=${outbound_caller_id_number}"/> <action application="set" data="sip_h_P-Preferred-Identity=sip:${outbound_caller_id_number}@pbx-network.de"/> <action application="bridge" data="{sip_cid_type=pid}sofia/gateway/equada-trunk/$1"/> </condition> </extension> </include> 00_inbound_did.xml (File in /etc/freeswitch/dialplan/public) <include> <extension name="public_did"> <condition field="destination_number" expression="number"> <action application="set" data="domain_name=$${domain}"/> <action application="answer"/> <action application="playback" data="/usr/share/freeswitch/sounds/en/us/callie/misc/48000/misc-your_call_has_been_terminated.wav"/> </condition> </extension> </include> Best regards, Oliver Jörg equada GmbH equada GmbH, Am neuen Berg 3, 63755 Alzenau Internet: www.equada.de<http://www.equada.de/> * Email: info(a)equada.de<mailto:info@equada.de> Geschäftsführer: Lorenz Barth, Bernd Büdenbender Eingetragen unter HRB10130 beim AG Aschaffenburg USt-ID: DE256347886

2 1

mod_dptools titles
by Bote Man 18 Jan '16

18 Jan '16

Back when I was very anal-retentive I started to remove the string "mod_dptools" from the titles of the dialplan application pages. I was concerned about the colon messing up the URL of the individual pages. I have come to my senses and restored that string to most of them at the start of the alphabetic listing. I still need to work on the final 6 pages at the bottom of the list. Sorry for the mixup. --- Bote FreeSWITCH Docs Janitor http://freeswitch.org/confluence

1 0

better documentation
by Mundkowsky, Robert 28 Dec '15

28 Dec '15

Hi, It is very difficult to use Freeswitch, because the documentation is very difficult to use. If the documentation was better you would have a lot more users. For example, in https://wiki.freeswitch.org/wiki/Sofia_Configuration_Files , I can read the whole page and I still do not understand fundamental things like: 1) What is a domain? 2) What is a profile? 3) What is a gateway? 4) How is a gateway different than a normal SIP end point? Simple definitions of key ideas and a structured top down descript would help a lot. And there is a lot of useless statements that one has to read through that does not help. For example, "The best thing to do is take a look at these things from a step back." Also it is common to explain what something is not, rather than explaining what it is first. Robert ________________________________ This e-mail and any files transmitted with it may contain privileged or confidential information. It is solely for use by the individual for whom it is intended, even if addressed incorrectly. If you received this e-mail in error, please notify the sender; do not disclose, copy, distribute, or take any action in reliance on the contents of this information; and delete it from your system. Any other use of this e-mail is prohibited. Thank you for your compliance. ________________________________

3 2

First draft of a "Howto write an endpoint module"
by Pat Beirne 28 Dec '15

28 Dec '15

Good morning. I have submitted a "New Endpoints" page to the confluence. It's located under the "New Modules", as it expands on that topic. Right now it's marked for confluence-editors and -devs. If anyone has a chance, I'd appreciate comments. If there's no comments in a weeks, I'll unlock it for public view. I had to add some anchors to "New Modules", I hope that's ok Italo. Pat

5 7

snmp issue from irc
by Michael Jerris 23 Dec '15

23 Dec '15

spyder13337 2:10 i am somewhat new new to cacti and snmpd and i spent some 3 or so months on trying to graph FreeSWITCH current calls to cacti to just now found out that the material on your website is incorrect "https://wiki.freeswitch.org/wiki/Snmp_Cacti <https://wiki.freeswitch.org/wiki/Snmp_Cacti>" the OID number that you want to use is .1.3.6.1.4.1.2021.8.1.101.1 if any one has access please update thank you

1 0

Re: [Freeswitch-docs] [Freeswitch-users] unable to get transfer_on_fail to work
by Brian West 25 Nov '15

25 Nov '15

And for those wondering: <extension name="call to 1234"> <condition field="destination_number" expression="^(1234)$"> <action application="set" data="orig_dest=$1"/> <action application="set" data="bypass_media=true"/> <action application="set" data="hangup_afer_bridge=true"/> <action application="set" data= "transfer_on_fail=PROGRESS_TIMEOUT,USER_BUSY,NORMAL_TEMPORARY_FAILURE"/> <action application="bridge" data="{progress_timeout=2}sofia/external/ sip:1234@192.168.1.123"/> </condition> </extension> <*extension* name="call to 1234"> <condition field="destination_number" expression="^PROGRESS_TIMEOUT$"> <action application="log" data="CRIT We can have progress timeouts?"/> </condition> </extension> See XML on https://freeswitch.org/jira/browse/FS-3193 I fear this isn't documented correctly. On Wed, Nov 25, 2015 at 4:53 PM, Brian West <brian(a)freeswitch.org> wrote: > There is no such thing as hangup_on_bridge, and if you wish to try a > different gateway if the first one doesn't respond quick enough with > progress do this: > > <extension name="call to 1234"> > > <condition field="destination_number" expression="^1234$"> > > <action application="set" data="bypass_media=true"/> > > <action application="set" data="hangup_after_bridge=true"/> > > <action application="bridge" data="{progress_timeout=2}sofia/internal/ > sip:1234@switch2-asdfa.com"/> > > <action application="bridge" data= > "{progress_timeout=10}sofia/internal/sip:1234@switch1-asdfa.com"/> > > </condition> > > </extension> > > > There is no reason to do what you were doing in this case. > > On Wed, Nov 25, 2015 at 12:42 PM, Gabriel Kuri <gkuri(a)ieee.org> wrote: > >> I can't seem to get transfer_on_fail to work. I'm not sure what I'm doing >> wrong, it just doesn't transfer to the transfer_on_fail extension. The >> dialplan is below. >> >> The idea is to set leg_progress_timeout = 3, so that if the device isn't >> responding to INVITEs, we use transfer_on_fail with the cause >> PROGRESS_TIMEOUT to send the call somewhere else. But transfer_on_fail >> never seems to get executed when we test it out. The FS logs show that >> we're hitting PROGRESS_TIMEOUT when the device doesn't respond to INVITEs, >> so I'm pretty sure we have the right hangup cause, but it's just not >> catching transfer_on_fail ... >> >> <document type="freeswitch/xml"> >> <section name="dialplan" description="Dial Plan for FreeSWITCH"> >> <context name="default"> >> <extension name="call to 12225551212"> >> <condition field="destination_number" expression="12225551212"> >> <action application="set" data="bypass_media=true"/> >> <action application="set" data="continue_on_fail=true"/> >> <action application="set" data="hangup_on_bridge=true"/> >> <action application="export" data="leg_progress_timeout=3"/> >> <action application="set" >> data="transfer_on_fail=PROGRESS_TIMEOUT NETWORK_UNAVAIL xml error"/> >> <action application="bridge" >> data="${sofia_contact(12225551212(a)switch.local)"/> >> </condition> >> </extension> >> </context> >> <context name="error"> >> <extension name="NETWORK_UNAVAIL"> >> <condition field="${originate_disposition}" >> expression="PROGRESS_TIMEOUT" continue="false" break="on-true"> >> <action application="bridge" data="sofia/external/12345551212 >> @switch2.local"/> >> </condition> >> </extension> >> </context> >> </section> >> </document> >> >> Here's a small snippet of the logs when leg_progress_timeout expires ... >> >> b54a79cd-85f1-4c15-929d-15b1654ff1de 2015-11-24 22:06:21.021538 [DEBUG] >> switch_ivr_originate.c:3727 Originate Resulted in Error Cause: 607 >> [PROGRESS_TIMEOUT] >> b54a79cd-85f1-4c15-929d-15b1654ff1de 2015-11-24 22:06:21.021538 [INFO] >> mod_dptools.c:3333 Originate Failed. Cause: PROGRESS_TIMEOUT >> >> >> Thanks ... >> >> >> >> _________________________________________________________________________ >> Professional FreeSWITCH Consulting Services: >> consulting(a)freeswitch.org >> http://www.freeswitchsolutions.com >> >> Official FreeSWITCH Sites >> http://www.freeswitch.org >> http://confluence.freeswitch.org >> http://www.cluecon.com >> >> FreeSWITCH-users mailing list >> FreeSWITCH-users(a)lists.freeswitch.org >> http://lists.freeswitch.org/mailman/listinfo/freeswitch-users >> UNSUBSCRIBE:http://lists.freeswitch.org/mailman/options/freeswitch-users >> http://www.freeswitch.org >> > > > > -- > > *Brian West* > brian(a)freeswitch.org > > > *Twitter: @FreeSWITCH , @briankwest* > http://www.freeswitchbook.com > http://www.freeswitchcookbook.com > > Got Bugs? Report them here <https://freeswitch.org/jira>! | Reddit: > /r/freeswitch <https://www.reddit.com/r/freeswitch> > > *T:*+19184209001 | *F:*+19184209002 | *M:*+1918424WEST (9378) > *iNUM:*+883 5100 1420 9001 | *ISN:*410*543 | *Skype:*briankwest > -- *Brian West* brian(a)freeswitch.org *Twitter: @FreeSWITCH , @briankwest* http://www.freeswitchbook.com http://www.freeswitchcookbook.com Got Bugs? Report them here <https://freeswitch.org/jira>! | Reddit: /r/freeswitch <https://www.reddit.com/r/freeswitch> *T:*+19184209001 | *F:*+19184209002 | *M:*+1918424WEST (9378) *iNUM:*+883 5100 1420 9001 | *ISN:*410*543 | *Skype:*briankwest

1 1

Variables: enable_heartbeat_events, heartbeat_fire_on_set
by Stanislav Sinyagin 20 Nov '15

20 Nov '15

before I dig into the sources, probably someone can give a short explanation for these variables: enable_heartbeat_events heartbeat_fire_on_set thanks

1 0

Variables that seem to not be documented...
by Brian West 20 Nov '15

20 Nov '15

Neither of these variables are documented. video_mirror_input and video_use_dedicated_encoder Where these are most useful are when you have a lower rest endpoint needing to call into a conference and the video res on the output to the caller needs to match the input from the caller, think polycom VVX1500 or other such lower rest video phone. So setting video_mirror_input=true and video_use_dedicated_encoder=true would trigger the output to match the input of the video from the caller. Thanks, -- *Brian West* brian(a)freeswitch.org *Twitter: @FreeSWITCH , @briankwest* http://www.freeswitchbook.com http://www.freeswitchcookbook.com Got Bugs? Report them here <https://freeswitch.org/jira>! | Reddit: /r/freeswitch <https://www.reddit.com/r/freeswitch> *T:*+19184209001 | *F:*+19184209002 | *M:*+1918424WEST (9378) *iNUM:*+883 5100 1420 9001 | *ISN:*410*543 | *Skype:*briankwest

2 3