Getting Seed Files

Gracenote provides seed data files you can use for initial setup and re-seeding for disaster recovery:

• Initial seeding of a database (Cold Start Problem)
• Fast rebuild of a database (Disaster Recovery)
• Post-release database refresh (Re-seeding)

FTP Delivery Method

The number of files expected in each batch is twice the number of endpoints you have access to, plus an additional manifest file. Access these files from the Gracenote FTP server using the credentials provided by your Customer Experience Team.

The server URL is : ftp1.tmstv.com

• Files ending in xml.gz: These are files with all the XML data, gzipped for compression
• Files ending in xml.gz.sig: These are Signature files (MD5 checksum) which will help you do checksum validation to ensure that you have the complete file available.
• Manifest file *manifest*.xml: This file outlines the files that are delivered in one batch/upload, with their names, their maxUpdateIds, and the count of records in each file
• Files ending in .tmp: These are files still in the process of being uploaded. They will be renamed after the upload is complete. If a file still has a .tmp extension, there may have been a connection issue while it was uploading. If this happens, retry the upload process..

There will be more than one set of files on the FTP server. Choose the latest file of each type for ingestion. The files are built at the requested frequency and can be delivered once a day at most.

To get started, we recommend parsing the manifest file first to automatically gather the file names that are part of the current batch. Also use the .sig files to be sure that you have the complete file before starting parsing.

Note: The .sig files contain the checksum of the gzipped file, not of the full extracted file. So, do your check before unzipping the file.

 

After getting the seed files, periodically get updates using the FTP process and/or using the On APIs to ensure you have the most recent data..

To get updates using the APIs, see Getting Updates

Referential Completeness

All programs referenced in all other files are guaranteed to be a part of the programs file, plus any programs that are supposed to be part of your entitlement.

All schedules are guaranteed to not have any schedule gaps or overlaps within or across days. If you so choose, this check can be disabled, but is enabled by default.