nene IXC Softswitch tips and tricks - old design | IXC - VoIP Software developer

IXC Softswitch tips and tricks - old design

1 Situation: I need to do the anum (calling party number) translation as following:
-if anum=1234xxxxx, then convert it into anum 7777
-at same time for same customer, if anum=12xxxxxx, then convert it into 66xxxxx
-all another anums i should pass as is

Solution: You need to create 2 InPeers for same customer A and B. In the InPeer A you should put anum=1234 into InIPAddresses and to InPeer B you should leave anum in InIPAddresses blank. So in this case InPeer A will handle all calls with anum like 1234xxxx, and InPeer B will handle all another anums. After that, we need to create an AnumReplaceClass for InPeer A and InPeer B. For InPeer A it should be AnumReplaceClass with type 'list' and 7777 inside. Now, lets go to InPeer B and create AnumReplaceClass with type 'prefix' and put prefix=12 and realPrefix=66. Solved.

2 Situation: I have few IP addresses of my carrier in one OutPeer. Softswitch is always trying to reach my carrier by the first IP, then goes to second and so on. Can i configure a random selection of IP addresses to send call via this OutPeer?

Solution: Yes, we can configure that globally in Softswitch. Please contact our support department with this request and solution will be provided within few minutes without any service outages.

3 Situation: The loops. Sometimes it happens that a call is looping between few customers/carriers and as a result i see a lot of same calls to the same number in my ActiveCalls and number of those calls is growing and growing and growing. It can grow up to 300-400 lines or even more. Performance of my system is going down because of that loops. How can i stop them?

Solution: When you faced the loop in ActiveCalls, just copy the CalledNumber, then go to InPeer who is originating that loop, open the additional tarrification 'Edit price' and add the number you copied before from ActiveCalls, set mark enabled=n and click GO. Reload your config. This is it. The new call to that loop number will be not routed further.


4 Situation: I deleted one of the peers of current customer by mistake and all CDRs and financial info are no longer available. It can cause a damage to my business. Please advice and help me!

Solution: Do not worry! When we are developing our systems, our main point is our clients and stability of their business. IXC Softswitch is a kind of system that all data can be easily restored. Just create a new peer for that customer with same parameters (do not enable it!), send us a link on it and inform us when you deleted the old peer. After that we will do the restore procedure in few minutes and then you can open your newly created peer. Miracle! But your old CDRs and financial data of deleted peer already restored and putted to your new peer. Problem solved in few minutes.

5 Situation: I deleted one of the users of my Softswitch and did not put attention on the warning message... All the data, prices, peers, companies where this user was responsible disappeared. Please advice and help.

Solution: Well. Situation is more terrible than "Situation 4" for our clients, but do not worry. Because, again, IXC Softswitch is a kind of system that all data can be easily restored :-) For such situations there is automatic backup system working on Softswitch. It backups almost all data of system configuration 4 times a day: on 00, 06, 12, 18 hours. So all your configuration database can be restored by time-stamp you requested. Restore procedure will take up to 10 minutes. Solved

6 Situation: I have Cisco ATA186 on the remote side of my partner, it is on h.323. And from my side i'm using SIP software. But when i call my partner via IXC Softswitch the ATA186 on the far end rings once and reject the call. How can i solve that?

Solution: This is known bug of Cisco ATA186 and solution can be found using IXC Softswitch Signalling Options. Go to the home-page, click on Signalling options, then click add, put any name to new signalling options and set flag 'y' on "permitTunnelingInSetup" field, all other fields leave as is. After that go to Configure Out, find your OutPeer you are using for calls to your partner? click edit, and select just created SignallingOptions there, click GO. Reload your config. After few minutes you can call your partner without any problems. Solved.


7 Situation: What is reload config? Is it manual or automatic? How can i change that?

Solution: IXC Softswitch like any another system has its own configuration parameters which used by system to actually accept the calls from known addresses/users, route them to vendors, bill them depending on prices in configuration etc. When you do any changes via web-interface of our Softswitch the changes take an effect to the database at first. For apply that changes to Softswitch the config should be reloaded. During that stage Softswitch is asking database about changes and apply them to its own configuration parameters.

