MTK: update compatibility content

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 %}
 

product_docs/docs/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx

@@ -3,9 +3,7 @@ title: "Supported platforms and databases"
 
 ---
 
-<div id="supported_operating_systems_and_database_versions" class="registered_link"></div>
-
-## Database versions
+## Supported database versions
 
 You can use the following database product versions with Migration Toolkit:
 
@@ -42,10 +40,47 @@ 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.
+    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 version and Migration Toolkit compatibility.
+
+### 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          |
+|-------------|------------------------|--------------------------|
+| 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 |
+
+See [Choosing a driver](./installing/installing_jdbc_driver/#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, for example, in the corresponding Oracle, Microsoft SQL Server, MySQL, or SAP Adaptive Enterprise documentation.
+
+See [Choosing a driver](./installing/installing_jdbc_driver/#choosing-a-driver) for download information.

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
 ---
 

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, to migrate from a Oracle Database instance to EDB Postgres Advanced Server, you require the Oracle Database JDBC driver and the EDB JDBC driver.
+
+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                                                                                                                                            |
+|--------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|
+| 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 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.
 
-- 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 `<mtk_install_dir>/lib` directory.