Difference between revisions of "Call Tracing"

From Kolmisoft Wiki
Jump to navigationJump to search
 
(42 intermediate revisions by 9 users not shown)
Line 1: Line 1:
=Overview =  
<mkmeta>How to trace MOR Call</mkmeta>
= MOR Call Tracing Overview =  


This function is for checking the setup of MOR in order to be sure user will be able to dial out. To setup MOR is not so trivial (we are trying to change this with this manual and GUI improvements). It often happens for users to miss some important detail trying to make everything work. Now Call Tracing will save a lot of head-scratching and we hope will help for a lot of beginners.
This function is for checking the setup of MOR in order to be sure a User will be able to dial out. To set MOR up isn't simple, but we are trying to make it easier with this manual and with improvements to GUI. It often happens that Users miss some important detail while trying to make everything work. Call Tracing will save a lot of head-scratching, and we hope it will be helpful for beginners.


This function can be found in '''SETTINGS –> Billing –> Function –> Call Tracing'''. It can be quickly accessed in the Users menu (SETTINGS –> Users) as well. Just click on the [[Image:icon_call_tracing.png]] icon for a User.


<big>'''Important! This function is for testing Dialing OUT. DID testing is not implemented yet.'''</big>
'''NOTE''' that Accountant can use this functionality with Call Tracing Usage permission.
 
 
This function can be found in '''SETTINGS – Billing – Function – Call Tracing'''. It can be quickly accessed in Users menu (SETTINGS – Users) also. Just press [[Image:icon_call_tracing.png]] icon for some user.
 
In the first window we have to select which user we want to check:
 


In the first window, we have to select which User we want to check:
<br><br>
[[Image:calltracing1.png]]
[[Image:calltracing1.png]]
 
<br><br>
 


= User testing =  
= User testing =  


Next window shows us did we configure everything properly for selected user. Let's look at each section separately.  
The next window shows us whether we have configured everything properly for the selected User. Let's look at each section separately.  
 
The first one shows info special for user:


The first section shows information special to the User:
<br><br>
[[Image:calltracing2.png]]
[[Image:calltracing2.png]]
<br><br>


Here we see three errors [[Image:icon_cross.png]] that prevent the User from operating. Let's say we want to allow a User to make Calls. We will go through each of the errors and fix them.




Here we see [[Image:icon_cross.png]] 4 errors which does not let user to operate. Let's say we want to make user to make calls. So we will go through each one of errors and fix them.
1. This error tells us that the User is Blocked and so unable to make Calls. We should go to [[User Details]] and unblock him.


2. Balance and Credit for this User are empty, and the User type is Prepaid. That means he has no funds to cover the Call fees. There are several ways to go about fixing this:


1. This error tells us that user is Blocked and it will not be able to make calls. We should go to User settings and unblock him.
*  If the User is postpaid, he should use some Payment method to increase his Balance. [[PayPal]] and [[Payments | Manual Payment]], among others, are good ways to do this.
We can change the User type to Postpaid and then we should adjust his Credit. Maybe it is unlimited, maybe some limit exists. But this will allow the User to dial out.


2. Balance and Credit for this user are empty. And user type is Prepaid. That means he has no funds to cover the call fees. There are several ways how to go about this:
3. The User has no Devices. A Device is necessary in order to dial out. Just create one for this User.


*  If user is postpaid – he should use some payment method to increase his balance. PayPal, Manual Payment and other ways are good to do this.
'''Note:''' We also see that the User has an empty Tariff assigned. That is the reason why the User will not be able to dial out. In addition, the User can dial out only to those destinations which have Rates. Currently none of them has. You need to add some Rates to the existing Tariff or assign a non-empty Tariff to this User.
*  We can change user type to postpaid and then we should adjust his credit. Maybe it is unlimited, maybe some limit exists. But that will allow user to dial out.


3. We see that user has assigned some tariff and type of tariff. Type of tariff is just for informational purposes. Here 'Explanation' tells us that tariff is empty. That is the reason why user will not be able to dial out. User can dial out only to these destinations which have rates. Currently none of them has. You need to put some rates to the existing tariff or assign non-empty tariff to this user.
4. User has no devices. Device is necessary to dial out. Just create one for this user.
After solving all these issues we should see:


After solving all these issues, we should see:
<br><br>
[[Image:calltracing3.png]]
[[Image:calltracing3.png]]
<br><br>


= Device testing =


The following section lets us choose a Device, Source, Server, Destination and a Call Time we want to test. For example:
<br><br>
[[Image:Calltracing3.png]]
<br><br>
This data means that we are testing a virtual Call from an IP authenticated SIP Device to a number 37061111111 on 2017 September 5th 09:30.


 
When we click '''Trace Call''', we will go to the next page and we will see something like:
We can proceed with next section which is about LCR:
<br><br>
 
