--------------------------------------------------------------------
Conversion Guide for Main (engine, Linux C++ server & client driver)
--------------------------------------------------------------------

Currently, the C++ ABI has not yet stable. Therefore, you will always need to recompile your
applications against the new libraries.

Also, please convert any use of deprecated API with the replacement.


Converting to the Current SVN trunk:
------------------------------------
* No conversion would be needed.


Version 0.9.2:
--------------
* The VDDBMS's super (system) user name and password have been changed. Hence, you will need to update the
  DBMS user access permission for the master node (the grant table of the resource catalog database).
* Some of the columns of the resource catalog tables have their data types changed. This should not cause
  any problem for older applications. However, it is reccommended to update the tables by executing these
  commands as the 'gcl_ddbms_user_s' in your resource catalog server:
      $ mysql -u gcl_ddbms_user -p gcl_ddbms_system
      mysql> ALTER TABLE resource_list         MODIFY COLUMN DBName   CHAR(255) NOT NULL;
      mysql> ALTER TABLE user_database_list    MODIFY COLUMN Name     CHAR(255) NOT NULL;
      mysql> ALTER TABLE user_table_list       MODIFY COLUMN Name     CHAR(255) NOT NULL;
      mysql> ALTER TABLE stored_procedure_list MODIFY COLUMN Name     CHAR(255) NOT NULL;
      mysql> ALTER TABLE stored_procedure_list MODIFY COLUMN BindToDB CHAR(255)     NULL;
  or delete the resource catalog table 'gcl_ddbms_system' so that the engine will recreate it.


Converting to Version 0.8.9:
----------------------------
* No conversion would be needed.


Converting to Version 0.7.9:
----------------------------
* If you got strange exceptions similar with:
      ----------------------------------------------------------------------------------------------------
      EXCEPTION: _terminateHandler_() called after throwing an instance of std::out_of_range
      ----------------------------------------------------------------------------------------------------
      caught exception of type 'std::exception'
          what(): vector::_M_range_check
      ----------------------------------------------------------------------------------------------------
  try to execute these commands as the 'gcl_ddbms_user' in your resource catalog server:
      $ mysql -u gcl_ddbms_user -p gcl_ddbms_system
      mysql> ALTER TABLE resource_list ADD COLUMN ODBCOpts TEXT NULL AFTER Password;
  or delete the resource catalog table 'gcl_ddbms_system' so that the engine will recreate it.


Converting to Version 0.6.5:
----------------------------
* If you got strange exceptions similar with:
      ----------------------------------------------------------------------------------------------------
      EXCEPTION: _terminateHandler_() called after throwing an instance of std::out_of_range
      ----------------------------------------------------------------------------------------------------
      caught exception of type 'std::exception'
          what(): vector::_M_range_check
      ----------------------------------------------------------------------------------------------------
  try to execute these commands as the 'gcl_ddbms_user' in your resource catalog server:
      $ mysql -u gcl_ddbms_user -p gcl_ddbms_system
      mysql> ALTER TABLE resource_usage_list DROP COLUMN TotalRecord_H, DROP COLUMN TotalRecord_L;
      mysql> ALTER TABLE resource_list ADD COLUMN DBName CHAR(128) NOT NULL AFTER PORT;
      mysql> UPDATE resource_list SET DBName = 'gcl_ddbms_data';
  or delete the resource catalog table 'gcl_ddbms_system' so that the engine will recreate it.