From a3f6eed8d1e2f7019eea01639e36ec3f079f3438 Mon Sep 17 00:00:00 2001 From: DMGithubPublisher Date: Fri, 24 Oct 2025 10:29:15 +0800 Subject: [PATCH] update to internal commit f70922d7 --- .../change-dynamsoft-service-certificate.md | 4 +- .../faq/general-troubleshooting-steps.md | 72 +++---------------- _articles/hello-world/index.md | 2 +- 3 files changed, 14 insertions(+), 64 deletions(-) diff --git a/_articles/faq/change-dynamsoft-service-certificate.md b/_articles/faq/change-dynamsoft-service-certificate.md index 9157c2c6..ee4efca8 100644 --- a/_articles/faq/change-dynamsoft-service-certificate.md +++ b/_articles/faq/change-dynamsoft-service-certificate.md @@ -40,10 +40,10 @@ Then, you can find the certificate named `fullchain.cer` and the private key nam * default keys * server.pem * server_key.pem -* keys for [local.dynamsoft.com](/_articles/faq/failed-to-load-resource.md) (encrypted) +* keys for [local.dynamsoft.com](/_articles/faq/failed-to-load-resource.md) (encrypted, get the latest from [demo site](https://demo.dynamsoft.com/DWT/Resources/dist/cert.zip)) * server.pem.ldsc * server_key.pem.ldsc -* keys for [Remote Scan](https://www.dynamsoft.com/remote-scan/docs/introduction/)'s proxy server after installation (encrypted) +* keys for [Remote Scan](https://www.dynamsoft.com/remote-scan/docs/introduction/)'s proxy server after installation (encrypted, get the latest from the domain binding page) * server.pem.ldwtc * server_key.pem.ldwtc diff --git a/_articles/faq/general-troubleshooting-steps.md b/_articles/faq/general-troubleshooting-steps.md index 44e4e9f4..db144a92 100644 --- a/_articles/faq/general-troubleshooting-steps.md +++ b/_articles/faq/general-troubleshooting-steps.md @@ -7,80 +7,30 @@ keywords: Dynamic Web TWAIN, Error Troubleshooting, general steps, verbose breadcrumbText: General troubleshooting steps description: General troubleshooting steps date: 2021-12-03 23:26:46 +0800 -last_modified: 2025-03-07 13:31:31 +0800 +last_modified: 2025-10-24 10:20:31 +0800 --- # Error Troubleshooting -## General troubleshooting steps +## General Troubleshooting Steps - Try our online demo and see if you can reproduce the issue. - Check the console or network log and report any errors. -- Enable and collect verbose logs (detailed below) +- Enable and collect verbose logs (detailed below). -### How to enable and collect verbose log +## Enable and Collect Verbose Logs -
- -- [v19.0+](#19plus) -- [Versions below 19.0](#19min) - -
- -1. Remove any old log files from - - Windows `C:\Program Files (x86)\Dynamsoft\Dynamic Web TWAIN Service {version number}\log` or `C:\Users\{UserName}\AppData\Roaming\Dynamsoft\Dynamic Web TWAIN Service\log` - - macOS, `Go > Applications > Dynamsoft > Dynamic Web TWAIN Service {version number} > log` - - Linux: `/opt/dynamsoft/Dynamic Web TWAIN Service {version number}/log` - -2. Set the log level - - Option A - (Only recommended for v18.0+) For only one client machine, add the line `LogLevel=14` to `DSConfiguration.ini` on that specific machine. To find the `DSConfiguration.ini` file, please return to the previous directory from the log directory. - - Option B - Single client machine troubleshooting - go to the application with Dynamic Web TWAIN integrated, press F12 to open the development tools, switch to "console" tab and enter the command `DWTObject.LogLevel = 1` to enable the debugger mode. - - Option C - For all client machines (application wide) - set [ `LogLevel` ](/_articles/info/api/WebTwain_Util.md#loglevel) to 1 in your code. This property should be set as soon as the `WebTwain` instance is created. For example, in the event `Dynamsoft_OnReady` +1. Remove old log files in the `log` folder under the service's [installation folder](/_articles/extended-usage/dynamsoft-service-configuration.md#installation-folder). +2. Set the log level: + - Option A (**only recommended for v18.0+**) - Single client machine troubleshooting: Add the line `LogLevel=14` to `DSConfiguration.ini` on the machine. Find the `DSConfiguration.ini` file in the **parent directory** of the log directory. + - Option B - Single client machine troubleshooting: Go to the Dynamic Web TWAIN-integrated application, press F12 to open the development tools, switch to "console" tab, and enter the command `DWTObject.LogLevel = 1` to enable debugger mode. + - Option C - Troubleshoot all client machines (application wide): set [`LogLevel`](/_articles/info/api/WebTwain_Util.md#loglevel) to 1 in your application code. This property should be set as soon as the `WebTwain` instance is created. For example, in the event `Dynamsoft_OnReady` ```javascript function Dynamsoft_OnReady() { DWTObject = Dynamsoft.DWT.GetWebTwain("dwtcontrolContainer"); DWTObject.LogLevel = 1; } ``` - -3. Perform a hard refresh (Ctrl + F5) on the application web page and attempt to reproduce the issue. To expedite issue identification, we would greatly appreciate it if you could create a txt file that records the time when the issue occurred and place the file in the same log folder. - +3. Perform a hard refresh (Ctrl + F5) on the application web page and attempt to reproduce the issue. To expedite issue identification, we would greatly appreciate it if you could create a `.txt` file that records the time when the issue occurred and place the file in the same log folder. 4. Zip the log folder and share with [Dynamsoft Support Team](/_articles/about/getsupport.md) via email. - - On Windows, the log files are in `C:\Program Files (x86)\Dynamsoft\Dynamic Web TWAIN Service {version number}\log` or `C:\Users\{UserName}\AppData\Roaming\Dynamsoft\Dynamic Web TWAIN Service\log` - - On macOS, the log files are in `Go > Applications > Dynamsoft > Dynamic Web TWAIN Service {version number} > log` - - On Linux, the log files are in `/opt/dynamsoft/Dynamic Web TWAIN Service {version number}/log` - -5. **Please remember to either remove the "LogLevel" entry from the "DSConfiguration.ini" file or set `DWTObject.LogLevel` back to its default value (0) to disable the debugger mode**. Otherwise the operation speed will be affected. - -
- -
- -1. Remove any old log files from - - Windows `C:\Windows\SysWOW64\Dynamsoft\DynamsoftServicex64_{version number}\log` or `C:\Users\{UserName}\AppData\Roaming\Dynamsoft\DynamsoftService\log` - - macOS, `Go > Applications > Dynamsoft > DynamsoftServicex64_{version number} > {installed version No.} > log` - - Linux: `/opt/dynamsoft/DynamsoftService/log` - -2. Set the log level - - Option A - (Only recommended for v18.0+) For only one client machine, add the line `LogLevel=14` to `DSConfiguration.ini` on that specific machine. To find the `DSConfiguration.ini` file, please return to the previous directory from the log directory. - - Option B - Single client machine troubleshooting - go to the application with Dynamic Web TWAIN integrated, press F12 to open the development tools, switch to "console" tab and enter the command `DWTObject.LogLevel = 1` to enable the debugger mode. - - Option C - For all client machines (application wide) - set [ `LogLevel` ](/_articles/info/api/WebTwain_Util.md#loglevel) to 1 in your code. This property should be set as soon as the `WebTwain` instance is created. For example, in the event `Dynamsoft_OnReady` - ```javascript - function Dynamsoft_OnReady() { - DWTObject = Dynamsoft.DWT.GetWebTwain("dwtcontrolContainer"); - DWTObject.LogLevel = 1; - } - ``` - -3. Perform a hard refresh (Ctrl + F5) on the application web page and attempt to reproduce the issue. To expedite issue identification, we would greatly appreciate it if you could create a txt file that records the time when the issue occurred and place the file in the same log folder. - -4. Zip the log folder and share with [Dynamsoft Support Team](/_articles/about/getsupport.md) via email. - - On Windows, the log files are in `C:\Windows\SysWOW64\Dynamsoft\DynamsoftServicex64_{version number}\log` or `C:\Users\{UserName}\AppData\Roaming\Dynamsoft\DynamsoftService\log` - - On macOS, the log files are in `Go > Applications > Dynamsoft > DynamsoftServicex64_{version number} > {installed version No.} > log` - - On Linux, the log files are in `/opt/dynamsoft/DynamsoftServicex64_{version number}/log` - -5. **Please remember to either remove the "LogLevel" entry from the "DSConfiguration.ini" file or set `DWTObject.LogLevel` back to its default value (0) to disable the debugger mode**. Otherwise the operation speed will be affected. - -
- -
\ No newline at end of file +5. **Please remember to either remove the `LogLevel` entry from the `DSConfiguration.ini` file or set `DWTObject.LogLevel` back to its default value (0) to disable the debugger mode**. Otherwise, verbose logging will affect operation speed. diff --git a/_articles/hello-world/index.md b/_articles/hello-world/index.md index 93cafdd7..ba45e0d1 100644 --- a/_articles/hello-world/index.md +++ b/_articles/hello-world/index.md @@ -20,4 +20,4 @@ The Hello World web app covers the following features: 3. [Specifying Scan Settings](/_articles/hello-world/scan-settings.md) 4. [Editing Images](/_articles/hello-world/editing.md) -Download the Hello World Code +Download the Hello World Code