Freeswitch Voicemail On Alpine Linux - Revision history

Sertonix: replace /etc/init.d with rc-service

2023-11-17T10:24:48Z

replace /etc/init.d with rc-service

← Older revision		Revision as of 10:24, 17 November 2023
Line 34:		Line 34:
	Start Freeswitch and add it to the default runlevel.		Start Freeswitch and add it to the default runlevel.
	rc-update add freeswitch		rc-update add freeswitch
	~~/etc/init.d/~~freeswitch start		rc-service freeswitch start
	You should now be able to dial into Freeswitch voicemail by registering a SIP user agent to one of the Freeswitch default local extensions (user=1000-1019, password=12345 as defined above) and directing a SIP call to any of the other extensions between 1000 and 1019, or the extension 4000. For each voicemail account, the default password is the same as the extension. For more details on this, please refer to Freeswitch documentation. Please keep in mind that these extensions and voicemail are part of the sample config and are not managed by ACF. We will add ACF-managed voicemail accounts below.		You should now be able to dial into Freeswitch voicemail by registering a SIP user agent to one of the Freeswitch default local extensions (user=1000-1019, password=12345 as defined above) and directing a SIP call to any of the other extensions between 1000 and 1019, or the extension 4000. For each voicemail account, the default password is the same as the extension. For more details on this, please refer to Freeswitch documentation. Please keep in mind that these extensions and voicemail are part of the sample config and are not managed by ACF. We will add ACF-managed voicemail accounts below.

Line 73:		Line 73:
	sed -i s/'name="file-extension" value="wav"'/'name="file-extension" value="mp3"'/ /etc/freeswitch/autoload_configs/voicemail.conf.xml		sed -i s/'name="file-extension" value="wav"'/'name="file-extension" value="mp3"'/ /etc/freeswitch/autoload_configs/voicemail.conf.xml
	=== 3. Restart Freeswitch ===		=== 3. Restart Freeswitch ===
	~~/etc/init.d/~~freeswitch restart		rc-service freeswitch restart
	== Using PostgreSQL ==		== Using PostgreSQL ==
	Freeswitch-1.2.5 and acf-freeswitch-vmail-0.5.0 fully support Postgresql as the voicemail database. These versions are available in Alpine Linux 3.2 and later. To configure it:		Freeswitch-1.2.5 and acf-freeswitch-vmail-0.5.0 fully support Postgresql as the voicemail database. These versions are available in Alpine Linux 3.2 and later. To configure it:
Line 80:		Line 80:
	=== 2. Setup and Start Postgresql ===		=== 2. Setup and Start Postgresql ===
	rc-update add postgresql		rc-update add postgresql
	~~/etc/init.d/~~postgresql setup		rc-service postgresql setup
	~~/etc/init.d/~~postgresql start		rc-service postgresql start
	=== 3. Create the Database ===		=== 3. Create the Database ===
	psql -U postgres -c "CREATE DATABASE voicemail"		psql -U postgres -c "CREATE DATABASE voicemail"
	=== 4. Stop Freeswitch ===		=== 4. Stop Freeswitch ===
	~~/etc/init.d/~~freeswitch stop		rc-service freeswitch stop
	{{Note\|Freeswitch does not always stop properly. You might need to run 'ps ax' to find the process and 'kill' it. Running '~~/etc/init.d/~~freeswitch zap' might also be necessary.}}		{{Note\|Freeswitch does not always stop properly. You might need to run 'ps ax' to find the process and 'kill' it. Running 'rc-service freeswitch zap' might also be necessary.}}
	=== 5. Configure Freeswitch and acf-freeswitch-vmail ===		=== 5. Configure Freeswitch and acf-freeswitch-vmail ===
	Edit /etc/freeswitch/autoload_configs/voicemail.conf.xml to set the odbc-dsn param to "pgsql://hostaddr=127.0.0.1 dbname=voicemail user=postgres password= options=''"		Edit /etc/freeswitch/autoload_configs/voicemail.conf.xml to set the odbc-dsn param to "pgsql://hostaddr=127.0.0.1 dbname=voicemail user=postgres password= options=''"
