PortaOne PortaSwitch User manual

Handbook:
Broadband Internet, Wifi and IPTV Services
Maintenance Release 23
Porta Switch ®
PORTA
ONE
www.portaone.com

Porta Switch
PortaSwitch® Handbook: Converged Services
© 2000-2011 PortaOne, Inc. All rights Reserved. www.portaone.com
2
Copyright Notice & Disclaimers
Copyright © 2000-2011 PortaOne, Inc. All rights reserved
PortaSwitch® Handbook:
Broadband Internet, WiFi and IPTV Services, May 2011
Maintenance Release 23
V1.23.4
Please address your comments and suggestions to: Sales Department,
PortaOne, Inc. Suite #408, 2963 Glen Drive, Coquitlam, BC, V3B 2P7
Canada.
Changes may be made periodically to the information in this publication.
The changes will be incorporated in new editions of the guide. The
software described in this document is furnished under a license
agreement, and may be used or copied only in accordance with the terms
thereof. It is against the law to copy the software on any other medium,
except as specifically provided in the license agreement. The licensee may
make one copy of the software for backup purposes. No part of this
publication may be reproduced, stored in a retrieval system, or transmitted
in any form or by any means, electronic, mechanical, photocopied,
recorded or otherwise, without the prior written permission of PortaOne
Inc.
The software license and limited warranty for the accompanying products
are set forth in the information packet supplied with the product, and are
incorporated herein by this reference. If you cannot locate the software
license, contact your PortaOne representative for a copy.
All product names mentioned in this manual are for identification
purposes only, and are either trademarks or registered trademarks of their
respective owners.

Porta Switch
PortaSwitch® Handbook: Converged Services
© 2000-2011 PortaOne, Inc. All rights Reserved. www.portaone.com
3
Table of Contents
Preface............................................................................................................................ 5
1. Prepaid WiFi Services .................................................................6
Typical Prepaid WiFi Service Scenario................................................................. 7
Setting Up Your Network Components................................................................ 8
Checklist........................................................................................................................ 14
Initial Configuration of PortaSwitch.................................................................... 15
Create Destination.................................................................................................... 15
Create Nodes.............................................................................................................. 16
Create a Vendor Tariff............................................................................................. 17
Enter Rates.................................................................................................................. 18
Create Vendors........................................................................................................... 20
Define Connections................................................................................................... 22
Create a Customer Tariff........................................................................................ 22
Enter Rates.................................................................................................................. 24
Create a Product........................................................................................................ 24
Create a Customer.................................................................................................... 27
Generate Accounts.................................................................................................... 28
Verify Wireless Internet Event History for Account...................................... 32
2. IPTV Services .............................................................................. 34
IPTV Service Scenario.............................................................................................. 35
Checklist........................................................................................................................ 38
Set up the Kasenna LivingRoom™ Server........................................................ 38
Configure PortaBilling.............................................................................................. 38
Create Subscriptions ................................................................................................ 39
Create Products.......................................................................................................... 40
Create Customer and Account.............................................................................. 42
Check Results on LivingRoom Server................................................................. 44
3. Broadband Internet Access Services.................................... 45
Examples of Broadband Packages...................................................................... 46
Checklist........................................................................................................................ 47
Initial Configuration of PortaSwitch.................................................................... 48
Create Destination.................................................................................................... 48
Create Services .......................................................................................................... 49
Create Nodes.............................................................................................................. 50
Create a Vendor Tariff............................................................................................. 51
Enter Rates.................................................................................................................. 53
Create a Vendor......................................................................................................... 54
Define a Connection................................................................................................. 55
Create a Customer Tariff........................................................................................ 56
Enter Rates.................................................................................................................. 57
Create Subscriptions ................................................................................................ 58
Create a Destination Group Set........................................................................... 60
Define a Destination Group................................................................................... 60
Assign Prefix to Destination Group..................................................................... 61
Create a Volume Discount Plan............................................................................ 62

