FAQ about ODC

ODC client installation

1. Q: What items are pre-checked when I install the ODC client?

   A: The following items are pre-checked:

• Windows operating system (OS) version: Only Windows 7 and later versions are supported.

• Port: Whether port 8989 is occupied is checked. The port will no longer be checked in ODC V2.3.0 and later versions because dynamic ports are used.

• Java runtime environment: JDK 1.8.0_242 or later is recommended.

2. Q: How do I view the logs when the installation or startup of the ODC client fails?

   A: You can view the error information in the main.log file. The storage path of the file varies with the OS.

• Linux: ~/.config/odc/

• macOS: ~/Library/Logs/odc/

• Windows: %USERPROFILE%\AppData\Roaming\odc\

3. Q: What do I do when the installation or startup of the ODC client fails and an error message is returned indicating that a port conflict issue has occurred?

   A: You need to check the process that occupies port 8989, kill the process, and then reinstall or restart the ODC client. Dynamic ports are used in ODC V2.3.0 and later to avoid this problem.

• On Mac OS, run the following command to check the use status of port 8989:

  lsof -i tcp:8989

• On Windows, run the following statement to check the use status of port 8989:

  netstat -ano|findstr 8989

• ODC V3.2.0 allows you to set custom ports.

  • On Mac OS, set environment variables and run the corresponding command to enable the port:

  • 

    

  • On Windows, set the ODC_MAPPING_PORT parameter to enable the specified port:

    

4. Q: What do I do when the installation or startup of the ODC client fails and an error message is returned indicating that the Java version is not supported?

   A: You can run the following command to check the Java runtime environment. We recommend that you install JDK1.8.0_242 or a later version. If you have installed JDK of an earlier version, upgrade JDK, restart the computer, and then reinstall or restart the ODC client.

   java -version

5. Q: What do I do when the installation or startup of the ODC client fails and an error message is returned indicating that the software package is damaged?

   A: You can run the sudo spctl --master-disable command and select any source.

   

6. Q: What do I do when the following message appears while I am installing the ODC client on macOS? A: The ODC client cannot be directly installed on Mac OS because it is not downloaded from the App Store. For more information about how to safely open an app that is not downloaded from the Apple Store, see Safely open apps on your Mac.