Line 93:		Line 93:
	dsn=pgsql://hostaddr=127.0.0.1 dbname=voicemail user=postgres password= options=''		dsn=pgsql://hostaddr=127.0.0.1 dbname=voicemail user=postgres password= options=''
	=== 6. Restart Freeswitch ===		=== 6. Restart Freeswitch ===
	~~/etc/init.d/~~freeswitch start		rc-service freeswitch start

	[[Category:ACF]]		[[Category:ACF]]

Zcrayfish: Removed a hyperlink to a hypothetical URL.

2021-12-20T21:20:40Z

Removed a hyperlink to a hypothetical URL.

← Older revision		Revision as of 21:20, 20 December 2021
Line 45:		Line 45:

	= ACF Web interface =		= ACF Web interface =
	You can now browse to https://IPADDRESS to access the web interface. To log in for administration, use the root user and the system root password (this is the default configuration set up by setup-acf).		You can now browse to <nowiki>https://IPADDRESS</nowiki> to access the web interface. To log in for administration, use the root user and the system root password (this is the default configuration set up by setup-acf).
	== Users ==		== Users ==
	The Voicemail \| Users tab will display all of the voicemail users that are managed through the ACF web interface. At the start, this will be empty. When you create Users in the ACF, it will modify the Freeswitch dialplan and directory (using xml_curl) to allow these users to receive and retrieve voicemail. It will also allow these users log into the ACF interface to check their voicemail and modify voicemail settings. The password defined here will control both ACF and IVR access.		The Voicemail \| Users tab will display all of the voicemail users that are managed through the ACF web interface. At the start, this will be empty. When you create Users in the ACF, it will modify the Freeswitch dialplan and directory (using xml_curl) to allow these users to receive and retrieve voicemail. It will also allow these users log into the ACF interface to check their voicemail and modify voicemail settings. The password defined here will control both ACF and IVR access.

Ttrask: Fix typo

2016-09-08T20:15:58Z

Fix typo

← Older revision		Revision as of 20:15, 8 September 2016
Line 39:		Line 39:
	== 5. Configure acf-freeswitch-vmail ==		== 5. Configure acf-freeswitch-vmail ==
	Add the voicemail authenticator to the ACF configuration. This will allow voicemail users to log into ACF to check their voicemail.		Add the voicemail authenticator to the ACF configuration. This will allow voicemail users to log into ACF to check their voicemail.
	echo "authenticator = authenticator-freeswitch-vmail~~.lua~~,authenticator-plaintext" >> /etc/acf/acf.conf		echo "authenticator = authenticator-freeswitch-vmail,authenticator-plaintext" >> /etc/acf/acf.conf
	Change the ACF voicemail domain to match the domain from the sample config. You should use the IP address of your voicemail server, as this is what the sample config uses.		Change the ACF voicemail domain to match the domain from the sample config. You should use the IP address of your voicemail server, as this is what the sample config uses.
	sed -i /^domain=/d /etc/freeswitchvmail.conf		sed -i /^domain=/d /etc/freeswitchvmail.conf

Ttrask: Add instructions to record in mp3 format

2016-07-13T17:45:23Z

Add instructions to record in mp3 format

← Older revision		Revision as of 17:45, 13 July 2016
Line 25:		Line 25:
	And modify ''/etc/freeswitch/autoload_configs/modules.conf.xml'' to load the mod_xml_curl module		And modify ''/etc/freeswitch/autoload_configs/modules.conf.xml'' to load the mod_xml_curl module
	<load module="mod_xml_curl"/>		<load module="mod_xml_curl"/>
	{{Note\|These following items are not needed for Alpine Linux 3.2 or later. They are needed on earlier versions due to bad default paths in the ~~freeswitch~~ package.}}		{{Note\|These following items are not needed for Alpine Linux 3.2 or later. They are needed on earlier versions due to bad default paths in the Freeswitch package.}}
	Fix the voicemail storage directory in ''/etc/freeswitch/autoload_configs/voicemail.conf.xml'' to point to ''/var/lib/freeswitch/voicemail''		Fix the voicemail storage directory in ''/etc/freeswitch/autoload_configs/voicemail.conf.xml'' to point to ''/var/lib/freeswitch/voicemail''
	<param name="storage-dir" value="/var/lib/freeswitch/voicemail"/>		<param name="storage-dir" value="/var/lib/freeswitch/voicemail"/>
