Deploy & Distribute

Environmental Requirements

Sever Side

Dynamic Web TWAIN runs 100% on the client-side, thus it doesn't matter what operating system runs on the server. The role of the server is to hold the Resources of the SDK and supply them when needed. No matter what web server is being used, you must make sure that it has the following MIME types set up correctly

Extension MIME Type Required by
.css text/css All Editions
.js application/javascript All Editions
.zip application/x-zip-compressed All Editions
.cab application/vnd.ms-cab-compressed ActiveX
.exe application/octet-stream ActiveX
.msi application/octet-stream HTML5 for Windows
.pkg application/pkg-mac HTML5 for macOS
.rpm audio/x-pn-realaudio-plugin HTML5 for Linux
.deb application/x-debian-package HTMl5 for Linux
Client Side

Check out About Editions


About the Running Services

On Windows

There are three always-running processes by default. All of them are called Dynamsoft Service and uses the same file DynamsoftService.exe. However they are started with different arguments.

The main process is started without any argument.

`C:\Windows\SysWOW64\Dynamsoft\DynamsoftService\DynamsoftService.exe`

Then there is a monitor process which is meant to monitor the main process and automatically start it in case it crashes

`C:\Windows\SysWOW64\Dynamsoft\DynamsoftService\DynamsoftService.exe -asmonitor Global\Dynamsoft_1.4_73769109_stop_service_event Global\Dynamsoft_1.4_73769078_certcheck_event`

The last always-running process is meant to support the SSL certificate for Firefox C:\Windows\SysWOW64\Dynamsoft\DynamsoftService\DynamsoftService.exe" "-certcheck" "1160" "Global\Dynamsoft_1.4_73770140_1_certcheck_event

Then each time you open a browser tab to use Dynamic Web TWAIN, two more processes will appear which are

  • Dynamsoft Service, also using the file DynamsoftService.exe. It's started like this

    "-scan" "\\.\pipe\dynamsoftscan_14.1_1160_52" "0" "Global\ss342249531_53_1160" "0" "C:\Windows\SysWOW64\Dynamsoft\DynamsoftService\dwt_trial_14.1.0.0828.dll"

  • Dynamsoft Scanning New Module which uses the file DSSCN.exe. It's started like this

    "-scan" "\\.\pipe\dynamsoftscan_14.1_1160_50" "1" "Global\ss342249250_51_1160" "0" "C:\Windows\SysWOW64\Dynamsoft\DynamsoftService\dwt_trial_14.1.0.0828.dll"

About the Distribution Files

Like any other libraries, you need to include the resource files of Dynamic Web TWAIN to use it in your project. The library is distributed as multiple JavaScript files, a CSS file and multiple binary files. From version 14.1, the files are organized as shown below

Resources
addon
dynamsoft.upload.js
dynamsoft.webtwain.addon.pdf.js
dist
DynamsoftServiceSetup.deb
DynamsoftServiceSetup.msi
DynamsoftServiceSetup.pkg
DynamsoftServiceSetup.rpm
LICENSE
dynamsoft.webtwain.config.js
dynamsoft.webtwain.css
dynamsoft.webtwain.initiate.js
dynamsoft.webtwain.install.js
Readme.txt

As you can see, there are more than 20 files. Depending on how you design your application, you can remove some of them to keep only the necessary files. The purpose of these files is detailed below to help you better understand them.

JavaScript, CSS, etc.
  • Readme.txt

    This file contains information about the resources files.

  • dynamsoft.webtwain.config.js

    This file is used to make basic configuration of Dynamic Web TWAIN. It's where you enter the product key for the product and to change the initial viewer size, etc.

  • dynamsoft.webtwain.initiate.js

    This file is the core of the Dynamic Web TWAIN JavaScript Library. You're not supposed to change it without consulting the Dynamsoft Support Team.

  • dynamsoft.webtwain.install.js

    This file is used to configure the dialogs which are shown when Dynamic Web TWAIN is not installed or needs to be upgraded. This file is already referenced inside the dynamsoft.webtwain.initiate.js

  • dynamsoft.webtwain.css

    This file contains the style definitions for all the elements of built-in image viewer, progress bar, dialogs, etc.

  • addon/dynamsoft.webtwain.addon.pdf.js

    This file contains the functionalities of the PDF Rasterizer addon. You're not supposed to change it without consulting the Dynamsoft Support Team.

  • addon/dynamsoft.upload.js

    This file defines the interfaces of the Dynamsoft Upload Module.

