SWITCHING AND ROUTING SYSTEMS PROJECT 2023-2024

 

ASSUMPTIONS:

 

1.     The AsteriskNOW IP PBX installed on a CentOS virtual machine. It will be downloaded in the C:\SCR folder on the laboratory workstation from:

https://el.el.obs.utcluj.ro/scr/pdf/AsteriskNOW.zip. 

 

2.     It is mandatory to build the project using the indicated software version. The practical demonstration will be performed on the laboratory workstations.

 

3.     The hypervisor used for x86 computers (Windows operating system) is Oracle VM Virtual Box 7.0.14. It will be downloaded in the C:\SCR folder on the laboratory workstation from the web page: https://download.virtualbox.org/virtualbox/7.0.14/VirtualBox-7.0.14-161095-Win.exe or from https://el.el.obs.utcluj.ro/scr/pdf/VirtualBox-7.0.14-161095-Win.exe

 

After installing the hypervisor, the AsteriskNOW VM will be added using the “Add” command in the “Machine” tab. Right-click on “Start” and use the option “Normal Start”.   

 

4.     The administrator is the user root with the password asteriskcloud.

 

5.     The IP address set for the AsteriskNOW VM depends on the DHCP server of the Internet Service Provider (for example: 10.134.2.220). 
 

6.     The used softphones are: MicroSIP (using the SIP protocol) and ZoIPer (using IAX2 only in this project, although it allows also SIP). They will be downloaded in the C:\SCR folder on the laboratory workstation  from:

è MicroSIP 3.21.3

https://www.microsip.org/downloads

The installation kit is available also at:

https://el.el.obs.utcluj.ro/scr/pdf/MicroSIP-3.21.3.exe

è ZoIPer5.6.4 (the newest version):

https://www.zoiper.com/en/voip-softphone/download/current

The installation kit is available also at:

https://el.el.obs.utcluj.ro/scr/pdf/Zoiper_Installer_5.6.4.exe

 

7.     Other versions of MicroSIP and ZoIPer software terminals (simpler, but sometimes not working properly on Windows 10 64-bit):

è  MicroSIP Lite  3.21.3

The installation kit is available also at:

https://el.el.obs.utcluj.ro/scr/pdf/MicroSIP-Lite-3.21.3.exe

è ZoIPer2.39 (the oldest version)

The installation kit is available only at:

https://el.el.obs.utcluj.ro/scr/pdf/Zoiper_Free_2.39_Installer.exe

 

8.     The softphones running on the workstations will use the following IP addresses, statically assigned in

https://el.el.obs.utcluj.ro/scr/pdf/Projects_assignment.pdf

 

9.     The configuration of the AsteriskNOW file will be performed using the CLI (command line interface). Configurations using the graphical user interface (FreePBX or others) are prohibited.

 

PROJECT REQUIREMENTS:

 

1.   Create a dial plan for an Asterisk IP PBX with at least two SIP subscribers having the phone numbers 1XYZ and 2XYZ, and at least two IAX2 subscribers having the phone numbers 3XYZ and 4XYZ. The three parameters are: 

 

X = group number

X

Subgroups

4

2331/1

5

2331/2

6

2331/3

 

Y = SIP softphone function and Z = IAX2 softphone function

Y, Z

Function

1

VOICE-MAIL

VMAuthenticate Authenticate a user based on voicemail.conf

VoiceMail Leave a voicemail message

VoiceMailMain Enter voicemail system

Authenticate Authenticate a user

2

CONFERENCING

MeetMe: Simple MeetMe conference bridge

MeetMeAdmin: MeetMe conference Administration

MeetMeCount: MeetMe participant count

3

SAY

SayAlpha: Say Alpha

SayDigits: Say Digits

SayNumber: Say Number

SayPhonetic: Say Phonetic

SayUnixTime: Say the date and/or time

4

PLAY

MusicOnHold: Play Music On Hold indefinitely

Playback: Play a file, Play an MP3 sound file or stream