Line 35:		Line 35:
	rc-update add freeswitch		rc-update add freeswitch
	/etc/init.d/freeswitch start		/etc/init.d/freeswitch start
	You should now be able to dial into Freeswitch voicemail by registering a SIP user agent to ~~freeswitch~~ (user=1000-1019, password=12345 as defined above) and directing a SIP call to any of the other extensions between 1000 and 1019, or the extension 4000. For each voicemail account, the default password is the same as the extension. For more details on this, please refer to Freeswitch documentation. Please keep in mind that these extensions and voicemail are part of the sample config and are not managed by ACF. We will add ACF-managed voicemail accounts below.		You should now be able to dial into Freeswitch voicemail by registering a SIP user agent to one of the Freeswitch default local extensions (user=1000-1019, password=12345 as defined above) and directing a SIP call to any of the other extensions between 1000 and 1019, or the extension 4000. For each voicemail account, the default password is the same as the extension. For more details on this, please refer to Freeswitch documentation. Please keep in mind that these extensions and voicemail are part of the sample config and are not managed by ACF. We will add ACF-managed voicemail accounts below.

	== 5. Configure acf-freeswitch-vmail ==		== 5. Configure acf-freeswitch-vmail ==
Line 47:		Line 47:
	You can now browse to https://IPADDRESS to access the web interface. To log in for administration, use the root user and the system root password (this is the default configuration set up by setup-acf).		You can now browse to https://IPADDRESS to access the web interface. To log in for administration, use the root user and the system root password (this is the default configuration set up by setup-acf).
	== Users ==		== Users ==
	The Voicemail \| Users tab will display all of the voicemail users that are managed through the ACF web interface. At the start, this will be empty. When you create Users in the ACF, it will modify the ~~freeswitch~~ dialplan and directory (using xml_curl) to allow these users to receive and retrieve voicemail. It will also allow these users log into the ACF interface to check their voicemail and modify voicemail settings. The password defined here will control both ACF and IVR access.		The Voicemail \| Users tab will display all of the voicemail users that are managed through the ACF web interface. At the start, this will be empty. When you create Users in the ACF, it will modify the Freeswitch dialplan and directory (using xml_curl) to allow these users to receive and retrieve voicemail. It will also allow these users log into the ACF interface to check their voicemail and modify voicemail settings. The password defined here will control both ACF and IVR access.
	== Voicemail ==		== Voicemail ==
	The Voicemail \| Voicemail tab will allow you to view, listen to, download, forward, and delete voicemail messages.		The Voicemail \| Voicemail tab will allow you to view, listen to, download, forward, and delete voicemail messages.
Line 56:		Line 56:

	= Demonstration =		= Demonstration =
	We are now ready to create voicemail accounts with ACF. The ~~freeswitch~~ sample config creates a fairly full dialplan and we do not want to stomp on any of its features, so we will demonstrate accounts in the 2100 - 2199 range, which is unused.		We are now ready to create voicemail accounts with ACF. The Freeswitch sample config creates a fairly full dialplan and we do not want to stomp on any of its features, so we will demonstrate accounts in the 2100 - 2199 range, which is unused. Once again, to dial into Freeswitch you can use one of the Freeswitch default local extensions as explained above.
	# Dial extension 2100 to verify what happens when an unsupported extension is called		# Dial extension 2100 to verify what happens when an unsupported extension is called
	# Logged into ACF as root, create a voicemail user with extension 2100 and some password		# Logged into ACF as root, create a voicemail user with extension 2100 and some password
