From 3ca86f8a6f127c7fcaadb2a0f338e970f8d9eaa2 Mon Sep 17 00:00:00 2001
From: Ashera Silva <asherasilva100@gmail.com>
Date: Fri, 1 Nov 2024 11:42:52 +0530
Subject: [PATCH 1/2] Mention the tested MySQL Java Connector version

---
 en/docs/design/api-monetization/monetizing-an-api.md       | 5 ++++-
 .../setup/distributed-deployment/product-profiles.md       | 5 ++++-
 .../changing-default-databases/changing-to-mysql.md        | 7 +++++--
 3 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/en/docs/design/api-monetization/monetizing-an-api.md b/en/docs/design/api-monetization/monetizing-an-api.md
index 6aa66adf76..e9b782124d 100644
--- a/en/docs/design/api-monetization/monetizing-an-api.md
+++ b/en/docs/design/api-monetization/monetizing-an-api.md
@@ -120,7 +120,10 @@ Let's use the
   
     1. Download and add the database related connector JAR into the`<APIM_HOME/repository/components/lib` directory. 
         
-        As a MySQL database is used for this example scenario, download and copy the [MySQL connector JAR](https://mvnrepository.com/artifact/mysql/mysql-connector-java/5.1.36) into the `<APIM_HOME/repository/components/lib` directory.
+        As a MySQL database is used for this example scenario, download and copy the [MySQL connector JAR](https://downloads.mysql.com/archives/c-j/) into the `<APIM_HOME/repository/components/lib` directory.
+
+        !!!tip
+            Tested connector version is **8.0.33**.
 
     2. Configure the WSO2 API Manager related datasource.  
         
diff --git a/en/docs/install-and-setup/setup/distributed-deployment/product-profiles.md b/en/docs/install-and-setup/setup/distributed-deployment/product-profiles.md
index 69b577a287..3fc8003d25 100644
--- a/en/docs/install-and-setup/setup/distributed-deployment/product-profiles.md
+++ b/en/docs/install-and-setup/setup/distributed-deployment/product-profiles.md
@@ -81,8 +81,11 @@ Create an optimized distribution for a particular API-M profile.
    
      For example, if you are using a MySQL database,
 
-     1. Download the MySQL connector JAR file and extract it.
+     1. Download the [MySQL connector JAR](https://downloads.mysql.com/archives/c-j/) file and extract it.
      
+        !!!tip
+            Tested connector version is **8.0.33**.
+
      2. Copy it to the `<API-M_HOME>/repository/components/lib/` directory.
 
 3. Create the required databases, namely the API-M database (`apimgtdb` also known as `WSO2_AM_DB`) and the shared database (`WSO2_SHARED_DB` also known as `shareddb`).
diff --git a/en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-mysql.md b/en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-mysql.md
index cc048ca792..60f6c5fba1 100644
--- a/en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-mysql.md
+++ b/en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-mysql.md
@@ -109,9 +109,12 @@ Follow the  instructions below to set up a MySQL database:
 
 1. Unzip the WSO2 API Manager pack. Let's refer to it as `<API-M_HOME>`.
 
-2. Download the MySQL Java connector [JAR file](https://dev.mysql.com/downloads/connector/j/), and extract it.
+2. Download the MySQL Java Connector from [MySQL Connector/J (Archived Versions)](https://downloads.mysql.com/archives/c-j/), and extract it.
 
-3. Copy it to the `<API-M_HOME>/repository/components/lib/` directory in all the nodes of the cluster.
+    !!! tip
+        The tested connector version is **8.0.33**.
+
+3. Copy the connector JAR file to the `<API-M_HOME>/repository/components/lib/` directory in all the nodes of the cluster.
 
 !!! tip
     Be sure to use the connector version that is supported by the MySQL version you use. If you come across any issues due to version incompatibility, follow the  instructions below:

From 27db84e08c9364ca6f5ea5976ffb8891835d4e12 Mon Sep 17 00:00:00 2001
From: Ashera Silva <asherasilva100@gmail.com>
Date: Fri, 1 Nov 2024 12:31:02 +0530
Subject: [PATCH 2/2] Update the tip with recommended connector version based
 on the mysql version

---
 en/docs/design/api-monetization/monetizing-an-api.md       | 7 +++++--
 .../setup/distributed-deployment/product-profiles.md       | 7 +++++--
 .../changing-default-databases/changing-to-mysql.md        | 5 ++++-
 3 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/en/docs/design/api-monetization/monetizing-an-api.md b/en/docs/design/api-monetization/monetizing-an-api.md
index e9b782124d..fc07665b5c 100644
--- a/en/docs/design/api-monetization/monetizing-an-api.md
+++ b/en/docs/design/api-monetization/monetizing-an-api.md
@@ -122,8 +122,11 @@ Let's use the
         
         As a MySQL database is used for this example scenario, download and copy the [MySQL connector JAR](https://downloads.mysql.com/archives/c-j/) into the `<APIM_HOME/repository/components/lib` directory.
 
-        !!!tip
-            Tested connector version is **8.0.33**.
+        !!! tip
+            Look for the compatible MySQL Connector version based on the MySQL version being used.
+
+            - For MySQL version 8.0.x, the compatible MySQL Connector version is **8.0.x**.    
+            - For MySQL version 8.4.x, the compatible MySQL Connector version is **8.4.x**.
 
     2. Configure the WSO2 API Manager related datasource.  
         
diff --git a/en/docs/install-and-setup/setup/distributed-deployment/product-profiles.md b/en/docs/install-and-setup/setup/distributed-deployment/product-profiles.md
index 3fc8003d25..563de83282 100644
--- a/en/docs/install-and-setup/setup/distributed-deployment/product-profiles.md
+++ b/en/docs/install-and-setup/setup/distributed-deployment/product-profiles.md
@@ -83,8 +83,11 @@ Create an optimized distribution for a particular API-M profile.
 
      1. Download the [MySQL connector JAR](https://downloads.mysql.com/archives/c-j/) file and extract it.
      
-        !!!tip
-            Tested connector version is **8.0.33**.
+        !!! tip
+            Look for the compatible MySQL Connector version based on the MySQL version being used.
+
+            - For MySQL version 8.0.x, the compatible MySQL Connector version is **8.0.x**.
+            - For MySQL version 8.4.x, the compatible MySQL Connector version is **8.4.x**.
 
      2. Copy it to the `<API-M_HOME>/repository/components/lib/` directory.
 
diff --git a/en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-mysql.md b/en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-mysql.md
index 60f6c5fba1..0377bc0b68 100644
--- a/en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-mysql.md
+++ b/en/docs/install-and-setup/setup/setting-up-databases/changing-default-databases/changing-to-mysql.md
@@ -112,7 +112,10 @@ Follow the  instructions below to set up a MySQL database:
 2. Download the MySQL Java Connector from [MySQL Connector/J (Archived Versions)](https://downloads.mysql.com/archives/c-j/), and extract it.
 
     !!! tip
-        The tested connector version is **8.0.33**.
+        Look for the compatible MySQL Connector version based on the MySQL version being used.
+
+        - For MySQL version 8.0.x, the compatible MySQL Connector version is **8.0.x**.
+        - For MySQL version 8.4.x, the compatible MySQL Connector version is **8.4.x**.
 
 3. Copy the connector JAR file to the `<API-M_HOME>/repository/components/lib/` directory in all the nodes of the cluster.