diff --git a/install_template/templates/products/migration-toolkit/index.njk b/install_template/templates/products/migration-toolkit/index.njk
index cf25f697f17..7eee98831a9 100644
--- a/install_template/templates/products/migration-toolkit/index.njk
+++ b/install_template/templates/products/migration-toolkit/index.njk
@@ -24,14 +24,14 @@ legacyRedirects:
{% endblock frontmatter %}
{% block navigation %}
{{- super() -}}
-- install_on_mac
-- install_on_windows
+- macos
+- windows
- installing_jdbc_driver
{% endblock navigation %}
{% block otherosinstall %}
-## Macintosh
-- [Mac OS X](macos)
+## Mac
+- [macOS](macos)
## Windows
- [Windows Server 2019](windows)
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..8bfadf0067a 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,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.
+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.
diff --git a/product_docs/docs/migration_toolkit/55/06_building_toolkit.properties_file.mdx b/product_docs/docs/migration_toolkit/55/06_building_toolkit.properties_file.mdx
index b1a18ce27e2..04a33e40ced 100644
--- a/product_docs/docs/migration_toolkit/55/06_building_toolkit.properties_file.mdx
+++ b/product_docs/docs/migration_toolkit/55/06_building_toolkit.properties_file.mdx
@@ -11,7 +11,7 @@ On Linux, the `toolkit.properties` file is located in `/usr/edb/migrationtoolkit
On Windows, the file is located in `C:\Program Files\edb\mtk\etc`.
-On Mac OS, the file is located in `/Library/edb/mtk/etc`.
+On macOS, the file is located in `/Library/edb/mtk/etc`.
The figure shows a sample `toolkit.properties` file:
diff --git a/product_docs/docs/migration_toolkit/55/installing/index.mdx b/product_docs/docs/migration_toolkit/55/installing/index.mdx
index 350db2b5bd6..07a521ccbde 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
---
@@ -81,9 +81,9 @@ Select a link to access the applicable installation instructions:
- [Debian 12](linux_arm64/mtk_debian_12)
-## Macintosh
+## Mac
-- [Mac OS X](macos)
+- [macOS](macos)
## Windows
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 a5d4390fd11..3c9874e932e 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,14 +8,27 @@ Migration Toolkit requires Java version 1.8.0 or later.
## Choosing a driver
-Your selection of the JDBC drivers to use depends on the databases you're migrating from and to. For example, if you're migrating from Oracle to EDB Postgres Advanced Server, you 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 macOS.
+ - 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)
@@ -23,9 +36,6 @@ Your selection of the JDBC drivers to use depends on the databases you're migrat
- [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 can be used with Migration Toolkit. We recommend the Microsoft-provided JDBC driver for SQL Server for the newer versions of SQL Server supported by Migration Toolkit.
-
## Adding the driver to `lib`
After downloading the driver, move the driver file into the `/lib` directory.
diff --git a/product_docs/docs/migration_toolkit/55/installing/macos.mdx b/product_docs/docs/migration_toolkit/55/installing/macos.mdx
index 8dc7791215c..87328286627 100644
--- a/product_docs/docs/migration_toolkit/55/installing/macos.mdx
+++ b/product_docs/docs/migration_toolkit/55/installing/macos.mdx
@@ -1,12 +1,12 @@
---
-title: "Installing on Mac OS X"
-navTitle: "On Mac OS X"
+title: "Installing on macOS"
+navTitle: "On macOS"
redirects:
- /migration_toolkit/latest/05_installing_mtk/install_on_mac/
- /migration_toolkit/latest/installing/install_on_mac/
---
-EDB provides a graphical interactive installer for MacOS. You can access it two ways:
+EDB provides a graphical interactive installer for macOS. You can access it two ways:
- Download the graphical installer from the [Downloads page](https://www.enterprisedb.com/software-downloads-postgres#migration-toolkit) and invoke the installer directly. See [Installing directly](#installing-directly).
@@ -67,7 +67,7 @@ If you are using PostgreSQL, you can invoke the graphical installer with Stack B
After installing Migration Toolkit, you must install the appropriate JDBC drivers before performing a migration. See [Installing a JDBC driver](/migration_toolkit/latest/installing/installing_jdbc_driver/) for more information.
!!! Note
- The EDB JDBC driver is not available for Mac OS.
+ The EDB JDBC driver is not available for macOS.