Line 64:		Line 64:

	= Other Features =		= Other Features =
			== Switching From wav to mp3 Recording (Recommended) ==
			{{Note\|The mp3 format is supported in acf-freeswitch-vmail-0.6.2 and later, available on Alpine Linux 3.2 or later.}}
			By default, Freeswitch will store voicemail recordings in wav format. Freeswitch also has the option of storing the recordings in mp3 format if mod_shout is installed. As mp3 format requires less storage/bandwidth and enjoys better support by web browsers, I would recommend making this change:
			=== 1. Add the mod_shout module ===
			Modify ''/etc/freeswitch/autoload_configs/modules.conf.xml'' to load the mod_shout module
			<load module="mod_shout"/>
			=== 2. Change Record Format to mp3 ===
			sed -i s/'name="file-extension" value="wav"'/'name="file-extension" value="mp3"'/ /etc/freeswitch/autoload_configs/voicemail.conf.xml
			=== 3. Restart Freeswitch ===
			/etc/init.d/freeswitch restart
	== Using PostgreSQL ==		== Using PostgreSQL ==
	Freeswitch-1.2.5 and acf-freeswitch-vmail-0.5.0 fully support Postgresql as the voicemail database. These versions are available in Alpine Linux 3.2 and later. To configure it:		Freeswitch-1.2.5 and acf-freeswitch-vmail-0.5.0 fully support Postgresql as the voicemail database. These versions are available in Alpine Linux 3.2 and later. To configure it:

Ttrask: Bad paths fixed for Alpine Linux 3.2 and later

2015-05-21T18:00:07Z

Bad paths fixed for Alpine Linux 3.2 and later

← Older revision		Revision as of 18:00, 21 May 2015
Line 25:		Line 25:
	And modify ''/etc/freeswitch/autoload_configs/modules.conf.xml'' to load the mod_xml_curl module		And modify ''/etc/freeswitch/autoload_configs/modules.conf.xml'' to load the mod_xml_curl module
	<load module="mod_xml_curl"/>		<load module="mod_xml_curl"/>
	{{Note\|These following items ~~should~~ not be needed~~, but~~ are ~~caused by~~ bad default paths in the freeswitch package}}		{{Note\|These following items are not needed for Alpine Linux 3.2 or later. They are needed on earlier versions due to bad default paths in the freeswitch package.}}
	Fix the voicemail storage directory in ''/etc/freeswitch/autoload_configs/voicemail.conf.xml'' to point to ''/var/lib/freeswitch/voicemail''		Fix the voicemail storage directory in ''/etc/freeswitch/autoload_configs/voicemail.conf.xml'' to point to ''/var/lib/freeswitch/voicemail''
	<param name="storage-dir" value="/var/lib/freeswitch/voicemail"/>		<param name="storage-dir" value="/var/lib/freeswitch/voicemail"/>

Ttrask at 20:22, 27 April 2015

2015-04-27T20:22:13Z

← Older revision		Revision as of 20:22, 27 April 2015
Line 84:		Line 84:
	=== 6. Restart Freeswitch ===		=== 6. Restart Freeswitch ===
	/etc/init.d/freeswitch start		/etc/init.d/freeswitch start

			[[Category:ACF]]

Ttrask: And commands to switch to postgresql instead of sqlite

2015-04-27T13:41:38Z

And commands to switch to postgresql instead of sqlite

← Older revision		Revision as of 13:41, 27 April 2015
Line 62:		Line 62:
	# Dial extension 4000 and log in as user 2100 with the password you defined above to listen to the message		# Dial extension 4000 and log in as user 2100 with the password you defined above to listen to the message
	# Log out of ACF as root and log in again as user 2100 with the password you defined above to view your message		# Log out of ACF as root and log in again as user 2100 with the password you defined above to view your message

			= Other Features =
			== Using PostgreSQL ==
			Freeswitch-1.2.5 and acf-freeswitch-vmail-0.5.0 fully support Postgresql as the voicemail database. These versions are available in Alpine Linux 3.2 and later. To configure it:
			=== 1. Install Postgresql ===
			apk add postgresql acf-postgresql
			=== 2. Setup and Start Postgresql ===
			rc-update add postgresql
			/etc/init.d/postgresql setup
			/etc/init.d/postgresql start
			=== 3. Create the Database ===
			psql -U postgres -c "CREATE DATABASE voicemail"
			=== 4. Stop Freeswitch ===
			/etc/init.d/freeswitch stop
			{{Note\|Freeswitch does not always stop properly. You might need to run 'ps ax' to find the process and 'kill' it. Running '/etc/init.d/freeswitch zap' might also be necessary.}}
			=== 5. Configure Freeswitch and acf-freeswitch-vmail ===
			Edit /etc/freeswitch/autoload_configs/voicemail.conf.xml to set the odbc-dsn param to "pgsql://hostaddr=127.0.0.1 dbname=voicemail user=postgres password= options=''"
			<param name="odbc-dsn" value="pgsql://hostaddr=127.0.0.1 dbname=voicemail user=postgres password= options=''" />
			Edit /etc/freeswitchvmail.conf and set the dsn param to "pgsql://hostaddr=127.0.0.1 dbname=voicemail user=postgres password= options=''"
			dsn=pgsql://hostaddr=127.0.0.1 dbname=voicemail user=postgres password= options=''
			=== 6. Restart Freeswitch ===
			/etc/init.d/freeswitch start

