======================================================= RELEASE NOTES FOR INFORMIX VIDEO FOUNDATION DATABLADE MODULE, VERSION 2.0 DATE: 2/15/00 ======================================================= TABLE OF CONTENTS I. OVERVIEW OF RELEASE NOTES II. CHANGES FROM PREVIOUS VERSION III. EXAMPLES IV. SERVER COMPATIBILITY V. CONFIGURATION VI. REGISTRATION VII. UPGRADING FROM PREVIOUS VERSIONS VIII. WRAPMEDTC CONVERSION FUNCTION IX. CHANGES IN UNIQUE IDS X. INSTALLING THE CLIENT API XI. KNOWN PROBLEMS XII. FIXED PROBLEMS +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ I. OVERVIEW OF RELEASE NOTES ============================= The purpose of these release notes is to make you aware of any special actions required to install, configure, upgrade, and use the Informix Video Foundation DataBlade module on your computer. In addition, this file contains information about known bugs and their workarounds. This release notes document is not intended to be all-inclusive; it should be used as an addendum to the "Informix Video Foundation DataBlade Module User's Guide," which provides thorough information about product features and behavior. These release notes are written for the following audience: o System administrators who install and configure the Informix Video Foundation DataBlade module for use with Informix Dynamic Server with Universal Data Option o Database administrators who control access to databases that depend on the Informix Video Foundation DataBlade module o Developers who write applications or DataBlade modules for the Video Foundation DataBlade module II. CHANGES FROM PREVIOUS VERSION ================================== Changes in the Video Foundation DataBlade module from Version 1.20.UC2 to Version 2.00.UC1 include: o added support for generating edit decision lists (EDLs). o added VSI_REMOTE driver for accessing remove video files using FTP. o added VSI_BLOB driver for storing video data in Dynamic Server sbspaces. o added support for video playlist generation. o added support for manipulating groups of MedChunk values. o added support for negative MedPtr values. o added support for discontinuous timecodes. o added support for hierarchical strata. III. EXAMPLES ============== All examples have been tested for this release. All examples printed in the "Informix Video Foundation DataBlade Module User's Guide" are included in this product distribution, in the following directory: $INFORMIXDIR/extend/Video.2.00.UC1/Docexamples. IV. SERVER COMPATIBILITY ========================= The Version 2.00 release of the Video Foundation DataBlade module is compatible with Informix Dynamic Server with Universal Data Option Version 9.14.UC3 or later. To check the version of Dynamic Server you are currently running, enter the following command: % $INFORMIXDIR/bin/onstat -V V. CONFIGURATION ================= This DataBlade module requires: o the libresolv.so.2 shared object (shipped with Sun Solaris 2.5.1). o the LOB Locator DataBlade module (Version LLD.1.20.UC1 or later, shipped with Informix Dynamic Server with Universal Data Option. o the Informix R-Tree DataBlade module (Version ifxrltree.1.00 or later), shipped with Informix Dynamic Server with Universal Data Option. VI. REGISTRATION ================= To use the Video Foundation DataBlade module, you must register it in each database in which it will be used. See the "DataBlade Module Installation and Registration Guide" for instructions on how to register DataBlade modules. If you have not previously registered the LOB Locator or Informix R-Tree DataBlade module into your database, BladeManager prompts you to decide whether you want to register it first. If you answer "no," the registration of the Video Foundation DataBlade module is canceled. VII. UPGRADING FROM PREVIOUS VERSIONS ====================================== Because of a change in type attributes and problems with unregistration of previous releases of the Video Foundation DataBlade module, you cannot upgrade directly to video.2.00 beta. Instead, to upgrade from prior versions (except beta release video.1.20.UC1B2, 1.20.UC1, or 1.20.UC2) to video.2.00, you must first start over with a clean database. Follow these steps: 1. Export all data in the database (using dbexport). 2. Drop the database. 3. Re-create the database. 4. Register the Video Foundation DataBlade module (2.00.UC1). 5. Register any other needed DataBlade modules. 6. Import the data previously exported (using dbimport). For more information concerning upgrades, read the section "Upgrading to a Newer Version" in the BladeManager on-line help. VIII. WRAPMEDTC CONVERSION FUNCTION ==================================== The WrapMedTC function converts MedTC values greater than 24 hours to the new 24-hour limit format. The WrapMedTC function will convert any MedTC value greater than or equal to zero; it will not convert negative MedTc values. This function is not automatically registered during installation of the Video Foundation DataBlade module. To register the WrapMedTC function, run the following SQL registration statement: create function WrapMedTC(lvarchar) returns medtc external name "$INFORMIXDIR/extend/video.2.00.UC1/video.bld(convertTo24hrMedTC)" language c; To run this statement, the DataBlade module must be installed in the $INFORMIXDIR/extend/video.2.00.UC1 directory. After you have registered the WrapMedTC function, run the function as follows: execute function wrapmedtc('48:00:10:10-n'); This example returns the following result: 00:00:10:10-n. IX. CHANGES IN UNIQUE IDS ============================== The Video Foundation DataBlade module Version 2.0 uses a different method to generate unique IDs for stored video files than older versions. Client applications written for older versions of the Video Foundation DataBlade module that rely on these unique IDs might not work with Version 2.0. Video files stored using the following VSI drivers are affected: o VSI_FILE o VSI_REMOTE o VSI_NETSHOW o VSI_REALVIDEO o VSI_EMC X. INSTALLING THE CLIENT API ================================ The Video Foundation DataBlade module's Client API is available as a separate set of libraries for Windows NT/95 client computers. This API has been verified with the latest Client SDK, which includes the following interfaces: o CLI, Version 2.7 o C++ Interface, Version 2.4 o DataBlade Developers Kit, Version 3.7 o Java API, Version 1.04 o ESQL/C, Version 9.12 To install the Client API, transfer the vid_win32.exe file from $INFORMIXDIR/extend/video.2.00.UC1/lib/client to the client computer and run it. The vid_win32.exe executable is a self-extracting archive that installs the link libraries, header files, and DLLs on your computer. XI. KNOWN PROBLEMS =================== This section describes the known problems with this release of the Informix Video Foundation DataBlade module. Bug 106332 The ClientAccess() function does not return the correct URL when passed in webview. Bug 109164 Traceset_video does not work with the 9.2 server (Centaur). Bug 118085 When using the Object Interface for C++, the statement 'COPY(VALUE,STORAGE(VSI_CLIENT:/TMP/FILENAME')) FROM TABLE' does not execute properly. Bug 119648 EdlGenerate() cannot use its list syntax with the 9.14 server. You must either break up lists into multiple EDLGenerate() statements or upgrade to a server that supports lists (for example, 9.20 or later). Bug 124289 You cannot unregister the Video Foundation DataBlade module from within Informix Dynamic Server. To unregister the DataBlade module, you must drop the database. XII. FIXED PROBLEMS ================== This section describes problems fixed with this release of the Informix Video Foundation DataBlade module. Bug 101370/102130 When deleting files from an EMC server, the EMC_destroy() function now only raises a MI_MESSAGE if the deletion fails. Bug 106048 Converting a character string to a MedTC value no longer raises a GLS error. Bug 112325 Calls to medloclose type msi_client now are successful. Bug 112886 Tables with type Medloc can now be dropped. Bug 113658 DBexport/DBimport now maintain video data in multiple smartblob spaces after storage.