Subscriber Database Server XML/SOAP Provisioning Interface 910-6371-001 Revision B August 2012 Copyright 2012 Tekelec. All Rights Reserved. Printed in USA. Legal Information can be accessed from the Main Menu of the optical disc or on the Tekelec Customer Support web site in the Legal Information folder of the Product Support tab. Table of Contents Chapter 1: Introduction.....................................................................10 Overview..................................................................................................................................11 Scope and Audience...............................................................................................................11 Manual Organization..............................................................................................................11 Documentation Admonishments..........................................................................................11 Customer Care Center............................................................................................................12 Emergency Response..............................................................................................................14 Related Publications...............................................................................................................15 Documentation Availability, Packaging, and Updates.....................................................15 Locate Product Documentation on the Customer Support Site.......................................15 Chapter 2: System Architecture.......................................................17 SDM Overview........................................................................................................................18 Architecture Overview...........................................................................................................18 XML Data Server (XDS).........................................................................................................19 SOAP Server.............................................................................................................................19 Provisioning Clients................................................................................................................19 System Provisioning...............................................................................................................20 Destinations.................................................................................................................20 NAI Hosts.....................................................................................................................20 Chapter 3: Interface Description......................................................21 XML Based...............................................................................................................................22 TCP/IP Based..........................................................................................................................23 XML Provisioning Client...........................................................................................23 SOAP Provisioning Client.........................................................................................23 Security.....................................................................................................................................24 Client Server IP Address White List.........................................................................24 Secure Connection Using SSLv3...............................................................................24 Multiple Session Connectivity..............................................................................................26 Request Queue Management................................................................................................27 Syncronous/Asyncronous Mode..........................................................................................27 Transaction Oriented..............................................................................................................28 Transaction Modes......................................................................................................28 910-6371-001 Revision B, August 2012 ii ACID-Compliant Transactions..................................................................................30 Provisioning Data Import (XML)..........................................................................................31 Provisioning Data Export (XML)..........................................................................................34 XML Export File..........................................................................................................35 Provisioning Data Import (CSV)...........................................................................................40 CSV Import Files.........................................................................................................43 Provisioning Data Export (CSV)...........................................................................................49 CSV Export Files..........................................................................................................50 MSISDN Format......................................................................................................................52 Connection Management.......................................................................................................52 Disable Interface..........................................................................................................52 Connections Allowed.................................................................................................52 Disable Provisioning...................................................................................................53 Measurements..........................................................................................................................53 Key Performance Indicators (KPIs)......................................................................................55 Alarms.......................................................................................................................................56 Events........................................................................................................................................60 Chapter 4: XML Message Definitions............................................62 Message Conventions.............................................................................................................63 XML Request/Response Length Indication........................................................................63 Transaction Id (ID)..................................................................................................................64 Response Messages.................................................................................................................64 Common Error Codes.............................................................................................................66 List of Request Messages.......................................................................................................67 Start Transaction......................................................................................................................67 Request..........................................................................................................................67 Response.......................................................................................................................68 Commit Transaction...............................................................................................................69 Request..........................................................................................................................69 Response.......................................................................................................................69 Rollback Transaction..............................................................................................................70 Request..........................................................................................................................70 Response.......................................................................................................................70 Update Subscriber...................................................................................................................70 Request..........................................................................................................................71 Response.......................................................................................................................73 Delete Subscriber.....................................................................................................................74 Request..........................................................................................................................74 Response.......................................................................................................................75 910-6371-001 Revision B, August 2012 iii Read Subscriber.......................................................................................................................76 Request..........................................................................................................................76