MTK 55.11.2: new errors

product_docs/docs/migration_toolkit/55/09_mtk_errors.mdx

@@ -117,6 +117,108 @@ 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 
+
+*When I try to perform a migration from an Oracle database with Migration Toolkit, I get the following error:*
+
+```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
+```
+
+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 MIgration Toolkit script.
+
+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 Migration Toolkit script adding the option `-Duser.timezone=<GMT>`.
+
+    **Linux**
+
+    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 "$@"
+    ```
+
+    **Windows** 
+
+    For example, if this was the original line in `runMTK.bat`:
+
+    ```
+    %WINDIR%\System32\cscript //nologo "%base%\etc\sysconfig\runJavaApplication.vbs" "%base%\etc\sysconfig\edbmtk-55.config" "%JAVA_HEAP_SIZE% -Dprop=%base%\etc\toolkit.properties -cp %base%\bin\edb-migrationtoolkit.jar;%base%/lib/* com.edb.MigrationToolkit %command%"
+    ```
+
+    Add the `-Duser.timezone=GMT+08:00` option while ensuring it is placed before the `-Dprop` option.
+
+    ```
+    %WINDIR%\System32\cscript //nologo "%base%\etc\sysconfig\runJavaApplication.vbs" "%base%\etc\sysconfig\edbmtk-55.config" "%JAVA_HEAP_SIZE% -Duser.timezone=GMT+08:00 -Dprop=%base%\etc\toolkit.properties -cp %base%\bin\edb-migrationtoolkit.jar;%base%/lib/* com.edb.MigrationToolkit %command%"
+    ```
+
+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` from `/usr/lib/oracle/xe/app/oracle/product/10.2.0/server/jlib/` to Migration Toolkit's library to enable it to be recognized by Migration Toolkit: 
+
+    **Linux** 
+
+    ```
+    /usr/edb/migrationtoolkit/lib
+    ```
+
+    **Windows**
+
+    ```
+    C:\Program Files\edb\mtk\lib
+    ```
+
+    Alternatively, download the required file from [Oracle's JAR downloads](https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html).
+
+### Error with unsupported character set 
+
+*When I try to perform a migration from an Oracle database with Migration Toolkit, I get the following error:*
+
+```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 ensure the Migration Toolkit can access the internationalization file.
+
+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` from `/usr/lib/oracle/xe/app/oracle/product/10.2.0/server/jlib/` to Migration Toolkit's library to enable it to be recognized by Migration Toolkit: 
+
+    **Linux** 
+
+    ```
+    /usr/edb/migrationtoolkit/lib
+    ```
+
+    **Windows**
+
+    ```
+    C:\Program Files\edb\mtk\lib
+    ```
+
+    Alternatively, download the required file from [Oracle's JAR downloads](https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html).
+
+
 <div id="migration_errors" class="registered_link"></div>
 
 ## Migration errors