LTE Configuration with Quota Control in PCRF
Enable the NetAccess Service Type on the Configuration Server
Configure Diameter (Gy) Settings on the Configuration Server
Create the LTE Service
Create a Customer Tariff
Create an Internet Access Policy
Create a Subscription
Create a Product
Enter SIM Cards into the SIM Card Inventory
Create a Customer
Create an Account
Enable the Sokoban Event Handler Module
This handbook demonstrates how to configure PortaBilling® for integration with the partner platform by the example of EPC (Evolved Packet Core) by ZTE. PortaBilling® supports ZTE provisioning of LTE / 3G services to EPC and supports quota control for these services. Note that by combining the PortaBilling® system with ZTE equipment, some of the possibilities are limited, e.g. only simple billing without real-time authorization is available; the service policy configuration (e.g. quota control, etc.) is defined on the ZTE side (which requires additional human and system resources), etc.
PortaBilling® serves as the B/OSS system in this configuration. It manages customer data (including unified balance), service configuration details, product / rate tables, etc. PortaBilling® allows ISPs to fine-tune a wide range of LTE features according to their business needs, and therefore it provides more flexibility and optimizes resources. Please refer to the LTE Configuration handbook to learn more about how to configure basic LTE service on the PortaBilling® platform.
To proceed with the LTE configuration based on integration with ZTE, follow the steps described below. This handbook provides the settings required on the PortaBilling® side only.
In this handbook, the following scenario is considered: the ISP provides 2 Gb of mobile Internet traffic for a $5 monthly fee. The Internet quota is defined on the ZTE side while end users are charged by PortaBilling®.
Print the following page and use it during system setup to check off the operations as you complete them according to the instructions in this chapter. Please be sure to perform all of the operations in the order designated (all of the boxes should be checked), otherwise the service will not work.
Enable the NetAccess service type on the Configuration server
Configure the Diameter (Gy) on the Configuration server
Create the LTE service
Create an empty customer tariff
Create an Internet access policy
Create a subscription plan
Create a product. Assign the created Internet access policy and subscription
Create a customer
Create an account for this customer. Assign the created product
Configure the Sokoban event handler module
Enable the NetAccess service type as described in the LTE Configurationhandbook.
These settings are necessary to allow the PortaBilling server and your gateway (router, modem) to exchange packages via the Diameter protocol. Refer to the LTE Configurationhandbook for detailed instructions how to configure Diameter (Gy) module.
Services provide a way to define how charges are calculated (e.g. whether customers are charged based on the time they stay online or by the amount of data transferred) and how these are then presented on the invoices.
Create the LTE service. It will enable you to provision Internet services for your end users.
1. In the Billing section of Admin-Index, choose Services.
2. Click on the Add button.
3. Fill in the required information:
· Name – A short descriptive name for this service that will be used in select menus and shown on the customer self-care pages. Type LTE into this field.
NOTE: LTE is the required name for the LTE service. Please do not change it.
· Service Type – Select Internet Access.
· Rating Base – Select upload+download (kilobytes).
· Base Unit – Select kilobyte.
· Billing Unit – Select megabyte. This will be shown on statistics pages and on invoices.
· Billing: Base Ratio – 1024.
4. Click Save.
According to the current business scenario, end users are charged via subscription plan. That is why real tariffs and rates are not required. Create an empty tariff to make it possible to create a product later on.
1. In the Rating section of Admin-Index, choose Tariffs.
2. On the Tariff Management page, choose Add.
3. Fill in the New Tariff form:
· Name – Type in a short name for the tariff object; this is the name you will see in the select menus.
· Currency – Select the currency in which you charge your customers.
· Applied To – Choose Customer. This tariff will be used to charge your customers.
· Service – Select LTE.
4. Click Save.
A policy is a collection of rules and parameters that define how an end user is allowed to access the Internet service.
1. In the Networking section of the admin interface, choose Internet Services.
2. On the Internet Access Policies page, click Add.
3. Fill in the Internet access policy information:
· Name – A short descriptive name for this access policy (e.g. ZTE Access Policy.)
· Managed by – Choose Administrator Only here.
· Access Types – Mark the access types on the table and specify their download and upload rates. Please refer to the Broadband Internet Access Services handbook for detailed information about how to configure access types.
4. On the Additional Info tab configure the ZTE specific parameters:
· Packid – Specify the package ID in ZTE SPR (Subscription Profile Repository). These packages are configured on the LTE side and define amount of Internet traffic, quality of service, bandwidth rules, access to sites, etc.
· Profile – Specify the service configuration value defined in HSS (Home Subscriber Server).
· USERTYPE – Specify the rank of the end user as defined in RCP (Resource and Charging Control Platform). For example, user type 1 represents a gold subscriber; user type 2 represents a silver subscriber, and so on.
5. Click Save.
According to the current business scenario, end users are charged a defined monthly amount of money via subscription. To do this, create a new subscription plan.
1. In the Rating section of the Main Menu page, click Subscription Plans.
2. On the Subscription Plan Management page, click the Add icon.
3. Fill in the fields at the top of the Add Subscription Plan page:
· Subscription Plan Name – Name of the subscription plan which is to be used on the admin interface.
· Subscription Plan Name visible to End User – Provide the name of the subscription plan that your customers will see on their self-care interfaces and invoices.
· Currency – Select the currency in which you charge your customers.
· Managed By – Select Administrator Only.
4. On the General Info tab, provide the following information:
· Subscription Charges Applied – Select In advance, to apply subscription charges to the account / customer balance during the first days of the billing period.
· Period in Advance – Specifies for how many periods advance charges should be made. Type in 1.
· Subscription Is Activated – Defines when the subscription will be considered active (and charges will begin to apply): either simply from the date it is entered into the system, or you may postpone it until the date when the customer actually uses the account for the first time. Select Upon the account’s first usage.
· Activation Fee – The value charged for every new subscription upon startup. Leave this field empty to waive the activation fee.
· Minimum Subscription Period – Time (in months) during which the customer must keep the subscription plan active in order to avoid penalties. Leave this field empty to create a subscription plan that can be closed at any time.
· Waive the charges for the days when no service was provided – Leave this check box unselected.
· Can be applied more than once – Leave this check box unselected.
· Round Charged Amount – Leave the default value.
· Description – Type a description for this subscription plan.
5. On the Periodic Fee tab, provide the following information:
· Periodic Fee – The default fee value that will be applied to your customers.
· Show rates for … billing periods – A billing period the periodic fee value will be defined for. Select monthly.
6. Click Save or Save & Close.
Accounts for specific products will be issued for accessing your Internet services.
1. In the Rating section of the Admin-Index page, choose Products.
2. On the Product management page, click the Add icon.
3. Fill in the “New product” form:
· Product Name – Type in a short name for the product; this is the name you will see in the select menus.
· Product Name Visible to End User – Specify a name for this product that your customers will see on their self-care interfaces.
· Account Role – Select MSISDN since this product will be used by mobile subscribers.
· Currency – Select the currency in which you will charge your customers; only tariffs with the same currency will be permitted in the rating list.
· Product Type – Choose Main Product here.
Included Services tab
· Service type – Select the LTE check box.
· Click Next.
NOTE: When Next is clicked, the product and all of the changes performed during product configuration are saved.
Service Configuration tab
Define the service attribute default values for all the accounts that this product will be assigned to. Assign to the product Internet access policy for ZTE:
· Feature Status – Select Enabled from the list to include a feature in your product.
· Internet Access Policy – Select the previously configured ZTE Access Policy.
· Click Next.
Usage Charges tab
· In the Node list select Any node.
· Leave empty the Access Code field.
· Choose LTE from the Service list.
· In theTariff list select the previously created ZTE tariff.
· Click Update.
Recurring Charges tab
Bundle the required subscription with the product to charge your customers for the LTE service. To do this, select previously created ZTE subscription from the Subscription list. You will see brief information about this subscription below.
4. Click Done.
Refer to the Enter SIM Cards into the SIM Card Inventory section of the MVNO Service Provisioning handbook to find out how to add SIM cards into the SIM card inventory.
A customer is an owner of accounts. Customer contact information is used for distributing account usage information, Internet access statistics, invoices, etc. You usually need to create one customer per each retail prepaid ZTE user.
1. In the Participants section of the Admin-Index page, choose Customers.
2. On the Customer Management page, choose the Add button.
3. Fill in the Add Customer form. Please note that there are several tabs with more information available on the page. The most important fields are:
Main form (top)
· Customer ID – Specify a short name for the customer; this will be used on the web interface.
· Balance Control – Choose Prepaid in this field.
· Currency – Select the currency in which this customer will be billed.
· Available Funds – The amount of funds available for the customer to spend on services.
Address Info tab
· Email – An email address for the distribution of accounting information. After the billing period ends, a list of xDRs and other statistics are sent to this address.
· Bcc – An email address for sending a copy of each outgoing email; this may be used for debugging and archiving purposes.
Web Self-Care tab
· Time Zone – The time zone for the customer self-care interface.
· Web Interface Language – Language used on the customer self-care web interface.
Life Cycle tab
· Billing Time Zone – Time zone in which customer’s billing period will be closed and invoices will be generated.
· Billing Period – Frequency of invoice generation. For more details about different billing periods available, see the PortaBilling Administrator Guide.
· Last Day of the Period – Read-only field available during customer creation only; shows the last date of the customer’s first billing period.
· Invoiced on – Read-only field available during customer creation only; shows the date when customer’s invoice is generated.
4. Click the Save button in the toolbar.
You need to create an account for each device that has a unique SIM card.
1. Go to the Customers page.
2. Next to the customer name, click on the (the one in the Accounts column) to go to the account management page.
3. Click on Add.
4. Fill in the Add Account form:
· Account Role – The intended usage of this account.
· Main Product – Select the ZTE Product here.
· Account ID – The ID which will be used to authorize a subscriber for Internet access. Type in the user’s mobile number or select it from the DID inventory clicking on the Account ID link.
· IMSI – Click the IMSI link and provision a SIM card to this account from the SIM card inventory.
Account Info tab
· Type – Select Credit.
· Balance Control – Leave the Subordinate option here.
· Service Password – The account ID and this password will be used to authenticate Internet users. Make sure you choose a password that is difficult to guess or hack. Alternatively, use the Auto button next to the Service Password field to generate a secure password.
· Email – Enter the account owner’s email address here. If he ever forgets his password for the web self-care pages, he will be able to reset it and a new password will be sent to this email address.
5. Click Save & Close and you will see a confirmation announcement that a new account has been created.
Sokoban is the event handler framework for provisioning service configuration and for account management operations done in PortaBilling® to the mobile carrier’s core.
It consists of events that are processed by handlers – special Perl modules. The events processing results are sent to the carrier’s core. You can either configure a Sokoban event handler module according to the requirements of your business model independently or contact the PortaOne® support team for assistance. To configure Sokoban independently, proceed following these steps:
To enable the Sokoban event handler daemon on the Configuration server, complete the following steps:
1. Go to the Configurations tab on the Configuration server.
2. Clone the existing configuration.
3. Select the Sokoban group on Admin and enable Sokoban:
o Enabled – Select Yes.
4. Click the Save button and then the Verify button.
5. Verify the new configuration and click the Check / Apply button.
To provision data to ZTE, you need to enable the ZTEEPC handler and activate the essential events. This requires a high level of technical knowledge so please contact the PortaOne® support team who will provide you with further assistance.
When a PortaBilling® administrator makes changes for an account (creating, blocking, changing product / Internet access policy, etc.), PortaBilling® immediately provisions updated data to the ZTE HSS (Home Subscriber Server) or ZTE SPR (Subscription Profile Repository). HSS then provides centralized user authentication across the network and SPR manages users’ service policies. This way, user data is always up-to-date in ZTE.