Porta Switch
PortaSwitch® Handbook: Converged Services
© 2000-2011 PortaOne, Inc. All rights Reserved. www.portaone.com
4
Define Discounts within Volume Discount Plan.............................................. 63
Create a Product........................................................................................................ 66
Create a Customer.................................................................................................... 71
Create Accounts......................................................................................................... 72
Check Current Volume Discount Statistics for Account............................... 75
Verify Broadband Event History for Account................................................... 76

Porta Switch
PortaSwitch® Handbook: Converged Services
© 2000-2011 PortaOne, Inc. All rights Reserved. www.portaone.com
5
Preface
This document provides PortaBilling® users with step-by-step
instructions and examples for setting up various prepaid and postpaid
services on a VoIP network.
Where to get the latest version of this guide
The hard copy of this guide is updated at major releases only, and does
not always contain the latest material on enhancements occurring between
minor releases. The online copy of this guide is always up to date, and
integrates the latest changes to the product. You can access the latest copy
of this guide at: www.portaone.com/support/documentation/
Conventions
This publication uses the following conventions:
Commands and keywords are given in boldface
Terminal sessions, console screens, or system file names are displayed
in fixed width font
The exclamation mark draws your attention to important information or
actions.
NOTE: Notes contain helpful suggestions about or references to materials not
contained in this manual.
Timesaver means that you can save time by taking the action described
in the paragraph.
Tips provide information that might help you solve a problem.
Trademarks and Copyrights
PortaBilling®, PortaSIP®, PortaUM® and PortaSwitch® are registered
trademarks of PortaOne, Inc.

Porta Switch
Prepaid WiFi Services
© 2000-2011 PortaOne, Inc. All rights Reserved. www.portaone.com
6
1. Prepaid WiFi
Services
Prepaid WiFi services enable Internet telephony service providers
(ITSP) to offer wireless access services that customers can pay for in
advance.
The market for prepaid services includes tourists, immigrant
communities, mobile populations such as military personnel, and
people with limited credit histories. These users can all gain immediate
access to WiFi services at key locations such as hotels, cafes by using
prepaid WiFi cards (“access codes”) purchased at supermarkets and
other types of retail outlets. Prepaid WiFi access is a single “purchase”
transaction – so at the moment of the authorization all available funds
are withdrawn from the account and converted into the WiFi access
time.

Porta Switch
Prepaid WiFi Services
© 2000-2011 PortaOne, Inc. All rights Reserved. www.portaone.com
7
Typical Prepaid WiFi Service Scenario
In an ITSP internal network infrastructure, prepaid services are
implemented through a debit card application and work in conjunction
with the following:
Mikrotik RouterBoard 532 with RouterOS 2.9 installed
PortaBilling®
This combination of services enables a carrier to authorize prepaid WiFi
access and debit individual user accounts in real time.
Customer interaction:
Customer selects the WiFi network
Customer clicks “Connect”
Customer opens web browser
Customer opens WiFi gateway authorization page
Customer enters the login and password
Customer starts working

Porta Switch
Prepaid WiFi Services
© 2000-2011 PortaOne, Inc. All rights Reserved. www.portaone.com
8
Setting Up Your Network Components
Mikrotik Configuration Guidelines
1. Assign a proper IP address to Mikrotik.
If it is already assigned go to step 2. If not, set IP address manually or
enable DHCP client and assign it to Ethernet interface with the help of
winbox.exe utility.
Click the “…” button, and select your router; only one should appear.
Make sure the login is admin and there is no password. Click Connect.

Porta Switch
Prepaid WiFi Services
© 2000-2011 PortaOne, Inc. All rights Reserved. www.portaone.com
9
Open the IP tab, choose DHCP Client and then at the window click the
“+” button. Assign a new DHCP Client port using the Interface
dropdown box and click OK.