Binary files
Under dist/win/

The following files are for end users who use IE 10/11, Edge, Chrome or Firefox on Windows (Windows XP/7/8/2008/2012/2016 and 10; 32-bit and 64-bit)

  • DynamsoftServiceSetup.msi

    This Dynamsoft Service needs to be manually installed on end-user machine. For controlled environment, you can also use it to silently deploy the service to all end-user machines.

  • WinDWT_*_*.*.*.*.zip

  • WinDWT_*-*.*.*.*_x64.zip

    These .zip files contain the core scanning library which is TWAIN-based. Please keep it in the Resources folder on your HTTP server. The file will be automatically and silently deployed to the end-user machine once the Dynamsoft Service is installed. You must make sure that your HTTP server is able to serve .zip files.

  • DynamicWebTWAINModule.msi or DynamicWebTWAINModuleTrial.msi

    In case the automatic deplyment of the .zip files fails, a prompt will come up and provide this .msi file for end users to download and install the core scanning library.

The following files are for Windows end users who use IE 6/7/8/9. As these old versions of IE don't support HTML5 and still rely on the old ActiveX technology. We still provide the ActiveX to support them.

  • ActiveX/DynamicWebTWAINActiveX.exe

    This is the default package to be downloaded in an automatic prompt, the end user needs to install it manually.

  • ActiveX/WebTwainMSIX64.msi or WebTwainMSITrialX64.msi

  • ActiveX/WebTwainMSIX86.msi or WebTwainMSITrialX86.msi

    These .msi files are mainly designed for silent group deployment in a controlled environment.

  • ActiveX/DynamicWebTWAIN.cab and ActiveX/DynamicWebTWAINx64.cab

    These .cab files are Microsoft's legacy way to install ActiveX in Internet Explorer. If you prefer using them, you can set ActiveXInstallWithCAB to true in dynamsoft.webtwain.config.js.

  • Pdf.zip and Pdfx64.zip

    These files are used to install the PDF Rasterizer on the client machine.

Under dist/mac/

The following files are for end users who use Safari, Chrome or Firefox on mac OS (OS X 10.6.8+)

  • DynamsoftServiceSetup.pkg

    This Dynamsoft Service needs to be manually installed on end-user machine.

  • MacDWT_*.*.*.*.zip

    These .zip files contain the core scanning library which is TWAIN|ICA-based. Please keep it in the Resources folder on your HTTP server. The file will be automatically and silently deployed to the end-user machine once the Dynamsoft Service is installed. You must make sure that your HTTP server is able to serve .zip files.

  • MacPdf.zip

    This file is used to install the PDF Rasterizer on the client machine.

Under dist/linux

The following files are for end users who use Chrome or Firefox on Linux (Ubuntu 12.0.4+, Debian 8+, Fedora 24+, mint 18.3; 64-bit)

  • DynamsoftServiceSetup.deb or DynamsoftServiceSetup.rpm

    This Dynamsoft Service needs to be manually installed on Debian/Ubuntu/mint or Fedora end-user machine.

  • LinuxDWT_*.*.*.*.zip

    These .zip files contain the core scanning library which is SANE-based. Please keep it in the Resources folder on your HTTP server. The file will be automatically and silently deployed to the end-user machine once the Dynamsoft Service is installed. You must make sure that your HTTP server is able to serve .zip files.

  • LinuxPdf.zip

    This file is used to install the PDF Rasterizer on the client machine.

Under dist/serviceupdate
  • WinDSUpdate_14.1.0.0828.zip
  • WinDSUpdate_14.1.0.0828_x64.zip
  • MacDSUpdate_14.1.0.0828.zip
  • LinuxDSUpdate_14.1.0.0828.zip

    These files are used to update the Dynamsoft Service. The update is disabled by default but can be enabled by setting IfUpdateService to true in dynamsoft.webtwain.config.js.

results matching ""

    No results matching ""

    results matching ""

      No results matching ""