Equisys technical notes

Technical guidance, explanations and fixes for our products

HOWTO: Install Zetafax Client Applications in a Terminal Services environment



ID: ZTN1688

This Zetafax technical note applies to:

  • Zetafax 2008 to Zetafax 2012 Platform Feature Pack


This technical note describes how to install the Zetafax Client Application on a Terminal Server so that the Zetafax Client and Office 2007 addins are available to all users.

More information

In Zetafax v2008 and later, the following components of the Zetafax Client Applications can be used in a Terminal Services environment:

  • Zetafax Client (inc. Zetafax Printer)
  • Outlook 2007 Extensions
  • Outlook 2010 Extensions
  • Word 2007 addin
  • Excel 2007 addin

To install the Zetafax Client Applications on a Terminal Server, please do the following:

Note: The installation must be done on the terminal server console and not through a session.

Additional Windows Server 2012 Terminal Server Steps

Systems using a Windows Server 2012 Terminal Server need to perform these additional steps before completing the steps below:

  1. Go to Server Manager in Windows Server 2012.
  2. Click on Add Roles and features. The Add Roles and Features Wizard is displayed.
  3. Click on the "Features" option in the "Select features" section and check the ".Net Framework 3.5 Features" and click "Install".
  4. You can now proceed with the setup steps below.

All Systems

  1. Log onto the Terminal Server machine locally as an Administrator.
  2. Bring up a command prompt.
  3. Type the following:
  4.       change user /install

  5. This puts the Terminal Server into install mode.
  6. Still at the command prompt, change to the folder that contains wksetup.exe and _zfclientrun.exe.
  7. Type the following:
  8.       cd prerequisites

          vcredist_x86.exe  (or vcredist_x64 if you are on a 64-bit machine)

  9. When the install of the pre-requisites has completed, type the following:
  10.       cd..

          _zfclientrun.exe /V" ALLUSERS=1 /L*v %TEMP%\ZFClientInstall.log"

  11. This runs the Zetafax Client Applications installer for all users.
  12. If you select the Custom install option, you should see the Zetafax Client, Outlook Integration and Office Addins as available features.  There should be no other components visible.
  13. Run through the installer UI as you would normally.
  14. When the installer is complete, type the following at the command line:

                  change user /execute

Last updated: 30th October 2008 (GR/MW)

Equisys Logo, Document Management and Expense Management for Business Central

Replaced by script