How to install AsterSwitchboard to work with FreePBX
Download Asterswitchboard and follow these four steps:
To operate properly, AsterSwitchboard needs at least a manager type account configured on the Asterisk PBX.
Your system administrator will have to add the following code in the Asterisk configuration file 'manager.conf'.
Add to the file '/etc/asterisk/manager.conf' (or equivalent) the following lines:
[user_name]
Secret = password
Deny=0.0.0.0/0.0.0.0
Permit=127.0.0.1/255.255.255.0
Permit= your_lan
Read = system,call,log,verbose,command,agent,user,config,command,dtmf,reporting,cdr,dialplan,originate
Write = system,call,log,verbose,command,agent,user,config,command,dtmf,reporting,cdr,dialplan,originate
Writetimeout = 5000
eventfilter=!Event: RTCP*
eventfilter=!Event: VarSet
eventfilter=!Event: Cdr
eventfilter=!Event: DTMF
eventfilter=!Event: AGIExec
eventfilter=!Event: ChannelUpdate
eventfilter=!Event: ChallengeSent
eventfilter=!Event: SuccessfulAuth
eventfilter=!Event: NewAccountCode
Secret = password
Deny=0.0.0.0/0.0.0.0
Permit=127.0.0.1/255.255.255.0
Permit= your_lan
Read = system,call,log,verbose,command,agent,user,config,command,dtmf,reporting,cdr,dialplan,originate
Write = system,call,log,verbose,command,agent,user,config,command,dtmf,reporting,cdr,dialplan,originate
Writetimeout = 5000
eventfilter=!Event: RTCP*
eventfilter=!Event: VarSet
eventfilter=!Event: Cdr
eventfilter=!Event: DTMF
eventfilter=!Event: AGIExec
eventfilter=!Event: ChannelUpdate
eventfilter=!Event: ChallengeSent
eventfilter=!Event: SuccessfulAuth
eventfilter=!Event: NewAccountCode
Replace these 3 values:
| user_name | Choose a user name. It will be inserted in AsterSwitchboard configuration in the Login name field on the client computer. (in step 3) |
| password | Choose a password. It will be inserted in AsterSwitchboard configuration in the Password field on the client computer. (in step 3) |
| your_lan | This is your local network (LAN) for example: 192.168.1.0/255.255.255.0. It will be inserted in AsterSwitchboard configuration in the IP Address field on the client computer. (in step 3) |
User name and Password will be used in step 3.
If on your Asterisk server the firewall is enabled is
necessary to open ports:
- 5038 TCP (Asterisk manager)
- 3306 TCP (MySQL)
To make the changes made on manager.conf take effect
execute the command core reload on Asterisk or an
equivalent one on the Asterisk administration web interface.
3) Run AsterSwitchboard and enter IP address, credentials and phone info into the configuration menu
From the AsterSwitchboard menu select File and then Settings
To access the application setting a password is required. The default one is 1234.
Digit it and click on Login button.
Asterisk Server Configuration
In the setting windows, tab Asterisk Server, fill in these fields:
IP Address
the asterisk server ip address (example 192.168.1.100). The same choosen in step 1
Login name
the same choosen in step 1
Password
the same choosen in step 1
Context
context of your extension.
For example from-internal is used by FreePBX, Elastix 2.x and Issabel.
Yeastar use
DLPN_DialPlanXXX, where XXX is the extension number.
If left blank it will be automatically compiled
by AsterSwitchboard after the first connection to the PBX.
Phone Configuration
Click on the Phone tab and fill in these fields:
My name
the name of user of the extension that AsterSwitchboard will manage.
It's just a string you can choose it freely.
My number
the number of the extension that AsterSwitchboard will manage. For example 112.
MySQL Database Configuration
This configuration part is required only if you want to use the shared address book or the presence status feature.
An access to MySQL DB is needed, usually is keeped on the same server as Asterisk.
AsterSwitchboard will automatically create the tables for you but not the database.
IP Address
The ip address of the server with MySQL installed. Example 192.168.1.100
Port
3306 is the default port
DB Name
the database name
Username
the username to log into MySQL
Password
the password
To be sure that the data inserted is correct you can click on the button Test database connection.
Click on the Save button to complete the configuration.
From the AsterSwitchboard menu select File and then Settings
To access the application setting a password is required. The default one is 1234.
Digit it and click on Login button.
Asterisk Server Configuration
In the setting windows, tab Asterisk Server, fill in these fields:
In the setting windows, tab Asterisk Server, fill in these fields:
| IP Address | the asterisk server ip address (example 192.168.1.100). The same choosen in step 1 |
|---|---|
| Login name | the same choosen in step 1 |
| Password | the same choosen in step 1 |
| Context | context of your extension. For example from-internal is used by FreePBX, Elastix 2.x and Issabel. Yeastar use DLPN_DialPlanXXX, where XXX is the extension number. If left blank it will be automatically compiled by AsterSwitchboard after the first connection to the PBX. |
Phone Configuration
Click on the Phone tab and fill in these fields:
Click on the Phone tab and fill in these fields:
| My name | the name of user of the extension that AsterSwitchboard will manage. It's just a string you can choose it freely. |
|---|---|
| My number | the number of the extension that AsterSwitchboard will manage. For example 112. |
MySQL Database Configuration
This configuration part is required only if you want to use the shared address book or the presence status feature.
An access to MySQL DB is needed, usually is keeped on the same server as Asterisk. AsterSwitchboard will automatically create the tables for you but not the database.
To be sure that the data inserted is correct you can click on the button Test database connection.
Click on the Save button to complete the configuration.
This configuration part is required only if you want to use the shared address book or the presence status feature.
An access to MySQL DB is needed, usually is keeped on the same server as Asterisk. AsterSwitchboard will automatically create the tables for you but not the database.
| IP Address | The ip address of the server with MySQL installed. Example 192.168.1.100 |
|---|---|
| Port | 3306 is the default port |
| DB Name | the database name |
| Username | the username to log into MySQL |
| Password | the password |
Click on the Save button to complete the configuration.
From the AsterSwitchboard menu select Actions and then Connect
If the settings of step three are correct you will see all the internal peers
and you are ready to use AsterSwitchboard!
From the AsterSwitchboard menu select Actions and then Connect
If the settings of step three are correct you will see all the internal peers
and you are ready to use AsterSwitchboard!