MOR PRO v0.5 documentation

These are notes which should be in MOR PRO v0.5 Manual.

Several IPs from Provider

If your provider providers different IP/PORT for Incomming calls - you should create such device with these settings in /etc/asterisk/sip.conf (for SIP).

zap prefix change for Asterisk

/etc/asterisk/mor.conf

zap technology change

zap_change = lvx

change lvx to anything you want zap should be changed when dialing zap device. This feature let's user use other technology apart from Zap.

Subscriptions

NOTE: service is billed from Activation Start till Activation End. And from invoice period start till end. Time period which fits in both previous periods is actual period which will be billed.

Troubleshooting Invoice

If trying to open PDF invoice you get error - make sure your logo PNG file is without ALPHA layer - that means without transparency layer.

CDR import

On step 2 you can see necessary fields to select. They are marked by *(star). You can select to enter Date/Time in one line OR Date AND Time in separate lines. Without selecting at least one field marked by * you will not be able to continue import process.

Admin email on user registration

If you set every setting to send email to admin when new user registers but no email arrives - check if you have email set for admin user.

Registration to provider

Add register +>…. line in [globals] section. If you add it to the end of file - it will not be active. To check if registration is active - execute sip show registry or iax2 show registry in Asterisk CLI.

If IP of your device can change - then you need to register. You don't need to register when you know static IP's of your devices.

Rounding

Rounding in MOR GUI is done only when showing final result. All values are not rounded in database. Example: 0.027 + 0.027 = 0.054 rounded is 0.05, if you are rounding each step, then you get: 0.03 + 0.03 = 0.06 which is not so right as 0.05.

Email variables

These variables can be used in emails:

• <%= server_ip %> - Server IP where your users should register their SIP/IAX2 devices
• <%= device_type %> - Used on user registration - shows device's type user had selected
• <%= device_username %> - Used on user registration - shows device's username
• <%= device_password %> - Used on user registration - shows device's password
• <%= login_url %> - GUI login url
• <%= login_username %> - User's username to login to GUI
• <%= login_password %> - User's password to login to GUI
• <%= username %> - same as login_username
• <%= first_name %> - First name of the user
• <%= last_name %> - Last name of the user
• <%= full_name %> - First name and last name of the user

Destinations from CSV file to Destination Groups

When you import some csv file and new Destinations are created they do not belong to any Destination Group. In order Call Tracing, Invoice generation and Dialing to work properly - you need to add these Destinations to appropriate Destination Groups.

Otherwise:

1. Call cann be dropped
2. Detailed invoice will have errors
3. Call Tracing will report bad call (when it is good)

Security

MOR DB password

After MOR installation you need to change MySQL passwords for root (which is empty) and for mor (which is 'mor'). For user mor you need to change password in following places:

MySQL itself
/home/mor/config/database.yml

/etc/asterisk/mor.conf
/etc/asterisk/res_mysql.conf
/var/lib/asterisk/agi-bin/mor.conf
/home/mor/public/c2c/c2c.php

Extension interval

If you want to change interval in which extensions are selected do following steps.

Find file /home/mor/app/controllers/application.rb

Make backup of this file!

Find line with:

for i in 104..9999

and change it to something you want.

Restart Apache.

H323 connection configuration example

[global]
userbyalias=no

[mera]
type=friend
host=23.45.67.89
accountcode=5
fastStart=no
context=mor

Note accountcode - it should be equal to devices ID in MOR GUI to tie this configuration with MOR.

IP Authentication for Provider/Device

Press to check IP Authentication in Provider's/Device's setting window to use IP to authenticate them.

username and secret are not used in IP Authentication.

Make sure you put correct Hostname/IP adress for Provider/Device!

How LCR works

Example:

• We have 2 providers A and B.
• Dialed destination is 921XXXXXXXXXX
• Provider A has such rates for prefixes(destinations):
  • 92 rate 0.1
  • No other destination starts with 92
• Provider B has such rates for prefixes:
  • 92 rate 0.05
  • 921 rate 0.2

So LCR in MOR will group this providers in following order:

1. Provider A with rate 0.1 (92)
2. Provider B with rate 0.2 (921)

It first dials through Provider A, if call fails, Provider B will be used to send the call.

If call is ANSWERED, BUSY or there's NO ANSWER - then call ends. And Provider B is not used.

It is used ONLY when call fails - CONGESTION.

Localization

Main purpose of Localization: No matter how you send number when localized it should be in e.164 format.

Localization has nothing in common with numbers you send to providers. It operates with numbers received from caller.

Port

Port in Device/Provider's settings is SOURCE port, that means FROM which port call is coming, NOT TO which port is coming.

Sell minutes to only one country

If you want to sell traffic to only 1 country (or several) create tariff for user which has rates for these destinations only.

How do I change admin password

• Login as admin
• Go to SETTINGS - Users
• Press on Edit for System Administrator
• Enter new password
• Press Change

How to view user's stats in Realtime Stats

• Add user to some Group
• Go to: MANAGEMENT - <Group Name> - Member Stats
• Check Show in Realtime Stats

Realtime Stats Usage

This window can be shown on big LCD screen for Call Center agents to check their performance as seen in photo on one Call Center in Lithuania:

How to create Zap/H323 providers

Zap and H323 does not have Realtime support in Asterisk. In order to configure them you should do following steps: 

1. Create provider in GUI
2. Write down just created provider's device accountcode which can be found in provider's edit window in Device ID: field.
3. In zapata.conf or h323.conf (ooh323.conf or similar) file look for context field. As example (in zapata.conf):

;Sangoma A101 port 1 [slot:2 bus:2 span: 1]
switchtype=euroisdn
context=from_pstn
group=0
signalling=pri_cpe
channel => 1-15
channel => 17-31

NOTE: context=from_pstn

4. In extensions.conf

[from_pstn]
exten => _X.,1,Set(CDR(ACCOUNTCODE)=X)
exten => _X.,2,Goto(mor,${EXTEN},1)

Where X is accountcode from Provider's settings (Device ID)
NOTE: same context as in zapata.conf

5. Add accountcode = X to just created provider (peer/friend) in .conf file where X is the Device ID created in GUI
6. Reload Asterisk and you are ready to go!

Troubleshooting

If you hear "Congratulation from asterisk ...." message that means you forget to set context = mor in zapata.conf or h323.conf file for your provider.