Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions _articles/faq/change-dynamsoft-service-certificate.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

72 changes: 11 additions & 61 deletions _articles/faq/general-troubleshooting-steps.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

<div class="multi-panel-switching-prefix"></div>

- [v19.0+](#19plus)
- [Versions below 19.0](#19min)

<div class="multi-panel-start"></div>

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.

<div class="multi-panel-end"></div>

<div class="multi-panel-start"></div>

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.

<div class="multi-panel-end"></div>

<div class="multi-panel-switching-end"></div>
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.
2 changes: 1 addition & 1 deletion _articles/hello-world/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)

<a href="{{site.baseurl}}assets/HelloWorld-Code.zip" class="orangeBgBtn" style="height:36px!important;line-height:36px!important">Download the Hello World Code</a>
<a href="https://download2.dynamsoft.com/Samples/DWT/HelloWorld-Code.zip" class="orangeBgBtn" style="height:36px!important;line-height:36px!important">Download the Hello World Code</a>