Batch Provisioning: Troubleshooting
Batch provisioning is available only for Premium customers at this time. If you are interested in upgrading your Brightcove account to a Premium account please contact Brightcove for more information.
This page can help you troubleshoot Brightcove's batch provisioning feature and understand any error messages you may receive. For more information about batch provisioning, see:
- Using Batch Provisioning
- Reference for the XML Manifest
I uploaded my files, but I don't know if the upload worked
If there were errors in your upload, you will get an email at the addresses you specified in the notify element of your XML manifest. If you didn't get an email, either you didn't specify your email address, or your upload succeeded and you didn't specify report-success="TRUE" in your XML manifest. You should be able to view your uploaded assets, titles, and lineups in the Brightcove Console.
As an alternative, you can set up a URL to which Brightcove can post a callback status notification, using the <callback> tag in your XML manifest.
The schedules I set in my XML manifest don't match the schedules I see in the Brightcove Console.
Schedule times in the XML manifest are Pacific time zone; schedule times in the Brightcove Console are Eastern time zone.
Error Messages
Here are some error messages you might see.
General Errors
Failed while parsing upload manifest '/mnt/upload/dir/myManifest.xml': Invalid byte 2 of 2-byte UTF-8 sequence.
This error occurs when a special character was used at any point in the XML manifest. This can include file names, refids, descriptions, or any other metadata. Be sure you validate your XML manifest before you upload it. See Preparing your assets.
Lineup Errors
The 'title-refid' tag '603598' for lineup 'Top Videos' could not be found in your library. This lineup will be processed without the title.
This error occurs if your XML manifest specifies a title's refid that the system is not able to find and therefore can not use to create a lineup. Check that the refid attribute in your manifest matches the refid of the title.
The lineup 'Friday, January 11, 2008' has no valid videos assigned to it. This lineup will not be processed.
When you create or edit a manual lineup, the lineup must contain titles. These titles are specified by adding sub-tags to the "manual-lineup" tag. See Creating or Updating Lineups.
Title Errors
The 'flash-full-refid' attribute '607713-F' for title 'Where's my snowshoe?' does not appear to be in your library. This title will not be processed.
This error occurs if your XML manifest specifies a refid for a full length FLV that the system is not able to find and therefore can not use to create a title. Check that the refid attribute in your manifest matches the refid of the asset.
The 'video-still-refid' attribute 'preview_10398382' for title 'The Real Story: January 21, 2008' does not appear to be in your library. This title will be created with no video still, but can be updated later to use an appropriate asset.
This error occurs if your XML manifest specifies a video still's refid that the system is not able to find and therefore can not use to create a title. Check that the refid attribute in your manifest matches the refid of the asset.
Encountered a 'delete-title' tag with unknown refid = '91425'.
This error occurs if your XML manifest specifies that an element should be deleted, but the system cannot find an element with that refid that the system is not able to find. Check that the refid attribute in your manifest matches the refid of the element you want to delete.
Encountered a 'delete-title' tag with refid = '91458' that failed to execute due to references from other entities.
This error occurs if your XML manifest specifies that an element should be deleted, but that element is currently being referenced by another element. Assets can be used in titles, titles can be used in lineups. These associations must be removed before the system will allow you to delete the element you've specified.
The title 'Funny Cats' is missing a 'short-description' tag. This title will not be processed.
This error occurs because the short-description tag, a sub-tag of the "title" tag, was not included the the short-description field is required by the system. For more information about creating titles with the "title" tag reference the Batch Uploading doc in the "Creating a Title" section.
The 'short-description' attribute 'If you've been losing sleep over losing sleep you're not alone. Millions of prescriptions are filled every year for sleep medications. But the US Food and Drug Administration is now warning people about some rare, but bizarre and potentially dangerous side effects.' exceeds the maximum value of 250 characters. This title will not be processed.
This error occurs when the short-description specified in the manifest exceeds the maximum value of 250 characters. This is the same limitation present in the Brightcove Console.
The 'name' attribute 'Essentially the same thing over and over again, featuring Some Folks You've Never Heard Of' exceeds the maximum value of 60 characters. This title will not be processed.
This error occurs when the title's name specified in the manifest exceeds the maximum value of 60 characters. This is the same limitation present in the Brightcove Console.
The 'type' attribute 'THUMBNAIL' for file asset 'Lion.jpg' does not match the type of the original asset 'VIDEO_STILL'. This asset will not be processed.
This error occurs if you upload an asset with one type, and then try to assign the asset to a title using a different asset type. For example, if you uploaded the asset with type video still and assign it to a title with type="THUMBNAIL". Either edit the asset's type in the Brightcove Console, or assign the asset to the proper type for the title.
A system error was encountered looking up title refid 'US41088'. This title will attempt to process as a new title.
A system error was encountered saving title 'Michael Jackson "Billie Jean"'. Please contact Brightcove support, or try updating the item in question directly in the Brightcove Console.
This error, and all errors that start with "system error" generally require additional investigation. Contact Brightcove Support for assistance.
Asset Errors
Encountered an 'asset' tag with an empty 'filename' attribute. This asset will not be processed.
Encountered an 'asset' tag for file '106_tail.jpg' with an empty 'type' attribute. This asset will not be processed.
These errors occur when your XML manifest doesn't specify the value of a required attribute in the asset tag. The filename and type attributes are required for the asset tag in the XML manifest.
The uploaded file 'david_beckham150.jpg' size of '9324' does not match the reported size of '9824' bytes. This asset will not be processed.
This error occurs when the system checks to see if the file size of the uploaded file matches the size of the asset as specified in the manifest. When this happens, either the file size specified in the XML manifest was set incorrectly or the file did not complete uploading.
The file 'hillcrest_480x360_464k.flv' was not found on the Brightcove system. All files must be uploaded prior to uploading the batch provisioning manifest. This asset will not be processed.
This occurs when the system processes the manifest and does not find a file that was referenced in the manifest. This can be caused by mistyping file names in the manifest, not uploading the correct files, or uploading the files after the manifest has begun processing. Generally, the problem is that the XML manifest was uploaded to the system before the assets completed uploading. All assets must be uploaded and complete before the manifest is uploaded to prevent this problem.
Skipping update of asset with 'refid' = '60422-S' since the filename, size, and hash have not changed.
This information message does not indicate that any error has occurred. You will receive this message when your XML manifest contains an asset tag, but all of the information it contains already exists in the system.