Automatic reload config - if you can not see the "Reload config" button on home-page, then it is automatic reload config in your system. It means the changes take an effect on softswitch every time when you press GO button anywhere during making changes on web-interface. Please keep in mind that reload config is the procedure which need more system resources as compared with usual Softswitch operations. So if you have a huge traffic, big database and many personal operating with Softswitch, you better to use Manual reload config.

Manual reload config - if you can see the "Reload config" button on home-page, then it is manual reload config set in your system. What does that mean? It means you can do as many changes as you want via web-interface and when you want the changes actually take an effect to softswitch, just press "Reload config" button. Config will be reloaded in few moments or minutes (depends on database size). Advantages of manual reload config can assess our clients who have a big database, many managers of Softswitch, huge traffic, etc. You can decide on your own when you want the changes to be applied to softswitch and as a result can manage the performance of system.

How to change type of reload config in my system? Go to home-page, click on "View settings", find "Automatic reload config" point with flags y/n there. Y - means automatic reload config, N - means manual.


8 Situation: When i'm checking my Active Calls the page is reloading every 5 seconds. That is not enough for me. How can i change the period of reloading that page?

Solution: Go to home-page, click on "View Settings" and find "Active Calls refresh time" there. Put any desired period in seconds and click GO.


9 Situation: I've just created new route for my customer, i checked callpath and it is working, but when my customer is placing a call the routing is not working. What could be an issue?

Solution: There could be few possible problems but most recent is that You did not press Reload Config (in case of manual reload config at IXC Softswitch) button after you finished your routing configuration. Press it and let your customer re-try after while.

10 Situation: What is the main difference between "Edit price" menu and "Tariff ruleset"? How can it be useful for me?

Solution: IXC recommends to use "Tariff ruleset" for billing rules for your customer or carrier. That is our main tariffication option. "Edit price" is used as additional tariffication rules when you need to do some quick correction of some exact code and do not want to edit entire "Tariff ruleset" which usually contain of 10-30k codes. Please keep in mind that "Edit price" has higher priority than "Tariff ruleset", so when you have some code enabled in "Tariff ruleset" and same code disabled in "Edit price" - the code will be disabled in fact.

Usability: imagine situation when your carrier has some outage for some exact destination (code) during 1 hour or so. To stop traffic to that carrier you do not need to edit entire "Tariff ruleset", it will be enough to add that exact code to "Edit price" and set it disabled there. And when your carrier will report that code (destination) is available again - you can just delete your setting from "Edit price".

As you can see it is easy and can be really helpful for you to minimize your time for re-routing.

11 Situation: What "Allowed Routes" and "Allowed Groups" stands for? How can it be useful for me?

Solution: Allowed Routes: is where you can add an OutPeers one by one for route from your InPeer.
Allowed Groups: is the same thing but you can add a group of OutPeers just by one click.

So, IXC recommends you to use AllowedGroups for building your routing as it is nice and easy to make your routing just with one click. Imagine that you have some carriers with Standard routes offer and some with Premium routes. It will be very useful for you to make two OutGroups - one for Std and another one for Prm and then you can add necessary group for your customer.

AllowedRoutes can be used together with AllowedGroups and it can stands for adding some OutPeer with highest prio to easily change your routing for one InPeer. Please keep in mind that AllowedRoutes has a highest prio than AllowedGroups.

12 Situation: Which way RTP is flowing via IXC Softswitch? Is it full proxy mode or half proxy mode? Is there any way to configure different behaviours?

Solution: IXC Softswitch is using full proxy mode (signalling and rtp are flowing via Softswitch) by default. The proxy mode can be easily changed to half (signalling is flowing via Softswitch and RTP is flowing directly between originator and terminator).

For changing the proxy mode it will be enough to set directRTP=y anywhere in: InPeer, OutPeer, AllowedRoutes or OutGroup. Please check our video below to see where directRTP can be set.


