Skip to content

Commit 81fa9a6

Browse files
committed
Add the TSG content to SHIR troubleshoot doc
1 parent 6480c60 commit 81fa9a6

File tree

5 files changed

+62
-1
lines changed

5 files changed

+62
-1
lines changed
4.49 KB
Loading
2.51 KB
Loading
14 KB
Loading
Loading

articles/data-factory/self-hosted-integration-runtime-troubleshoot-guide.md

Lines changed: 62 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ ms.service: data-factory
77
ms.subservice: integration-runtime
88
ms.custom: synapse
99
ms.topic: troubleshooting
10-
ms.date: 09/09/2021
10+
ms.date: 10/26/2021
1111
ms.author: lle
1212
---
1313

@@ -351,6 +351,67 @@ To solve this issue, you need to add the self-hosted integration runtime service
351351
1. Select **Check Names** and then select **OK**.
352352
1. In the "Permissions" pane, select **Apply** and then select **OK**.
353353
354+
355+
### UserErrorJreNotFound error message when you run a copy activity to Azure
356+
357+
#### Symptoms
358+
359+
When you try to copy content to Microsoft Azure by using a Java-based tool or program (for example, copying ORC or Parquet format files), you receive an error message that resembles the following:
360+
361+
> ErrorCode=UserErrorJreNotFound,'Type=Microsoft.DataTransfer.Common.Shared.HybridDeliveryException,Message=Java Runtime Environment is not found. Go to `http://go.microsoft.com/fwlink/?LinkId=808605` to download and install on your Integration Runtime (Self-hosted) node machine. Note 64-bit Integration Runtime requires 64-bit JRE and 32-bit Integration Runtime requires 32-bit JRE.,Source=Microsoft.DataTransfer.Common,''Type=System.DllNotFoundException,Message=Unable to load DLL 'jvm.dll': The specified module could not be found. (Exception from HRESULT: 0x8007007E),Source=Microsoft.DataTransfer.Richfile.HiveOrcBridge
362+
363+
#### Cause
364+
365+
This issue occurs for either of the following reasons:
366+
367+
- Java Runtime Environment (JRE) isn't installed correctly on your Integration Runtime server.
368+
369+
- Your Integration Runtime server lacks the required dependency for JRE.
370+
371+
By default, Integration Runtime resolves the JRE path by using registry entries. Those entries should be automatically set during JRE installation.
372+
373+
#### Resolution
374+
375+
Follow the steps in this section carefully. Serious problems might occur if you modify the registry incorrectly. Before you modify it, [back up the registry for restoration](https://support.microsoft.com/en-us/topic/how-to-back-up-and-restore-the-registry-in-windows-855140ad-e318-2a13-2829-d428a2ab0692) in case problems occur.
376+
377+
To fix this issue, follow these steps to verify the status of the JRE installation:
378+
379+
1. Make sure that Integration Runtime (Diahost.exe) and JRE are installed on the same platform. Check the following conditions:
380+
- 64-bit JRE for 64-bit ADF Integration Runtime should be installed in the folder: `C:\Program Files\Java\`
381+
382+
> [!NOTE]
383+
> The folder is not `C:\Program Files (x86)\Java\`
384+
385+
- JRE 7 and JRE 8 are both compatible for this copy activity. JRE 6 and versions that are earlier than JRE 6 have not been validated for this use.
386+
387+
2. Check the registry for the appropriate settings. To do this, follow these steps:
388+
389+
1. In the **Run** menu, type **Regedit**, and then press Enter.
390+
391+
1. In the navigation pane, locate the following subkey:<br/> `HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\Java Runtime Environment`. <br/>
392+
393+
In the **Details** pane, there should be a Current Version entry that shows the JRE version (for example, 1.8).
394+
395+
:::image type="content" source="./media/self-hosted-integration-runtime-troubleshoot-guide/java-runtime-environment-image.png" alt-text="Screenshot showing the Java Runtime Environment.":::
396+
397+
1. In the navigation pane, locate a subkey that is an exact match for the version (for example 1.8) under the JRE folder. In the details pane, there should be a **JavaHome** entry. The value of this entry is the JRE installation path.
398+
399+
:::image type="content" source="./media/self-hosted-integration-runtime-troubleshoot-guide/java-home-entry-image.png" alt-text="Screenshot showing a JavaHome entry.":::
400+
401+
3. Locate the bin\server folder in the following path: <br/>
402+
403+
`C:\Program Files\Java\jre1.8.0_74`
404+
405+
:::image type="content" source="./media/self-hosted-integration-runtime-troubleshoot-guide/folder-of-jre.png" alt-text="Screenshot showing the JRE folder.":::
406+
407+
1. Check whether this folder contains a jvm.dll file. If it does not, check for the file in the `bin\client` folder.
408+
409+
:::image type="content" source="./media/self-hosted-integration-runtime-troubleshoot-guide/file-location-image.png" alt-text="Screenshot showing a jvm.dll file location.":::
410+
411+
> [!NOTE]
412+
> - If any of these configurations are not as described in these steps, use the [JRE windows installer](https://java.com/en/download/manual.jsp) to fix the problems.
413+
> - If all the configurations in these steps are correct as described, there may be a VC++ runtime library missing in the system. You can fix this problem by installing the VC++ 2010 Redistributable Package.
414+
354415
## Self-hosted IR setup
355416
356417
### Integration runtime registration error

0 commit comments

Comments
 (0)