Initial Configuration of PortaSwitch®

 

Checklist

Basic General Configuration of PortaSwitch®

Provide Company Information

Add Users

Add Currencies

Create Destinations

Upload the Default Destinations Set

Upload a Set of Destinations from a File

Creating Destinations One-by-One

Create Nodes

Create Internal Vendor Tariff

Create Internal (Virtual) Vendor

Add Connections

Checklist

Print the following page and use it to check off the operations you have completed while performing the system setup according to the instructions in this chapter. Please be sure to perform all of the operations in the order designated (all of the boxes must be checked), otherwise the service will not work.

 

 

Operation

 

Done

General configuration

 

Enter company data under Company Info and specify a base currency. You can use different currencies for your customers or vendors, but Cost / Revenue Reports will be generated in this currency.

[     ]

For any other currency you plan to use, specify the exchange rate source and define exchange rates

[     ]

Create all the required destinations for off-net calls

[     ]

Create a wildcard ‘|’ destination

[     ]

Create a special destination for your SIP phones

[     ]

Create a special destination for calls to the PortaSIP® Media Server

[     ]

Create a special destination for incoming calls

[     ]

Network configuration

 

Create a PortaSIP® node that represents the PortaSIP® cluster

[     ]

Rating Configuration

 

Create internal tariff, which describes your termination costs for SIP-to-SIP calls and for calls to the PortaSIP® Media Server. Make sure it is NOT a Routing type!

[     ]

Enter a rate for the wildcard destination (|) in this tariff

[     ]

Create a special “internal” vendor which represents your own company for keeping track of SIP-to-SIP calls and calls made to the PortaSIP® Media Server

[     ]

Create a “Calls to Vendor via SIP” connection with the Remote Gateway ID field containing the “SIP-UA” string for this vendor using the internal tariff created above

[     ]

Create a “Calls to Vendor via SIP” connection with the Remote Gateway ID field containing the “INTERNAL” string for this vendor using the internal tariff created above

[     ]

Create a “Calls to Vendor via SIP” connection with the Remote Gateway ID field containing the “SIP-URI” string for this vendor using the internal tariff created above

[     ]

Basic General Configuration of PortaSwitch®

The following steps are normally performed only once, after the system is installed.

Provide Company Information

1.     On the navigation menu to the left, select My company and click Company info.

2.     On the Company info panel, fill in the company details:

·       Company Name – The conventional form of your company’s name (e.g. “Demo system”).

·       Currency – The company’s internal currency. You can use different currencies for your customers or vendors, but Cost / Revenue Reports will be generated in this currency.

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.

 

·       Time zone for global reports – Time zone in which global reports for the environment (e.g. Cost / Revenue Report) will be generated.

·       Reconciliation period – How frequently the global reports (e.g. Cost / Revenue Reports, the report about xDRs for calls which were not identified as crossing any connection to a vendor) will be generated.

 

3.     Go to the Address information panel. Here, in the Legal info section, you can enter information about your company that could be used for any legal transactions, e.g. for taxation purposes:

·       “From” email for outgoing communication – An email address that will appear in the From: field of all outgoing emails, e.g. statistics / invoices or low credit warnings sent to your customers.

·       In the Contact info for invoices section enter contact information about your company that will be used on reports as the primary point of contact for your vendors and customers. This information is the same as that which appears on your letterhead and business cards, for example.

·       Contact email – An email that your customers can use for contacting you (this email can be added to an invoice template and thus appear on issued invoices).

 

Click the Use legal address for invoices option to use your legal company address.

 

Provide company information

 

4.     Go to the Invoicing and taxation panel and fill in the following information:

·       Invoice number sequence – Sequencing level for invoice numbers.

o   Individual for environment – Sequential invoice numbering throughout the environment.

o   Individual for reseller – Sequential invoice numbering throughout the environment for direct customers, distributors and resellers, though the reseller will have their own sequential numbering for all of their customers.

o   Individual for customer – Every customer (direct customer, subcustomer, distributor, and reseller) will have their own sequential numbering.

 

5.     Click Save.

 

Spesify taxation info

Add Users

It is not recommended to use the default PortaBilling® root user (<env>-root) for any operations other than initial setup. That is why you need to create at least one new user with root permissions.

1.     On the navigation menu to the left, select My company, then Access control, and click Users.

 

Open the Users panel.

 

2.     On the Create user panel, fill in the user details:

·       Login – Type a username that will be used by this user to log in to the admin interface.

·       Email – Type an email contact for this user. The user will receive notifications for which they are subscribed via this email.

·       Password – Type the password for this user.

·       Role – Select Root for this user.

 

3.     Click Save.

 

Create a new user.

 

You may configure additional parameters for a user as well. For more information about available fields, click  at the top-right corner.

Make sure that you are able to log in as the newly-created user, and change the password for the <env>-root user.

Add Currencies

If you plan to do billing in multiple currencies, define them and specify exchange rates on the Currency management panel.

 

To open the Currency management panel:

1.     In the left upper corner click  to open the navigation menu.

2.     On the navigation menu, select Financial, and then select Currency management.

 

Add a new currency.

 

 

Exchange rates.

Create Destinations

There are two ways to insert a new destination into the system:

·       A bulk update, by uploading destinations from a file.

·       One-by-one on the web interface.

NOTE: PortaBilling® supplies a file with a default destination set which you can download and then upload to the server. However, it is possible that your business requires different types of prefixes, so please check the data in the file before uploading.

Upload the Default Destinations Set

1.     On the navigation menu, select Service catalog, select Rate codes, and then select Destinations.

2.     On the Destination panel, click Upload.

3.     In the Upload destinations dialog box, select Default destination set.

4.     Click the default destinations set link to download a set of destinations as a .csv (comma-separated values) file.

 

Upload the default destination set.

NOTE: PortaBilling® supplies a file with a default set of destinations in the E.212 format. To download a set of destinations, select the E.212 format on the Destination panel and click Upload. Repeat these steps to edit and upload the file with destinations in the E.212 format.

5.     Open this file in Microsoft Excel or any other suitable program and verify that the list of destinations is correct.

 

Edit the data in the file

 

6.     Switch back to the PortaBilling® admin interface. In the Upload destinations dialog box, select the I have checked the default destinations set check box and click Upload.

Upload a Set of Destinations from a File

1.     On the Destination panel, click Upload.

2.     In the Upload destinations dialog box, select Custom file.

3.     Click Browse and locate the file that contains the destinations.

4.     Click Upload.

 

Upload destinations from a file.

Creating Destinations One-by-One

How to add a new destination

1.     Open the Create a destination panel.

2.     Fill in the destination information. This includes the phone prefix, the country name and the country subdivision. You can use the Description field to store extra information about the destination (for example, if it is a mobile or fixed number).

3.     Click Save.

 

Add a new destination.

Create some special destinations

These destinations are included in a default destination set provided by PortaOne, so skip this step if you have uploaded the default set of destinations.

How to check what special destinations are in the system

To check what special destinations are already in the system, on the Destination panel, from the Format list select Custom and click Apply filters.

 

Custom destinations.

Create special wildcard destination (|)

Sometimes you do not need to differentiate between individual destinations, all calls should be rated the same. A good example of a situation where this is required would be processing xDRs for on-net calls for your internal vendor. There is no direct cost, so you basically want every xDR to be rated at $0.0/min. One way of doing this is to create a rate for every country in the world, but a more elegant way is to use a wild-card rate.

 

Destination | (‘pipe’ symbol) is special: when a rate is created for it in a tariff, it would match any dialed number (unless of course there is more specific rate available).

Create special destinations for SIP calls

 

VOICEONNET

Rate for this special destination covers calls made between IP phones connected to PortaSwitch® (regardless of the actual phone number). Please refer to the Voice On-net Rating section in the PortaSIP Administrator Guide for more details.

 

VOICEONNETR

This special destination allows creating a rate, which will be applied to on-net calls between accounts of subcustomers, which are managed by the same reseller.

 

VOICEONNETRX

Rate for this special destination covers calls made between accounts of the same customer (on-net calls between extensions within the same IP Centrex context).

Create special destinations for incoming calls

These destinations are included in a default destination set provided by PortaOne, so skip this step if you have uploaded the default set of destinations.

 

INCOMING

Rate for this special destination covers all incoming calls.

 

INCOMINGN

This special destination allows creating a rate which will be applied to incoming calls between IP phones connected to PortaSwitch.

 

INCOMINGNR

Rate for this special destination is applied to incoming on-net calls between accounts of subcustomers, which are managed by the same reseller.

 

INCOMINGNRX

This special destination allows creating a rate which covers incoming on-net calls made between accounts of the same customer (within the same IP Centrex context).

Create other special destinations

UM

A rate for this special destination is applied for calls from IP phones to PortaSIP® Media Server access numbers (e.g. to check voice messages).

 

UMIVR

A rate for this special destination is used for charging your customers for calls to any IVR application (for example, for conferencing, callback calling, balance information, etc.).

 

FAV

Rate for this special destination is used when you offer customers a “call friends & family cheaper”-type service, when the dialed number is checked against a list of “favorite” numbers defined for each account. If a match is found, the call is rated according to a rate for the FAV destination, defined in the customer’s tariff.

 

WiFi

This special destination allows creating a rate which is used to charge your WiFi customers.

 

NETACCESS

This special destination allows creating a rate which is used to charge your Broadband Internet customers.

Create Nodes

Now you have to enter your PortaSIP® servers and, optionally, other gateways as nodes. PortaBilling® requires some key information about your network equipment, such as the IP address, Node ID, Radius shared secret, and so on.

Create a node for the PortaSIP® cluster

Let us take a look at this example for adding the PortaSIP® node.

 

Note that you should first configure the PortaSIP® cluster on the configuration server web interface. For detailed configuration instructions, please refer to the PortaSwitch® Configuration Server Web Reference or submit a request to support@portaone.com.

 

