This topic shows you how to fix some of the most common issues using the Lingma troubleshooting script in Windows. The script gathers information about your system, network configurations, and the Lingma service status. The script also collects related logs to help find and fix potential issues based on its output.
Prerequisites
You use the Windows operating system and have administrator permissions to run the script.
You have downloaded and saved the windows_lingma_en.bat file named as a
.bat
file for example,Lingma_Debug.bat
.Lingma is correctly installed in the default path (
C:\Users\\.lingma
).
Procedure
Run the script. Double-click the saved ".bat" file to start the script.
View logs. After you run the script, the generated log file opens automatically. The log file's location appears on the command line. The log file is typically located in the same directory as the script. The generated log file is named in this format: Lingma_Log_Date.txt.
Troubleshooting guide
Issue type | Issue Details | Solution |
Network | The script checks whether the network proxy is enabled. | View the "[Network settings 0x0 means proxy is not enabled]" section to confirm whether it meets your expectations. If you have a proxy, you will need to manually configure the proxy address for Lingma in the settings. |
Lingma service status | The script first checks if the Lingma.exe file exists. | If you receive an error,
|
The script checks Lingma's version and connectivity. | It checks the Version Parameter and Launch Lingma fields. If you get a "failed" error message, configure a proxy to access the Internet in the settings using the URL from the error message. | |
The script checks if Lingma.exe process starts but logon has no response | You need to add the process file to the Windows Firewall whitelist (Control Panel\System and Security\Windows Defender Firewall\Allowed apps) and then try to log on again: C:\Users\xxx\.lingma\bin\2.X.X\x86_64_windows\lingma.exe. | |
The script checks if an incompatible program is reported | If you use IDEA, you might run into problems with low memory. This can cause decompression failure. Click the Lingma icon in the lower right corner, select Advanced Settings, and change the path to a non-C drive path ending with an empty folder. Then restart IDEA. Note Some companies lock their binary programs, which prevents them from running. | |
System compatibility | The script records the version and CPU model of your operating system. | It checks the [Operating system info] field to confirm that Lingma system requirements are met. |
Log analysis | Lingma application logs | The generated log file records the last 80 lines from a file named "lingma.log". This helps you find specific errors or warnings when using Lingma. You can analyze the errors in the log file. |
The script shows directory structure and file size | This information can be used to check for space or file integrity. | |
Other issues that cannot be troubleshooted | Join the DingTalk group Lingma Public Preview Communication Group. The group number is |