Database Synchronization Guideline
Total Page:16
File Type:pdf, Size:1020Kb
Database-to-Database Synchronization Interoperability Specification White Space Database Administrator Group Database-to-Database Synchronization Interoperability Specification Version 1.2.0 December 11, 2012 Copyright © 2011-2012 Airity, Inc., Comsearch, a CommScope Company, Frequency Finder, Inc., Google Inc., LS telcom AG, Microsoft Corporation, Neustar, Inc., Spectrum Bridge, Inc., Telcordia Technologies, Inc. All Rights Reserved Version 1.2.0 1 December 11, 2012 Database-to-Database Synchronization Interoperability Specification Version Date Change V1.0 8/30/11 Initial Release V1.01 9/12/11 Change XSD to specify Circle + Radius for LP-Aux and add associated elements, updated XSD and XML Example V1.1 2/29/12 1) Change LP Aux to conform to new FCC rules on location 2) Change LP_Aux to allow for unlicensed wireless microphone registrations (event changes) 3) Document the expected interoperability behavior for TV Receive Site registration records 4) Clarify use of date and date-time for event start and end times, 5) Clarify usage of ical:uid and ical:dtstamp, and ical:recurid per ical specification RFC 5545 6) Update schema and examples V1.1.1 4/17/12 Added support for unlicensed wireless mics using FCC data, clarified version specification for file names. V1.2.0 9/11/12 Added presentationTime to Event objects Added ability to handle multiple VEVENTs per registration record Removed special date-time language to maintain consistency with ical standard Renamed ensembleSignature to Signature and moved it to the end of RegistrationRecordEnsemble Added Version to poll request and response Added text for how new versions are introduced Updated Web Services-related elements in schema (nextTransactionID and XsdVersion in RealTimePollResponse, RT-PollStatusCode) Generated new XML examples based on V1.2 XSD Changed XSD to accommodate changes in GML as discussed at http://www.opengeospatial.org/blog/1597, specifically changes related to xlink. Specified maximum length of xsd:string data is 64 characters Added nextTransactionID to RealTimePollResponse Added Sec 7.5 Common Language for Information Disclosure in overstrike text, awaiting final language V1.2.0 12/11/12 Created new XSD XSD_V1-2_Checkpoint_11-21-12.xsd o ref= in Signature element o Remove WSDL-specific elements Created XSD_V1-2_WSDL-Specific_11-21-12.xsd and updated Section 4 Real Time Web Service Updated WSDL to WSDL_V1-2_Checkpoint_11-21-12.wsdl Updated all six XML examples to validate with XSD_V1- 2_Checkpoint_11-21-12.xsd Added Section 7.5 Common Language for information disclosure Version 1.2.0 2 December 11, 2012 Database-to-Database Synchronization Interoperability Specification This interface specification was developed by the White Space Database Administrator Group. NOTE - The user’s attention is called to the possibility that compliance with this interface may or may not require use of an invention covered by patent rights. By publication of this standard, no position is taken with respect to the validity of any claim or any patent rights in connection therewith. No express or implied license is granted to a user of the interface who is not a participant in the White Spaces DBA Group for any intellectual property contributed by a White Spaces DBA Group participant. Notice of Disclaimer and Limitation of Liability The information provided in this document is directed solely to professionals who have the appropriate degree of experience to understand and interpret its contents in accordance with generally accepted engineering or other professional standards and applicable regulations. No recommendation as to products or vendors is made or should be implied. NO REPRESENTATION OR WARRANTY IS MADE THAT THE INFORMATION IS TECHNICALLY ACCURATE OR SUFFICIENT OR CONFORMS TO ANY STATUTE, GOVERNMENTAL RULE OR REGULATION, AND FURTHER, NO REPRESENTATION OR WARRANTY IS MADE OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR AGAINST INFRINGEMENT OF INTELLECTUAL PROPERTY RIGHTS. THE WHITE SPACE DATABASE ADMINISTRATOR GROUP AND ITS PARTICIPANTS SHALL NOT BE LIABLE, BEYOND $100 FOR THIS DOCUMENT, WITH RESPECT TO ANY CLAIM, AND IN NO EVENT SHALL THE WHITE SPACE DATABASE ADMINISTRATOR GROUP AND ITS PARTICIPANTS BE LIABLE FOR LOST PROFITS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES. THE WHITE SPACE DATABASE ADMINISTRATOR GROUP ADVISES ANY AND ALL USE OF OR RELIANCE UPON THIS INFORMATION PROVIDED IN THIS DOCUMENT IS AT THE RISK OF THE USER. Version 1.2.0 3 December 11, 2012 Database-to-Database Synchronization Interoperability Specification Table of Contents 1 Background ............................................................................................................ 3 1.1 Possible Methods to interchange records that were considered by the White Space DBA Group ................................................................................................................ 3 1.1.1 Real Time ............................................................................................................... 3 1.1.2 File Transfer ........................................................................................................... 3 1.1.3 Database Replication .............................................................................................. 3 1.2 Conclusions .............................................................................................................. 4 1.3 Glossary .................................................................................................................... 4 2 Data Layout............................................................................................................. 4 3 File Transfer method: ............................................................................................ 5 4 Real Time Web Service .......................................................................................... 6 5 Data Format .......................................................................................................... 10 5.1 RegistrationRecordEnsemble .................................................................................11 5.2 Registration Record ................................................................................................13 5.3 Registration Information and Registration Disposition ........................................13 5.4 Registration Objects ................................................................................................15 5.4.1 MVPD_Registration ...............................................................................................15 5.4.2 TV_Receive Site_Registration ...............................................................................15 5.4.3 LP-Aux_Registration (Licensed and Unlicensed) ...................................................17 5.4.4 Fixed TVBD_Registration ......................................................................................20 5.4.5 Temp_BAS_Registration .......................................................................................20 5.5 EnsembleDescription ..............................................................................................22 5.6 RegistrationDisposition ..........................................................................................24 5.7 Location ...................................................................................................................25 5.8 US_TV_Spectrum ....................................................................................................25 5.9 Event ........................................................................................................................26 5.10 DeviceId ....................................................................................................................28 5.11 Radiation Center ......................................................................................................29 5.12 vCard ........................................................................................................................29 5.13 Signature Element ...................................................................................................30 5.14 lpauxOperationalArea .............................................................................................31 5.15 RealTimePollRequest ..............................................................................................33 5.16 RealTimePollResponse ...........................................................................................34 5.17 lpauxPointArea ........................................................................................................34 5.18 lpauxQuadrilateralArea ...........................................................................................35 6 Data Mapping Considerations ............................................................................. 36 6.1 Data Completeness .................................................................................................37 7 General Whitespace Administrator Responsibilities and Error Management 37 7.1 Set-up and process .................................................................................................37 7.1.1 Servers and clients ................................................................................................37 7.1.2 HTTPS ...................................................................................................................37 7.2 Client Test Environment .........................................................................................38