[[Image:New_mor_call_tracing.png]]
[[Image:calltracing4.png]]
<br><br>
 
Call Tracing Log will show self explanatory warnings, errors (in red colored text), other messages, and an informative summary.  
 
 
It tells us that LCR we assigned to the user has no Providers. We should fix it. When at least one Provider is in the LCR assigned to the User we should see:
 
[[Image:calltracing5.png]]
 
 
 
This error happens when all providers in LCR are disabled. We need to have at least 1 active provider in order for user to be able to dial-out:
 
[[Image:calltracing6.png]]
 
 
 
Now none of our active providers has any rates. We should add rates to the provider's tariff. We can press directly on the Tariff to go to its rates and add some of them. After that we should see:
 
[[Image:calltracing7.png]]
 
 
 
To summarize all this section you should check for [[Image:icon_cross.png]] and read error descriptions. After fixing them you should see [[Image:icon_check.png]]. That means problem is solved and you can proceed. If at the bottom of the page you see:
 
[[Image:calltracing8.png]]
 
 
 
That means you still have unresolved issues. After all issues are solved you should see:
 
[[Image:calltracing9.png]]
 
 
 
When you see this green message you know that your user is configured properly. He is not blocked, he has enough money in his balance to pay for the call, his tariff has some rates for some destinations (so only these destinations are available to dial), he has some devices to use for dialing. Also his LCR has active providers with not empty tariffs.
 
You can proceed.
 
 
 
<br><br>
<br><br>
= Device testing =
[[Image:calltracing10.png]]
[[Image:calltracing11.png]]
[[Image:calltracing12.png]]
[[Image:calltracing13.png]]
[[Image:calltracing14.png]]
[[Image:calltracing15.png]]
[[Image:calltracing16.png]]
[[Image:calltracing17.png]]


=From Accountant=


If you see direction as '''Unknown''' that means your number is not in E.164 compatible format. Edit Localization rules to transform your number to E.164 number format.
Accountant must have '''Call tracing usage''' permission in [[Accountant_permissions | Accountant permissions group]] to use this functionality.

Latest revision as of 08:58, 3 October 2017

MOR Call Tracing Overview

This function is for checking the setup of MOR in order to be sure a User will be able to dial out. To set MOR up isn't simple, but we are trying to make it easier with this manual and with improvements to GUI. It often happens that Users miss some important detail while trying to make everything work. Call Tracing will save a lot of head-scratching, and we hope it will be helpful for beginners.

This function can be found in SETTINGS –> Billing –> Function –> Call Tracing. It can be quickly accessed in the Users menu (SETTINGS –> Users) as well. Just click on the Icon call tracing.png icon for a User.

NOTE that Accountant can use this functionality with Call Tracing Usage permission.

In the first window, we have to select which User we want to check:

Calltracing1.png

User testing

The next window shows us whether we have configured everything properly for the selected User. Let's look at each section separately.

The first section shows information special to the User:

Calltracing2.png

Here we see three errors Icon cross.png that prevent the User from operating. Let's say we want to allow a User to make Calls. We will go through each of the errors and fix them.


1. This error tells us that the User is Blocked and so unable to make Calls. We should go to User Details and unblock him.

2. Balance and Credit for this User are empty, and the User type is Prepaid. That means he has no funds to cover the Call fees. There are several ways to go about fixing this:

  • If the User is postpaid, he should use some Payment method to increase his Balance. PayPal and Manual Payment, among others, are good ways to do this.
  • We can change the User type to Postpaid and then we should adjust his Credit. Maybe it is unlimited, maybe some limit exists. But this will allow the User to dial out.

3. The User has no Devices. A Device is necessary in order to dial out. Just create one for this User.

Note: We also see that the User has an empty Tariff assigned. That is the reason why the User will not be able to dial out. In addition, the User can dial out only to those destinations which have Rates. Currently none of them has. You need to add some Rates to the existing Tariff or assign a non-empty Tariff to this User.


After solving all these issues, we should see:

Calltracing3.png

Device testing

The following section lets us choose a Device, Source, Server, Destination and a Call Time we want to test. For example:

Calltracing3.png

This data means that we are testing a virtual Call from an IP authenticated SIP Device to a number 37061111111 on 2017 September 5th 09:30.

When we click Trace Call, we will go to the next page and we will see something like:

New mor call tracing.png

Call Tracing Log will show self explanatory warnings, errors (in red colored text), other messages, and an informative summary.

From Accountant

Accountant must have Call tracing usage permission in Accountant permissions group to use this functionality.