Playtones: Play a tone list while executing other commands

5

WAIT

Wait: Waits for some time

WaitExten: Waits for some time

MusicOnHold: Wait, playing Music On Hold

6

TIMEOUT

AbsoluteTimeout: Set absolute maximum time of call

DigitTimeout: Set maximum timeout between digits

ResponseTimeout: Set maximum timeout awaiting response

7

RECORD

Dictate: Records and plays back a dictation

Monitor: Record a telephone conversation to a sound file

Record: Record user voice input to a file

 

2.   The mandatory part for managing phone calls will be implemented (DIAL, RINGING, ANSWER and HANGUP functions).

 

Mandatory functions

URL address for further details:

DIAL

Dial: Place a call and connect to the current channel

RINGING

Ringing: Indicate ringing

ANSWER

Answer: Answer a channel if ringing

HANGUP

Hangup: Unconditional hangup

 

NOTES:

1.   SIP subscribers (1XYZ, 2XYZ) do not have access to IAX2 subscribers (3XYZ, 4XYZ) functions and vice versa.

2.   Each of the following subscribers: 1XYZ, 2XYZ, 3XYZ and 4XYZ must be able to call all other defined subscribers.

3.   Y≠Z. 

 

REQUIREMENTS FOR WRITING AND DEFENDING THE PROJECT:

·        Each team must know and be able to explain the purpose of the executed Asterisk commands.

·        The source code MUST contain explanatory comments.

·        Each team will PRINT 2 COPIES of the following files: extensions.conf, sip.conf, iax.conf (in their original format with Courier New 10 font, as in /etc/asterisk/). The code must NOT be modified (for esthetical considerations) by editing using Microsoft Word, OpenOffice etc.!!! The source code should run in the presented format.

·        Furthermore all other configuration files which are mandatory for functions Y and Z will be uploaded (even if they have not been modified!), e.g.: musiconhold.conf, meetme.conf, voicemail.conf etc.

 

 

 

INTERMEDIATE STEPS:

Step 1 (P3)

Call 1 SIP subscriber, 1 IAX subscriber

-

Step 2 (P4)

Implement SIP functions

1 p.

Step 3 (P5)

Implement IAX functions

1 p.

Step 3 (P6)

Integrate SIP and IAX functions

-

 

Ex officio (for defending the project)

0.5 p.

 

REFERENCES:

[Bry13]

R. Bryant, L. Madsen & J. Van Meggelen, “Asterisk™: The Definitive Guide. Fourth Edition”, O’Reilly Media Inc, 2013, Available: https://el.el.obs.utcluj.ro/scr/pdf/Asterisk_The_Definitive_Guide_2013.pdf

[Meg19]

J.Van Meggelen, R.Bryant, L.Madsen, “Asterisk™: The Definitive Guide. Fifth Edition”, O’Reilly Media Inc, 2019, Available: https://www.oreilly.com/library/view/asterisk-the-definitive/9781492031598/

https://el.el.obs.utcluj.ro/scr/pdf/Dialplan_Basics_Asterisk_5th_Edition.pdf
[VoIP24]
„Asterisk – Documentation of Application Commands”, voip-info.org, 2024, Available: https://www.voip-info.org/wiki-Asterisk+documentation+of+application+commands

 

 

EVALUATION CRITERIA:

Content + Functionality

·  SIP functions (design logic, code comments)

·  IAX2 functions (design logic, code comments)

·  Functionality SIP-SIP, IAX2-IAX2, SIP-IAX2, IAX2-SIP

·  Meeting the functioning project requirements

1.0 p.

Questions during project defending

·  Knowledge of the Linux operating system

·  Knowledge of the Asterisk IP PBX

·  Knowledge of the design logic

1.5 p.

Work during the semester

·  See intermediate steps

2.0 p.

Ex officio

 for defending the project

0.5 p.

TOTAL

 

5.0 p.

 

Last update:    11 March 2024