HOWTO: Configure Zetafax 9.1 and later with Windows 2000/3 terminal services
ZTN1371
ID: ZTN1371
This Zetafax technical note applies to:
- Zetafax 9.1 and later
- Windows 2000/3 terminal services (including the Citrix Metaframe 1.8/XP add-ons)
Summary
This document details how to deploy Zetafax in a Windows 2000/3 terminal services application server environment, and gives details of configuring Zetafax when using the Zetafax client and application within the terminal session.
NOTE: Equisys do not support the Zetafax server or email gateway installations when installed directly on the terminal server, but rather on a separate computer accessible via a network share. (Outlook extensions are supported as per ZTN1403
More information
The Zetafax client can be configured so that users can print, address and send a fax from an application in a terminal services session using the Zetafax client in the same session.
NOTE: For V 9.0.208 and V9.0.300 users you need to update to 9.1 before you begin. This can be downloaded from here Version 9 updates
NOTE: Version 9.1 users should also refer to this technical note to resolve an issue with the Zetafax client print control program. For more information please refer to ZTN1450 Print to fax addressing dialog is not presented in a terminal session running Zetafax 9.1
This fix has been rolled into all subsequent versions of Zetafax.
After you have downloaded (if required) these updates, in order that the Zetafax printer is available in the terminal session for users to 'Print to Fax' please do the following:
Installing the Zetafax Client: (This applies to all versions of Zetafax)
Note: The client must be installed directly on the terminal server and not from within an RDP session
1. Log onto the application server as the network administrator and run zfax\SYSTEM\WKSETUP.EXE, where 'zfax' is the name of the directory where the Zetafax files are installed.
2. Select the appropriate language then click OK.
3. At the welcome screen click Next> , then Next> again, and then Install. After the install wizard has completed the installation wizard click Finish.
4. The Zetafax printer and Zetafax program group will now be installed on the terminal server and be available to all users that have Zetafax user accounts.
Testing the installation:
1. Start a terminal services client session, logging on as a user with a valid Zetafax account.
2. Browse to the printers folder in the terminal session, highlight the Zetafax printer and go to File | Properties and then print a test page.
3. The addressing dialog box will popup and the Zetafax client should be started once the spooling has been completed, address the fax with a test fax number, confirm the options and then send.
NOTE: if you have any problems please refer to the troubleshooting section of this technical note.
How it works:
When the Zetafax client is installed on a standard Windows workstation, each user gets their own (local) installation of the Zetafax printer, which they can use to send documents to their (local) Zetafax client.
In an application server environment the situation is different. The Zetafax printer is installed on the application server and although any user in a terminal session can print to the printer, the printer process itself runs on the server, rather than in the user's session.
The printer therefore has no direct way of communicating with the user's Zetafax client, or of working out which directory to print its output file to.
To solve this problem we install a 'daemon' process, which is added to every user's start-up group so that it will always be running in any terminal session. The Zetafax printer is able to communicate with the daemon for the terminal session that requested the print job. The daemon in turn launches a control program in the user's session, which determines the correct directory for the print job and launches the Zetafax client for addressing if required. The printer prints to the user's individual 'temp' directory. This setting should not be changed under normal circumstances.
Troubleshooting
Is embedded addressing supported with terminal services?
Yes the embedded addressing feature is supported with the Zetafax printer within a terminal session with Version 9 and later, but please note that it is not supported on Windows NT 4 terminal servers.
When using Zetafax within terminal services how do I install the office addins?
If users wish to install the Zetafax office addins, each user then needs to install them by following the instructions in the Word document titled 'Installing the Zetafax Office Addins'. This document can be found in the Zetafax program group.
When I print a document to the Zetafax printer I do not get the Zetafax addressing dialog box, even if the Zetafax client is running
On printing the document to the Zetafax printer you should be presented with the Zetafax addressing dialog box, if not, this may be due to the 'daemon' process not running in the terminal session. To check for this, start Task Manager and check to see if ZFDAEMON.EXE is listed in the current processes. If it is not running then copy zfax\SYSTEM\I386\ZFDAEMON.EXE to the 'All users' startup group and restart the session.
References
ZTN1290 INFO Summary of Zetafax features supported in a terminal services environment
ZTN1132-HOWTO Configure Zetafax 7 with Windows 2000 terminal services (mixed mode)
ZTN1131-HOWTO Configure Zetafax 7 with Windows 2000 terminal services
ZTN1403 HOWTO Install Zetafax Outlook extension on a terminal server system
Last updated 03 November 2005 (LD/SV/EB)
Date published 05 July 2005 (SV/DH/EB)
Keywords < Terminal services> < Citrix> < ZFDaemon>