Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Asterisk Conference Calls"

(Troubleshooting)
(USE A HEAD SET WITH ASTERISK!)
Line 1: Line 1:
=USE A HEAD SET WITH ASTERISK!=
+
=IMPORTANT!=
 
<div style="background: #FFEEEE; border: 1px solid #FF0000; padding: 5px; font-weight: bold">
 
<div style="background: #FFEEEE; border: 1px solid #FF0000; padding: 5px; font-weight: bold">
 
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.
 
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.

Revision as of 12:56, 18 July 2007

IMPORTANT!

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. Connect via IAX or SIP to "asterisk.eclipse.org"(IAX/SIP) or "conference@asterisk.eclipse.org"(some SIP phones)
  4. Dial your conference number
  5. Dial your PIN
  6. 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. 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
  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.

Back to the top