Jump to: navigation, search

Difference between revisions of "Asterisk Conference Calls"

(Quick Summary)
(Asterisk Client Setup)
 
(21 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Quick Summary==
+
=IMPORTANT=
# Project Leads and PMC Members can use the [http://portal.eclipse.org Portal] to generate conference codes and PINs
+
<div style="background: #FFEEEE; border: 1px solid #FF0000; padding: 5px; font-weight: bold">
# Use a softphone
+
Using a headset vastly improves call quality for everyone. Microphones built into laptops and desktops are the number one cause of poor line quality when using VOIP. Even if more than one person is using the same computer a single headset microphone with the laptop speaker will usually pick up all the voices in the room and the call quality is far superior.
# Connect via IAX or SIP to "asterisk.eclipse.org"
+
</div>
# Dial your conference number
+
# Dial your PIN
+
# [http://en.wikipedia.org/wiki/Coffee_Talk_with_Linda_Richman|Talk amongst yourselves]
+
 
+
==Trouble Shooting==
+
# If you are using IDEFisk, use version 1.37. Do not use version 2.0.
+
# If you don't have access to a soft phone for some good reason, there is an 800 number with a separate passcode. However, because the 800 number costs us money, its use needs to be justified. (I.e. "I'm used to dialing an 800 number and I'm too lazy to set up a softphone" is not a good enough justification :-)
+
 
+
<p>
+
<hr style="color: #CCCCFF; background-color: #CCCCFF; height: 4px;">
+
 
+
 
==What is Asterisk?==
 
==What is Asterisk?==
Asterisk is an open source, free soft switch/soft PBX system for managing all manner of telephony needs.  It is produced by Digium (http://www.digium.com/) as a method of marketing their telephony hardware.  The Foundation is currently investigating using it as a conferencing solution.
+
Asterisk is an open source, free soft switch/soft PBX system for managing all manner of telephony needs.  It is produced by Digium (http://www.digium.com/) as a method of marketing their telephony hardware.  The Foundation has rolled this out for projects to use.
  
 
==Asterisk Conference Server==
 
==Asterisk Conference Server==
 
An installation of Asterisk exists on asterisk.eclipse.org configured by default to work as a conferencing bridge.   
 
An installation of Asterisk exists on asterisk.eclipse.org configured by default to work as a conferencing bridge.   
  
Currently, to connect to the server clients are required to use an Internet Protocol-based softphone.  In the future POTS (regular telephone) access could be provided on a cost basis.  This page contains information on downloading and configuring the simplest of the available clients for use with the Foundation's Asterisk conferencing server.
+
Currently, to connect to the server clients are required to use an Internet Protocol-based softphone.  This page contains information on downloading and configuring the simplest of the available clients for use with the Foundation's Asterisk conferencing server.
 +
 
 +
If you don't have access to a soft phone for some good reason, there is an 800 number with a separate passcode. However, because the 800 number costs us money, its use needs to be justified. (I.e. "I'm used to dialing an 800 number and I'm too lazy to set up a softphone" is not a good enough justification :-)
 +
 
 +
==Quick Summary==
 +
# Project Leads and PMC Members can use the [http://portal.eclipse.org Portal] to generate conference codes and PINs. See this [http://eclipsewebmaster.blogspot.com/2007/06/conferencing-is-coming.html Blog Entry].
 +
# Use a softphone (see below for instructions on using Idefisk)
 +
# Use a headset!
 +
# Connect via IAX or SIP to "asterisk.eclipse.org"(IAX/SIP) or "conference@asterisk.eclipse.org"(some SIP phones)
 +
# Dial your conference number
 +
# Dial your PIN
 +
# [http://en.wikipedia.org/wiki/Coffee_Talk_with_Linda_Richman Talk amongst yourselves]
  
 
==Asterisk Client Setup==
 
==Asterisk Client Setup==
Line 30: Line 30:
 
#Download Idefisk from http://www.asteriskguru.com/idefisk/free by clicking on the icon for your operating system about half way down the page
 
#Download Idefisk from http://www.asteriskguru.com/idefisk/free by clicking on the icon for your operating system about half way down the page
 
##If you are on Windows choose the ZIP version
 
##If you are on Windows choose the ZIP version
##Note that these instructions are for version 1.3x and do not seem to work with Idefisk 2.0 which is available only on Windows
+
##<span style="background: #FFEEEE; border: #FF0000 1px solid; font-weight: bold; padding: 1px;">Use Idefisk 1.3x NOT 2.0</span>
 
#Make a new folder for Idefisk
 
#Make a new folder for Idefisk
 
##On Windows you might want to put this in c:\program files\
 
##On Windows you might want to put this in c:\program files\
Line 40: Line 40:
 
#When presented with the following screen, select "Skip and go to manual configuration," then click "Next"<br> [[image:idefisk1.JPG]]
 
#When presented with the following screen, select "Skip and go to manual configuration," then click "Next"<br> [[image:idefisk1.JPG]]
 
#You will then see a screen like this, and you will just press "OK"<br> [[image:idefisk2.JPG]]
 
#You will then see a screen like this, and you will just press "OK"<br> [[image:idefisk2.JPG]]
 +
#<span style="background: #FFEEEE; border: #FF0000 1px solid; font-weight: bold; padding: 3px; font-size: large">NEW</span>The default Idefisk window will now appear.  We need to set some audio filtering options to improve the default sound quality.  Right click somewhere (not an icon) in the Idefisk window.  Select "Filter Options" and use the following settings:<br>[[Image:FilterOptions.jpg]]
 
#That's it for the setup!  To make a call, enter 'asterisk.eclipse.org' in the "Phone to dial" text box like this, and then press the little phone icon (highlighted in red):<br>[[image:idefisk3.JPG]]
 
#That's it for the setup!  To make a call, enter 'asterisk.eclipse.org' in the "Phone to dial" text box like this, and then press the little phone icon (highlighted in red):<br>[[image:idefisk3.JPG]]
 
# When you are connected you will be asked for a conference number.  In order to enter the conference number you will need the phone number pad (DTMF pad) which you can cause to appear by pressing the little sideways arrow highlighted in this shot:<br>[[image:idefisk4.JPG]]
 
# When you are connected you will be asked for a conference number.  In order to enter the conference number you will need the phone number pad (DTMF pad) which you can cause to appear by pressing the little sideways arrow highlighted in this shot:<br>[[image:idefisk4.JPG]]
 
#In order to test your client, we'll connect to a test conference.  The conference number is "8976" and the PIN is "12345".  If you successfully connect to the conference then everything is in order!
 
#In order to test your client, we'll connect to a test conference.  The conference number is "8976" and the PIN is "12345".  If you successfully connect to the conference then everything is in order!
  
==Troubleshooting Asterisk Clients==
+
==Troubleshooting==
 
The most common problems occuring in Asterisk client setups are the following:
 
The most common problems occuring in Asterisk client setups are the following:
 +
 +
*<span style="background: #FFEEEE; border: #FF0000 1px solid; font-weight: bold; padding: 3px; font-size: large">NEW</span>'''Symptom:''' ''Audio Quality Is Bad''
 +
**'''Cause:''' Everyone using a softphone on the call should use a headset or at a minimum an external microphone.  Call quality can be drastically reduced by 1 person using a laptop built-in microphone.  Please also refer to item number 7 in the setup instructions on how to configure Idefisk to support the best call quality.  Additionally you can try flipping the filter setting between digital and analog gain detection for best results with your hardware.
 +
 +
*'''Symptom:''' ''Nothing works''
 +
**'''Cause:''' If you are using IDEfisk use version 1.3x NOT version 2.0 (it says this in the instructions)
  
 
*'''Symptom:''' ''I don't hear any audio.''
 
*'''Symptom:''' ''I don't hear any audio.''
Line 55: Line 62:
 
**'''Cause:''' Check that you are able to connect to the Internet with your web browser.
 
**'''Cause:''' Check that you are able to connect to the Internet with your web browser.
 
**'''Cause:''' SIP clients may be blocked by the firewall's NAT configuration.  Enter the real external IP address of your Internet router in the client's NAT configuration screen.  IAX clients like Idefisk don't need this information.
 
**'''Cause:''' SIP clients may be blocked by the firewall's NAT configuration.  Enter the real external IP address of your Internet router in the client's NAT configuration screen.  IAX clients like Idefisk don't need this information.
 +
**<span style="background: #FFEEEE; border: #FF0000 1px solid; font-weight: bold; padding: 3px; font-size: large">NEW</span>'''Cause:''' IAX requires outbound UDP on port 4569.  You may need to request that your firewall aministrator allow tihs traffic.
 +
 +
==Other Recommended Clients==
 +
* [http://www.sjlabs.com/sjp.html SJPhone]  for Linux, MacOSX, WinCE and Windows - This is a SIP client and is harder to get through firewalls but the audio and call quality are fantastic.  The GUI is less than stellar but setup is fairly easy.

Latest revision as of 11:56, 19 July 2007

IMPORTANT

Using a headset vastly improves call quality for everyone. Microphones built into laptops and desktops are the number one cause of poor line quality when using VOIP. Even if more than one person is using the same computer a single headset microphone with the laptop speaker will usually pick up all the voices in the room and the call quality is far superior.

What is Asterisk?

Asterisk is an open source, free soft switch/soft PBX system for managing all manner of telephony needs. It is produced by Digium (http://www.digium.com/) as a method of marketing their telephony hardware. The Foundation has rolled this out for projects to use.

Asterisk Conference Server

An installation of Asterisk exists on asterisk.eclipse.org configured by default to work as a conferencing bridge.

Currently, to connect to the server clients are required to use an Internet Protocol-based softphone. This page contains information on downloading and configuring the simplest of the available clients for use with the Foundation's Asterisk conferencing server.

If you don't have access to a soft phone for some good reason, there is an 800 number with a separate passcode. However, because the 800 number costs us money, its use needs to be justified. (I.e. "I'm used to dialing an 800 number and I'm too lazy to set up a softphone" is not a good enough justification :-)

Quick Summary

  1. Project Leads and PMC Members can use the Portal to generate conference codes and PINs. See this Blog Entry.
  2. Use a softphone (see below for instructions on using Idefisk)
  3. Use a headset!
  4. Connect via IAX or SIP to "asterisk.eclipse.org"(IAX/SIP) or "conference@asterisk.eclipse.org"(some SIP phones)
  5. Dial your conference number
  6. Dial your PIN
  7. Talk amongst yourselves

Asterisk Client Setup

In order to connect to the Asterisk conferencing system you will need either a SIP or an IAX protocol client. IAX has a protocol advantage over SIP in that it automatically handles Network Address Translation (NAT) configuration. Since nearly all Internet users pass through a NAT gateway on their way to the Internet, we will focus on IAX. There are several usable IAX client but the most mature and simplest of these to use and set up is the IAX client Idefisk which is available from http://www.asteriskguru.com/idefisk/free . This client is available on Linux, Win32, and MacOSX. The screenshots below are from Win32 but the appearance and configuration are nearly exactly the same on all platforms and the defaults are usually correct.

Here's how to make your first call to the Eclipse Foundation's asterisk conference server:

  1. Download Idefisk from http://www.asteriskguru.com/idefisk/free by clicking on the icon for your operating system about half way down the page
    1. If you are on Windows choose the ZIP version
    2. Use Idefisk 1.3x NOT 2.0
  2. Make a new folder for Idefisk
    1. On Windows you might want to put this in c:\program files\
    2. On MacOSX you might want to put this in /Applications
  3. Link Idefisk to where you will run it
    1. On MacOSX drag the icon into the dock at the bottom of the screen
    2. On Windows, right click the Idefisk icon (man with a headset) and select 'Create Shortcut'. Move the new shortcut to the desktop
  4. Launch Idefisk by clicking on the icon
  5. When presented with the following screen, select "Skip and go to manual configuration," then click "Next"
    Idefisk1.JPG
  6. You will then see a screen like this, and you will just press "OK"
    Idefisk2.JPG
  7. NEWThe default Idefisk window will now appear. We need to set some audio filtering options to improve the default sound quality. Right click somewhere (not an icon) in the Idefisk window. Select "Filter Options" and use the following settings:
    FilterOptions.jpg
  8. That's it for the setup! To make a call, enter 'asterisk.eclipse.org' in the "Phone to dial" text box like this, and then press the little phone icon (highlighted in red):
    Idefisk3.JPG
  9. When you are connected you will be asked for a conference number. In order to enter the conference number you will need the phone number pad (DTMF pad) which you can cause to appear by pressing the little sideways arrow highlighted in this shot:
    Idefisk4.JPG
  10. In order to test your client, we'll connect to a test conference. The conference number is "8976" and the PIN is "12345". If you successfully connect to the conference then everything is in order!

Troubleshooting

The most common problems occuring in Asterisk client setups are the following:

  • NEWSymptom: Audio Quality Is Bad
    • Cause: Everyone using a softphone on the call should use a headset or at a minimum an external microphone. Call quality can be drastically reduced by 1 person using a laptop built-in microphone. Please also refer to item number 7 in the setup instructions on how to configure Idefisk to support the best call quality. Additionally you can try flipping the filter setting between digital and analog gain detection for best results with your hardware.
  • Symptom: Nothing works
    • Cause: If you are using IDEfisk use version 1.3x NOT version 2.0 (it says this in the instructions)
  • Symptom: I don't hear any audio.
    • Cause: Sound may be disabled. Can you play any other sounds on your system?
    • Cause: Networking equipment is blocking your audio connection. Does the client show that you are connected?
  • Symptom: I can't connect to the server
    • Cause: Check that you have entered the address correctly.
    • Cause: Check that you are able to connect to the Internet with your web browser.
    • Cause: SIP clients may be blocked by the firewall's NAT configuration. Enter the real external IP address of your Internet router in the client's NAT configuration screen. IAX clients like Idefisk don't need this information.
    • NEWCause: IAX requires outbound UDP on port 4569. You may need to request that your firewall aministrator allow tihs traffic.

Other Recommended Clients

  • SJPhone for Linux, MacOSX, WinCE and Windows - This is a SIP client and is harder to get through firewalls but the audio and call quality are fantastic. The GUI is less than stellar but setup is fairly easy.