From 685952aee02c40304ab6ebdd7e782f654134034e Mon Sep 17 00:00:00 2001 From: gvasquezvargas Date: Wed, 29 Jan 2025 13:11:01 +0100 Subject: [PATCH 1/4] MTK: update compatibility content --- .../products/migration-toolkit/index.njk | 4 +-- ...perating_systems_and_database_versions.mdx | 29 ++++++++++++++++--- .../migration_toolkit/55/installing/index.mdx | 4 +-- 3 files changed, 29 insertions(+), 8 deletions(-) diff --git a/install_template/templates/products/migration-toolkit/index.njk b/install_template/templates/products/migration-toolkit/index.njk index cf25f697f17..800a654c288 100644 --- a/install_template/templates/products/migration-toolkit/index.njk +++ b/install_template/templates/products/migration-toolkit/index.njk @@ -24,8 +24,8 @@ legacyRedirects: {% endblock frontmatter %} {% block navigation %} {{- super() -}} -- install_on_mac -- install_on_windows +- macos +- windows - installing_jdbc_driver {% endblock navigation %} diff --git a/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx b/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx index 648f1cea3d4..c316cb40f84 100644 --- a/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx +++ b/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx @@ -3,9 +3,7 @@ title: "Supported platforms and databases" --- - - -## Database versions +## Supported database versions You can use the following database product versions with Migration Toolkit: @@ -42,10 +40,33 @@ Contact your EnterpriseDB Account Manager or [sales@enterprisedb.com](mailto:sal The Migration Toolkit isn't tested with and doesn't officially support use with Oracle Real Application Clusters (RAC) and Exadata. However, Migration Toolkit might work when it's connected to a single persistent node. For more information, contact your EDB representative. !!! -## Supported operating systems versions +## Supported operating system versions Migration Toolkit supports installations on Linux, Windows, and MacOS platforms. See [Product Compatibility](https://www.enterprisedb.com/platform-compatibility#mtk) for details. !!! Note The ojdbc7.jar can cause large data migrations to be incomplete due to a limit on records over Integer.MAX_VALUE (2147483647) while fetching from the ResultSet. To avoid this issue, we recommend upgrading to ojdbc8.jar. + +## Supported JDBC drivers + +To perform a migration, you must install JDBC drivers that support your source and target databases. Migration Toolkit supports the following JDBC driver versions. + +### Supported PostgreSQL and EDB JDBC drivers + +| | PostgreSQL JDBC driver | EDB JDBC driver | +|-------------|------------------------|--------------------------| +| MTK 55.10.0 | JDBC 42.7.3 and later | JDBC 42.7.3.2 and later | +| MTK 55.9.0 | JDBC 42.5.4 and later | JDBC 42.5.4.2 and later | +| MTK 55.8.0 | JDBC 42.5.4 and later | JDBC 42.5.4.2 and later | +| MTK 55.7.0 | JDBC 42.5.4 and later | JDBC 42.5.4.2 and later | +| MTK 55.6.0 | JDBC 42.5.4 and later | JDBC 42.5.4.2 and later | +| MTK 55.5.0 | JDBC 42.5.1 and later | JDBC 42.5.1.2 and later | +| MTK 55.4.0 | JDBC 42.5.1 and later | JDBC 42.5.1.2 and later | +| MTK 55.3.0 | JDBC 42.5.0 and later | JDBC 42.5.0.2 and later | +| MTK 55.2.0 | JDBC 42.5.0 and later | JDBC 42.5.0.2 and later | +| MTK 55.1.0 | JDBC 42.2.12 and later | JDBC 42.2.12.2 and later | +| MTK 55.0.0 | JDBC 42.2.12 and later | JDBC 42.2.12.2 and later | + + +### Supported Oracle, SQL Server, MySQL and SAP Adaptive Enterprise versions diff --git a/product_docs/docs/migration_toolkit/55/installing/index.mdx b/product_docs/docs/migration_toolkit/55/installing/index.mdx index 350db2b5bd6..b1aafd6ec5c 100644 --- a/product_docs/docs/migration_toolkit/55/installing/index.mdx +++ b/product_docs/docs/migration_toolkit/55/installing/index.mdx @@ -30,8 +30,8 @@ navigation: - linux_x86_64 - linux_arm64 - linux_ppc64le - - install_on_mac - - install_on_windows + - macos + - windows - installing_jdbc_driver --- From 04cc3e18441bf3b141c222c0296d1387062f98f3 Mon Sep 17 00:00:00 2001 From: gvasquezvargas Date: Thu, 30 Jan 2025 14:30:10 +0100 Subject: [PATCH 2/4] staging further edits --- ...ed_operating_systems_and_database_versions.mdx | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx b/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx index c316cb40f84..1f068320a9c 100644 --- a/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx +++ b/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx @@ -50,9 +50,13 @@ Migration Toolkit supports installations on Linux, Windows, and MacOS platforms. ## Supported JDBC drivers -To perform a migration, you must install JDBC drivers that support your source and target databases. Migration Toolkit supports the following JDBC driver versions. +To perform a migration, you must [choose and install JDBC drivers](../55/installing/installing_jdbc_driver/#choosing-a-driver) that support your source and target databases. -### Supported PostgreSQL and EDB JDBC drivers +These can be Postgres JDBC drivers, or third-party JDBC drivers. + +### Supported Postgres JDBC drivers + +For Postgres JDBC drivers, Migration Toolkit supports the following PostgreSQL and EDB Advanced Server drivers: | | PostgreSQL JDBC driver | EDB JDBC driver | |-------------|------------------------|--------------------------| @@ -68,5 +72,10 @@ To perform a migration, you must install JDBC drivers that support your source a | MTK 55.1.0 | JDBC 42.2.12 and later | JDBC 42.2.12.2 and later | | MTK 55.0.0 | JDBC 42.2.12 and later | JDBC 42.2.12.2 and later | - ### Supported Oracle, SQL Server, MySQL and SAP Adaptive Enterprise versions + +If your source or target database is a third-party, non-postgres database, you will require a third-party JDBC driver. + +To ensure compatibility of your Migration Toolkit version with the third-party JDBC driver version, use the latest available JDBC driver version that is compatible with the database you want to migrate from or to. + +Check JDBC driver and database compatibility with the third-party provider. \ No newline at end of file From 6d6a2c1480fc0e01503a2b3579514e23131dce59 Mon Sep 17 00:00:00 2001 From: gvasquezvargas Date: Fri, 31 Jan 2025 12:16:56 +0100 Subject: [PATCH 3/4] Added MTK-JDBC compat information + JDBC selection help --- ...perating_systems_and_database_versions.mdx | 11 ++++-- .../55/installing/installing_jdbc_driver.mdx | 34 +++++++++++-------- 2 files changed, 28 insertions(+), 17 deletions(-) diff --git a/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx b/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx index 1f068320a9c..266705433d7 100644 --- a/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx +++ b/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx @@ -51,8 +51,9 @@ Migration Toolkit supports installations on Linux, Windows, and MacOS platforms. ## Supported JDBC drivers To perform a migration, you must [choose and install JDBC drivers](../55/installing/installing_jdbc_driver/#choosing-a-driver) that support your source and target databases. +These can be [Postgres JDBC drivers](#supported-postgres-jdbc-drivers), or [non-postgres JDBC drivers](#supported-non-postgres-database-versions). -These can be Postgres JDBC drivers, or third-party JDBC drivers. +These sections provide information on JDBC driver and Migration Toolkit compatibility. ### Supported Postgres JDBC drivers @@ -72,10 +73,14 @@ For Postgres JDBC drivers, Migration Toolkit supports the following PostgreSQL a | MTK 55.1.0 | JDBC 42.2.12 and later | JDBC 42.2.12.2 and later | | MTK 55.0.0 | JDBC 42.2.12 and later | JDBC 42.2.12.2 and later | -### Supported Oracle, SQL Server, MySQL and SAP Adaptive Enterprise versions +See [Choosing a driver](./02_supported_operating_systems_and_database_versions/#choosing-a-driver) for download information. + +### Supported non-postgres database versions If your source or target database is a third-party, non-postgres database, you will require a third-party JDBC driver. To ensure compatibility of your Migration Toolkit version with the third-party JDBC driver version, use the latest available JDBC driver version that is compatible with the database you want to migrate from or to. -Check JDBC driver and database compatibility with the third-party provider. \ No newline at end of file +Check JDBC driver and database compatibility with the third-party provider, for example, in the corresponding Oracle, Microsoft SQL Server, MySQL, or SAP Adaptive Enterprise documentation. + +See [Choosing a driver](./02_supported_operating_systems_and_database_versions/#choosing-a-driver) for download information. \ No newline at end of file diff --git a/product_docs/docs/migration_toolkit/55/installing/installing_jdbc_driver.mdx b/product_docs/docs/migration_toolkit/55/installing/installing_jdbc_driver.mdx index 8e69dbf6597..635063846cd 100644 --- a/product_docs/docs/migration_toolkit/55/installing/installing_jdbc_driver.mdx +++ b/product_docs/docs/migration_toolkit/55/installing/installing_jdbc_driver.mdx @@ -8,23 +8,29 @@ Migration Toolkit requires Java version 1.8.0 or later. ## Choosing a driver -Which JDBC drivers you use depends on the databases you are migrating from and to. For example, if you are migrating from Oracle to EDB Postgres Advanced Server, you will need the Oracle JDBC driver and the EDB JDBC driver. - -- If you're migrating to or from EDB Postgres Advanced Server, use the EDB JDBC driver. To download the latest driver, see [EDB Connectors](https://enterprisedb.com/software-downloads-postgres#edb-connectors) on the EDB Downloads page. For installation instructions, see [Installing and configuring EDB JDBC Connector](/jdbc_connector/latest/installing/). +Which JDBC drivers you use depends on the source and target databases for the migration. For example, if you are migrating from Oracle to EDB Postgres Advanced Server, you will need the Oracle Database JDBC driver and the EDB JDBC driver. + +To obtain the correct JDBC driver for your database: + +| Source or target database | JDBC driver | +|--------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------| +| PostgreSQL | [PostgreSQL JDBC driver](https://jdbc.postgresql.org/download/) | +| EDB Postgres Advanced Server | [EDB JDBC connector](/jdbc_connector/latest/installing/) (See notes) | +| Oracle Database | [Oracle Database JDBC driver](https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html) | +| Microsoft SQL Server | [Microsoft JDBC driver for SQL Server](https://learn.microsoft.com/en-us/sql/connect/jdbc/release-notes-for-the-jdbc-driver?view=sql-server-ver16#102) | +| MySQL | [Connector/J JDBC driver](https://dev.mysql.com/downloads/connector/j/) | +| SAP Adaptive Server Enterprise (ASE) | [Sybase ASE (jTDS) JDBC driver](https://sourceforge.net/projects/jtds/files/) (See notes) | + +!!!note Notes + - The EDB JDBC connector is not available for Mac OS. + - The open-source jTDS driver also supports older versions of Microsoft SQL Server (version 2012 and earlier) and may be used with Migration Toolkit. The Microsoft-provided JDBC driver for SQL Server is recommended for the newer versions of SQL Server supported by Migration Toolkit. +!!! - !!! Note - The EDB JDBC driver is not available for Mac OS. +### Driver version compatibility -- If you're migrating to or from PostgreSQL, use the PostgreSQL JDBC driver. To download the latest supported driver, see the [JDBC drivers section](https://jdbc.postgresql.org/download/) on the PostgreSQL Downloads page. +After you select the correct drivers for your migration, ensure the selected driver versions support the Migration Toolkit you are using. EDB recommends using the latest available Migration Toolkit version, as it provides compatibility with more database versions and JDBC driver versions. -- If you're migrating from Oracle, MySQL, Microsoft SQL Server, or Sybase, use the freely available source-specific JDBC driver. - - [Oracle JDBC](https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html) - - [MySQL JDBC](https://dev.mysql.com/downloads/connector/j/) - - [Microsoft SQL Server JDBC](https://learn.microsoft.com/en-us/sql/connect/jdbc/release-notes-for-the-jdbc-driver?view=sql-server-ver16#102) - - [Sybase ASE (jTDS) JDBC](https://sourceforge.net/projects/jtds/files/) - - !!! Note - The open-source jTDS driver also supports older versions of Microsoft SQL Server (version 2012 and earlier) and may be used with Migration Toolkit. The Microsoft-provided JDBC driver for SQL Server is recommended for the newer versions of SQL Server supported by Migration Toolkit. +See [Supported JDBC drivers](../02_supported_operating_systems_and_database_versions/#supported-jdbc-drivers) for more information. ## Adding the driver to `lib` After downloading the driver, move the driver file into the `/lib` directory. From d463dbe36196cef2063e5ffbeb9f182b07319237 Mon Sep 17 00:00:00 2001 From: gvasquezvargas Date: Fri, 31 Jan 2025 13:54:05 +0100 Subject: [PATCH 4/4] Readability and searchability edits --- ..._supported_operating_systems_and_database_versions.mdx | 8 ++++---- .../55/installing/installing_jdbc_driver.mdx | 6 +++--- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx b/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx index 266705433d7..50153920d96 100644 --- a/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx +++ b/product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx @@ -46,14 +46,14 @@ Migration Toolkit supports installations on Linux, Windows, and MacOS platforms. !!! Note - The ojdbc7.jar can cause large data migrations to be incomplete due to a limit on records over Integer.MAX_VALUE (2147483647) while fetching from the ResultSet. To avoid this issue, we recommend upgrading to ojdbc8.jar. + The ojdbc7.jar can cause large data migrations to be incomplete due to a limit on records over `Integer.MAX_VALUE (2147483647)` while fetching from the `ResultSet`. To avoid this issue, we recommend upgrading to ojdbc8.jar. ## Supported JDBC drivers To perform a migration, you must [choose and install JDBC drivers](../55/installing/installing_jdbc_driver/#choosing-a-driver) that support your source and target databases. These can be [Postgres JDBC drivers](#supported-postgres-jdbc-drivers), or [non-postgres JDBC drivers](#supported-non-postgres-database-versions). -These sections provide information on JDBC driver and Migration Toolkit compatibility. +These sections provide information on JDBC driver version and Migration Toolkit compatibility. ### Supported Postgres JDBC drivers @@ -73,7 +73,7 @@ For Postgres JDBC drivers, Migration Toolkit supports the following PostgreSQL a | MTK 55.1.0 | JDBC 42.2.12 and later | JDBC 42.2.12.2 and later | | MTK 55.0.0 | JDBC 42.2.12 and later | JDBC 42.2.12.2 and later | -See [Choosing a driver](./02_supported_operating_systems_and_database_versions/#choosing-a-driver) for download information. +See [Choosing a driver](./installing/installing_jdbc_driver/#choosing-a-driver) for download information. ### Supported non-postgres database versions @@ -83,4 +83,4 @@ To ensure compatibility of your Migration Toolkit version with the third-party J Check JDBC driver and database compatibility with the third-party provider, for example, in the corresponding Oracle, Microsoft SQL Server, MySQL, or SAP Adaptive Enterprise documentation. -See [Choosing a driver](./02_supported_operating_systems_and_database_versions/#choosing-a-driver) for download information. \ No newline at end of file +See [Choosing a driver](./installing/installing_jdbc_driver/#choosing-a-driver) for download information. diff --git a/product_docs/docs/migration_toolkit/55/installing/installing_jdbc_driver.mdx b/product_docs/docs/migration_toolkit/55/installing/installing_jdbc_driver.mdx index 635063846cd..65b843fceb8 100644 --- a/product_docs/docs/migration_toolkit/55/installing/installing_jdbc_driver.mdx +++ b/product_docs/docs/migration_toolkit/55/installing/installing_jdbc_driver.mdx @@ -8,9 +8,9 @@ Migration Toolkit requires Java version 1.8.0 or later. ## Choosing a driver -Which JDBC drivers you use depends on the source and target databases for the migration. For example, if you are migrating from Oracle to EDB Postgres Advanced Server, you will need the Oracle Database JDBC driver and the EDB JDBC driver. +Which JDBC drivers you use depends on the source and target databases for the migration. For example, to migrate from a Oracle Database instance to EDB Postgres Advanced Server, you require the Oracle Database JDBC driver and the EDB JDBC driver. -To obtain the correct JDBC driver for your database: +These are reference sources where JDBC drivers are freely available for download. However, there are other sources where you can obtain the same drivers. | Source or target database | JDBC driver | |--------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -28,7 +28,7 @@ To obtain the correct JDBC driver for your database: ### Driver version compatibility -After you select the correct drivers for your migration, ensure the selected driver versions support the Migration Toolkit you are using. EDB recommends using the latest available Migration Toolkit version, as it provides compatibility with more database versions and JDBC driver versions. +After selecting the appropriate drivers for your migration, verify that their versions are compatible with the Migration Toolkit you are using. EDB recommends using the latest available version of the Migration Toolkit to ensure broader compatibility with various database versions and JDBC drivers. See [Supported JDBC drivers](../02_supported_operating_systems_and_database_versions/#supported-jdbc-drivers) for more information.