Skip to content

Commit 2ae06db

Browse files
authored
Refactor installer links to OS tabs and add version guidance (#987)
* Refactor installer links to OS tabs and add version guidance * Adopt note/warning/important templates in failed-resource FAQ
1 parent 1e346f8 commit 2ae06db

1 file changed

Lines changed: 56 additions & 87 deletions

File tree

_articles/faq/failed-to-load-resource.md

Lines changed: 56 additions & 87 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ keywords: Dynamic Web TWAIN, Error Message, Failed to load resource, CERT INVALI
77
breadcrumbText: Error Message - Failed to load resource
88
description: Error Message - Failed to load resource
99
date: 2021-12-01 17:04:03 +0800
10-
last_modified: 2025-11-05 15:23:24 +0800
10+
last_modified: 2026-03-25 12:48:00 -0700
1111
---
1212

1313
# Error Troubleshooting
@@ -24,105 +24,74 @@ By default, "127.0.0.1" is used for service connection. "127.0.0.1" uses a self-
2424

2525
In this case, we provide a domain, "local.dynamsoft.com", which points to "127.0.0.1". It has a VeriSign’ed certificate that has an expiry date. The most recent expired "local.dynamsoft.com" certificate expired on <font color=red>2025 November 20th</font>, and the latest certificate will expire on <font color=red>2026 November 21st</font>.
2626

27-
> ___Please note:___ _all official certificates issued by 3rd party come with an expiry date - generally one year. This means that each year the certificate will need to be updated if local.dynamsoft.com is used._
27+
> [!NOTE]
28+
> All official third-party certificates come with an expiry date (generally one year). If `local.dynamsoft.com` is used, the certificate needs to be updated each year.
2829
29-
<!-- 2. Your own domain certificate expired. -->
30-
31-
<!-- In this case, if you are trying to access an application that integrates a version of Dynamic Web TWAIN V15.3 ~ V17.2.5, you will get the error. Because the old "local.dynamsoft.com" certificate expired on <font color=red>January 9th, 2023</font>. -->
3230

3331
### Resolution
3432

3533
- **No High Level Security Requirement**:
3634
Set back to self-signed certificate "127.0.0.1" by comment the line `Dynamsoft.WebTwainEnv.Host = "local.dynamsoft.com"` or `Dynamsoft.DWT.Host="local.dynamsoft.com"` out. No need to worry about the expiry date of the certificate anymore.
3735

38-
- **High Level Security Requirement (<font color=red>Please note: you need to replace the certificate annually due to expiration</font>)**
36+
- **High Level Security Requirement**
37+
38+
> [!WARNING]
39+
> If you use `local.dynamsoft.com`, replace the certificate annually due to expiration.
3940
4041
If you have to use "local.dynamsoft.com", the following methods can be taken:
4142

42-
- Method 1.Use the following links to download and install the new Dynamic Web TWAIN Service Installer.
43-
- For Windows
44-
> Choose between Admin (requires admin privileges) or Personal (for individual users).
45-
- Version 19.2
46-
- [Windows Installer (Admin)](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup.msi)
47-
- [Windows Installer (Personal)](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup.exe)
48-
- Version 18
49-
- [Windows Installer (Admin)](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup.msi)
50-
- [Windows Installer (Personal)](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup.exe)
51-
- For macOS
52-
> Use the installer matching your SDK version.
53-
- [macOS Installer v19.2](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup.pkg)
54-
- [macOS Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup.pkg)
55-
- For Linux
56-
> Select the installer format based on your distribution type.
57-
- RPM Packages (Red Hat, Fedora, CentOS, etc.)
58-
- [Linux RPM Installer v19.2](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup.rpm)
59-
- [Linux RPM Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup.rpm)
60-
- DEB Packages (Ubuntu, Debian, etc.)
61-
- [Linux DEB Installer v19.2](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup.deb)
62-
- [Linux DEB Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup.deb)
63-
- ARM64 Architecture
64-
- [Linux ARM64 DEB Installer v19.2](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup-arm64.deb)
65-
- [Linux ARM64 DEB Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup-arm64.deb)
66-
- MIPS Architecture
67-
- [Linux MIPS DEB Installer v19.2](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup-mips64el.deb)
68-
- [Linux MIPS DEB Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup-mips64el.deb)
43+
- Method 1. Use the following links to download and install the Dynamic Web TWAIN Service Installer.
44+
> [!IMPORTANT]
45+
> Dynamic Web TWAIN Service installers are backward-compatible within the same major version. Identify the major SDK version first, then download the corresponding installer (for example, 19.x SDK uses v19 installers, 18.x SDK uses v18 installers). If you are unsure about your SDK version, follow [How do I know which SDK version I am using?](/_articles/faq/find-SDK-version.md).
46+
47+
<div class="multi-panel-switching-prefix"></div>
48+
49+
- Windows
50+
- macOS
51+
- Linux
52+
53+
<div class="multi-panel-start"></div>
54+
55+
> Choose between Admin (requires admin privileges) or Personal (for individual users).
56+
- Version 19
57+
- [Windows Installer (Admin)](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.3.2/DynamicWebTWAINServiceSetup.msi)
58+
- [Windows Installer (Personal)](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.3.2/DynamicWebTWAINServiceSetup.exe)
59+
- Version 18
60+
- [Windows Installer (Admin)](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.4/DynamsoftServiceSetup.msi)
61+
- [Windows Installer (Personal)](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.4/DynamsoftServiceSetup.exe)
62+
63+
<div class="multi-panel-end"></div>
64+
65+
<div class="multi-panel-start"></div>
66+
67+
> Use the installer matching your SDK version.
68+
- [macOS Installer v19](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.3.2/DynamicWebTWAINServiceSetup.pkg)
69+
- [macOS Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.4/DynamsoftServiceSetup.pkg)
70+
71+
<div class="multi-panel-end"></div>
72+
73+
<div class="multi-panel-start"></div>
74+
75+
> Select the installer format based on your distribution type.
76+
- RPM Packages (Red Hat, Fedora, CentOS, etc.)
77+
- [Linux RPM Installer v19](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.3.2/DynamicWebTWAINServiceSetup.rpm)
78+
- [Linux RPM Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.4/DynamsoftServiceSetup.rpm)
79+
- DEB Packages (Ubuntu, Debian, etc.)
80+
- [Linux DEB Installer v19](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.3.2/DynamicWebTWAINServiceSetup.deb)
81+
- [Linux DEB Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.4/DynamsoftServiceSetup.deb)
82+
- ARM64 Architecture
83+
- [Linux ARM64 DEB Installer v19](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.3.2/DynamicWebTWAINServiceSetup-arm64.deb)
84+
- [Linux ARM64 DEB Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.4/DynamsoftServiceSetup-arm64.deb)
85+
- MIPS Architecture
86+
- [Linux MIPS DEB Installer v19](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.3.2/DynamicWebTWAINServiceSetup-mips64el.deb)
87+
- [Linux MIPS DEB Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.4/DynamsoftServiceSetup-mips64el.deb)
88+
89+
<div class="multi-panel-end"></div>
90+
91+
<div class="multi-panel-switching-end"></div>
6992

7093
- Method 2. Click <a href="https://demo.dynamsoft.com/DWT/Resources/dist/cert.zip" target="_blank">here</a> to download the new certificate and use the new server.pem.ldsc & server_key.pem.ldsc to replace the old one in the `cert` folder under the service's [installation folder](/_articles/extended-usage/dynamsoft-service-configuration.md#installation-folder). Then restart Dynamic Web TWAIN Service.
7194

7295
- Method 3. [Contact Dynamsoft](/_articles/about/getsupport.md){:target="_blank"} for a new service installer for client-side. Please specify the exact service version build number found from the version your client currently has installed.
7396

7497
- Method 4. You can also generate the certificate by yourself. Check out this [post](/_articles/faq/change-dynamsoft-service-certificate.md).
75-
76-
<!--
77-
78-
- Method 4 (**<u>Convenience but not recommend</u>**). For v17.2 or higher versions, you can use the new API [UpdateCert](/_articles/info/api/Dynamsoft_WebTwainEnv.md#updatecert){:target="_blank"} to automatically update the client side certificate before it expires. **Please go to dynamsoft.webtwain.install.js file in the Resource Folder and search the keyword "OnSSLCertInfo"**, add the following lines of code:
79-
```javascript
80-
Dynamsoft.OnSSLCertInfo = function (sslExpiredDate) {
81-
if ((sslExpiredDate - new Date()) / 86400000 < 15) { // Automatically updates 15 days before expiration
82-
Dynamsoft.DWT.UpdateCert(
83-
"https://demo.dynamsoft.com/DWT/Resources/dist/cert.zip", //You may use your own URL to where the new certificate is placed.
84-
function () {
85-
//Success callback
86-
},
87-
function (errorCode, errorString) {
88-
console.log(errorString);
89-
}
90-
);
91-
}
92-
};
93-
```
94-
***Please be aware that the download may not work properly in all environments due to your company's security policy.***
95-
96-
97-
1) Go to service directory, and find _DSConfiguration.ini_.
98-
<ul>
99-
<li>Windows: C:\Windows\SysWOW64\Dynamsoft\DynamsoftService or C:\Windows\SysWOW64\Dynamsoft\DynamsoftServicex64_(version)</li>
100-
<li>macOS: Go > Applications > Dynamsoft > DynamsoftService > {installed version No.}</li>
101-
<li>Linux: opt/dynamsoft/DynamsoftService</li>
102-
</ul>
103-
104-
then add the following code lines in DSConfiguration.ini
105-
106-
```javascript
107-
//if you prefer to use your own valid certificate, change the local.dynamsoftwebtwain.com to your own address. As well as cert_name and key_name.
108-
[local.dynamsoftwebtwain.com]
109-
cert_name=server.pem.ldsc
110-
key_name=server_key.pem.ldsc
111-
```
112-
113-
2) Click <a href="https://tst.dynamsoft.com/public/download/dwt/newcert/newcert.zip" target="_blank">here</a> to download the new certificate and use the new server.pem.ldsc & server_key.pem.ldsc to replace the old one under [cert](/_articles/extended-usage/dynamsoft-service-configuration.md#for-the-service){:target="_blank"} folder.
114-
115-
If you use your own certificate, put your own cert and key under the cert folder.
116-
117-
Note: the new certificate from Dynamsoft will expire on September 23th, 2022. This means you will need to update the certificate again after this certificate expires.
118-
<br>
119-
120-
3) Call the following line in Resources/dynamsoft.webtwain.config.js to use the new certificate.
121-
```javascript
122-
// V15.3~16.2 uses
123-
Dynamsoft.WebTwainEnv.Host = 'local.dynamsoftwebtwain.com';
124-
125-
// V17.0+ uses
126-
Dynamsoft.DWT.Host = 'local.dynamsoftwebtwain.com';
127-
```
128-
-->

0 commit comments

Comments
 (0)