Porta Switch
Prepaid WiFi Services
© 2000-2011 PortaOne, Inc. All rights Reserved. www.portaone.com
10
2. Connect to Mikrotik.
ssh [email protected]
NOTE: Replace 192.168.0.21 with Mikrotik IP address:
3. Assign IP address to wlan1 interface.
[admin@Mikrotik] > /ip address add interface=wlan1 address=192.168.12.1
netmask=255.255.255.0 disabled=no
[adimn@Mikrotik] > / address print
Flags: X – disabled, I – invalid, D – dynamic
# ADDRESS NETWORK BROADCAST INTERFACE
0 D 192.168.0.214/24 192.168.0.0 192.168.0.255 ether1
1 192.168.12.1/24 192.168.12.0 192.168.12.255 wlan1
[admin@MikroTik] >
NOTE: Network “192.168.12.0/24” is used as a sample.
4. Enable wlan1 interface and set wireless to “access
point-bridge” mode.
[admin@Mikrotik] > /interface enable wlan1
[admin@Mikrotik] > /interface print
Flags: X – disabled, D – dynamic, R - running
# NAME TYPE RX-RATE TX_RATE MTU
0 R ether1 ether 0 0 1500
1 R ether2 ether 0 0 1500
2 R ether3 ether 0 0 1500
3 R wlan1 wlan 0 0 1500
[admin@Mikrotik] >
[admin@Mikrotik] > /interface wireless print
Flags: X – disabled, R – running
0name="wlan1" mtu=1500 mac-address=00:0C:42:05:7A:B6 arp=enabled
disable-running-check=no interface-type=Atheros AR5413
radio-name="000C42057AB6" mode=station ssid="MikroTik" area=""
frequency-mode=manual-txpower country=no_country_set antenna-gain=0
frequency=5180 band=5ghz scan-list=default rate-set=default
supported-rates-b=1Mbps,2Mbps,5.5Mbps,11Mbps supported-rates-
a/g=6Mbps,9Mbps,12Mbps,18Mbps,24Mbps,36Mbps,48Mbps,54Mbps basic-
rates--b=1Mbps basic-rates-a/g=6Mbps max-station-count=2007 ack-
timeout=dynamic tx-power-mode=default noise-floor-threshold=default
periodic-calibration=default periodic-calibration-interval=60 burst-
time=disabled dfs-mode=none antenna-mode=ant-a wds-mode=disabled
wds-default-bridge=none wds-default-cost=100 wds-cost-range=50-150
wds-ignore-ssid=no update-stats-interval=disabled default-
authentication=ye default-forwarding=yes default-ap-tx-limit=0

Porta Switch
Prepaid WiFi Services
© 2000-2011 PortaOne, Inc. All rights Reserved. www.portaone.com
11
default-client-tx-limit=0 proprietary-extensions=post-2.9.25 hide-
ssid=no security-profile=default disconnect-timeout=3s on-fail-
retry-time=100ms preamble-mode=both compression=no allow-
sharedkey=no
[admin@Mikrotik] > /interface wireless set 0 mode=”ap-bridge”
[admin@Mikrotik] > /interface wireless print
Flags: X – disabled, R – running
0name=”wlan1”...
mode=ap-bridge …
…
[admin@Mikrotik] >
5. Configure DHCP-SERVER for WiFi.
5.1. Add IP pool which will be used for WiFi;
[admin@Mikrotik] >/ip pool add name=wifi-pool ranges=192.168.12.2-
192.168.12.255
[admin@Mikrotik] >/ip pool print
# NAME RANGE
0 wifi-pool 192.168.12.2-192.168.12.255
[admin@Mikrotik] >
5.2. Add dhcp network;
[admin@Mikrotik] > /ip dhcp-server network add address=192.168.12.0/24
dns-server=192.168.0.1,213.186.192.2 gateway=192.168.12.1 comment="wifi
network"
[admin@Mikrotik] > /ip dhcp-server network print
# ADDRESS GATEWAY DNS-SERVER WINS-SERVER DOMAIN
0;;; wifi network
192.168.12.0/24 192.168.12.1 192.168.0.1
213.186.192.2
[admin@Mikrotik] >
NOTE: Network «192.168.12.0/24» used for sample, replace it with real
network address and set correct dns-server address(es).
5.3. Add dhcp server;
[admin@Mikrotik] > /ip dhcp-server add interface=wlan1 address-
pool=wifi-pool lease-time=3d00:00:00 disabled=no
[admin@Mikrotik] >/ip dhcp-server print
Flags: X – disabled, I – invalid
# NAME INTERFACE RELAY ADDRESS-POOL LEASE-TIM ADD-ARP
0 dhcp1 wlan1 wifi-pool 3d
[admin@Mikrotik] >
6. Configure RADIUS client.
[admin@Mikrotik] > /radius add address=111.11.11.11 secret="mikrotik"
service="hotspot"
[admin@Mikrotik] > /radius print
Flags: X – disabled
# SERVICE CALLED-ID DOMAIN ADDRESS SECRET
0 hotspot 111.11.11.11 mikrotik
[admin@Mikrotik] >
NOTE: 111.11.11.11 – IP of Master (Radius) Server, secret
– RADIUS Key

