Skip to content

Commit fb142b9

Browse files
Merge pull request mendix#9006 from liamsommer-mx/reactClient
React client compatiblity of GenAI modules + JDK troubleshooting update
2 parents 7755cfb + c174832 commit fb142b9

4 files changed

Lines changed: 55 additions & 7 deletions

File tree

content/en/docs/appstore/use-content/platform-supported-content/modules/genai/Mx GenAI Connector.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -254,6 +254,28 @@ The **Documentation** pane displays the documentation for the currently selected
254254

255255
For more inspiration or guidance on how to use microflows in your logic, Mendix recommends downloading the [GenAI Showcase App](https://marketplace.mendix.com/link/component/220475), which demonstrates a variety of example use cases and applies almost all of the Mendix Cloud GenAI operations. The starter apps in the [Mendix Components](/appstore/modules/genai/#mendix-components) list can also be used as inspiration or simply adapted for a specific use case.
256256

257+
## Troubleshooting {#troubleshooting}
258+
259+
### Outdated JDK Version Causing Errors while Calling a REST API {#outdated-jdk-version}
260+
261+
The Java Development Kit (JDK) is a framework needed by Mendix Studio Pro to deploy and run applications. For more information, see [Studio Pro System Requirements](/refguide/system-requirements/). Usually, the correct JDK version is installed during the installation of Studio Pro, but in some cases, it may be outdated. An outdated version can cause exceptions when calling REST-based services with large data volumes, like for example embeddings operations or chat completions with vision.
262+
263+
Mendix has seen the following two exceptions when using JDK versions below `jdk-11.0.5.0-hotspot`:
264+
`java.net.SocketException - Connection reset` or
265+
`javax.net.ssl.SSLException - Received fatal alert: record_overflow`.
266+
267+
To check your JDK version and update it if necessary, follow these steps:
268+
269+
1. Check your JDK version – In Studio Pro, go to **Edit** > **Preferences** > **Deployment** > **JDK directory**. If the path points to a version below `jdk-11.0.5.0-hotspot`, you need to update the JDK by following the next steps.
270+
2. Go to [Eclipse Temurin JDK 11](https://adoptium.net/en-GB/temurin/releases/?variant=openjdk11&os=windows&package=jdk) and download the `.msi` file of the latest release of **JDK 11**.
271+
3. Open the downloaded file and follow the installation steps. Remember the installation path. Usually, this should be something like `C:/Program Files/Eclipse Adoptium/jdk-11.0.22.7-hotspot`.
272+
4. After the installation has finished, restart your computer if prompted.
273+
5. Open Studio Pro and go to **Edit** > **Preferences** > **Deployment** > **JDK directory**. Click **Browse** and select the folder with the new JDK version you just installed. This should be the folder containing the *bin* folder. Save your settings by clicking **OK**.
274+
6. Run the project and execute the action that threw the above-mentioned exception earlier.
275+
1. You might get an error saying `FAILURE: Build failed with an exception. The supplied javaHome seems to be invalid. I cannot find the java executable.` In this case, verify that you have selected the correct JDK directory containing the updated JDK version.
276+
2. You may also need to update Gradle. To do this, go to **Edit** > **Preferences** > **Deployment** > **Gradle directory**. Click **Browse** and select the appropriate Gradle version from the Mendix folder. For Mendix 10.10 and above, use Gradle 8.5. For Mendix 10 versions below 10.10, use Gradle 7.6.3. Then save your settings by clicking **OK**.
277+
3. Rerun the project.
278+
257279
## Read More{#readmore}
258280

259281
For Anthropic Claude-specific documentation, refer to:

content/en/docs/appstore/use-content/platform-supported-content/modules/genai/genai-commons.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -844,3 +844,24 @@ The Java actions from the [CommunityCommons](https://marketplace.mendix.com/link
844844
#### Solution
845845

846846
Update the [CommunityCommons](https://marketplace.mendix.com/link/component/170) module to the latest version.
847+
848+
### Outdated JDK Version Causing Errors while Calling a REST API {#outdated-jdk-version}
849+
850+
The Java Development Kit (JDK) is a framework needed by Mendix Studio Pro to deploy and run applications. For more information, see [Studio Pro System Requirements](/refguide/system-requirements/). Usually, the correct JDK version is installed during the installation of Studio Pro, but in some cases, it may be outdated. An outdated version can cause exceptions when calling REST-based services with large data volumes, like for example embeddings operations or chat completions with vision.
851+
852+
Mendix has seen the following two exceptions when using JDK versions below `jdk-11.0.5.0-hotspot`:
853+
`java.net.SocketException - Connection reset` or
854+
`javax.net.ssl.SSLException - Received fatal alert: record_overflow`.
855+
856+
To check your JDK version and update it if necessary, follow these steps:
857+
858+
1. Check your JDK version – In Studio Pro, go to **Edit** > **Preferences** > **Deployment** > **JDK directory**. If the path points to a version below `jdk-11.0.5.0-hotspot`, you need to update the JDK by following the next steps.
859+
2. Go to [Eclipse Temurin JDK 11](https://adoptium.net/en-GB/temurin/releases/?variant=openjdk11&os=windows&package=jdk) and download the `.msi` file of the latest release of **JDK 11**.
860+
3. Open the downloaded file and follow the installation steps. Remember the installation path. Usually, this should be something like `C:/Program Files/Eclipse Adoptium/jdk-11.0.22.7-hotspot`.
861+
4. After the installation has finished, restart your computer if prompted.
862+
5. Open Studio Pro and go to **Edit** > **Preferences** > **Deployment** > **JDK directory**. Click **Browse** and select the folder with the new JDK version you just installed. This should be the folder containing the *bin* folder. Save your settings by clicking **OK**.
863+
6. Run the project and execute the action that threw the above-mentioned exception earlier.
864+
1. You might get an error saying `FAILURE: Build failed with an exception. The supplied javaHome seems to be invalid. I cannot find the java executable.` In this case, verify that you have selected the correct JDK directory containing the updated JDK version.
865+
2. You may also need to update Gradle. To do this, go to **Edit** > **Preferences** > **Deployment** > **Gradle directory**. Click **Browse** and select the appropriate Gradle version from the Mendix folder. For Mendix 10.10 and above, use Gradle 8.5. For Mendix 10 versions below 10.10, use Gradle 7.6.3. Then save your settings by clicking **OK**.
866+
3. Rerun the project.
867+

content/en/docs/appstore/use-content/platform-supported-content/modules/genai/openai/_index.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -292,25 +292,25 @@ Some examples demonstrate knowledge base interaction and require a connection to
292292

293293
## Troubleshooting {#troubleshooting}
294294

295-
### Outdated JDK Version Causing Errors while Calling the Embeddings API {#outdated-jdk-version}
295+
### Outdated JDK Version Causing Errors while Calling a REST API {#outdated-jdk-version}
296296

297-
The Java Development Kit (JDK) is a framework needed by Mendix Studio Pro to deploy and run applications. For more information, see [Studio Pro System Requirements](/refguide/system-requirements/). Usually, the correct JDK version is installed during the installation of Studio Pro, but in some cases, it may be outdated. An outdated version can cause exceptions when calling the Embeddings API or other REST-based services with large data volumes.
297+
The Java Development Kit (JDK) is a framework needed by Mendix Studio Pro to deploy and run applications. For more information, see [Studio Pro System Requirements](/refguide/system-requirements/). Usually, the correct JDK version is installed during the installation of Studio Pro, but in some cases, it may be outdated. An outdated version can cause exceptions when calling REST-based services with large data volumes, like for example embeddings operations or chat completions with vision.
298298

299-
Mendix has seen the following two exceptions when using JDK version `jdk-11.0.3.7-hotspot`:
299+
Mendix has seen the following two exceptions when using JDK versions below `jdk-11.0.5.0-hotspot`:
300300
`java.net.SocketException - Connection reset` or
301301
`javax.net.ssl.SSLException - Received fatal alert: record_overflow`.
302302

303303
To check your JDK version and update it if necessary, follow these steps:
304304

305-
1. Check your JDK version – In Studio Pro, go to **Edit** > **Preferences** > **Deployment** > **JDK directory**. If the path points to `jdk-11.0.3.7-hotspot`, you need to update the JDK by following the next steps.
305+
1. Check your JDK version – In Studio Pro, go to **Edit** > **Preferences** > **Deployment** > **JDK directory**. If the path points to a version below `jdk-11.0.5.0-hotspot`, you need to update the JDK by following the next steps.
306306
2. Go to [Eclipse Temurin JDK 11](https://adoptium.net/en-GB/temurin/releases/?variant=openjdk11&os=windows&package=jdk) and download the `.msi` file of the latest release of **JDK 11**.
307307
3. Open the downloaded file and follow the installation steps. Remember the installation path. Usually, this should be something like `C:/Program Files/Eclipse Adoptium/jdk-11.0.22.7-hotspot`.
308308
4. After the installation has finished, restart your computer if prompted.
309309
5. Open Studio Pro and go to **Edit** > **Preferences** > **Deployment** > **JDK directory**. Click **Browse** and select the folder with the new JDK version you just installed. This should be the folder containing the *bin* folder. Save your settings by clicking **OK**.
310310
6. Run the project and execute the action that threw the above-mentioned exception earlier.
311-
1. You might get an error saying `FAILURE: Build failed with an exception. The supplied javaHome seems to be invalid. I cannot find the java executable.`. In this case, verify that you have selected the correct JDK directory containing the updated JDK version.
312-
1. You may also need to update Gradle. To do this, go to **Edit** > **Preferences** > **Deployment** > **Gradle directory**. Click **Browse** and select the appropriate Gradle version from the Mendix folder. For Mendix 10.10 and above, use Gradle 8.5. For Mendix 10 versions below 10.10, use Gradle 7.6.3. Then save your settings by clicking **OK**.
313-
1. Rerun the project.
311+
1. You might get an error saying `FAILURE: Build failed with an exception. The supplied javaHome seems to be invalid. I cannot find the java executable.` In this case, verify that you have selected the correct JDK directory containing the updated JDK version.
312+
2. You may also need to update Gradle. To do this, go to **Edit** > **Preferences** > **Deployment** > **Gradle directory**. Click **Browse** and select the appropriate Gradle version from the Mendix folder. For Mendix 10.10 and above, use Gradle 8.5. For Mendix 10 versions below 10.10, use Gradle 7.6.3. Then save your settings by clicking **OK**.
313+
3. Rerun the project.
314314

315315
### Chat Completions with Vision and JSON Mode (Azure OpenAI)
316316

content/en/docs/refguide/runtime/mendix-client/content-readiness.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,3 +53,8 @@ The following table shows which of the more popular platform-supported Marketpla
5353
| [Web Actions](https://marketplace.mendix.com/link/component/114337) | {{< icon name="checkmark-circle-filled" color="green" >}} |
5454
| [Workflow Commons](https://marketplace.mendix.com/link/component/117066) | {{< icon name="checkmark-circle-filled" color="green" >}} |
5555
| [XSUAA Connector for SAP Cloud Platform](https://marketplace.mendix.com/link/component/78091) | {{< icon name="remove-circle-filled" color="red" >}} |
56+
| [AWS Authentication Connector](https://marketplace.mendix.com/link/component/120333) | {{< icon name="checkmark-circle-filled" color="green" >}} |
57+
| [Amazon Bedrock Connector](https://marketplace.mendix.com/link/component/215042) | {{< icon name="checkmark-circle-filled" color="green" >}} |
58+
| [OpenAI Connector](https://marketplace.mendix.com/link/component/220472) | {{< icon name="checkmark-circle-filled" color="green" >}} |
59+
| [GenAI For Mendix](https://marketplace.mendix.com/link/component/227931) | {{< icon name="checkmark-circle-filled" color="green" >}} |
60+
| [PgVector Knowledge Base](https://marketplace.mendix.com/link/component/225063) | {{< icon name="checkmark-circle-filled" color="green" >}} |

0 commit comments

Comments
 (0)