Ttrask: Fix command for /etc/freeswitchvmail.conf because it does not exist at first

2015-04-26T19:48:18Z

Fix command for /etc/freeswitchvmail.conf because it does not exist at first

← Older revision		Revision as of 19:48, 26 April 2015
Line 41:		Line 41:
	echo "authenticator = authenticator-freeswitch-vmail.lua,authenticator-plaintext" >> /etc/acf/acf.conf		echo "authenticator = authenticator-freeswitch-vmail.lua,authenticator-plaintext" >> /etc/acf/acf.conf
	Change the ACF voicemail domain to match the domain from the sample config. You should use the IP address of your voicemail server, as this is what the sample config uses.		Change the ACF voicemail domain to match the domain from the sample config. You should use the IP address of your voicemail server, as this is what the sample config uses.
	sed -i s/domain=~~voicemail~~/domain=IPADDRESS/ /etc/freeswitchvmail.conf		sed -i /^domain=/d /etc/freeswitchvmail.conf
			echo "domain=IPADDRESS" >> /etc/freeswitchvmail.conf

	= ACF Web interface =		= ACF Web interface =

Ttrask: Fixed domain config issue

2015-04-13T13:43:57Z

Fixed domain config issue

← Older revision		Revision as of 13:43, 13 April 2015
Line 1:		Line 1:
	~~{{Draft}}~~
	= Overview =		= Overview =
	This page describes how to install a basic voicemail server based upon Freeswitch including a web interface based upon ACF. It is built and tested on Alpine Linux 2.7, 3.0, 3.1, and the future 3.2.		This page describes how to install a basic voicemail server based upon Freeswitch including a web interface based upon ACF. It is built and tested on Alpine Linux 2.7, 3.0, 3.1, and the future 3.2.

	~~{{Note\|While dialing 4000 to get to the voicemail IVR works, and logging in as ACF-managed voicemail users works, new voicemail messages are not showing up. Not sure why yet.}}~~

	= Setup Procedure=		= Setup Procedure=
Line 43:		Line 40:
	Add the voicemail authenticator to the ACF configuration. This will allow voicemail users to log into ACF to check their voicemail.		Add the voicemail authenticator to the ACF configuration. This will allow voicemail users to log into ACF to check their voicemail.
	echo "authenticator = authenticator-freeswitch-vmail.lua,authenticator-plaintext" >> /etc/acf/acf.conf		echo "authenticator = authenticator-freeswitch-vmail.lua,authenticator-plaintext" >> /etc/acf/acf.conf
			Change the ACF voicemail domain to match the domain from the sample config. You should use the IP address of your voicemail server, as this is what the sample config uses.
			sed -i s/domain=voicemail/domain=IPADDRESS/ /etc/freeswitchvmail.conf

	= ACF Web interface =		= ACF Web interface =
	You can now browse to https://~~<ip address>~~ to access the web interface. To log in for administration, use the root user and the system root password (this is the default configuration set up by setup-acf).		You can now browse to https://IPADDRESS to access the web interface. To log in for administration, use the root user and the system root password (this is the default configuration set up by setup-acf).
	== Users ==		== Users ==
	The Voicemail \| Users tab will display all of the voicemail users that are managed through the ACF web interface. At the start, this will be empty. When you create Users in the ACF, it will modify the freeswitch dialplan and directory (using xml_curl) to allow these users to receive and retrieve voicemail. It will also allow these users log into the ACF interface to check their voicemail and modify voicemail settings. The password defined here will control both ACF and IVR access.		The Voicemail \| Users tab will display all of the voicemail users that are managed through the ACF web interface. At the start, this will be empty. When you create Users in the ACF, it will modify the freeswitch dialplan and directory (using xml_curl) to allow these users to receive and retrieve voicemail. It will also allow these users log into the ACF interface to check their voicemail and modify voicemail settings. The password defined here will control both ACF and IVR access.

