One-EIR Provisioning Sales Feature Description Confidential September 2014 04-09-2014 – / 14 Version 03 Confidential © Nokia Solutions and Networks 2014 The information in this document applies solely to the hardware/software product (“Product”) specified herein, and only as specified herein This document is intended for use by Nokia Solutions and Networks' customers (“You”) only, and it may not be used except for the purposes defined in the agreement between You and Nokia Solutions and Networks (“Agreement”) under which this document is distributed No part of this document may be used, copied, reproduced, modified or transmitted in any form or means without the prior written permission of Nokia Solutions and Networks If you have not entered into an Agreement applicable to the Product, or if that Agreement has expired or has been terminated, You may not use this document in any manner and You are obliged to return it to Nokia Solutions and Networks and destroy or delete any copies thereof The document has been prepared to be used by professional and properly trained personnel, and You assume full responsibility when using it Nokia Solutions and Networks welcome Your comments as part of the process of continuous development and improvement of the documentation This document and its contents are provided as a convenience to You Any information or statements concerning the suitability, capacity, fitness for purpose or performance of the Product are given solely on an “as is” and “as available” basis in this document, and Nokia Solutions and Networks reserves the right to change any such information and statements without notice Nokia Solutions and Networks has made all reasonable efforts to ensure that the content of this document is adequate and free of material errors and omissions, and Nokia Solutions and Networks will correct errors that You identify in this document But, Nokia Solutions and Networks' total liability for any errors in the document is strictly limited to the correction of such error(s) Nokia Solutions and Networks does not warrant that the use of the software in the Product will be uninterrupted or error-free NO WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY OF AVAILABILITY, ACCURACY, RELIABILITY, TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, IS MADE IN RELATION TO THE CONTENT OF THIS DOCUMENT IN NO EVENT WILL NOKIA SOLUTIONS AND NETWORKS BE LIABLE FOR ANY DAMAGES, INCLUDING BUT NOT LIMITED TO SPECIAL, DIRECT, INDIRECT, INCIDENTAL OR CONSEQUENTIAL OR ANY LOSSES, SUCH AS BUT NOT LIMITED TO LOSS OF PROFIT, REVENUE, BUSINESS INTERRUPTION, BUSINESS OPPORTUNITY OR DATA THAT MAY ARISE FROM THE USE OF THIS DOCUMENT OR THE INFORMATION IN IT, EVEN IN THE CASE OF ERRORS IN OR OMISSIONS FROM THIS DOCUMENT OR ITS CONTENT This document is Nokia Solutions and Networks’ proprietary and confidential information, which may not be distributed or disclosed to any third parties without the prior written consent of Nokia Solutions and Networks Nokia is a registered trademark of Nokia Corporation Other product names mentioned in this document may be trademarks of their respective owners, and they are mentioned for identification purposes only Copyright © 2014 Nokia Solutions and Networks All rights reserved 04-09-2014 – / 14 Version 03 Confidential © Nokia Solutions and Networks 2014 Version Date Change Notes 01 2009-07-01 Created 02 2013-09-30 Rebranding 03 2014-09-04 Rebranding 04-09-2014 – / 14 Version 03 Confidential © Nokia Solutions and Networks 2014 Contents One-EIR Sales Feature 1.1 Application SW 1.2 Value for Communications Service Provider 1.3 Summary 1.3.1 Provisioning Gateway 1.4 Availability 1.5 Descriptions 1.5.1 Architecture of One-EIR Provisioning 1.5.2 Provisioning Gateway 1.6 Man Machine Interface (Operator) 11 1.7 Prerequisites 12 1.8 Supported by 12 References One-EIR - Basic Feature Package One-NDS 8.0 - Provisioning Gateway Base Feature Package 04-09-2014 – / 14 Version 03 Confidential © Nokia Solutions and Networks 2014 One-EIR Sales Feature 1.1 Application SW Sales items: One-EIR Provisioning Gateway Plug-In One-EIR 1.2 Value for Communications Service Provider In addition to defining the configuration to specify how the EIR operates, it is necessary to provision the lists of black, grey and white listed devices In the One-EIR FE/System deployment configuration SPML-operations are used for provisions the black, grey and white listed devices One-NDS SF884801 “Provisioning Gateway Base Feature Package” offers the basic generic functionality required to provision all kinds of data in general in One-NDS The basic feature functions and the optional feature functions of One-EIR described directly or indirectly by SF “One-EIR Basic Feature Package” requires additional specific provisioning features provided by the Provision Gateway, the SPML Interface These feature functions are offered by the sales feature package “One-EIR Provisioning Gateway Plug-In One-EIR” It enables operators to provision efficiently diverse subscriber and services data for One-EIR system and to reduce OPEX 1.3 Summary The efficient data provisioning procedures of One-EIR System is enabled by the provisioning gateways, the SPML interface 1.3.1 Provisioning Gateway The provisioning gateway (PGW) is used for provisioning the database It provides a single point of access and a logical coherent view of the stored data and offers a text-based interface to the customer care system Provisioning tasks such as creation, modification, deletion, and display of subscriber and service data based on the common data model are supported It is responsible for: Service administration 04-09-2014 – / 14 Version 03 Confidential © Nokia Solutions and Networks 2014 Subscriber administration, including administration of SIM cards and related subscriber data SOAP-based application triggering The PGW system is implemented as a common, open, and flexible system It supports the administration of any type of data and provides access to open standards, such as Service Provisioning Markup Language (SPML) SPML provides an XML framework for managing the provisioning and allocation of identity information and system resources within and between organizations PGW offers following interfaces for subscriber and service data administration: SPML interface via SOAP/HTTP SPML/batch file interface (bulk file data provisioning) SPML have been specified by Organization for the Advancement of Structured Information Standards (OASIS), non-profit-oriented international consortium that drives the development, convergence, and adoption of e-business standards Due to open standards, the PGW can easily be enhanced to support future services This includes the creation of new services, further integrity rules, and the use of additional valueadded agents for adaptive client support In this way, the provisioning interfaces can be tailored to meet the specific needs of a network operator and even various national companies with different requirements related to the interface behavior, such as different languages, service names, and error handling, while still residing in the same logical directory 1.4 Availability One-EIR 1.5 Provisioning Gateway Plug-In One-EIR Descriptions 1.5.1 Architecture of One-EIR Provisioning As described in the Basic feature, the One-EIR System offered by Nokia is built based on a distributed system architecture consisting of a centralized highly reliable and scalable data repository accommodating diverse subscriber and service data and a number of data-less frontend servers providing One-EIR applications The following graphic shows the provisioning architecture of One-EIR System 04-09-2014 – / 14 Version 03 Confidential © Nokia Solutions and Networks 2014 Figure 1: Integration of the provisioning gateway in the One-EIR System architecture 04-09-2014 – / 14 Version 03 Confidential © Nokia Solutions and Networks 2014 The graphic below illustrates the provisioning interfaces of One-EIR System Figure 2: SPML provisioning interface 1.5.2 Provisioning Gateway 1.5.2.1 Functionality In the provisioning process, the customer relationship management (CRM) system and the subscriber identity module (SIM) card encryption systems act as clients The provisioning gateway provides open-standard interfaces, protocols, and technologies (service provisioning markup language (SPML), simple object access protocol (SOAP)) to enable easy use-case-driven provisioning operations The provisioning gateway uses the provisioning gateway directory service agent (PGW-DSA) to store configuration data The logical PGW-DSA maps onto a set, or cluster, of physical directory servers (DS) The PGW-DSA is responsible for configuration of provisioning activities 04-09-2014 – / 14 Version 03 Confidential © Nokia Solutions and Networks 2014 The main characteristics of the PGW system are: Common data Administration of any type of data Open access Access over protocol based on open standards (service provisioning markup language (SPML)) Flexible adaptation – Easy enhancement to support services for future applications – Customization of provisioning interfaces to meet specific needs The PGW provides the interface to CRM system to handle subscriber administration The CRM system contacts the PGW when new subscribers are updated, deleted, or being located Depending on the architecture of the interfaces and the database, adaptations need to be made in the PGW For the administration of HLR-related subscriber data, the CRM system accesses the PGW over the SPML interface via SOAP/hypertext transfer protocol (HTTP) The SPML requests are encapsulated in SOAP messages that are transported via HTTP protocol The CRM system can send more than one SPML request at the same time; therefore, the PGW needs to serve multiple clients in parallel The PGW offers the SPML/SOAP/HTTP interface and the SPML/batch file interface for subscriber and service data administration SPML interface via SOAP/HTTP The CRM system uses the SPML interface via SOAP/HTTP This interface uses SOAP messages that are transported via HTTP protocol SPML requests are encapsulated in SOAP body of the SOAP envelope SPML/batch file interface (bulk file data provisioning) The CRM system uses the SPML/batch file interface for sending and receiving messages via batch files to and from application clients The batch file will mainly contain SPML requests Internally the PGW splits each SPML request into one or more LDAP requests, validates them and sends them to the One-NDS 1.5.2.2.Realization The PGW’s northbound interface supports SPML requests using SOAP over HTTP, and bulk files over SFTP The provisioning component invoked by the CRM system and the SIM Card 04-09-2014 – / 14 Version 03 Confidential © Nokia Solutions and Networks 2014 management system (also called subscriber authentication system) uses the SPML interface of the PGW for providing subscriber-specific data and services as well as SIM card data This means that the provisioning system and the subscriber authentication system act as clients of the PGW The subscriber authentication system uses SFTP to transfer bulk files that contain SPML requests The services are defined in a web services description language (WSDL) file that is exported by the SOAP interface The Admin Web GUI, connected to @vantage Commander over the DSML interface, is the user interface to administer the PGW’s configuration data Requests from the CRM system, the AC system and the Admin Web GUI are forwarded to the PGW In the PGW, syntax checks and application specific semantic checks are done The main functions on the PGW are: SOAP interface service The SOAP interface service is a classical SOAP server It is responsible for Validating digital signatures and signing the responses, Extracting the request from the SOAP message, Extracting the SOAP callback endpoint in case of asynchronous request, Validating the request syntax against an XML schema, Forwarding the requests to the processing framework, Receiving the responses from the processing framework and sending back the response to the caller Bulk File Interface service The bulk file interface service is the entry point for all bulk files Bulk files arrive over SFTP at the inbox of an SFTP user belonging to a dedicated user group The bulk file interface service is responsible for: Checking the content of the bulk file, Parsing the file request by request, Forwarding the requests and Receiving responses for the requests SOAP Callback service The SOAP callback service sends back responses for asynchronous requests Its main tasks are: Packing the response into a SOAP message, Sending the message to the SOAP endpoint (given by an attribute of the processing response), Handling all SOAP related errors (especially when the given SOAP endpoint is unavailable, the SOAP callback service will some retries with a delay between each retry) 04-09-2014 – 10 / 14 Version 03 Confidential © Nokia Solutions and Networks 2014 Admin Web GUI The Admin Web GUI is used to administer the PGW's configuration data stored in the PGW-DSA The Admin Web GUI offers an additional Update-Now button that triggers the PGW processes at one site to reread their configuration data from the database (Triggering is done by broadcasting a SOAP message to the internal SOAP interface) The Admin Web GUI accesses the PGW-DSA, where the data are stored in a separate logical database This connection is nontransactional The operator can add, delete, and modify configuration data The Admin Web GUI is used to -) Administer the configuration data of the PGW using DSML requests -) Update all PGW instances after the configuration data have been changed -) Browse the command logs collected by all the Provisioning Gateway instances on the host Note that there are only the log files of one host accessible from the Admin Web GUI Overload Handler The overload handler monitors the load of the SPML interface As soon as a request queue runs full (“full” can be defined by a configuration parameter), the overload handler raises an alarm and blocks the queue As soon as the queue is below a configurable threshold, the overload handler unblocks the queue Version Manager The version manager keeps track of the supported SPML and plug-in the SPML components with the appropriate mappers and validators For more information refer to the SPML interface specification for One-NDS Request History The request history stores request-IDs, the state of the request (processing, failed, successful), and the brief result data in the PGW-DSA Command Logging The command logging saves incoming requests and outgoing responses Log files can be used to track changes in the database 1.6 Man Machine Interface (Operator) This sales feature package provides the man-machine interfaces of the One-EIR system for operators to provision subscriber and service data over the SPML interface 04-09-2014 – 11 / 14 Version 03 Confidential © Nokia Solutions and Networks 2014 1.7 Prerequisites The installation of the following sales features is the prerequisite of this sales feature: SF884801 1.8 Provisioning Gateway Base Feature Package (One-NDS) Supported by One-EIR One-DNS 3.0 8.0 04-09-2014 – 12 / 14 Version 03 Confidential © Nokia Solutions and Networks 2014 Abbreviations @Com @vantage Commander AC Authentication Center BSC Base Station Controller BTS Base Transceiver Station CRM Customer Relationship management EIR Equipment Identity Register GGSN Gateway GPRS Support Node GUI Graphical User Interface HLR Home Location Register HTTP HyperText Transfer Protocol IP-M Internet Protocol Manager IPS Intelligent Packet Solution LDAP Lightweight Directory Access Protocol MGW Media GateWay MS/UE Mobile Station / UMTS Equipment MSC Mobile services Switching Center NodeB Node for Broadband service OASIS Organization for the Advancement of Structured Information Standards PGW Provisioning GateWay PSP Provisioning Service Point PST Provisioning Service Target QoS Quality of Service RA Requesting Authority RC Radio Commander RNC Radio Network Controller SC Switch Commander 04-09-2014 – 13 / 14 Version 03 Confidential © Nokia Solutions and Networks 2014 SGSN Serving GPRS Support Node SIM Subscriber Identity Module SMC SIM card Management Center SOAP Simple Object Access Protocol SPC SIM card Provisioning Center SPML Service Provisioning Markup Language TRAU Transcoding and Rate Adaptation Unit VLR Visitor Location Register 04-09-2014 – 14 / 14 Version 03 Confidential © Nokia Solutions and Networks 2014 ... efficient data provisioning procedures of One-EIR System is enabled by the provisioning gateways, the SPML interface 1.3.1 Provisioning Gateway The provisioning gateway (PGW) is used for provisioning. .. directory 1.4 Availability One-EIR 1.5 Provisioning Gateway Plug-In One-EIR Descriptions 1.5.1 Architecture of One-EIR Provisioning As described in the Basic feature, the One-EIR System offered by... by the sales feature package ? ?One-EIR Provisioning Gateway Plug-In One-EIR? ?? It enables operators to provision efficiently diverse subscriber and services data for One-EIR system and to reduce