13 Situation: I want to trace some calls and have some signalling logs for those calls. Is there any opportunity to enable debug for calls?

Solution: Yes, sure, IXC Softswitch has its own debug system which can be turned on for a while to debug some live calls. Debug is off by default to minimize the system load and HDD free space, so if you want to debug some calls you can enable the debug for some short period and then disable it again. To enable debug follow the link http://yourservername.interexc.com/_logs_ and put ival=2 near your SS name, and put ival=1 to disable debug. To check and collect debugged information please contact our support department and we will propose you few solutions.

Please see our video below to see how to enable/disable debug.


14 Situation: Every time before we start live traffic interconnect with some new carrier we should to test quality of routes of this carrier. This is a lot of job and it takes a lot of time for my managers. Is there any possibility to have some tool for this purposes to make our life easier?

Solution: This is problem of every VoIP company. That is a things to be done, need time, need human resources and so on. So we are developed a tool to make life easier. This tool named IXC Checkup (Autotester). This tool automatically builds routing tables and origination points so you don’t need to do anything’s in order to begin tests; place calls to any terminator's destination code in only 3 clicks; all voice answers during test calls are recorded and can be played directly on web interface. Call results include call setup time and call duration; calls which seem to have been FAS’ed are pointed out and can be reviewed on web-interface as well. Support of any count of test numbers which can be easily added or edited.
So this tool is really what you need to make things better. Please contact us to find more about Autotester.

15 Situation: I need to limit my customer by incoming traffic balance. How can i do that and how can i warn my customer about limitation?

Solution: Solution: You need to click on Configure Customers and click on your Customer, then click on Edit and find "inDep" field there. To limit your customer by incoming traffic balance you should set this flag to 'y'. Next, please see "Max negative balance" field which equals 0.00 by default. What it means? It means when your customer incoming balance (paid to us - inbound sum) will reach 0 - then your customer will not be able to call via your Softswitch. You can set some credit line for your customer by using Max negative balance:100 for example. In this case your customer will be able to call in credit till his incoming balance will be (paid to us - inbound sum)>-100. Once your customer will reach his balance - the mail message will be sent automatically on customer's email.
To warn your customer BEFORE he reached his balance, you can use "depAlarm" flag and set it to 'y'. In the field "minDep" which is 0 by default, you can set some amount, for example 10. In this case customer will be informed by warning email automatically once his incoming balance will pass 10.

16 Situation: Ok, i got how to configure and set the incoming balance limit for my customer, but i want to find out more about emails that automatically sent to my customer. How can i change the text in that message and put some my own contact information?

Solution: You can contact our duty engineer who is available 24/7/365 and ask for two files which used for emails about service stop and warning due to balance things: peerstop.txt and warn.txt. You can edit any information you want in those files except the fields in @ (at). After that you should sent those files back to duty engineer so we can upload them on your Softswitch.

17 Situation: I need to limit myself by outgoing traffic balance that will be sent to carrier. How can i do that?

Solution: You need to click on Configure Customers and click on your Carrier, then click on Edit and find "outDep" field there. To limit yourself by outgoing traffic balance you should set this flag to 'y'. Next, please see "Max negative balance" field which equals 0.00 by default. What it means? It means when your outgoing balance (we paid - outbound sum) will reach 0 - then you will not be able to route calls to your Carrier. You can set some credit line by using Max negative balance:100 for example. In this case your will be able to call in credit till your outgoing balance will be (we paid - outbound sum)>-100.

18 Situation: Ok, but is there any way to set two-way balance as my customer is originating traffic to me and can accept (terminate) traffic from me as well?

Solution: Yes, sure, you can set two-way balance limit. You need to click on Configure Customers and click on your Customer, then click on Edit and find "balanceDep" field there. To set two-way limit you should set this flag to 'y'. Next, please see "Max negative balance" field which equals 0.00 by default. What it means? It means when your two-way balance will reach 0 - then you will not be able to exchange calls with your Carrier/Customer. You can set some credit line by using Max negative balance:100 for example. In this case your will be able to exchange calls in credit till your two-way balance will be >-100.