Ttrask: Fixed packages for alpine 3.0 - 3.2

2015-04-12T20:49:57Z

Fixed packages for alpine 3.0 - 3.2

← Older revision		Revision as of 20:49, 12 April 2015
Line 1:		Line 1:
	{{Draft}}		{{Draft}}
	= Overview =		= Overview =
	This page describes how to install a basic voicemail server based upon Freeswitch including a web interface based upon ACF. It is built and tested on Alpine Linux 3.2.		This page describes how to install a basic voicemail server based upon Freeswitch including a web interface based upon ACF. It is built and tested on Alpine Linux 2.7, 3.0, 3.1, and the future 3.2.

	* Alpine 3.2 - dialing 4000 ~~does not list voicemails~~, ~~voicemail actions through~~ ACF ~~don't work (nc doesn't exit)~~		{{Note\|While dialing 4000 to get to the voicemail IVR works, and logging in as ACF-managed voicemail users works, new voicemail messages are not showing up. Not sure why yet.}}
	* Alpine 3.1 -
	* Alpine 3.0 - dialing 4000 does not list voicemails, voicemail ~~actions through ACF don't work (nc doesn't exit)~~
	* Alpine 2.~~7 - dialing 4000 does not list voicemails, downloading works fine~~

	= Setup Procedure=		= Setup Procedure=
Line 22:		Line 19:
	Modify the default password to avoid warnings and delays (obviously, you can choose something other than 12345 if you want)		Modify the default password to avoid warnings and delays (obviously, you can choose something other than 12345 if you want)
	sed -i s/"default_password=1234"/"default_password=12345"/ /etc/freeswitch/vars.xml		sed -i s/"default_password=1234"/"default_password=12345"/ /etc/freeswitch/vars.xml
	~~Fix the voicemail storage directory in ''/etc/freeswitch/autoload_configs/voicemail.conf.xml'' to point to ''/var/lib/freeswitch/voicemail''~~
	~~<param name="storage-dir" value="/var/lib/freeswitch/voicemail"/>~~
	~~Set the sounds directory in ''/etc/freeswitch/vars.xml'' by adding the following line:~~
	~~<X-PRE-PROCESS cmd="set" data="sounds_dir=/usr/share/freeswitch/sounds"/>~~
	Use Freeswitch XML curl to call into ACF to determine voicemail accounts. To do so, edit ''/etc/freeswitch/autoload_configs/xml_curl.conf.xml'' and add the following bindings:		Use Freeswitch XML curl to call into ACF to determine voicemail accounts. To do so, edit ''/etc/freeswitch/autoload_configs/xml_curl.conf.xml'' and add the following bindings:
	<binding name="voicemaildialplan">		<binding name="voicemaildialplan">
Line 35:		Line 28:
	And modify ''/etc/freeswitch/autoload_configs/modules.conf.xml'' to load the mod_xml_curl module		And modify ''/etc/freeswitch/autoload_configs/modules.conf.xml'' to load the mod_xml_curl module
	<load module="mod_xml_curl"/>		<load module="mod_xml_curl"/>
			{{Note\|These following items should not be needed, but are caused by bad default paths in the freeswitch package}}
			Fix the voicemail storage directory in ''/etc/freeswitch/autoload_configs/voicemail.conf.xml'' to point to ''/var/lib/freeswitch/voicemail''
			<param name="storage-dir" value="/var/lib/freeswitch/voicemail"/>
			Set the sounds directory in ''/etc/freeswitch/vars.xml'' by adding the following line:
			<X-PRE-PROCESS cmd="set" data="sounds_dir=/usr/share/freeswitch/sounds"/>

	== 4. Start Freeswitch ==		== 4. Start Freeswitch ==