Installation Guide
Obsoleted - With Vasuntu, SSGWPE is already installed into the system.
This guide is for Ubuntu Feisty 7.04. For any other distributions, I hope this can be of some help.
Ubuntu Feisty 7.04
Install this OS if you have not already done so. You can download the distribution from here. After the installation, do a system update.
Step 1 - Update to low latency image
This is supposed to perform better for audio, especially if you intend to install Asterisk together with this gateway.
- sudo apt-get install linux-image-2.6.20-16-lowlatency
Step 2 - Download and install Skype
Download and install Skype (Beta) Version 1.4.0.118
- You can download from Skype or if the version is not what you want, you can download the above version from here.
- After the download, install Skype. If packages libqt4-core & libqt4-gui are not already in the system, these will be downloaded automatically. These two packages are also needed by this gateway program.
- Do an echo test to make sure that Skype client is working properly.
- Use the default alsa sound system. Do not change to OSS.
Step 3 - Download and install Skype Sip Gateway (Personal Edition)
- Login to non-root account. You can install this gateway under anywhere under the home directory of this user. However, you need to have administrative rights when you need to add packages. This is similar to the Skype installation.
- Download from here.
- Extract the files. They should be in a directory “release”. You can choose to rename the directory or moved it to somewhere you like.
- cd into that directory.
- chmod a+x install.sh.
- Run the command “./install.sh”. This should set up the required environment for running this gateway. Note that alsa jack plugin library has been removed from Feisty 7.04. This library is needed for the gateway to work properly. During the “./install.sh” script, you need to response “y” for “copying this library over”.
- For those who are doing for other distributions, you may want to view “./install.sh” and see how it works. Customise appropriately to your distributions.
Step 4 - Reconfigure Skype
- Run Skype.
- Set up start up for Skype. Replace “abcdef” with your Skype Id. “Sign me in when Skype starts” must be checked!
- Set up sound devices for Skype. Choose “skype” as the device as shown below. DO NOT choose other devices. This is needed for Skype to properly work with the gateway.
Step 5 - Setup Skype Sip Gateway
- cd to the installed directory.
- Run “./safe_skypegw.sh”. The gateway program should be displayed. The gateway will also automatically re-launch Skype.
- Set up the gateway to talk to Skype. See the image below:
- Configure Skype to allow gateway to connect to it. Click “yes” when the image below pops up.
- You can see that this is done correctly from Skype “Public API” window. See below. Note that “X11″ must be checked also.
- Configure gateway as both Sip client and server. As a Sip client it calls out using the Sip identity configured. As a Sip server it listens for Sip connections and then redirect call to the Skype client.
- If this gateway and the Sip server are in the same PC, then either the Sip server or the gateway has to be reconfigured to listen on different IP address. For example, if Asterisk is the Sip server and it binds to IP address is 192.168.1.99, then use ifconfig to allow the PC to have another IP address say, 192.168.1.98. The gateway can then listen on 192.168.1.98. Example of ifconfig command can be:”ifconfig eth0:1 192.168.1.98 netmask 255.255.255.0 up“
- Finally, you can configure how you want to handle calls coming in from various Skype callers via this tab. Once Skype is up, pressing the “Refresh” button will allow you to get the Skye buddies into the gateway. Then you can add or remove the buddies into the various groups.
Step 6 - Test the Gateway
- Skype Caller Calling In. When the above is done correctly, you can begin testing the gateway. Use another Skype client on another computer to call into this gateway. If you have set up the above correctly, your call will be redirected by the gateway to a Sip connection as defined in your gateway.
You can use the “qjackctrl” program to view the audio connections. Proper audio connections should be something like this.
- Sip Caller Calling Skype. Use a Sip Client (like Ekiga or Xten-Lite) to make a call to another Skype user. The gateway uses arbitrary mapping. This is an example of Sip client calling a Skype user:
Sip Client (sip:103@192.168.1.99) -> Gateway As Sip Server(sip:elephant@192.168.1.98)-> Skype (elephant)
Sometimes there can be audio problems with such a connection. Please see known problems about this.
