NOVATAXE administrators guide

Transcription

NOVATAXE administrators guide
“La Connectivité de Qualité en Toute Simplicité”
NOVATAXE
Administrator’s guide
Version 6.5.7
Page 1 of 52
“La Connectivité de Qualité en Toute Simplicité”
Table of Contents
Quick Setup..........................................................................................................................4
WINDOW 7 / WINDOWS Vista Compatibility.................................................................5
Gateways and Modules........................................................................................................6
Types................................................................................................................................6
Notes:...............................................................................................................................6
Cyber Cafe...........................................................................................................................7
Station Installation...........................................................................................................7
Important Topics..........................................................................................................7
Station Maintenance.....................................................................................................7
IP Ports Used....................................................................................................................8
NovaTaxe Configuration.................................................................................................8
Price (By Administrator)..............................................................................................8
Printing Monitoring and Billing.......................................................................................8
NovaTaxe server Printing setup ..................................................................................8
Printer Sharing enable in Windows FireWall............................................................10
Debug / Trace NovaTaxe Cybercafé..............................................................................11
Uninstall NovaTaxe on the Stations.............................................................................11
Subscriptions.....................................................................................................................13
Forfeit – Package (By Administrator)............................................................................13
Subscriptions Creation (By Administrator)...................................................................14
Subscription Sale (By User)...........................................................................................16
List of Subscriptions (By Administrator)......................................................................16
Subscriptions types........................................................................................................17
Telephony subscription..............................................................................................17
WIFI Monitoring and Billing ............................................................................................19
Concept..........................................................................................................................19
Configuration.................................................................................................................19
Add a WIFI Service...........................................................................................................19
WIFI Sessions................................................................................................................21
Concept..........................................................................................................................23
JUSAN’s CL10..............................................................................................................23
CL10 Components.....................................................................................................23
CL10 Connection.......................................................................................................24
Enabling.....................................................................................................................26
Setting the cabin numbers..........................................................................................26
Price List............................................................................................................................27
Price list structure..........................................................................................................27
Pricing Modes................................................................................................................28
Examples:...................................................................................................................29
Prices Filter....................................................................................................................29
Page 2 of 52
“La Connectivité de Qualité en Toute Simplicité”
Pricing Prefixes..............................................................................................................29
Import price list..............................................................................................................30
Notes:.........................................................................................................................30
Import Numbering Plan.................................................................................................32
Changing price for a group of destinations....................................................................32
Multiple Operators.........................................................................................................33
Activation...................................................................................................................33
Changing Operator Cost............................................................................................34
Building LCR (Least Cost Routing) table................................................................34
Concept..........................................................................................................................36
Advantages for using SIP Client service.......................................................................36
Windows Asterisk Installation.......................................................................................36
Configuration.................................................................................................................36
Network Router configuration...................................................................................36
Remote Asterisk PBX configuration.........................................................................37
NovaTaxe configuration............................................................................................37
Adding IP Phone Client / Cabin.................................................................................38
Monitoring SIP Clients..................................................................................................39
Cabin Status...............................................................................................................39
SIP client service............................................................................................................40
Usage..............................................................................................................................42
VoIP Providers definition .................................................................................................43
Concept..........................................................................................................................43
Trunk creation................................................................................................................43
Parameters..................................................................................................................44
Call Routing ......................................................................................................................46
Concept..........................................................................................................................46
Route definition.............................................................................................................46
Parameters..................................................................................................................47
Prefix notations..............................................................................................................47
Licensing............................................................................................................................48
Login Authorizations Rights..............................................................................................48
Profile default usernames and password........................................................................48
Profile Authorizations....................................................................................................49
System Requirements.........................................................................................................50
Novataxe IP Ports used..................................................................................................50
Cyber Café Station IP Ports used...................................................................................50
FAQ....................................................................................................................................51
Q. Message “Can not open port 514”............................................................................51
Q. At the end of Call the total turned into 0, Why?.......................................................51
Q. Can not block the cabin using AudioCodes..............................................................52
Q. Can not cut the call (prepaid ) on AudioCodes.........................................................52
Q. When launching NovaTaxe, getting a message “Application already started”........52
Page 3 of 52
“La Connectivité de Qualité en Toute Simplicité”
Quick Setup
1. Download the latest version from http://www.novataxe.eu/NTsetup
2. Install NovaTaxe by running the latest version of NovaTaxe-setup-x.x.x.exe,
where x.x.x is the version.
3. Launch the application by double click on the icon NovaTaxe on the desktop or
Select NovaTaxe / NovaTaxe on the Start/ All Programs.
4. On authentication dialog box, put “ope” as user name and “ope” as password.
5. On the main application menu select “System” /”Gateways and Connections…”
6. On the opened dialog box, select “File” and then choose the GW or connection
you like to add.
7. Fill number of cabins, license and IP address of the GW when applicable. Press
OK.
8. When IP license is used, on main window, select “System” / “Operator
preferences…” and put the operator ID.
Page 4 of 52
“La Connectivité de Qualité en Toute Simplicité”
WINDOW 7 / WINDOWS Vista Compatibility
The following procedure is done automatically during the installation and normally there
is no need to intervene.
1. Right click on the NovaTaxe application and select Properties.
2. Select Compatibility from the tabbed menu at the top of the properties page.
3. Tick the "Run this program in compatibility mode for..." box and select Windows
XP SP2 or XP SP3.
4. Tick on “Run this program as an administrator” (below under section “Privilege
Level”
5. Click OK.
Page 5 of 52
“La Connectivité de Qualité en Toute Simplicité”
Gateways and Modules
Types
The NovaTaxe supporting different kinds of VoIP gateways and types of connections for
emitting the calls:
1. AudioCodes FXS Gateway- MP112, MP114, MP118 and MP124, for connection
of analogue telephones
2. Linksys/Cisco FXS Gateway- PAP2T, SPA2100/2, SPA8000, SPA112, for
connection of analogue telephones
3. Linksys/Cisco IP Phones- SPA962, SPA932, SPA303
4. Astribank FXS (Only with NovaTaxe Box)- 8/16/24/32 ports, for connection of
analogue telephones and payphones
5. Asterisk IP Phones – For monitoring and invoicing IP phones connected to
Asterisk based NovaTaxe Box.
6. PABX – analogue PBX like Ericsson or Alcatel
7. DISA (Monitoring Asterisk)
8. Cybercafé – for monitoring cybercafé stations
9. CallBack (Monitoring Asterisk)
10. WIFI
Type
AudioCodes version 5.2+
AudioCodes version 5.0Linksys
Astribank
IP Phones on NovaTaxe
Box
IP Phones on remote
Asterisk
DISA (NovaTaxe Box)
Cyber Cafe
PABX
Cabin blocking
Yes
No
No
Yes
Call cutting
Yes
Yes
No
Yes
Tax Info
Yes*
Yes*
Yes*
Yes
Yes
Yes
Yes
No
Yes
Yes
No
No
Yes
Yes
No
Yes*
No
Yes
No
The possibility to do a Call cutting and Cabin blocking, enable usage of Pre-paid mode.
Tax info is the possibility to show the credit balance
* - By using cabin displays like Jusan or LCD.
Notes:
1. When Astribank is used, it should be the first module on the list.
2. Every module can have its own license.
Page 6 of 52
“La Connectivité de Qualité en Toute Simplicité”
Cyber Cafe
Station Installation
1. Uninstall any other instance of application of CyberCafé like Cyberluxe, TinaSoft
and etc.
2. Disable any software that protects Disk changes, like Deepfreeze or MicroSoft
Widows Steady State.
3. Download the latest version from http://www.bosanova.fr/CCsetup
4. You must login and have the rights of administrator !
5. Make sure that you are protected by a password, by default administrator of
Windows do not have password, using panel of configuration create a password,
reboot the PC to make sure that you have been asked for password.
6. Install Cyber Café station by running the latest version of xpccsetup-x.x.x.exe,
where x.x.x is the version
7. Run XpccConfig under BOSaNOVA / XPCC Client.
8. Attention !!! Remember the password you set for the administrator, otherwise you
will not be able to login again to make configuration changes.
Defaults: CafeUser- 1234
Admin – 1234
9. Activate software that protects Disk changes, like Deepfreeze or MicroSoft
Widows Steady State.
Important Topics
1. Set Password for the administrator account.
2. Disable the automatic sleeping
Station Maintenance
To Enter the Cyber cafe client as administrator, you can do one of the following:
1. Press ALT+CTRL+END (ALT+CTRL+FIN) and enter the PC administrator user
name and password.
2. Press ALT+CTRL+END (ALT+CTRL+FIN) and enter as user name "Admin" or
"Administrator" or "Administrateur" and as password "1234"
3. Install the NovaTaxe server on another PC connected to same local network, Add
Cyber cafe connection and on the right station, right click and choose to open as
administrator.
To log on as same as the client or subscriber, log on as “CafeUser”
Page 7 of 52
“La Connectivité de Qualité en Toute Simplicité”
IP Ports Used
The following IP ports should be open to let the communication between the cyber café
station and NovaTaxe to function:
NovaTaxe- port 6999 UDP
Cyber Café Station- port 6998 UDP
Please Note: You should open these ports on the firewall if there is a firewall active.
NovaTaxe Configuration
Price (By Administrator)
Add in the price list an entry with prefix “xpcc_noauth”, please note that for example, for
15 minutes the time should be set to 15 X 60 seconds = 900 seconds, for 1 hour, set to
3600 seconds.
Package price is automatically added in the price list, as an entry with prefix
“xpcc_code”, where code is the code selected for the package.
Printing Monitoring and Billing
NovaTaxe can monitor and bill the printouts done by the stations.
NovaTaxe server Printing setup
1. Name Each Computer Correctly
On a peer-to-peer Windows network, all computers must possess unique names.
Ensure all computer names are unique and each follows the Microsoft naming
recommendations. For example, consider avoiding spaces in computer names:
Windows 98 and other older versions of Windows will not support file sharing
with computers having spaces in their name. The length of computer names, the
case (upper and lower) of names and the use of special characters must also be
considered.
2. Name Each Workgroup (or Domain) Correctly
Each Windows computer belongs either to a workgroup or a domain. Home
networks and other small LANs utilize workgroups, whereas larger business
networks operate with domains. Whenever feasible, ensure all computers on a
workgroup LAN have the same workgroup name. While sharing files between
computers belonging to different workgroups is possible, it is also more difficult
and error-prone. Similarly, in Windows domain networking, ensure each
computer is set to join the correct named domain.
Page 8 of 52
“La Connectivité de Qualité en Toute Simplicité”
3. Install TCP/IP on Each Computer
TCP/IP is the best network protocol to use when setting up a Windows LAN. In
some circumstances, it's possible to use the alternative NetBEUI or IPX/SPX
protocols for basic file sharing with Windows. However, these other protocols
normally don't offer any additional functionality beyond what TCP/IP provides.
Their presence also can create technical difficulties for the network. It is strongly
recommended to install TCP/IP on each computer and uninstall NetBEUI and
IPX/SPX whenever possible.
4. Set up Correct IP Addressing and Subnetting
On home networks and other LANs having a single router or gateway computer,
all computers must operate in the same subnet with unique IP addresses. First,
ensure the network mask (sometimes called "subnet mask") is set to the same
value on all computers. The network mask "255.255.255.0" is normally correct
for home networks. Then, ensure each computer possesses a unique IP address.
Both the network mask and other IP address settings are found in the TCP/IP
network configuration.
5. Verify File and Printer Sharing for Microsoft Networks is Installed
"File and Printer Sharing for Microsoft Networks" is a Windows network service.
This service must be installed on a network adapter to enable that computer to
participate in file sharing. Ensure this service is installed by viewing the adapter's
properties and verifying that a) this service appears in the list of installed items
and b) the checkbox next to this service is checked in the 'on' position.
6. Temporarily or Permanently Disable Firewalls
The Internet Connection Firewall (ICF) feature of Windows XP computers will
interfere with peer-to-peer file sharing. For any Windows XP computer on the
network that needs to participate in file sharing, ensure the ICF service is not
running. Misconfigured third-party firewall products can also interfere with LAN
file sharing. Consider temporarily disabling (or lowering the security level of)
Norton, ZoneAlarm and other firewalls as part of troubleshooting file sharing
problems.
7. Verify Shares are correctly defined to share files on a Windows network,
ultimately one or more network shares must be defined. Share names that end
with a dollar sign ($) will not appear in the list of shared folders when browsing
the network (although these can still be accessed). Ensure shares have been
defined on the network appropriately, following the Microsoft recommendations
for share naming.
Page 9 of 52
“La Connectivité de Qualité en Toute Simplicité”
Printer Sharing enable in Windows FireWall
1. Click Start, point to All Programs, then Accessories, then Communications then
Network Connections. (Or you can right click My Network Places on the desktop
and choose Properties).
2. Right-click the Local Area Network or the connection you are using, then click
Properties.
3. Click the Advanced tab, and then click Settings.
4. Click the Exceptions tab. The Exceptions tab with its default settings is shown in
the following picture.
5. Click the File and Printer Sharing checkbox.
6. Click Ok (twice).
If file and printer sharing still does not work properly, verify that the scope setting
for the File and Printer Sharing exception is not preventing other computers from
accessing your shared files and printers. The scope setting allows you to restrict an
exception to a specific group of computers. Be sure that the scope setting for
the File and Printer Sharing exception includes the computers that are trying to
access the files and folders on your computer. There are three possible scope
settings:
Page 10 of 52
“La Connectivité de Qualité en Toute Simplicité”
Any computer (including those on the Internet), which does not restrict the
exception.
My Network (subnet) only, which restricts the exception to computers that are
directly reachable based on entries in the IP routing table.
Custom list, which restricts the exception to a list of Internet Protocol version 4
(IPv4) addresses or IPv4 address ranges. You cannot use the Custom list option for
Internet Protocol version 6 (IPv6) traffic.
To verify the scope of the File and Printer Sharing exception
1. Open Windows Firewall, and then click the Exceptions tab.
2. Click File and Printer Sharing, and then click Edit.
3. Click TCP 139, and then click Change Scope.
4. Verify that the scope setting includes the computers that you want to access
your computer. If it does not, change the scope so it is less restrictive.
5. Repeat steps 3 and 4 for TCP 445, UDP 137, and UDP 138.
Debug / Trace NovaTaxe Cybercafé
NovaTaxe station keep tracks of all activity in two files, located in C:\Program
Files\BOSaNOVA\XPCC\log.
The files name are xpcc-0 and xpcc-1.
Uninstall NovaTaxe on the Stations
There are 4 ways to deactivate the NovaTaxe on the station:
Page 11 of 52
“La Connectivité de Qualité en Toute Simplicité”
1. Right Click on the station icon in the NovaTaxe server and then select “Restore
Station” , after this you restart the station to let this take effect.
2. On the station, enter as administrator (CTRL+ALT+END and your credentials),
from Applications / BOSaNOVA choose “Uninstall”
3. Restoring the original Winlogon DLL.
A. Reboot the station into “safe” mode (Pressing F8 on rebooting).
B. In the registry change the key
“HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\WinLogon” to
“msgina.dll”
4. Restoring the original Winlogon DLL.
A. Reboot the station into “safe” mode (Pressing F8 on rebooting).
B. Copy “C:\Windows\system32\msgina.dll” into “C:\Program
Files\BOSaNOVA\XPCC Client-x.y.z\XpccGina.dll
Page 12 of 52
“La Connectivité de Qualité en Toute Simplicité”
Subscriptions
NovaTaxe gives the possibility to issue PIN codes for client subscriptions, PIN codes can
be part of different packages.
Packages can be characterized by: the cost, duration of use and expiry date.
Steps to create PIN codes:
1. Create package- forfeit
2. Create PIN codes
3. Sell of subscription
4. List of all subscriptions
Forfeit – Package (By Administrator)
Select on the main menu: Configuration / Cyber café / Forfeits
To add / modify a package select File / Add.
Page 13 of 52
“La Connectivité de Qualité en Toute Simplicité”
The following parameters should be filled:
1. Code- the code to be used in the price list, in the price list the entry should appear
xpcc_nnnn, where nnnn is the code, in this example the entry should be
xpcc_0021, the price will be set according the cost / duration.
2. Name of the package, this name will appear when selecting which type of PIN
codes to be created.
3. Description
4. Cost – cost to sell to the client.
5. Duration – the time in minutes to grant to the client.
6. Expiration – Time in days, after which the PIN validity expires. The time start to
count after date of the sale of PIN code.
Once the package is created, the package price is automatically added in the price list, as
an entry with prefix “xpcc_code”, where code is the code selected for the package.
Subscriptions Creation (By Administrator)
Select Configuration / Cyber Café / Subscriptions PINs Pool...
The following dialog box will appear.
Page 14 of 52
“La Connectivité de Qualité en Toute Simplicité”
Select File / Add for creating more PIN codes
Select File / Automatic generation for creating a batch of PIN codes
Select the number of PIN codes you like to create and the package and press OK.
Page 15 of 52
“La Connectivité de Qualité en Toute Simplicité”
Subscription Sale (By User)
Select Information / Subscription sale
Press OK, to validate the sale
List of Subscriptions (By Administrator)
To see all subscriptions valid and non valid, select Configuration / Cyber Café / List of
subscriptions.
Page 16 of 52
“La Connectivité de Qualité en Toute Simplicité”
Subscriptions types
Multiple types of subscription:
1. CyberCafé
2. WIFI
3. Telephony
4. Call Back
5. DISA
Telephony subscription
Clients on the telephone cabins, can use subscription.
• The client will dial a special prefix (“0089”) followed by the PIN code.
• The client will get busy / non exist indication.
• The client should hook on the receiver.
• Once the PIN was authenticate by NovaTaxe, a welcome message with the credit
rest will be shown on the cabin display, asking the client to hook on, hook off and
dial his destination ( The client should do it within 5 seconds, otherwise the status
will be reset to idle)
• On the NovaTaxe, it will show as a prepaid call with the credit rest
• The client should dial his destination number
Page 17 of 52
“La Connectivité de Qualité en Toute Simplicité”
•
•
Once finish the conversation, the client can hook on and hook off to dial to a new
destination, the system waits X seconds for successive dialing.
After X seconds without dialing, the credit is cached out and calls cost is deducted
from the subscription.
Page 18 of 52
“La Connectivité de Qualité en Toute Simplicité”
WIFI Monitoring and Billing
Concept
NovaTaxe can monitor and bill WIFI connections, using Linksys WIFI router
WRT54GL.
Clients can authorized using a PIN code or by authorizing their MAC.
Configuration
Add a WIFI Service
1. On Menu select “System” and then “Add a GW/Connection”, list of connections
appears.
Page 19 of 52
“La Connectivité de Qualité en Toute Simplicité”
2. Click on “File” and select “Add a WIFI Service”
For changing the SSID, put the new SSID and restart the router.
3. For finding the IP of the WIFI router, several possibilities:
A. If There is not DHCP server, put the default IP address of the router is
192.168.0.222 in the IP field, and add an additional IP to the PC where the
NovaTaxe installed in the same subnet, for example 192.168.0.2
Page 20 of 52
“La Connectivité de Qualité en Toute Simplicité”
B. When the DHCP server is enabled, Press the button “Scanner” to scan and find the
allocated IP.
WIFI Sessions
Press on WIFI icon
on the toolbar to get WIFI status
Page 21 of 52
“La Connectivité de Qualité en Toute Simplicité”
Toolbar indications
No license
OK
Registration problem of one of the trunks
Page 22 of 52
“La Connectivité de Qualité en Toute Simplicité”
Cabin displays
Concept
NovaTaxe supports the possibility to show on the cabin level, using a display:
1. Cabin ready or still not cleared.
2. The amount to pay or credit in prepaid mode, updated in real-time.
3. Number dialled
4. Country dialled
5. Cabin number
There are 2 types of displays supported by the NovaTaxe:
1. JUSAN’s CL10
2. USB displays
JUSAN’s CL10
CL10 Components
Cabin display
Page 23 of 52
“La Connectivité de Qualité en Toute Simplicité”
8 cabins multiplexer
Powered with power supply (supplied)
CL10 Connection
The display for each cabin is connected by a cable RJ9-RJ9 straight (not supplied) to the
multiplexer.
The multiplexer is connected by a cable RJ45-RJ45 straight (Network cable) to the
multiplexer and by adapter RJ45-D9 (supplied) to the PC D9 serial output.
Each multiplexer can support up to 8 cabin displays, Multiple multiplexers can be
cascaded using cable RJ45-RJ45 straight between the first to the second and between the
second to the third and etc.
Page 24 of 52
“La Connectivité de Qualité en Toute Simplicité”
Page 25 of 52
“La Connectivité de Qualité en Toute Simplicité”
Enabling
Select from the menu “Configuration” and then “Options..”
Select from the combobox “Afficheur” “CL10”, and select the corresponding serial portCOMx to which you did connect the display multiplexer.
Setting the cabin numbers
1. On menu, choose system and then “set cabin number”, a dialog box will be
opened.
2. choose the cabin number and press “SET”
3. On all the displays should appear a message “Press button…”
4. Press the button of the display in the cabin you previously chose.
5. Repeat 2-4 for all the display.
6. At the end press “Reset”
Page 26 of 52
“La Connectivité de Qualité en Toute Simplicité”
Price List
NovaTaxe offers many possibilities and flexibility to mange the price list:
• Four modes of pricing: per second or per 1/2/3 steps
• Changing prices by groups
• Indication and easy changing of destinations without sale price
• Indication and easy changing of destinations that are losing- their cost is higher
than their sale price
• Import and export of part or whole price list
• Cost price per operator
• Price comparison and creation of LCR table
Price list structure
Price list consists of the following elements:
Page 27 of 52
“La Connectivité de Qualité en Toute Simplicité”
1. Prefix- Prefix of the destination, for example for France mobile, SFR 33621.
Prefix should include country code and without leading zeros.
2. Destination – destination description in text, for example for prefix 33621, the
destination will be “France Mobile SFR”
3. Buying connection time- Time in seconds of the first period to invoice, default 60
seconds
4. Buying connection cost- cost for the buying connection time period.
5. Buying 2nd Step time - Time in seconds of the 2nd step period of buying, default
60 seconds
6. Buying 2nd step cost- cost for the buying 2nd step time period.
7. Selling connection time- Time in seconds of the first period to invoice, default 60
seconds
8. Selling connection cost- cost for the selling connection time period.
9. Selling 2nd Step time - Time in seconds of the 2nd step period to invoice, default
60 seconds
10. Selling 2nd step cost- cost of the selling 2nd step time period.
Pricing Modes
In “Configuration” / “Price list”, select “File” and then “Options of sale price”:
There are 4 pricing modes:
1. 2 steps- first step is connection time and after this, consecutive steps with the cost
of the step, this is the default for selling price.
2. 3 steps- first step is connection time, second step is the step time and after this
consecutive steps with the total cost of the connection + the step with the time of
the connection + the step.
3. Par second, every second the price is increased, calculated as (time/”connection
time”*”connection cost”), this is the default for buying.
4. 1 step- same as 2 steps when connection and step are equal.
Connection Cost
Set the duration of connection time in seconds and the cost for this amount of the first seconds..
This overrides the first X seconds calculation if the amount is less than the first step, after these
Page 28 of 52
“La Connectivité de Qualité en Toute Simplicité”
X seconds the connection cost is ignored and calculation for first step used. Default is 0, no
connection cost
Examples:
Usage of 3 Steps for selected destinations with connection cost:
Target:
First step 8 seconds = 0.15 €
For 60 seconds = 0.30 €
Settings:
For destination with connection cost:
Connection time: 8 seconds
Connection cost: 0.15 €
Step time: 52 seconds
Step cost: 0.15 €
For destination without connection cost:
Connection time: 0 seconds
Connection cost: 0 €
Step time: 60 seconds
Step cost: X €
Prices Filter
Filter can be set to select a group of prices or to find specific one.
The filter can set by choosing part of whole set of prefixes or by choosing a destination.
Multiple prefixes should be separated by “;”.
Pricing Prefixes
There are 3 types of prefixes supported:
1. Normal telephone numbers- always starting with the country code, for example
for Paris in France, the prefix should be “331”.
The NT knows to ignore the international prefix (usually “00”) or adding the
country code in case of dialing local number for example 01nnnnnnnn (converting
into 331nnnnnnnn).
2. Short telephone numbers- start with “s”, numbers that are dialed with national
prefix and without international prefix, for example, the prefix for European help
“112” can be written as “s1”.
3. Cyber café- all prefixes are starting with “xpcc_”, for manual start/ stop, the
prefix is “xpcc_noauth”, for other cyber café packages the prefix will be
“xpcc_nnnn”, where nnnn is the package code.
For supporting the special numbers:
Page 29 of 52
“La Connectivité de Qualité en Toute Simplicité”
1. On the Linksys or AudioCodes, put as dial plan the following string (*xx|
<3:0033C3>xxxS0|<1:00331>0xxS0|<1:00331>18xxxS0|00|0[1-9]xxxxxxxxS0|
xxxxxxxxxxxx.)
2. On NovaTaxe price list add all the prefixes started with 33C… , example can be
downloaded at “c:\Program files\novataxe\resources\tarif\tarif FR.csv”
Import price list
Price list can imported, to save time of entering one by one.
1. From the menu select “Configuration” and then “Liste de Prix…”, price list
should appear.
2. If you intend to import complete price list, erase the existing price list before.
3. Select “Fichier” and then “Import…”
4. Select the csv file to be imported from.
Checking or unchecking check box that represent group or single field, changes the
expected file structure and the number of fields expected.
When only prefix and destination check boxes are selected, procedure of import dial plan
will done (see later).
Notes:
1. The imported file should be consisted from lines, each line represent different
destination.
Page 30 of 52
“La Connectivité de Qualité en Toute Simplicité”
2. The line can have 10 fields separated by separator, the fields are in this order:
□ Prefix (1 Field)
Prefix;
□ Destination (1 Field)
Destination;
□ Buying (4 Fields)
Buying_1st_period;
Buying_1st_period_cost;
Buying_2nd_period;
Buying_2nd_period_cost;
□ Selling (4 Fields)
Selling_1st_period;
Selling_1st_period_cost;
Selling_2nd_period;
Selling_2nd_period_cost;
3.
The first line can consist an header, that will be ignored:
code;location;opct;opcc;opst;opsc;csct;cscc;csst;cssc;
4. The separator by default is “ ; “ , it can be changed by selecting from the menu:
“Configuration” and then “Options…”, the following dialog box will appear:
5. With “Separateur CVS”, the separator can be changed.
6. If the separator on the file do not corresponds to the separator selected on
“Options”, a message with “Wrong format” will appear.
Page 31 of 52
“La Connectivité de Qualité en Toute Simplicité”
Import Numbering Plan
Numbering plan- the relation between dialing prefixes and destination groups. NovaTaxe
can import this list with synchronization with the existing price list.
NovaTaxe adapts automatically the price assigned to destination group if a new prefix is
added in the imported file.
The format of the file imported should be CSV, with 2 columns: code(prefix) and
destination.
NovaTaxe adds or deletes destinations on the price list, with the possibility to
automatically adapt the selling prices for new prefixes with same destination name.
For new destinations name, the default price will be as in “defer.price” in the file
novataxe.properties.
1
2
Destination
existing = new
existing = new
Prefix-indicatif
existing = new
existing # new
3
4
existing # new
existing # new
existing = new
existing > new
5
existing # new
existing < new
Action
Change nothing
Create a new price with price from existing
destination
Change the destination in the existing prefix
Create a new line, set price as in defer.price in
novataxe.properties
Create a new price with price from existing
destination with new location
Optionally, All prefixes that exist in the old price list and not exist on the new sync file
will be deleted on the new created price list.
Changing price for a group of destinations
1. Select the group by putting the prefix or the destination
2. On the price list dialog box select “Groupe de tariff..”
3. On the dialog box that opened, you can put the price common for this group.
Page 32 of 52
“La Connectivité de Qualité en Toute Simplicité”
Multiple Operators
NovaTaxe supports billing for multiple operators
• Cost price per call can depend on the trunk used to do the call
• With Asterisk, routing can be choose according LCR (Least Call Routing)
Activation
To turn on multiple operators, select “System” and then “Operator Preferences”
The effect will be noticeable on the price table, where you can select the operator and
change the cost price per destination
Trunk “ – “ is the default and only here, you can change the sale price
Page 33 of 52
“La Connectivité de Qualité en Toute Simplicité”
Changing Operator Cost
On Price Window select the operator you want to change.
You can import the price list by selecting “File” and then “Import Price List…”
Or you can manually add a single price by selecting “File” and then “Add…”
Only the operator cost can be changed here, the sale price rest unchanged.
Building LCR (Least Cost Routing) table
On Price Window, press on the button “Price Comparison…”.
The table put a common dominator of prefixes, and shows the price per operator per
prefix, in addition it shows the operator with minimal price and the minimal price.
Page 34 of 52
“La Connectivité de Qualité en Toute Simplicité”
To create the LCR table, press on the button “Create LCR”, the following table will be
shown
The table shows the order of the routing for the outgoing calls, where the 1st operator is
with the minimal price, the 2nd operator is the 2nd best and etc.
Once confirmed, press on the “Transmit LCR !” button, to add a route per prefix in the
database.
Page 35 of 52
“La Connectivité de Qualité en Toute Simplicité”
Asterisk SIP Clients
Concept
NovaTaxe can monitor SIP clients connected to Asterisk PBX, using manager protocol of
the Asterisk.
NovaTaxe can monitor and bill calls originated from Asterisk IP PBX
SIP clients can be:
1. Any SIP gateway like Linksys, AudioCodes or any other.
2. IP phones of any kind, if used with IP phones that support text message, it can
show in real time the total due / credit.
3. SIP client application installed on PC, MAC or any smart phone.
Each client account looks like a telephone cabin and the call shop administrator can see
in real-time the phases of call generation: ringing and connecting.
Asterisk can be hosted locally in Windows PC, installation instructions are detailed
further.
Advantages for using SIP Client service
•
•
•
Unlike with Linksys monitoring, this service is giving the possibility
blocking/unblocking the cabin and using prepaid.
Possibility to have multiple SIP providers and routing calls by prefix.
Possibility for clients to communicate between each other without using SIP
provider- cost 0 for the call shop, a new service (payable ?) to offer clients.
Note:
Unlike with Linksys monitoring, there is no off hook indication.
Windows Asterisk Installation
1. Download Asteriskwin32 installation program from
http://www.asteriskwin32.com/ or
http://miseajour.novataxe.fr/asterisk/AsteriskWin32-0.66b-Setup.exe
2. Run the program and install it on the default directory C:\cygroot
3. Install again the NovaTaxe, it will affect nothing on the current installation, but
will add the necessary files to Asteriskwin32 installation.
Configuration
Network Router configuration
Important:
• In order to let external SIP client to access NovaTaxe which is behind NAT, you
should forward in the network router port 5060, UDP and TCP.
Page 36 of 52
“La Connectivité de Qualité en Toute Simplicité”
•
In order to let external IAX (IAX2) client to access NovaTaxe which is behind
NAT, you should forward in the network router port 4569, UDP.
Remote Asterisk PBX configuration
On the REMOTE asterisk PBX, edit manager.conf file to enable the interaction with
NovaTaxe.
Please note, use the default port of 5038.
[general]
enabled = yes
port = 5038
bindaddr = 0.0.0.0
[novataxe]
secret=pa55w0rd
permit=0.0.0.0/0.0.0.0
read=all
write=all
This will enable the Manager AP, allow access from any IP address using the username
"novataxe" and the password "pa55w0rd".
NovaTaxe configuration
On the menu select “System”/” Gateways and Connections...” and then select
“File”/”Add IP Phones”
“Nombre des cabines” – number of cabins /clients that will use this service of IP Phone
Page 37 of 52
“La Connectivité de Qualité en Toute Simplicité”
“Licence” – License corresponds to the license on the license USB key.
“Temps de deconnexion” – For the prepaid mode, this is the time in seconds for starting
the cut of the call, when the credit limit reach. There is a latency of time that is required
between the decision to cut the call and the actual cut.
Adding IP Phone Client / Cabin
Select from the menu- “systeme” and then “Telephonie” and then “Extensions…”, a
dialog box with all defined IP Phones cabins.
To add the IP Phone client, select “Fichier” and then “Ajouter”
Page 38 of 52
“La Connectivité de Qualité en Toute Simplicité”
“Extension”- Must be 60xx where xx is the cabin number.
“Type”: Currently only SIP is available.
“Affichage”- select the check box if the IP Phone supports showing the cabin balance,
selecting this while the IP Phone does not support this, can cause mal function of the
telephone.
“Nom” – Name of the client.
“Cabine”- Number of the cabin, should be SAME like the xx on the filed of “Extension”.
“Secret”- Password for the client identification.
“NAT”- Check this if client is behind NAT, failing to check this out, can cause one way
voice.
Monitoring SIP Clients
Cabin Status
Page 39 of 52
“La Connectivité de Qualité en Toute Simplicité”
Idle not registered SIP client,
Idle Registered SIP client
Occupied not registered SIP cabin,
Occupied Registered SIP cabin
SIP client service
No licence or can not connect to Astrisk
One or more VoIP providers is not registered
Asterisk is connected, and all VoIP providers is registered
On pressing on the image above, the SIP status appeared.
Page 40 of 52
“La Connectivité de Qualité en Toute Simplicité”
Page 41 of 52
“La Connectivité de Qualité en Toute Simplicité”
Usage
Client can be invoiced in prepaid or post-paid mode. In prepaid mode, the call will be cut
once the credit left will reach insufficient level.
Call shop administrator can anytime, enable or disable the cabin, by blocking or
unblocking the cabin.
The Client can consult and test the connection:
Dial
Function
3456
Hear the amount of credit / due.
3444
See on the IP Phone display the amount of credit / due (on IP phones or
SIP clients that support this).
3333
Echo test, to verify that there is no one way voice problem
Page 42 of 52
“La Connectivité de Qualité en Toute Simplicité”
VoIP Providers definition
Concept
The NovaTaxe IN can use multiple trunks for termination, trunks can be:
1. SIP account with or without registration.
2. GSM or CDMA, using IP – GSM gateway.
3. PSTN, using FXO gateway or Astribank FXO
Under one VoIP account, there can be zero, one or multiple registrations:
1. Without registration, for VoIP operators that are using IP address for
authentication.
2. One registration account, all the calls will use this account, so this account should
support multiple concurrent calls.
3. Two or more registrations accounts, cabin one will use the first account; the
second cabin will use the second account and etc. In this case the number of
registration accounts MUST be the same (or greater) than the number of cabins
Trunk creation
From the menu select system / Telephony and then “VoIP provider”
To add a new trunk / provider, select “File” and then “Add…”
Page 43 of 52
“La Connectivité de Qualité en Toute Simplicité”
Parameters
•
•
•
•
•
•
Name – Free text for descriptive name of the trunk.
Type – Currently only SIP supported, in future AIX will be supported as well.
Host – IP address or URL of the VoIP operator
Port – Default 5060
NAT – Select this box if the NovaTaxe box is behind NAT.
From Domain – Fill the domain, only if required.
Select “File” and then “Add…” to add caller ID with or without registration.
Page 44 of 52
“La Connectivité de Qualité en Toute Simplicité”
•
•
•
•
Caller ID- Caller ID to be identified against the VoIP provider.
Register – select this box if registration is required.
Name – User name for identification as part of registration.
Secret- Password for identification as part of registration.
Page 45 of 52
“La Connectivité de Qualité en Toute Simplicité”
Call Routing
Concept
Call routing is based on the number dialed, by default all the numbers are routed to the
account defined.
Some destinations can be blocked, by not defining a route these destinations.
Route definition
From menu select “System” / “Telephony” and “Call Routing…”
Page 46 of 52
“La Connectivité de Qualité en Toute Simplicité”
To add route, select “File” and then “Add…”
Parameters
•
•
•
Name – Free text for name of the route
Channel- Select the desired trunk
Routing prefix- Destination prefix, see “Prefix notations” later for the pattern.
Prefix notations
Prefix may be numbers, letters, or combinations thereof. In patterns, some characters
have special meanings:
•
•
•
•
•
•
•
X - any digit from 0-9
Z - any digit from 1-9
N - any digit from 2-9
[1235-9] - any digit in the brackets (in this example, 1,2,3,5,6,7,8,9)
. - wildcard, matches anything remaining (e.g. _9011. matches anything starting
with 9011 excluding 9011 itself)
! - wildcard, causes the matching process to complete as soon as it can
unambiguously determine that no other matches are possible
| - Separate a dialing prefix from the number (for example 00|ZX. Will match
0021262435466, but will dial 21262435466).
For example the extension NXXXXXX would match normal 7 digits dialing, while
1NXXNXXXXXX would represent an area code plus phone number preceded by a one.
Page 47 of 52
“La Connectivité de Qualité en Toute Simplicité”
Licensing
There are three types of licensing, using:
1. MAC address of AudioCodes / Linksys gateway.
2. USB key
3. IP License- License resides on server
Each license corresponds to a specific MAC address or a USB key with number of cabins
allowed.
MAC license can authorize one of more GWs, depending on the number of cabins
allowed.
One USB license can allow multiple connections types up to the limit of the total
allowed.
The NT will authorize the connections one after the other in the same order they are
defined, If the numbers of cabins allowed that rest, is not sufficient to ALL the number of
cabins requested by this connection, all the cabins of this connection are disabled.
Login Authorizations Rights
Administrator can manage 2 types of user profiles:
1. Administrator – Callshop owner, can set the prices and the cabins
2. User – Call shop worker, operates and supervises the call shop
Each profile can login with different username and password, to assure:
1. Callshop owner can set several users to supervise the callshop and can generate
reports per user. In addition only the administrator- callshop owner can change
the price list
Notes:
1. Administrator can create multiple users’ accounts.
Profile default usernames and password
Profile
Administrator
User
Username
admin
user
Page 48 of 52
Password
admin
user
“La Connectivité de Qualité en Toute Simplicité”
Profile Authorizations
Principal
Fichier
Sub menu
Sub menu2
Operator
X
X
X
X
X
X
X
X
X
X
Administrator
X
X
X
User
X
X
X
X
X
X
X
X
Liste de Prix...
Gestion des utilisateurs...
Langues & devises...
Options...
Mise à jour du logiciel...
X
X
X
X
X
X
X
X
X
X
Historique...
Liste de Prix...
Call shop...
Status...
X
X
X
X
X
X
X
X
X
X
Payer...
Detail...
X
X
X
X
X
X
A propos...
X
X
X
Redemarrer !
Quiter
Systeme
Gestion des passerelles...
Telephonie -->
IP Phone...
DISA...
Redemarer telephonie !
Log…
Configuration
Information
Cabine
Aide
Page 49 of 52
“La Connectivité de Qualité en Toute Simplicité”
System Requirements
•
•
•
•
•
•
•
•
Operating system Windows XP, NT, VISTA or Windows 7
Disk space of minimum 80 M
Colour Display with minimum resolution 1024 X 768 (For displaying 24 cabins at
one screen 1280 X 1024 required)
Mouse
PDF reader (for printing invoices and subscriptions)
For using USB cabin display, a USB port
For using JUSAN cabin display, an available serial port
For analogue PABX, an available serial port
Novataxe IP Ports used
Port
Inbound/
Outbound
Inbound
Module
Reason
514
UDP /
TCP
UDP
Syslog, By default, can be change
6999
6996
UDP
UDP
Inbound
Outbound
Inbound
AudioCodes
/ Linksys
Cyber-Cafe
Cyber-Cafe
Asterisk
9
80
UDP
TCP
Outbound
Outbound
Outbound
Outbound
Communication with station
Communication with station
Receive activity log from Asterisk
communication manger
Cyber-Cafe Wakeup LAN for stations
All
For verifying Internet connection,
default can be changed
Linksys
For verifying the MAC and the model
AudioCodes SNMP, for blocking the cabin
Outbound
AudioCodes Telnet, for cutting the call
Outbound
Outbound
All
All
80
161
TCP
UDP
&TCP
23
UDP
&TCP
18000 UDP
25
Request IP license
SMTP, send email for error report or
call problem
Cyber Café Station IP Ports used
Port
5900
6999
UDP /
Inbound/
TCP
Outbound
UDP
Inbound
&TCP
UDP
Outbound
Module
VNC
NovaTaxe
Reason
NovaTaxe can take control of the
station
Communication with NovaTaxe
Page 50 of 52
“La Connectivité de Qualité en Toute Simplicité”
6996
UDP
Inbound
NovaTaxe
Communication with NovaTaxe
FAQ
Q. Message “Can not open port 514”
A. Port 514 used for syslog there are possible two reasons for this:
Port 514 Blocked by anti virus or internal firewall- change of the configuration of
these utilities is required or close these applications.
Another application is using this port- uninstall this application or change the port
used by:
NovaTaxe- “System / Operator Preferences”
Gateway Linksys1. Select tab “Voice”
2. Select sub tab “System”
3. Enter the IP of the PC with NovaTaxe on “Syslog Server” and “Debug Server”
4. Choose “Debug level” to 3.
5. Change the syslog port, put on “Syslog Server” and “Debug Server” the IP
followed by “:” and the port number (W.X.Y.Z:port).
Gateway AudioCodes- Change field “Syslog server port” on:
Version older than 4.8: “Advanced Configuration”/”Network Setting/Application
Setting”
Version 4.8-5.2 “Advanced Configuration”/”Management Setting”.
Version 5.4 and up - Select “Management/ Management Configuration/ Management
Setting”
Q. At the end of Call the total turned into 0, Why?
A. Possible reasons:
1. The Hook-Flash is not disable on the VoIP gateway.
2. Verify that “Automatic configuration” in “Options” dialog window, is NOT
selected.
3. Verify that the “Debug Level” and on AudioCodes the “Start / End call” is set
correctly.
Page 51 of 52
“La Connectivité de Qualité en Toute Simplicité”
Q. Can not block the cabin using AudioCodes.
A. Verify that the SNMP is enabled.
By pressing on the image of the GW on the tool bar, verify that the “Firmware (SNMP)”
field is not empty.
Q. Can not cut the call (prepaid ) on AudioCodes
A. Verify that the Telnet is enabled and the username and password of the gateway is set
correctly.
Q. When launching NovaTaxe, getting a message “Application
already started”
A. Close the message and move to the open message, if nothing appears and you want to
kill the application, press ALT+CTRL+DEL and kill the process “javaw.exe”.
Page 52 of 52