This topic describes how to use the Lingma script and its output to troubleshoot issues with Lingma, such as startup problems. The script helps you quickly diagnose and resolve potential issues by automatically gathering system environment information, network configurations, the Lingma service status, and related logs.
Prerequisites
Ensure that you are using the Windows operating system and have administrator permissions to run the script.
Download and save the windows_lingma.bat script as a .bat file, such as "Lingma_Debug.bat".
Ensure that Lingma is correctly installed in the default path (C:\Users\<YourUsername>\.lingma).
Procedure
Run the script: Double-click the saved .bat file to run the script.
View the log: After the script finishes, the generated log file opens automatically. The log file path is displayed in the command-line window. The log file is typically located in the same folder as the script and named in the format Lingma_Log_Date_Time.txt.
Troubleshooting guide
Issue type | Issue item | Solution |
Network | Check proxy settings | The script checks whether a proxy is enabled. Check the [Network settings: 0x0 indicates that no proxy is enabled] section to verify the configuration. If a proxy is enabled, you must manually configure the network proxy for Lingma in Settings. |
Lingma service status | Lingma.exe existence | The script first verifies that Lingma.exe exists. If an error occurs, check whether the installation path is correct. Then, delete the .lingma folder and restart the IDE to regenerate the .lingma folder. |
Version and startup test | Check the "[version test]" and "[start Lingma]" sections to confirm the Lingma version information and its ability to connect to the Internet. If the test fails, use the URL from the error message to configure a proxy in the settings to access the Internet. | |
The Lingma.exe process starts but logon is unresponsive | Add the process file to the Windows Firewall whitelist and then retry logging on. The path is C:\Users\xxx\.lingma\bin\2.X.X\x86_64_windows\lingma.exe. You can find the whitelist settings in Control Panel > System and Security > Windows Defender Firewall > Allowed apps. | |
An "incompatible program" error is reported | If you use IntelliJ IDEA, this error might be caused by insufficient heap memory, which leads to a decompression failure. To fix this, click the Lingma icon in the lower-right corner, select Advanced Settings, and change the path to a location on a non-C drive that ends with an empty folder. Then, restart IntelliJ IDEA. Note Some companies may lock binary programs, which prevents them from running. | |
What to do if the status is "Lingma is starting" (or a startup exception is reported and the service is unresponsive)? |
| |
System compatibility | System and hardware information | The script collects the operating system version and CPU model. Check the "[Operating system info]" section to confirm that your system meets the requirements for Lingma. |
Log analysis | Lingma application log | The generated log file contains the last 80 lines of "lingma.log". This helps identify specific runtime errors or warnings. You can analyze the errors in the log. |
Directory structure and file sizes | The script also provides the structure and file sizes of the Lingma installation folder. Use this information to check disk space usage or verify file integrity. | |
Issues you cannot resolve | Join the DingTalk group 'Lingma Public Preview Communication Group (Please read the group announcement before asking questions)'. The group number is |