Porta Switch
Prepaid WiFi Services
© 2000-2011 PortaOne, Inc. All rights Reserved. www.portaone.com
12
7. Configure HOTSPOT server.
7.1. Add profile for RADIUS AAA;
[admin@Mikrotik] > /ip hotspot profile add name="wi-fi AAA" use-
radius=yes
[admin@Mikrotik] > /ip hotspot profile print
Flags: * - default
0 * name="default" hotspot-address=0.0.0.0 dns-name="" html-
directory=hotspot rate-limit="" http-proxy=0.0.0.0:0 smtp-
server=0.0.0.0
login-by=cookie,http-chap http-cookie-lifetime=3d split-user-
-domain=no use-radius=no
1* name="wi-fi AAA" hotspot-address=0.0.0.0 dns-name="" html-
directory=hotspot rate-limit="" http-proxy=0.0.0.0:0 smtp-
server=0.0.0.0
login-by=cookie,http-chap http-cookie-lifetime=3d split-user-domain=no
use-radius=yes radius-accounting=yes radius-interim-update=received
nas-port-type=wireless-802.11 radius-default-domain="" radius-location-
id="" radius-location-name=""
[admin@Mikrotik] >
7.2. Add HOTSPOT server;
[admin@Mikrotik] > /ip hotspot add name="WiFi" interface=wlan1 address-
pool="wifi-pool" profile="wi-fi AAA"
[admin@Mikrotik] > /ip hotspot print
Flags: X – disabled, I – invalid, S – HTTPS
# NAME INTERFACE ADDRESS-POOL PROFILE IDLE-TIMEOUT
0 X WiFi wlan1 wifi-pool wi-fi AAA 5m
[admin@Mikrotik] > /ip hotspot enable 0
[admin@Mikrotik] > /ip hotspot print
Flags: X – disabled, I – invalid, S – HTTPS
# NAME INTERFACE ADDRESS-POOL PROFILE IDLE-TIMEOUT
0 WiFi wlan1 wifi-pool wi-fi AAA 5m
[admin@Mikrotik] >
NOTE: The name of the HOTSPOT server should be WiFi (the same as the special
destination for WiFi service in PortaBilling®).
8. Connect to WiFi router.
Select the WiFi network and click Connect.

Porta Switch
Prepaid WiFi Services
© 2000-2011 PortaOne, Inc. All rights Reserved. www.portaone.com
13
9. Get online.
Launch your web browser;
Enter your MikroTik’s IP address (configured on the step 1) in
the browser’s Address field;
Enter your Account Id and Service password.

