Workshop Lab Instruction - Internet2

Workshop Lab Instruction Contents 1.

2.

2.

4.

5.

Introduction .................................................................................................................................... 3 1.1.

Prerequisites .......................................................................................................................... 3

1.2.

Checklist................................................................................................................................. 3

1.3.

Network ................................................................................................................................. 3

1.4.

Lab VM Setup......................................................................................................................... 4

1.5.

How to SSH to the Server ...................................................................................................... 4

1.6.

How to Access Web Interface................................................................................................ 4

1.7.

Packet Trace .......................................................................................................................... 5

Initial Configurations ....................................................................................................................... 6 2.1.

AsteriskNOW Setup ............................................................................................................... 6

2.1.1.

Module Admin ....................................................................................................................... 6

2.1.2.

Advanced Settings ................................................................................................................. 8

2.1.3.

Asterisk SIP Settings............................................................................................................. 10

AsteriskNOW Extensions............................................................................................................... 11 3.1.

Extension Configuration ...................................................................................................... 11

3.2.

Softclient Configuration....................................................................................................... 12

a)

Launch LinPhone.................................................................................................................. 12

3.3.

Echo Test ............................................................................................................................. 16

3.4.

Call Analysis ......................................................................................................................... 18

Enterprise SIP routing ................................................................................................................... 19 4.1.

Background to APAN SIP Peering ........................................................................................ 19

4.2.

Call Routing .......................................................................................................................... 19

4.3.

Asterisk SIP Trunking and call routing ................................................................................. 19

4.3.1.

SIP Trunking ......................................................................................................................... 19

4.3.2.

Call Routing .......................................................................................................................... 23

4.4.

Kamailio Initial Configuration .............................................................................................. 25

4.5.

Kamailio Enterprise Server Configuration ........................................................................... 25

4.6.

Kamailio Error Logging ......................................................................................................... 26

4.7.

Call Analysis ......................................................................................................................... 27

ENUM ............................................................................................................................................ 28 Page 1 of 72

5.1.

NRENum.net ........................................................................................................................ 28

5.2.

Asterisk: ENUM Configuration ............................................................................................. 28

5.2.1.

Asterisk Call Analysis ........................................................................................................... 30

5.3.

Kamailio: ENUM Configuration............................................................................................ 30

5.3.1.

Calls Analysis........................................................................................................................ 31

6.

Cisco CUBE Peering Configuration Example. ................................................................................ 32

7.

Cisco VCS ENUM Configuration Example ...................................................................................... 32

8.

Appendix A. – Kamailio Command Summary ............................................................................... 35

9.

Appendix B. – Lab Topology Diagram ........................................................................................... 36

10.

Appendix C. - Enterprise SIP Server Config example. .............................................................. 37

11.

Appendix D. - Country SIP Server Config example ................................................................... 54

12.

Appendix E. – Kamailio Syslog.................................................................................................. 71

13.

Appendix E. – Cisco ISR CUBE sample config ........................................................................... 71

Page 2 of 72

1. Introduction In this workshop, attendees will be divided into 20 available PODs (groups) and each POD hosts one Kamailio server and one AsteriskNOW server with 10 available extensions. This workshop works through and includes a number of sample configurations for a number of applications. Please note that these are SAMPLES ONLY, and MUST NOT be implemented “as is” in a production environment without careful considerations to security aspects specific to your environment.

1.1.Prerequisites The workshop uses pre-built virtual machines. Please note, this is not a Asterisk or Kamailio course. There are other much better courses for that. Most Asterisk configuration changes will be done via the web interface, although there may be a need to occasionally edit a text based configuration file. All Kamailio changes are done via a text editor such as VI, PICO or whatever else you are comfortable using within a linux environment. The AsteriskNOW packaged ISO uses the CentOS linux distribution. The Kamailio server is built using Ubuntu Server 12.04 LTS. Attendees are required to bring their own laptops with a webcam, headset, and wireless. Also, Wireshark is required for packet analysis from the client’s (laptop or workstation) perspective.

1.2.Checklist Please go through this list for laptop software and hardware required to be used in the lab:    

  

Install wireshark. Install SSH client (eg, putty). Install Linphone (www.linphone.org). You can use an alternative SIP softclient if you have one. This one is free. (optional) Install H.264 codecs for Linphone. Please install this codec plugin if you have chosen to use Linphone and would like to try using the H.264 video codec. Please note however, that this codec does tax the CPU. (http://www.linphone.org/eng/download/). Configure/install camera. Connect & configure headset. Wireless access required.

1.3.Network The workshop provides wireless network access to the SIP workshop environment. You will require the following settings to successfully connect to this network.    

Ssid: TBA Authentication: TBA Key: TBA Wireless mode: TBA

Page 3 of 72

1.4.Lab VM Setup This lab is setup using a virtualised environment. It has been designed and resourced for a “lab/workshop” environment, NOT a production environment. Therefore, please EXPECT some performance related issues throughout the course of the day. For example, there may be some delays when logging into the server(s) or you may find there is a delay during call setup and all this will depend on the overall utilisation of the wireless network and hosting resources. We have chosen to use the Indonesian country code for International dialing. All PODS will be located in a publically accessible LAN, and use 5 digit internal extension dialling. Please refer to the accompanying workshop topology diagram for details of IP addressing and allocated extension ranges. The central Proxy is preconfigured with 168.105.216.62/26. It will be demonstrated as a centralised proxy peering server with all other PODs and the APAN SIP server. Please see appendix D for a sample configuration.

1.5.How to SSH to the Server You can SSH to the assigned IP address with SIP server: username: sip and password: sipnn. Asterisk server: username: root and password: asterisknn.

1.6.How to Access Web Interface The AsteriskNOW server is also installed and configured with a web application called FreePBX. This provides an easy way to administer the application server. To login use a browser and go to http://{Asterisk_vm_ip_address}. You should then see a page looking like the following:

Click on the “FreePBX Administration” link. Login with username: admin and password: admin credential. Page 4 of 72

1.7.Packet Trace Ngrep has been installed on all servers. You can run the following command to display plain text packet traces during the SSH session. This will help with call analysis. sudo bash ngrep -p -q port 5060 -W byline press ctrl^C to exit

Alternatively you can use TCPDUMP to capture and analyse raw packet data: sudo bash tcpdump –w {filename.pcap} –i eth0 –s0 press ctrl^C to stop PLEASE be a careful not to fill the drive space. On your own laptop (where the soft client is running), you can run any packet trace tools, such as Wireshark.

Page 5 of 72