diff --git a/product_docs/docs/migration_toolkit/55/09_mtk_errors.mdx b/product_docs/docs/migration_toolkit/55/09_mtk_errors.mdx index b34d4949987..ec130ae14c2 100644 --- a/product_docs/docs/migration_toolkit/55/09_mtk_errors.mdx +++ b/product_docs/docs/migration_toolkit/55/09_mtk_errors.mdx @@ -117,6 +117,49 @@ The JDBC URL for the target database (EDB Postgres Advanced Server) specified in To resolve this error, edit the `toolkit.properties` file, specifying valid connection information for the target database in the `TARGET_DB_URL` property. For information about forming a JDBC URL for EDB Postgres Advanced Server, see [Defining an EDB Postgres Advanced Server URL](06_building_toolkit.properties_file/#url-and-parameters-for-an-advanced-server). +### Error with time zone region or unsupported character set + +*When I try to perform a migration from an Oracle database with Migration Toolkit, I get one or both of the following errors:* + +```text +MTK-11009: Error Connecting Database "Oracle" +DB-604: java.sql.SQLException: ORA-00604: error occurred at recursive SQL level 1 +ORA-01882: timezone region not found +``` + +```text +MTK-11009: Error Connecting Database "Oracle" +DB-17056: java.sql.SQLException: Non supported character set (add orai18n.jar in your classpath): ZHS16GBK +``` + +To resolve this issue you must align the time zone Migration Toolkit is using for the migration with the time zone of the Oracle database. You can do this by specifying the time zone of the Oracle database in the `runMTK.sh` file. + +1. Find out which time zone your Oracle database is using. + + For example, you can run `SELECT sessiontimezone FROM dual;` to get the time zone value (for example +08:00), or run `SELECT * FROM v$timezone_file;` to understand which time zone file is being used by your Oracle instance. + +1. Update the `runMTK.sh` file adding the option `-Duser.timezone=GMT`. + + For example, if this was the original line in `runMTK.sh`: + + ``` + runJREApplication $JAVA_HEAP_SIZE -Dprop=$base/etc/toolkit.properties -cp $base/bin/edb-migrationtoolkit.jar:$base/lib/* com.edb.MigrationToolkit "$@" + ``` + + Add the `-Duser.timezone=GMT+08:00` option while ensuring it is placed before the `-Dprop` option. + + ``` + runJREApplication $JAVA_HEAP_SIZE -Duser.timezone=GMT+08:00 -Dprop=$base/etc/toolkit.properties -cp $base/bin/edb-migrationtoolkit.jar:$base/lib/* com.edb.MigrationToolkit "$@" + ``` + +1. Set the classpath environment variable to the JAR internationalization file to ensure Migration Toolkit has access to it: + + ``` + export CLASSPATH=$CLASSPATH:$ORACLE_HOME/jlib/orai18n.jar + ``` + +1. Copy `orai18n.jar` and `ojdbc14.jar` from `/usr/lib/oracle/xe/app/oracle/product/10.2.0/server/jlib/` and `/usr/lib/oracle/xe/app/oracle/product/10.2.0/server/jdbc/lib/` to `/usr/edb/migrationtoolkit/lib` respectively to enable the updated libraries to be recognized by Migration Toolkit. + ## Migration errors