Porta Switch
Prepaid WiFi Services
© 2000-2011 PortaOne, Inc. All rights Reserved. www.portaone.com
14
Checklist
Print the following page and use it to check off the operations you have
completed while performing system setup according to the instructions in
this chapter. Please be sure to perform all of the operations (all of the
boxes must be checked), otherwise the service will not work.
Operation Done
General configuration
Enter company data under My Company. [ ]
Specify a base currency. [ ]
For any other currency you plan to use, specify the exchange rate
source and define exchange rates.
[ ]
Create a symbolic destination WiFi. [ ]
Network configuration
Add node on the web.
Configure your gateway. [ ]
Rating configuration (Vendor)
Create a tariff A, which describes your termination costs. [ ]
Insert rates in tariff A for a symbolic WiFi destination. [ ]
Create a vendor. [ ]
Create a connection for this vendor with the Wi-Fi service type,
using tariff A.
[ ]
Rating configuration (Customer)
Create a tariff B, which will be applied to prepaid WiFi users. [ ]
Insert rates in tariff B for a symbolic WiFi destination. [ ]
Create your WiFi product. [ ]
Create one rating entry in account’s product, using the node you
created and tariff B.
[ ]
Account provisioning
Create a retail customer who owns the WiFi cards. [ ]
Generate a batch of accounts for this customer. [ ]
Testing
Mikrotik Configuration. [ ]

Porta Switch
Prepaid WiFi Services
© 2000-2011 PortaOne, Inc. All rights Reserved. www.portaone.com
15
Initial Configuration of PortaSwitch
TIP: When the system has just been installed, use username pb-root and
password pb-root to login.
The following steps are normally performed only once, after the system is
installed:
Visit My Company on the main menu. Enter information about your
company and set up a base currency. Naturally, this does not limit your
operations to this currency only. However, on cost / revenue reports and
the like different currencies will be converted to the one you specify here.
NOTE: Once you set up a base currency it cannot be changed. If you make a mistake,
you will have to start with a new PortaBilling® environment.
From the main menu, choose Users and create login entries for users
who will be working with the system. It is not recommended that the
default PortaBilling® root user (pb-root) be used for any operations
other than initial set-up. Make sure you are able to login as the newly-
created user and change the password for the pb-root user.
If you plan to do billing in multiple currencies, define them and specify
exchange rates in Currencies section.
Create Destination
You need to create the same destination as the name of HOTSPOT
server you specified in step 7 above (Configure HOTSPOT server.) when
you set up your network components; in this case it will be WiFi.
1. In the Rating section of Admin-Index, choose Destination.
2. Click on the Add button.
3. Fill in the required information. The country subdivision is optional.
You can use the Description column to store some extra information
about the destination.

Porta Switch
Prepaid WiFi Services
© 2000-2011 PortaOne, Inc. All rights Reserved. www.portaone.com
16
4. Click Save.
Create Nodes
This step is only required if you have not entered your gateways into the
system before. In this case, you must enter your gateways as nodes.
PortaBilling® requires some key information about your network
equipment such as IP address, Node ID, Radius shared secret, etc.
1. In the Networking section of the Admin-Index page, choose Nodes.
2. In the Node management window, click the Add icon.
3. Fill in the New Node form:
oNode Name – A short descriptive name for this node (will be
used in the select menus).
oManufacturer - Select Mikrotik.
oType – VoIP node type; select ROUTER.
oNode ID – Mikrotik server host name (recommended
hostname.domainname).
oNAS-IP-Address – IP address of the gateway.

