Installation Guide for Caller SIPc
Wonsang Song
Columbia University
Before starting…
• This document shows how to install and configure the caller SIPc in the
NG9-1-1 system. We have a different SIPc version for call takers. This
document doesn’t cover calltaker SIPc.
• Get the installer, petitsipc_setup.exe, with a valid license key from CU.
• We assume that there is a SIP proxy for caller up and running to which the
caller can register. Here is the information you need to know before
configuring the caller SIPc:
– Caller’s SIP URL, username and password
– Hostname or IP address of the SIP proxy for caller
– Hostname or HTTP URL of Public LoST server
– Hostname of DNS server unless you use LoST server’s HTTP URL
System requirement
• Windows XP
• 30MB disk space
• JRE 1.5+
– http://java.sun.com
Step 1: Preinstallation
• Uninstall previous version.
– Start -> Programs -> SIPc -> Uninstall
• Delete the SIPc configuration directory manually.
– C:\Documents and Settings\\.sipc
Step 2: Installation
• Run the installer, petitsipc_setup.exe, and
follow the installation instruction on the
screen.
• After installation finishes, start SIPc.
– Start -> Programs -> SIPc -> SIPc
Step 3.1: Enter license key
• Copy and paste the license key into the SIPc
license window.
• License key looks like:
sipc:cs.columbia.edu:2011-09-15:2011-09-15:12341234123412339a226920c9540d7f
[allowed domain] [expire date] [hash]
Step 3.2: General
• Enter the caller’s username and email
address.
Step 3.3: Connection
• Check “Use the specified service” and
press the “Add a service” button.
Step 3.4: Account information
• User Information
– Your Name: display name
• e.g., caller4
– SIP Address: caller’s SIP URL
• e.g., sip:caller4@sipproxy.vm.irt.cs.columbia.edu
-> SIP From header field will be:
From: caller4
• Login Information
– User Name: userid for authentication
– Password: password for authentication
– Check “Remember password”
• Proxy Information
– Server: Hostname of IP of SIP proxy for caller
• e.g., sipproxy.vm.irt.cs.columbia.edu
– Short name: any unique string for this account
– Check “Register my contact to the communication
server”. If checked, SIPc automatically sends SIP
REGISTER request to the proxy (registrar) whenever it
starts.
• Press “Add” and Click “OK” in both pop-ups.
Step 3.5: SOS
• Home Address for Emergency Dialstrings
– Country: us
– State: 2 character State’s name (optional)
• LoST Server
– Server Name: public LoST server hostname or URL
• e.g., http://lost1.vm.irt.cs.columbia.edu:8080/lost/LoSTServlet
– Timeout: LoST query timeout in millisecond
• DNS Settings
– Server Name: DNS server name
– Timeout: DNS query timeout in millisecond
!) If you use LoST server name, instead of the HTTP URL,
SIPc tries to resolve the LoST HTTP URL by DNS U-
NAPTR/DDDS query. The DNS server configured here
should be able to answer U_NAPTR queries. To bypass
U-NAPTR query, use the LoST server’s HTTP URL.
Step 3.6: Location
• If there is no location determination method available, the caller’s location
can be set manually.
• Press Ctrl+L in the SIPc’s main window to open the location information
window.
– You can enter location information manually.
– If both civic and geospatial location are entered, geo location will have higher
priority.
– You can use either DMS or decimal degree format for geodetic coordinates.
• e.g., 40:48:33N 73:57:34W or 40.8091 -73.9593
Step 4: Making emergency call
Press “sos” button to Make sure you
make emergency call. select the correct
account you added.
SOS call procedure in SIPc
1. Queries LoST with the caller’s location and gets the next
hop URL, which is usually the ESRP’s SIP URL.
2. Sends the emergency SIP INVITE request to the SIP proxy
for caller (outbound SIP proxy). Each field in the request is:
- Request URI: urn:service:sos
- To header field: urn:service:sos
- Route header field: ESRP SIP URL from step1
- Geolocation header + PIDF-LO in the body for the caller’s location
information.
(Outbound SIP proxy forwards the SIP INVITE request to the
ESRP because of the SIP Route header.)
SIPc log information
• All incoming/outgoing SIP messages are stored in:
– C:\Documents and Settings\\.sipc\sipc.log
• Debugging messages are written in:
– C:\Documents and Settings\\.sipc\sip.dbg
• Also you can see incoming/outgoing SIP messages
using the SIP message window. To open it:
– “Tools -> Monitor” in the menu or Press Ctrl+W.