Difference between revisions of "Ring Groups"
| (10 intermediate revisions by 4 users not shown) | |||
| Line 7: | Line 7: | ||
Ring groups use the database to get the list of destinations to call on demand. | Ring groups use the database to get the list of destinations to call on demand. | ||
| − | SQlite databases can be read natively. MySQL | + | SQlite and Postgres databases can be read natively. MySQL requires ODBC. |
Setup ODBC according to: | Setup ODBC according to: | ||
| Line 22: | Line 22: | ||
* password: use the database password | * password: use the database password | ||
| + | NOTE: Do not enter hostname, port or any fields other than those listed above. Doing so may result in DB connectivity errors, such as "DBH NOT Connected" in FS_CLI | ||
| + | |||
| + | After saving the FusionPBX ODBC DSN information in Advanced -> Databases it will create a config.lua script. You can view the config.lua file with the script editor. To get to the script edit use the menu navigate to Advanced -> Script Editor. From the script editor look in the resources directory. Click on the config.lua you should see the information you provided in the Databases tool. If you are looking for the config.lua file from the file system its in the freeswitch/scripts/resources directory. | ||
| + | |||
| + | ===Fields=== | ||
| + | |||
| + | '''Name''' Simply the meaningful name of the Ring group (shows after the Extension in menu selections). | ||
| + | |||
| + | '''Extension''' the Dial-able extension for this group standard config states as a 2-7 number extension | ||
| + | |||
| + | '''Strategy''' The selectable way in which the destinations are being used. | ||
| + | Simultaneous - [Rings all EXT Listed] | ||
| + | Sequence - [Lowest Order dialed first] | ||
| + | Enterprise - [Rings all EXT and works with Follow Me] | ||
| + | Rollover - [Calls EXT in Sequence, skips in use EXT] | ||
| + | Random - [EXT ring in random order] | ||
| + | |||
| + | '''Destinations''' The extensions that this ring group applies to. | ||
| + | |||
| + | Prompt where you determine if the call must have a dial to confirm before a pickup event | ||
| + | |||
| + | '''CID Name Prefix''' the string that is added to the caller ID when it displays on the ringing extension | ||
| + | |||
| + | '''CID Number Prefix''' the '''Number''' that is added to the caller ID when it displays on the ringing extension | ||
| + | |||
| + | '''Ring Back''' What the caller hears when they are waiting for the '''Destinations''' Extensions to answer | ||
| + | |||
| + | ''' Context''' the grouping that this ring group will search as specified in the configuration of your Extensions (if this excludes an extension it will not ring) | ||
===Troubleshooting=== | ===Troubleshooting=== | ||
| − | To troubleshoot ring groups should check the | + | To troubleshoot ring groups should check the FreeSWITCH cli to see if you are getting errors. |
| + | |||
| + | File permissions can prevent the file from being updated. Make sure that the web server has access to write tot he freeswitch/scripts directory and sub-directories. | ||
| + | |||
| + | Test the odbc connection with isql fusionpbx being the name of the DSN you may also need to provide the username and password to the database. | ||
| + | isql -v fusionpbx username password | ||
Latest revision as of 15:25, 29 March 2018
Menu: Apps -> Ring Groups
Ring Groups can be set up to ring multiple registered endpoints.
Installation
Ring groups use the database to get the list of destinations to call on demand.
SQlite and Postgres databases can be read natively. MySQL requires ODBC.
Setup ODBC according to: http://wiki.freeswitch.org/wiki/Using_ODBC_in_the_core
Create an ODBC connection for the FusionPBX database. Usually give the DSN name fusionpbx.
In FusionPBX go to the menu Advanced -> Databases.
- Driver: odbc
- Type: mysql or postgres
- Name: fusionpbx (the name of the ODBC DSN)
- username: use the database username
- password: use the database password
NOTE: Do not enter hostname, port or any fields other than those listed above. Doing so may result in DB connectivity errors, such as "DBH NOT Connected" in FS_CLI
After saving the FusionPBX ODBC DSN information in Advanced -> Databases it will create a config.lua script. You can view the config.lua file with the script editor. To get to the script edit use the menu navigate to Advanced -> Script Editor. From the script editor look in the resources directory. Click on the config.lua you should see the information you provided in the Databases tool. If you are looking for the config.lua file from the file system its in the freeswitch/scripts/resources directory.
Fields
Name Simply the meaningful name of the Ring group (shows after the Extension in menu selections).
Extension the Dial-able extension for this group standard config states as a 2-7 number extension
Strategy The selectable way in which the destinations are being used.
Simultaneous - [Rings all EXT Listed]
Sequence - [Lowest Order dialed first]
Enterprise - [Rings all EXT and works with Follow Me]
Rollover - [Calls EXT in Sequence, skips in use EXT]
Random - [EXT ring in random order]
Destinations The extensions that this ring group applies to.
Prompt where you determine if the call must have a dial to confirm before a pickup event
CID Name Prefix the string that is added to the caller ID when it displays on the ringing extension
CID Number Prefix the Number that is added to the caller ID when it displays on the ringing extension
Ring Back What the caller hears when they are waiting for the Destinations Extensions to answer
Context the grouping that this ring group will search as specified in the configuration of your Extensions (if this excludes an extension it will not ring)
Troubleshooting
To troubleshoot ring groups should check the FreeSWITCH cli to see if you are getting errors.
File permissions can prevent the file from being updated. Make sure that the web server has access to write tot he freeswitch/scripts directory and sub-directories.
Test the odbc connection with isql fusionpbx being the name of the DSN you may also need to provide the username and password to the database.
isql -v fusionpbx username password
