1. ECE355 Project SIP Applications Tiuley Alguindigue talguind@ecemail.uwaterloo.ca

2. Overview SIP COMMUNICATOR JAIN-SIP-PRESENCE-PROXY Eclipse Projects Setup Basic CVS commands Running Apps Making a SIP Phone Call

3. Taken from http://www.iptel.org/sip/siptutorial.pdf

5. SIP COMMUNICATOR A software-based IP phone that runs on a PC audio/video. You can use SIP COMMUNICATOR to place VoIP phone calls between two PCs or between a PC and an IP Phone(such as the one in the E2-2363 Lab) A SIP User Agent in Java. –Can act as a client: creates a SIP request and sends it. –Also as a server: generates a response to a SIP request. Based on JAIN SIP libraries and JMF (More info on the architecture at Emil Ivov’s project site http://www.emcho.com/)http://www.emcho.com/ Project info and download at https://sip-communicator.dev.java.net/https://sip-communicator.dev.java.net/ ECE355 project will be based in the alpha version for Windows (sip- communicator-windows.zip).

6. SIP COMMUNICATOR

7. JAIN-SIP-PRESENCE-PROXY SIP Proxy, SIP Registar, and SIP Presence server. –SIP proxy servers help route requests to the user's current location, authenticate and authorize users for services, implement provider call- routing policies, and provide features to users. –SIP Registar servers allows users to upload their current locations for use by proxy servers. Based on JAIN SIP libraries Project info and download at http://snad.ncsl.nist.gov/proj/iptel/

8. Eclipse Projects Setup CVS Repositories in Group Accounts You create your projects in Eclipse importing the source code from your group account in UNIX. There is a CVS repository in each group account called sip- communicator.cvs In this CVS Repository, there are projects that contain the base source code for the ECE355 project: –Sip-Comunicator-Fall05 –sipproxy

9. Eclipse Projects Setup For each project SIP COMMUNICATOR and JAIN-SIP-PRESENCE-PROXY, you will need to: –Checkout code from group CVS repository –Set up Run Configuration parameters in Eclipse –May need to change configuration settings for the project in project.xml files.

10. Eclipse Projects Setup Checking Out Project from CVS File|New|Project In Project Wizard select CVS|Checkout Project from CVS Next, select option “Create a new repository location” Repository path is /home/e355gNN/sip-communicator.cvs NN : Group Number User ID, and Password for UNIX Accounts.

11. Eclipse Projects Setup Checking Out Project from CVS

15. Eclipse Projects Setup Creating Run Configuration Run|Run.. New Configuration Project Name Main Class Arguments (Program or Java VM)

16. SIP COMMUNICATOR Creating Run Configuration

18. SIP PROXY Creating Run Configuration

20. Running Apps SIP COMMUNICATOR SIP COMMUNICATOR reads execution parameters from sip-communicator.xml file Parameters in this file are currently set so that SIP COMMUNICATOR will use the SIP Services provided by JAIN-SIP-PRESENCE-PROXY running locally (127.0.0.1). ….. JAIN-SIP-PRESENCE-PROXY IP Address and Port SIP COMMUNICATOR Port

21. Running Apps SIP COMMUNICATOR Parameters in sip-communicator.xml file also indicate the ports used for audio/video communication ….. More about SIP COMMUNICATOR parameters at https://sip-communicator.dev.java.net/instructions.html Default Values are AUDIO 22224 VIDEO 22222

22. SIP PROXY uses reads parameters from configuration.xml file Parameters in this file are currently set so the SIP proxy runs in the same machine using Port 4000. <SIP_STACK stack_name="nist-proxy" stack_IP_address="127.0.0.1" router_path="gov.nist.sip.proxy.router.ProxyRouter" max_connections="20" thread_pool_size="20" > Local Address Port Running Apps JAIN-SIP-PRESENCE-PROXY

23. Making a SIP Phone Call Ports used for SIP SIP COM 1 SIP COM 2 PROXY 5060 4000

24. Making a SIP Phone Call All ports SIP COM 1 SIP COM 2 PROXY 5060 4000 22224(Audio) 22222(Video)

25. Making a SIP Phone Call For testing, you can run the two instances of SIP Communicator in one machine. You will need to change the SIP port, Audio and Video ports in the sip- communicator.xml files for the second instance.

26. References SIP COMMUNICATOR: https://sip-communicator.dev.java.net/ http://www.emcho.com/ PROXY: http://snad.ncsl.nist.gov/proj/iptel/ SIP: http://rfc.net/rfc3261.html