1.     On the navigation menu, select Infrastructure, then Billing data sources, and click Nodes.

2.     On the Create node panel, fill in the node details:

·       Name – Type a short descriptive name for your SIP server (that will be used in the lists).

·       Node ID – Type the host name of the PortaSIP® cluster (recommended format: hostname.domainname).

·       IP – Type the visible IP address of the PortaSIP® cluster.

·       Manufacturer – Select PortaOne.

·       Type – VoIP node type. Select PortaSIP.

 

3.     Click Save.

 

Add a new node

 

4.     Repeat these steps if you want additional nodes to be entered into the system; for instance, if you have several PortaSIP® clusters.

Create Internal Vendor Tariff

The tariff is a single price list for services or for your termination costs. To correctly bill your internal calls (the calls inside the system), you will need to create a special tariff for the internal vendor (see the Create Internal (Virtual) Vendorsection of this handbook):

 

NOTE: When creating this tariff, make sure to disable the Routing option.

 

1.     On the navigation menu, select Service catalog and click Tariffs.

2.     On the Create tariff panel, fill in the tariff details:

·       Name – Type a short name for the tariff, e.g. Internal SIPonNET. This is the name you will see in the lists.

·       Currency – Leave the default value here (it will be your base currency).

·       Service – Select Voice Calls from this list.

·       Applied to – Select Vendor from this list.

·       Routing – Use the slider to disable Routing for this tariff.

 

3.     Click Save.

 

Add a new tariff.

Add Rates for Internal Vendor Tariff

1.     On the vendor tariff’s panel (Internal SIPonNET), click Rates.

2.     On the Add rate panel, type ‘|’ (pipe) in the Destination field and set zero as the price. Leave the other fields in the form as they are, because there are no actual costs for calls going between individual IP phones or going to voicemail. This will create a special rate that matches any dialed phone number.

3.     Click Save.

 

Add a new rate.

Create Internal (Virtual) Vendor

Vendors are your termination partners or providers of incoming toll-free lines. PortaBilling requires that every call be accounted for on the revenue side (customers) and on the cost side (vendors) and since in case of on-net calls no vendor (in the traditional sense) is involved – you will need to create a special internal (virtual) vendor, which will be used to keep the xDRs for these calls. This vendor and the connections to the vendor is a required step in order to bill internal calls properly.

 

1.     On the navigation menu, select Infrastructure and click Vendors.

2.     On the Create vendor panel, fill in the vendor details:

·       Name – Specify a short name for the internal (virtual) vendor (for example, Internal vendor).

·       Currency – Leave the default value here (it will be your base currency).

·       Opening Balance – Leave the default value here (0).

 

3.     Click Save.

 

Add Connections

Connections represent the point from which calls leave or enter a network and are directed to or from vendors where charges are incurred. For the initial configuration you should define 3 special connections for the internal (virtual) vendor.

Add internal connection for SIP-to-SIP calls

This is a connection that is used for SIP-to-SIP (on-net) calls.

1.     On your vendor’s panel (Internal vendor), click Connections.

2.     On the Create connection panel, fill in the connection details:

·       Description – Type a short description for the connection.

·       Service type – Select Voice.

·       Type of connections – Select SIP.

·       Direction – Select To vendor.

·       Tariff – Select the internal vendor tariff you created earlier.

·       Internal – Use the slider to set this connection as internal.

·       Use for – Select the Route to internally registered SIP accounts (SIP-UA) option.

·       Capacity – Type the maximum number of simultaneous SIP-to-SIP calls you anticipate handling on the PortaSIP® cluster in the near future (e.g. 7500 simultaneous calls). This parameter is only used for correctly scaling the load graph for the connection.

 

3.     Click Save.

 

Add an internal connection.

 

Add internal connection for calls to media server

This is a connection that is used to provide the unified messaging services for end users.

 

To add this connection, repeat steps described in the Add internal connection for SIP-to-SIP calls section, but:

·      In step 2 select the “Unified messaging services (INTERNAL)” in the Use for list.

·      In step 2 specify the maximum number of simultaneous calls you anticipate handling on the PortaSIP® Media Server in the near future (e.g. an average PortaSIP® Media Server handles about 700 simultaneous calls) in the Capacity field.

Add virtual connection for calls forwarded to SIP URI

This is a connection that is used to route calls directly to an external SIP proxy.

 

To add this connection, repeat steps described in the Add internal connection for SIP-to-SIP calls section, but:

·      In step 2 select the “SIP-to-External SIP proxy (SIP-URI)” in the Use for list.

·      In step 2 specify what you anticipate to be the maximum number of simultaneous calls to be directly routed to an external SIP proxy in the Capacity field.

 

For further configuration please refer to the handbook that best meets your business needs:

 

Prepaid Calling Cards 

 

Prepaid Calling Cards (Using a Gateway)

 

Basic Residential VoIP Service

 

Setting up a Wholesale Traffic Exchange

 

Wholesale Termination via a Gateway