WAN Twain Device Interface

Wide Area Network ( WAN ) Twain Device Interface Setup (TWAINWAN)

This article also applies to running the software through Terminal Server on a LAN

Requirements:

	The Host and Remote Locations must connect through an operational VPN with NetBIOS browsing capability.
	Host Site must have a Windows 2000/2003 Server Standard or Enterprise Edition or NT40 Terminal Server. (NOTE: 2003 SBS Server Edition does not have terminal server capabilities.)
	Product Executable (i.e. EYEMD.EXE or EYECARE.EXE) dated 12/16/2005 (for 8.1) and 11/01/2004 (for 8.0) or later
	TWAINWAN.EXE and TWAINGET.EXE File Located in Advantage Product Directory. (TWAINGET.EXE is only required for the TWAINWAN.EXE dated 11/01/2005)
	Install your peripheral Locally using the installation page

Instructions:

The local workstation must have the same CBS environment variable name and value as the accessed session through Terminal Server or Citrix. The TWAINWAN.EXE software will use the local environment variable to create the correct naming for the data being transferred. CAUTION: The local workstation only needs the CBS variable. Do not add any other Advantage related variables.

The Terminal Server or Citrix environment for each User/Profile must have the environment variable TWAINWAN=Y. (variable name is TWAINWAN, variable value is Y) This variable can be added to the USER or SYSTEM environmental settings unless the server is using the TWAIN function locally. In that case only add this variable to the user variable.

Each local station at the remote sites will launch and leave open, minimized, the TWAINWAN.EXE at the startup. The TWAINWAN.EXE must be running directly from the server's mapped drive on the local station and not thru the session. Example: if X is the shared/mapped drive, then TWAINWAN.EXE would be launched during the Startup of the computer by a shortcut that points to X:\EYECARE\TWAINWAN.EXE. Compulink recommends adding this shortcut to the startup of the local workstation so it will launch automatically.

In the Terminal Server Session, the Device Specific (.DS) file path for the TWAIN device must be entered into workstation setup of the Compulink Advantage product. (example for insurance card reader: C:\Windows\twain_32\EdtCard\EDTCard.ds). All paths are automatically generated and stored in TWAINWAN.INI file located in C:\Windows sub-directory on the remote workstation's local hard drive. CAUTION: This file will be created automatically during the first launch of TWAINWAN.EXE. Should a device driver need to be changed the TWAINWAN.INI file must be deleted and recreated.

***** Do not use a TWAINWAN.EXE older than 7/18/2003 ******

Download TWAINWAN.EXE here Dated 7/18/2003 (Works with version 8.0)

For Version 8.1 or better download and replace the TWAINWAN.EXE and the TWAINGET.EXE and place in the product directory (\EYECARE or \EYEMD, etc.):

Download new TWAINWAN.EXE for 8.1 - Dated 11/01/2005 (Rename to TWAINWAN.EXE)

Download TWAINGET.EXE - (Rename to TWAINGET.EXE) Place in the product directory, i.e. \EYECARE or \EYEMD - This file and two DLLs should be automatically copied to the root of the local "C" drive of the workstation after it is launched the first time. If it does not, please manually place TWAINGET.EXE, CRDE2003.dll and ISP2003.dll in the root of the "C" of the local workstation.

Download TWAINGET with Executables dated 03/03/2006 or newer

Download TWAINWAN DLLs here - In case TWAINWAN or TWAINGET is crashing you may be missing the associated DLLs. Please make sure the following DLLs exist in the product directory without overwriting the existing DLLs.

Install your peripheral Locally using the installation page

Summary:

	Place TWAINWAN.EXE dated 7/18/2003 or newer in the product directory
	Map a drive to the shared product directory on the server at the remote workstation and place a shortcut in startup for TWAINWAN.EXE
	Remote client must have the same CBS ID (environment variable) as the Terminal Server session
	Add TWAINWAN=Y to the user or system variable of the session at the server
	Install your peripheral Locally using the installation page

Troubleshooting:

	Multi-page scanning over the WAN is not supported.
	TWAINWAN can't be launched after upgrade to 8.1. Some DLLs may be missing. Download the TWAINWAN DLL here but do not overwrite any existing DLLs.
	Can not map a drive over the VPN. A VPN does not usually forward broadcast packets across a network link. Make sure you can browse the network over the VPN. Consult your VPN hardware manufacturer on how to enable browsing over VPN. This is usually accomplished by a WINS server or an LMHOST file on the network.
	Error "cannot overwrite TWAINWANX.JPG".

Remote desktop connection must use the internal IP address of the server after a VPN tunnel is established.

Be sure you are using the TWAINWAN.EXE dated 7/18/2003

	If you receive an error message “can not open file” after the first scan, reduce the size/resolution of the scanned image. Images must be saved as Black/White 1bit or lowest possible resolution for images that need enhancements.
	Once all of the above is in place and you are still experiencing problems, make sure the Insurance card reader or other devices are set up correctly. For BizCard Reader setup instructions click here. For Visioneer Strobe XP 200 scanner click here. These document will provide general guidelines for installing most TWAIN devices.
	Do not place the TWAINWAN=Y on the local workstation. This variable is only for the server's session.
	Be sure the TWAINWAN.EXE is launched and minimized at the local station.
	TWAINWAN.EXE shortcut path must be "mapped drive letter:\folder\TWAINWAN.EXE" - example: X:\EYEMD\TWAINWAN.EXE.
	If logging in the domain, the user must have standard access to the local machine's registry. in user accounts, create another user with the same name as the user that is logging in to the domain and specify the domain.