Porta Switch
Prepaid WiFi Services
© 2000-2011 PortaOne, Inc. All rights Reserved. www.portaone.com
17
oAuth. Translation rule – Leave this empty for now; see the
Translation Rules section of the PortaBilling Administrator
Guide.
oRTP Proxying – Leave the default selection (Optimal); this
parameter is not used for the WiFi Internet access service.
oRadius Client – Make sure this check-box is enabled, since the
gateway (node) must be able to communicate with PortaBilling
via RADIUS.
oRadius Key – Enter the RADIUS secret key you have specified
in the configuration of the gateway.
oRadius Source IP – See the Node ID, NAS IP address, and Radius
source IP section of the PortaBilling Administrator Guide.
Unless your gateway has multiple network interfaces, the value
here should be the same as the NAS-IP-Address.
oPOD Server – This checkbox relates to ISP billing. Leave it
unchecked for now.
4. Click Save&Close.
5. Repeat steps 2-4 until all of your nodes have been entered.
Create a Vendor Tariff
The tariff is a single price list for the use of WiFi services. To provide
WiFi services successfully, the following tariff should be created:
oA tariff with the termination costs for each termination partner
you have; these tariffs are created as “Applied to: Vendor”.
To create the required tariff, follow the next steps:

Porta Switch
Prepaid WiFi Services
© 2000-2011 PortaOne, Inc. All rights Reserved. www.portaone.com
18
1. In the Rating section of Admin-Index, choose Tariffs.
2. On the Tariff Management page, choose Add.
3. Fill in the Add Tariff form:
oName - A short name for the tariff object; this is the name you
will then see in the select menus.
oCurrency – Indicates the currency, in which the vendor charges
you.
NOTE: The currency for the tariff may be chosen only once, and cannot be changed
later.
oApplied To – Choose Vendor in the Applied To select menu.
oRouting – Clear the check-box Routing.
oService – Choose Wi-Fi here.
oDefault Off-peak Period – If you do not differentiate between
peak and off-peak rates, just choose Not defined; otherwise,
select one of the previously defined off-peak periods.
oShort Description – A short tariff description.
oDescription – An extended tariff description.
4. Click Save.
Enter Rates
Rates are per-destination prices. Please refer to the Call Billing Parameters
section in the PortaBilling Administrator Guide for more information
on billing parameters.
Managing Rates Online
Managing rates online is very convenient for maintaining existing rate
tables, as well as for reference purposes. For new price lists or major
updates, an offline method is better.

Porta Switch
Prepaid WiFi Services
© 2000-2011 PortaOne, Inc. All rights Reserved. www.portaone.com
19
1. On the Tariff Management page you will see a list of available tariffs.
Click the Rates icon before the name of the tariff. When you are in
Tariff Management for a particular tariff, click on Rates in the
toolbar.
2. In the Edit Rates screen, click Add.
3. Fill in the required information:
oDestination – A symbolic destination prefix may be entered
directly, or you can access the destinations directory by clicking
the Destination link (in the column header).
NOTE: The phone prefix you are trying to create a rate for must already exist in
Destinations.
oInterval First – first billing unit in seconds.
oInterval Next – next billing unit in seconds.
oPrice First – per-minute price for first interval.
oPrice Next – per-minute price for next interval.
oOff-peak Interval First– first billing unit in seconds for off-peak
time.
oOff-peak Interval Next – next billing unit in seconds for off-
peak time.
oOff-peak Price First – per-minute price for first interval for off-
peak time.

Porta Switch
Prepaid WiFi Services
© 2000-2011 PortaOne, Inc. All rights Reserved. www.portaone.com
20
oOff-peak Price Next – per-minute price for next interval for
off-peak time.
NOTE: Off-peak fields appear only if an off-peak period has been defined for the
tariff.
oEffective From – If you want this rate to take effect sometime in
the future, you can either type in a date manually, or use the
calendar (click the DD-MM-YYYY link).
NOTE: When using the calendar, you can specify that the date you are entering is in a
different time zone than your present one. PortaBilling® will then automatically adjust
the time.
oRate Formula Wizard – launches the wizard for creating a
custom rating formula
oPayback Rate, Hidden, Forbidden or Discontinued flags are
optional.
4. Click the Save button in the toolbar, or the icon on the left side
of the row.
Create Vendors
This step is only required if you have not entered information about your
vendors into the system before. Vendors are your termination partners
who will charge you for providing WiFi services.
1. In the Participants section of the Admin interface, choose Vendors.
2. On the Vendor Management page, click Add.