Freeswitch Module - Revision history

Tampa at 06:29, 7 August 2024

2024-08-07T06:29:24Z

Ubit: /* Firewall Config */

2024-08-06T21:31:47Z

‎Firewall Config

Manni: /* FreeSwitch Install */

2023-01-07T22:30:20Z

‎FreeSwitch Install

Manni: /* FreeSwitch Install */

2023-01-07T22:22:20Z

‎FreeSwitch Install

Manni: /* FreeSwitch Install */

2023-01-07T22:21:01Z

‎FreeSwitch Install

Manni: /* FreeSwitch Install */

2023-01-07T22:20:03Z

‎FreeSwitch Install

Manni at 09:02, 13 March 2021

2021-03-13T09:02:11Z

JeffKelley: Freeswitch wiki links update

2019-01-23T10:43:08Z

Freeswitch wiki links update

Justincc: fix zak url

2014-06-27T21:02:20Z

fix zak url

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

2012-03-04T06:32:18Z

Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

← Older revision		Revision as of 06:29, 7 August 2024
Line 1:		Line 1:
−	{{Quicklinks}} <br />	+	{{Quicklinks\|Freeswitch_Module}} <br />

	{{thirdparty}}		{{thirdparty}}

@@ Line 242: / Line 242: @@
 == Firewall Config ==
-Basically open ports 1720 and 5060, and maybe 50505 must be open for listening.
+Basically ports 1720 and 5060, and maybe 5050 must be open for listening.
 Make sure that the ports used by Freeswitch are accessible though your firewall(s). In the example above the main port used is 5060 though other ports may be used for call initiation (port 1720 for H.323 Call Signalling) and dynamically assigned ports for specific call traffic. The usual H.323 and SIP traffic dynamic port handling on modern firewalls usually enables this.

← Older revision		Revision as of 22:30, 7 January 2023
Line 25:		Line 25:

	''Note: Freeswitch Git master as of 18th April 2011 already has codecs/mod_siren configured''		''Note: Freeswitch Git master as of 18th April 2011 already has codecs/mod_siren configured''
−
−	* You can also use this [http://madhawa.com/?p=10 guide] for setting it up in a quick way -- [[User:Fly-man-\|Fly-man-]]

	<u>January 2019 update</u> : The Freeswitch wiki is now at https://freeswitch.org/confluence/. As stated, « The sprint that copied remaining pages from the old mediawiki to Confluence has given us all the documentation fit to print, however they are not organized well. Search is your friend. »		<u>January 2019 update</u> : The Freeswitch wiki is now at https://freeswitch.org/confluence/. As stated, « The sprint that copied remaining pages from the old mediawiki to Confluence has given us all the documentation fit to print, however they are not organized well. Search is your friend. »

@@ Line 16: / Line 16: @@
 Follow the [https://developer.signalwire.com/freeswitch/FreeSWITCH-Explained/Installation/#Compiling_and_Installation compilation instructions in the FreeSWITCH wiki]. '''Please ensure you compile from the freeswitch trunk for now until we can post a minimum version number (there are known issues with older versions)'''. For OpenSim's purposes, we need to enable two specific modules.
-Make sure to <s>[http://wiki.freeswitch.org/wiki/Installation_Guide#Compile_and_Install_Sounds install the hold music]</s> (dead link) if you are not going to disable it in the "configure conference.conf.xml" section below.
+Make sure to [https://developer.signalwire.com/freeswitch/FreeSWITCH-Explained/Installation/#Compile_and_Install_Sounds install the hold music] if you are not going to disable it in the "configure conference.conf.xml" section below.
 When you get to "'''Edit modules.conf'''" section of the Freeswitch build instructions, edit the modules.conf file and uncomment to make active the entries for xml_curl and the siren14 codec

@@ Line 14: / Line 14: @@
 == FreeSwitch Install ==
-Follow the <s>[https://developer.signalwire.com/freeswitch/FreeSWITCH-Explained/Installation/#Compiling_and_Installation compilation instructions in the FreeSWITCH wiki]</s>. (dead link) '''Please ensure you compile from the freeswitch trunk for now until we can post a minimum version number (there are known issues with older versions)'''. For OpenSim's purposes, we need to enable two specific modules.
+Follow the [https://developer.signalwire.com/freeswitch/FreeSWITCH-Explained/Installation/#Compiling_and_Installation compilation instructions in the FreeSWITCH wiki]. '''Please ensure you compile from the freeswitch trunk for now until we can post a minimum version number (there are known issues with older versions)'''. For OpenSim's purposes, we need to enable two specific modules.
 Make sure to <s>[http://wiki.freeswitch.org/wiki/Installation_Guide#Compile_and_Install_Sounds install the hold music]</s> (dead link) if you are not going to disable it in the "configure conference.conf.xml" section below.

← Older revision		Revision as of 09:02, 13 March 2021
Line 8:		Line 8:

	* http://zaki.asia/2009/04/28/freeswitch-module-in-opensim.html		* http://zaki.asia/2009/04/28/freeswitch-module-in-opensim.html
		+
		+	How To Install FreeSwitch PBX on Ubuntu 20.04 and 18.04
		+	* https://computingforgeeks.com/how-to-install-freeswitch-pbx-on-ubuntu/

	== FreeSwitch Install ==		== FreeSwitch Install ==

@@ Line 11: / Line 11: @@
 == FreeSwitch Install ==
-Follow the [http://wiki.freeswitch.org/wiki/Installation_Guide#Compiling_and_Installation compilation instructions in the FreeSWITCH wiki]. '''Please ensure you compile from the freeswitch trunk for now until we can post a minimum version number (there are known issues with older versions)'''. For OpenSim's purposes, we need to enable two specific modules.
+Follow the <s>[http://wiki.freeswitch.org/wiki/Installation_Guide#Compiling_and_Installation compilation instructions in the FreeSWITCH wiki]</s>. (dead link) '''Please ensure you compile from the freeswitch trunk for now until we can post a minimum version number (there are known issues with older versions)'''. For OpenSim's purposes, we need to enable two specific modules.
-Make sure to [http://wiki.freeswitch.org/wiki/Installation_Guide#Compile_and_Install_Sounds install the hold music] if you are not going to disable it in the "configure conference.conf.xml" section below.
+Make sure to <s>[http://wiki.freeswitch.org/wiki/Installation_Guide#Compile_and_Install_Sounds install the hold music]</s> (dead link) if you are not going to disable it in the "configure conference.conf.xml" section below.
 When you get to "'''Edit modules.conf'''" section of the Freeswitch build instructions, edit the modules.conf file and uncomment to make active the entries for xml_curl and the siren14 codec
@@ Line 24: / Line 24: @@
 * You can also use this [http://madhawa.com/?p=10 guide] for setting it up in a quick way -- [[User:Fly-man-|Fly-man-]]
 == FreeSwitch Config ==

@@ Line 7: / Line 7: @@
 A little history on the development of the FreeSWITCH module is given here:
-* http://zaki.asia/2009/04/28/freeswitch-module-in-opensim/
+* http://zaki.asia/2009/04/28/freeswitch-module-in-opensim.html
 == FreeSwitch Install ==

@@ Line 3: / Line 3: @@
 {{thirdparty}}
-The FreeSWITCH module enables voice in OpenSim with no changes required to the Linden Labs Second Life viewer. For OpenSim 0.7.0.2 and earlier, the viewer must be between versions 1.22 and 1.23.5. For OpenSim 0.7.1 and later 2.x viewers will also work.
+The FreeSWITCH module enables voice in OpenSimulator with no changes required to the Linden Labs Second Life viewer. For OpenSimulator 0.7.0.2 and earlier, the viewer must be between versions 1.22 and 1.23.5. For OpenSimulator 0.7.1 and later 2.x viewers will also work.
 A little history on the development of the FreeSWITCH module is given here:
@@ Line 49: / Line 49: @@
 You can set this up by editing /usr/local/freeswitch/conf/autoload_configs/xml_curl.conf.xml.
-==== OpenSim 0.7.1 and later ====
+==== OpenSimulator 0.7.1 and later ====
-You can replace the existing config with the following settings, or just add the directory and dialplan bindings. The IP address is used by the Freeswitch server to reach the OpenSim freeswitch service to fetch its configuration details. If you're running everything on a single server and your system has only one IP address, this can simply be localhost. If you're running freeswitch on another server or you have multiple IP addresses then this explicitly needs to be your standalone's address.
+You can replace the existing config with the following settings, or just add the directory and dialplan bindings. The IP address is used by the Freeswitch server to reach the OpenSimulator freeswitch service to fetch its configuration details. If you're running everything on a single server and your system has only one IP address, this can simply be localhost. If you're running freeswitch on another server or you have multiple IP addresses then this explicitly needs to be your standalone's address.
 You will also need to change the port number if you're using a different standalone HTTP port from the default (9000).
@@ Line 73: / Line 73: @@
   &lt;/configuration&gt;
-==== OpenSim 0.7.0.2 and earlier ====
+==== OpenSimulator 0.7.0.2 and earlier ====
-For OpenSim 0.7.0.2 and earlier the setup is identical except that the gateway-url paths start with /api rather than /fsapi.
+For OpenSimulator 0.7.0.2 and earlier the setup is identical except that the gateway-url paths start with /api rather than /fsapi.
   &lt;configuration name="xml_curl.conf" description="cURL XML Gateway"&gt;
@@ Line 235: / Line 235: @@
   Is port 50505 actually used, or is it just something that must be
-  reported by OpenSim when the Freeswitch service makes contact?
+  reported by OpenSimulator when the Freeswitch service makes contact?
 <br /> More details on the Freeswitch ports used and firewall configuration details are at http://wiki.freeswitch.org/wiki/Firewall
@@ Line 243: / Line 243: @@
 == Starting everything up ==
-. Freeswitch fetches OpenSim related configuration from the OpenSim freeswitch voice module and service that we set up earlier. Therefore, you need to start OpenSim first. On startup you should see the lines
+. Freeswitch fetches OpenSimulator related configuration from the OpenSimulator freeswitch voice module and service that we set up earlier. Therefore, you need to start OpenSimulator first. On startup you should see the lines
 :45:33 - [FreeSwitchVoice]: using FreeSwitch server <your ip address>
@@ Line 260: / Line 260: @@
 You can ignore these errors for now - they should be fixed in the future but will not prevent Freeswitch from working.
-On the OpenSim region (on standalone) or grid console (on grid) you should see the lines
+On the OpenSimulator region (on standalone) or grid console (on grid) you should see the lines
   [FreeSwitchVoice]: Received request for config section directory, event calling function 'config_sofia'
@@ Line 266: / Line 266: @@
   [FreeSwitchVoice]: Received request for config section directory, event calling function 'switch_load_network_lists'
-. Now, make sure your parcel in the region has voice enabled in the parcel dialog. You may need to change this and then restart OpenSim if it wasn't previously set.
+. Now, make sure your parcel in the region has voice enabled in the parcel dialog. You may need to change this and then restart OpenSimulator if it wasn't previously set.
 . Login your client. Make sure you have voice enabled and it's working (probably by testing on another grid first).
@@ Line 274: / Line 274: @@
   [FreeSwitchVoice]: OnRegisterCaps() called with agentID 0fe223e7-370a-46da-b935-b0831ddf6d08 caps OpenSim.Framework.Capabilities.Caps in scene test2
-amongst others on the OpenSim region console. And on the freeswitch console you should see something like
+amongst others on the OpenSimulator region console. And on the freeswitch console you should see something like
 <pre>
@@ Line 333: / Line 333: @@
 * conference list <--- to see if you have any conferences setup (note you have to be inworld when you try this)
-* xml_curl debug_on <--- this command will dump the transactions between OpenSim and FreeSWITCH into a file (on linux it is in /tmp)
+* xml_curl debug_on <--- this command will dump the transactions between OpenSimulator and FreeSWITCH into a file (on linux it is in /tmp)
 * xml_curl debug_off <-- turn it off after you login/logout a few times
@@ Line 350: / Line 350: @@
 . You appear as one user in the SL Viewers, ALL other users appear as a single "user" with a coded name for the other users on the channel - something like conf-x9999999999999999999.
-. You must have voice enabled at the region, AND the plot level. This is a pain, as the default setting in OpenSim is that PLOTS have voice turned off. The standard viewers 1.23 and 2.x do not allow you to turn this back on, so you must use a third party viewer to turn on PLOT voice. I have asked before that we change the default setting when a plot is created to have this on by default (or on if the region voice is on - which it is by default).
+. You must have voice enabled at the region, AND the plot level. This is a pain, as the default setting in OpenSimulator is that PLOTS have voice turned off. The standard viewers 1.23 and 2.x do not allow you to turn this back on, so you must use a third party viewer to turn on PLOT voice. I have asked before that we change the default setting when a plot is created to have this on by default (or on if the region voice is on - which it is by default).
 . We are not sure if you MUST start FreeSwitch.exe before the regions that you want voice to work on. But we do so for safety. It works fine over OpenSim.exe restarts without FreeSwitch being started again.
@@ Line 356: / Line 356: @@
 . If you wish to use FreeSwitch beyond your local network, remember to configure for EXTERNALLY accessible IP addresses. Use IP numbers for FreeSwitch... and if there are 192.168.x.x style local net addresses in there you will not get FreeSwitch to work with external users. It can work through a range of firewalls with suitable mechanisms such as port forwarding or DMZs, so long as you definitely map to the externally visible IP address. Ensure you have the appropriate ports open in your Firewall(s). See separate section in Wiki on ports required.
-. There are some red errors on startup of FreeSwitch - at least in our setup - which appears to be related to a missing config file that FreeSwitch tries to retrieve from OpenSim (opensim-region-server-url:port/api/freeswitch-config) that is not in the OpenSim setup... We have (safely?) ignored those without problems...
+. There are some red errors on startup of FreeSwitch - at least in our setup - which appears to be related to a missing config file that FreeSwitch tries to retrieve from OpenSimulator (opensim-region-server-url:port/api/freeswitch-config) that is not in the OpenSimulator setup... We have (safely?) ignored those without problems...
 -11-13 14:42:55.252361 [ERR] mod_xml_curl.c:252 Received HTTP error 0 trying