workshare professional 9

WORKSHARE PROFESSIONAL 9
INSTALLATION GUIDE
Version 2.0 | January 2015
WORKSHARE PROFESSIONAL INSTALLATION GUIDE
COMPANY INFORMATION
Workshare Professional Installation Guide
Workshare Ltd. (UK)
20 Fashion Street
London
E1 6PX
UK
Workshare Inc. (USA)
th
625 Market Street, 15 Floor
San Francisco
CA 94105
USA
Workshare Website: www.workshare.com
Trademarks
Trademarked names may appear throughout this guide. Instead of listing these here or inserting
numerous trademark symbols, Workshare wishes to state categorically that no infringement of
intellectual or other copyright is intended and that trademarks are used only for editorial purposes.
Disclaimers
The authors/publishers of this guide and any associated Help material have used their best efforts to
ensure accuracy and effectiveness. Due to the continuing nature of software development, it may be
necessary to distribute updated Help from time to time. The authors would like to assure users of their
continued best efforts in supplying the most effective Help material possible.
The authors/publishers, however, make no warranty of any kind, expressed or implied, with regard to
Workshare programs or Help material associated with them, including this guide. The authors/publishers
shall not be liable in the event of incidental or consequential damages in connection with, or arising out
of, the programs or associated Help instructions.
Copyright
© 2015. Workshare Ltd. All rights reserved. Workshare Professional and Workshare DeltaView are
registered trademarks of Workshare Ltd. Workshare Compare, Workshare Protect, Workshare 3,
Workshare DeltaServer, SafetyGain, and the Workshare logo are trademarks of Workshare Ltd. All other
trademarks are those of their respective holders.
2
WORKSHARE PROFESSIONAL INSTALLATION GUIDE
TABLE OF CONTENTS
Chapter 1.
Installation Overview .............................................................................................................7
Introducing this Guide ............................................................................................................................... 8
System Requirements ................................................................................................................................ 8
Certified Environments .......................................................................................................................... 8
Installation Guidelines ............................................................................................................................. 10
Workshare Installation Files .................................................................................................................... 11
Executables .......................................................................................................................................... 11
Update or Full Release? ................................................................................................................... 12
Prerequisite Components .................................................................................................................... 12
Windows Installer Packages ................................................................................................................ 13
Workshare PDF Publisher .................................................................................................................... 13
Important Information ............................................................................................................................ 14
Workshare Connect Registration......................................................................................................... 14
Workshare Configuration Assistant ..................................................................................................... 14
Re-Running the WCA ....................................................................................................................... 14
Workshare Microsoft Office Integration ............................................................................................. 15
Workshare OCR Functionality.............................................................................................................. 16
Chapter 2.
Installation on Single Workstation.......................................................................................17
Installing Workshare ................................................................................................................................ 18
Uninstalling Workshare ........................................................................................................................... 22
Chapter 3.
Licensing ..............................................................................................................................23
Licensing Workshare Professional ........................................................................................................... 24
One-Time Log In................................................................................................................................... 25
Create Accounts for Users ................................................................................................................... 26
Compare and Protect....................................................................................................................... 29
Viewing License InforMation ................................................................................................................... 30
Renewing a License.................................................................................................................................. 31
Suppressing Expiry Reminders ............................................................................................................. 32
Further Information ................................................................................................................................. 32
3
WORKSHARE PROFESSIONAL INSTALLATION GUIDE
Chapter 4.
Configuration .......................................................................................................................33
Introducing the Workshare Configuration Manager ............................................................................... 34
Administrator Mode and User Mode .................................................................................................. 34
Client Default Policy............................................................................................................................. 35
Accessing the Workshare Configuration Manager .................................................................................. 36
Searching Parameters .......................................................................................................................... 37
Setting Parameters .................................................................................................................................. 38
Recipient Checking .............................................................................................................................. 38
Deploying Configuration Settings ............................................................................................................ 39
Saving Configuration Files.................................................................................................................... 40
Loading Configuration Files ................................................................................................................. 42
Upgrading to Workshare 9 .................................................................................................................. 43
Registry Configuration ............................................................................................................................. 43
Convert Hyperlinks .............................................................................................................................. 43
Small Text Removal ............................................................................................................................. 44
Chapter 5.
Integration ...........................................................................................................................45
Introduction ............................................................................................................................................. 46
Document Management Systems ....................................................................................................... 46
Email Systems ...................................................................................................................................... 46
Document Management Systems Integration......................................................................................... 47
Autonomy iManage Integration – Configuring Server Integration ...................................................... 47
Adding File Types to the Autonomy iManage Server ...................................................................... 47
Adding the Workshare Compare Application to the Autonomy iManage Server ........................... 48
Adding Workshare Professional as a Class to Autonomy iManage Server ...................................... 49
Autonomy iManage Integration – Configuring Client Integration ....................................................... 50
Launching Applications within Autonomy iManage ........................................................................ 51
Creating a Workshare Compare Icon on the Autonomy iManage Desktop .................................... 52
Autonomy iManage Integration - Configuring Workshare .................................................................. 52
Hummingbird Integration – DM5 ........................................................................................................ 54
Adding Application and File Types to the DM5 Server .................................................................... 54
Making Workshare Compatible with DM5 ...................................................................................... 56
4
WORKSHARE PROFESSIONAL INSTALLATION GUIDE
Making the Workshare Compare Icon Appear on the Desktop and Within a User Profile ............. 57
Worldox Integration – Configuring Compare Files .............................................................................. 57
SharePoint Integration - Server Installation ........................................................................................ 59
SharePoint Integration - Client Configuration ..................................................................................... 61
SharePoint Site Configuration ......................................................................................................... 61
Email Systems Integration ....................................................................................................................... 62
Setting Up Microsoft Outlook .............................................................................................................. 62
Setting Up IBM Lotus Notes ................................................................................................................. 63
Resolving Email Addresses as Internal - Creating the Internal Domain List .................................... 63
Offline Mode .................................................................................................................................... 63
Issues with Custom Forms (Recipient Fields) .................................................................................. 65
Chapter 6.
Network Deployment ..........................................................................................................66
Overview .................................................................................................................................................. 67
Installation File Summary .................................................................................................................... 67
Deploying via the Command Line ............................................................................................................ 68
Configuring Modules During Installation ............................................................................................. 68
Registry ............................................................................................................................................ 69
DisableFeatures.ini .......................................................................................................................... 70
Installation Procedure with the Install Wizard .................................................................................... 70
Deploying Workshare with the Executable ..................................................................................... 70
Installation Procedure using the MSI Files Directly ............................................................................. 70
First Example Installation................................................................................................................. 71
Second Example Installation ............................................................................................................ 72
Compulsory Properties– Professional/Compare/Protect ................................................................ 72
Optional Properties – Professional/Compare/Protect .................................................................... 73
Optional Properties – Desktop Client .............................................................................................. 74
Citrix Installation Guidelines .................................................................................................................... 75
Enable Specific Users ........................................................................................................................... 75
Active Directory Deployment Guidelines ................................................................................................ 76
Assigned/Published to User Methods ............................................................................................. 76
Deploying Workshare Professional/Compare/Protect ........................................................................ 77
Deploying Workshare Desktop ............................................................................................................ 81
5
WORKSHARE PROFESSIONAL INSTALLATION GUIDE
Appendix A.
Additional Msiexec.exe Parameters and Switches ..............................................................85
MSIEXEC.EXE Parameters and Switches .................................................................................................. 86
Appendix B.
Default Profile ......................................................................................................................90
Workshare Default Profile ....................................................................................................................... 91
Document Conversion Policy ............................................................................................................... 91
Hidden Data Policy............................................................................................................................... 91
Hidden PDF Data Policy ....................................................................................................................... 92
Full Document Restriction Policy ......................................................................................................... 92
External Document Restriction Policy ................................................................................................. 92
For Internal Use Only Policy ................................................................................................................ 93
Confidential Policy ............................................................................................................................... 93
Highly Confidential Policy .................................................................................................................... 93
Appendix C.
Workshare Prerequisites .....................................................................................................94
Workshare Prerequisites ......................................................................................................................... 95
Summary .............................................................................................................................................. 95
Microsoft .NET Framework 4.5 ............................................................................................................ 95
Microsoft Visual C++ 2012 Redistributable Package (x86) .................................................................. 95
Microsoft Visual C++ 2012 Redistributable Package (x64) .................................................................. 95
Microsoft Visual Studio 2010 Tools for Office Runtime Setup ............................................................ 95
6
INSTALLATION OVERVIEW
CHAPTER 1. INSTALLATION OVERVIEW
This chapter provides an overview of the installation of Workshare Professional, Workshare Compare
and Workshare Protect as well as a list of system requirements. It includes the following sections:
• Introducing this Guide, page 8, explains what this installation guide covers.
• System Requirements, page 8, describes the system attributes required in order to install and run
Workshare Professional/Compare/Protect.
• Installation Guidelines, page 8, describes the recommended installation and deployment
procedure for Workshare Professional/Compare/Protect.
• Workshare Installation Files, page 11, describes the installation files and prerequisites for
Workshare Professional/Compare/Protect.
• Important Information, page 14, provides important information that should be read before
installing, configuring and deploying Workshare Professional/Compare/Protect.
7
INSTALLATION OVERVIEW
INTRODUCING THIS GUIDE
This Installation Guide describes how to install, license and integrate Workshare products into your
environment. It covers the installation of the following:
• Workshare Professional 9: Professional 9 helps you work on documents with other people. It is a
suite of products that includes Compare, Protect and Connect. You can install the full suite or
combinations of products, such as Compare and Connect or Protect and Compare.
• Workshare Protect 9: Protect 9 identifies and cleans metadata from documents, removing the
risk of unintentional data leakage. When sending emails, users can remove hidden sensitive
data, convert the documents to PDF or PDF/A and even replace attachments with a link to a
Connect where others can review them. Additionally, Protect provides the ability to set policies
to automatically clean attachments based on specific criteria.
• Workshare Compare 9: Compare 9 enables users to compare multiple documents to easily
identify and review changes. Users can accept or reject changes and apply them from within
Word or Workshare Compare. Documents can be compared from a DMS, CRM or Outlook.
Workshare Connect can be included in the Professional. Protect and Compare installations. Connect
extends comparison and protection functionality with online services, for example, comparisons as well
as Office documents can be securely saved and shared to Connect, and attachments can be replaced
with a secure link to the document in Connect. Connect also includes a desktop sync app – an application
that syncs content between Workshare Connect and your PC. At any time, you can access and review
your Connect content as well as add files.
SYSTEM REQUIREMENTS
The system requirements for Workshare Professional/Compare/Protect 9 are as follows:
Minimum System Requirements
Intel Pentium 4 3.2GHz processor
1.5GB RAM
1GB free disk space
Recommended System Requirements
Intel Core 2 DUO @ 2.2GHz
AMD Athlon 64 X2 4400+
2GB RAM
2GB free disk space
Certified Environments
Workshare Professional/Compare/Protect 9 have been tested and certified in a number of
environments. If your environment is not included in the following list, it may still be a compatible
environment. Contact Workshare Customer Support (support@workshare.com) for any help.
For details of which environments previous versions of Workshare Professional/Compare/Protect were
certified against, refer to previous versions of release notes on the knowledge base.
8
INSTALLATION OVERVIEW
Note: Unless otherwise stated, all environments are the English version with the en-us language set.
Operating System:
• Microsoft Windows 8.1 (32 bit and 64 bit) + Japanese
• Microsoft Windows 7 SP1 (32 bit and 64 bit) + Chinese Simplified & French
Citrix:
• With Microsoft Windows R2 Server 2012 (64 bit)
 Citrix XenApp 7.5
 Citrix XenDesktop 7.5
• With Microsoft Windows R2 Server 2008 SP1 (64 bit)
 Citrix XenApp 6.5
 Citrix XenDesktop 6.5
 Citrix XenDesktop 5.6
Note: Check with your Citrix vendor about which Windows operating system supports your version of
Citrix.
Microsoft Office System:
• Microsoft Office 2013 SP1 (32 bit) + Japanese
• Microsoft Office 2013 (32 bit) + Japanese
• Microsoft Office 2010 SP2 (32 bit) + Chinese Simplified & French
• Microsoft Office 2007 SP3 (32 bit)
Email System:
• Microsoft Outlook 2013 SP1 (32 bit) + Japanese
• Microsoft Outlook 2013 (32 bit) + Japanese
• Microsoft Outlook 2010 SP2 (32 bit) + Chinese Simplified & French
• Microsoft Outlook 2007 SP3 (32 bit)
• IBM Lotus Notes 9.0.1
• IBM Lotus Notes 9.0
Note: Interactive Protect and the replace email attachment with link feature of Workshare
Protect is not supported in a Lotus Notes environment.
Microsoft SharePoint:
• Microsoft SharePoint 2013 SP1
9
INSTALLATION OVERVIEW
DMS Integration:
Note: Check with your DMS vendor about which Windows operating system supports your DMS.
• NetDocuments
Note: The NetDocuments integration requires that Microsoft Internet Explorer is installed (the
NetDocuments login screen is displayed in an IE iframe) although it does not have to be the
default browser.
• Autonomy iManage:
 FileSite 9.0 Update 5 (+ EMM)
 FileSite 9.0 Update 4 (+EMM)
 DeskSite 9.0 Update 5
 DeskSite 8.5 SP3 Update 5/6
• Open Text:
 eDOCS DM 5.3.1 COM only (Patch 5)
 eDOCS DM 5.3 COM only (Patch 5 Rollup 4&5)
• Worldox GX3
Note: Workshare recommends WBGX Version ID: 6EB.688.D48 (Mar 28 2014) 11.0 or later.
Workshare will endeavor to support future service packs of certified environments.
INSTALLATION GUIDELINES
This guide will take you through a typical Workshare installation. The general steps involved are as
follows:
1. For DMS users, configure your DMS server and client (described in Chapter 5: Integration).
2. Install Workshare on a single workstation (described in Chapter 2: Installation).
3. Use the Workshare Configuration Manager (Administrator Mode) to configure Workshare as you
want it to work in your organization (described in Chapter 4: Configuration).
4. Save the configuration to a deployment script (reg or adm file) (described in Saving
Configuration Files in Chapter 4: Configuration).
5. Deploy the configuration across your network using a deployment script so that Workshare will
be configured uniformly across your organization.
6. Deploy Workshare across your network (described in Chapter 6: Network Deployment).
10
INSTALLATION OVERVIEW
It is recommended that you follow the guidelines listed below when installing Workshare to ensure a
smooth and trouble-free installation:
• Ensure that your system meets the recommended requirements for Workshare shown on page 7.
• Ensure that all important data is backed up prior to installation.
• Elevated/administrator privileges are required to install Workshare.
• Workshare MSI files should not be directly edited. Changes can be applied via a transform file
(.mst) or other method of applying properties such as command line parameters.
• Transform files may be created via any third party software that supports Windows Installer
technology.
• Workshare MSI files should not be repackaged. Certain custom actions that are contained in the
original MSI file may be missed and may also prevent future upgrades.
• Workshare MSI files should not be patched with in-house authored MSP files as this may cause
future upgrade issues and system instability.
• Additional customer specific files and Registry keys may be deployed alongside Workshare
software as long as they do not interact or replace any files or Registry keys belonging to the
product.
• No additional third party software should be bundled into any Workshare MSI.
If you have any queries about the installation of Workshare that are not dealt with in this guide, please
contact Workshare Customer Support.
WORKSHARE INSTALLATION FILES
This section describes the Workshare executables, Windows Installer Packages and shared components.
Executables
A single, downloadable self-extracting executable will install Workshare Professional or Workshare
Compare or Workshare Protect and (where necessary) the DMS integration. Workshare Professional and
Workshare Compare can be installed to work with your local file system or with your DMS.
The installation executables are as follows:
Executable
Installs….
Workshare.Professional.Bundle.exe
Workshare Professional (Compare, Protect and Connect)
Workshare.Compare.Bundle.exe
Workshare Compare
Workshare.Protect.Bundle.exe
Workshare Protect
On a single workstation, the easiest way to install Workshare is to simply run the install executable file
and answer any questions asked. Where a manual installation per computer is not feasible, you can
deploy Workshare to multiple workstations using methods described in Chapter 6: Network Deployment.
11
INSTALLATION OVERVIEW
Update or Full Release?
The Workshare installation files will depend on the type of release:
• Fast track fixes: Individual fast track fixes will be sent to individual customers via an MSP file.
• Fix rollups: An update which contains a roll up of all fast tracks created within the last 8-12 weeks
will be sent to all customers via an MSP, EXE or MSI file.
• Full product releases: Full product releases will be via MSI and EXE files only.
Prerequisite Components
The prerequisites for Workshare Professional/Compare/Protect 9 depend on the version of the operating
system and the version of Microsoft Office. They are described in the following table. Prerequisites for
other versions of Workshare Professional/Compare/Protect may be slightly different.
Workshare 9 is a native x86 application. It normally requires the x86 prerequisites for proper operation.
The exception is the Microsoft .NET Framework which must have the appropriate x86/x64 version
installed.
Prerequisite
Version
OS
Office
Notes
Microsoft .NET
Framework 4.5
4.5.50709.17929
Windows 7,
Server 2008,
Server 2008
R2
NA
Microsoft Visual C++
2012 Redistributable
Package (x86)
11.0.61030.0
All (including
x64 versions)
NA
Microsoft Visual C++
2012 Redistributable
Package (x64)
11.0.61030.0
x64 OS
versions
NA
The right-click handler is
written in x64 code and
requires this prerequisite.
Microsoft Visual Studio
2010 Tools for Office
Runtime Setup
10.0.40303.00
All
All
Visual Studio is NOT
required.
Note: Microsoft .NET Framework should be installed first. The other prerequisite components can be
installed in any order.
For further information about each prerequisite, refer to Appendix C: Workshare Prerequisites.
12
INSTALLATION OVERVIEW
Windows Installer Packages
If you need to extract the MSI and prerequisites from the executables, you can do so using the /layout
command. The Downloading Files and Prereqs dialog is displayed while the prerequisites and MSIs are
downloaded to the same location as the executable. The 4 prerequisite executables are put in a folder
called redist.
The following files are extracted from the executables:
Executable
Contents Extracted
Workshare.Professional.Bundle.exe
Workshare.Professional.msi
WorkshareCompareForPowerPoint.msi
Workshare.Desktop.msi
Redist folder including the prerequisite executables
(dotNetFx45_Full_x86_x64.exe, vcredist_x64.exe,
vcredist_x86.exe, vstor_redist.exe)
Workshare.Compare.Bundle.exe
WorkshareCompare.msi
WorkshareCompareForPowerPoint.msi
Workshare.Desktop.msi
Redist folder including the prerequisite executables
(dotNetFx45_Full_x86_x64.exe, vcredist_x64.exe,
vcredist_x86.exe, vstor_redist.exe)
Workshare.Protect.Bundle.exe
WorkshareProtect.msi
Workshare.Desktop.msi
Redist folder including the prerequisite executables
(dotNetFx45_Full_x86_x64.exe, vcredist_x64.exe,
vcredist_x86.exe, vstor_redist.exe)
If you install using an extracted MSI, you must first install all the prerequisite components described
above.
Workshare PDF Publisher
When Workshare Professional/Compare/Protect is installed it creates a printer called Workshare PDF
Publisher in the user’s Printers folder. This is the printer that Workshare uses to convert documents to
PDF.
13
INSTALLATION OVERVIEW
IMPORTANT INFORMATION
Workshare Connect Registration
When you include the Protect and Connect products in your Workshare installation and Protect is
configured to work with the Protect Profile dialog or Advanced Email dialog, your users will be registered
against your online Workshare Connect account. A validation email is sent to each user that has the
Protect client installed on their desktop. Only one automatic email is sent and only to these users.
The installation of Protect includes the installation of a Workshare add-in and when a user first runs
Outlook, Workshare obtains their email address and, if no account already exists, generates an account
on Workshare Connect using that email address. Users will be registered against your online Workshare
Connect account and a validation email is sent to each user.
If you do NOT want your users to receive a validation email, you can disable the License Activation
Emails option (Admin Console > Account Settings > Email Preferences) BEFORE deploying Professional
across your organization. This is done from the Workshare Admin Console - refer to
http://workshare.force.com/knowledgebase/articles/Help_Articles/Configuring-Activation-Emails
Note: Only if Protect and Connect are included in the installation and Protect is configured to work with
the Protect Profile dialog or Advanced Email dialog will a Workshare account be automatically created
for each user.
Workshare Configuration Assistant
The Workshare Configuration Assistant (WCA) is a program that completes the installation process. The
WCA is not optional as it performs actions that are required to correctly install the product. The install
process automatically runs the WCA silently.
Re-Running the WCA
Following installation, the WCA can be run as a separate executable for any of the following reasons:
• To update an installation, such as to make Workshare compatible with a new DMS
• To install/uninstall specific Workshare features
When re-run, the WCA provides information on the progress of installation and any necessary messaging
if any problems are encountered. If a problem is encountered, the user can access the online Workshare
knowledge base which provides an extended description and, where possible, a solution to resolve the
problem.
The executable is named WMConfigAssistant.exe and is found in the Modules folder of the installation
directory. To be run, the WCA requires administration rights to the workstation.
The WCA executable can be run from the command line, from within a DOS window or using a batch
(.bat) file. This should only be attempted by the network administrator or other qualified personnel. The
WCA can be run silently, without any user interface and quietly, with a reduced user interface.
14
INSTALLATION OVERVIEW
The WCA is also available from the Start Menu: Start > Programs > Workshare > Workshare Configuration
Assistant.
To run the WCA from the command line, the following syntax should be used:
“C:\Program Files\Workshare\Modules\WMConfigAssistant.exe” /INSTALL /SILENT
/LOGFILE=”\\InstallMachine\Workshare\Workshare.log”
Where the switches can be:
Switch
Value
SILENT
Indicates that the WCA is to be run silently, with no user interface.
QUIET
Indicates that the WCA is to be run with a reduced user interface.
LOGFILE
Name and location of the WCA log file. For example, LOGFILE=”\\server\share\
logfile.log”. The log file can either be stored at a shared location or stored locally on
the workstation.
If a location is not specified for the log file it will be written to the local TEMP folder.
By default the log file is named WorkshareConfig.log.
The WCA log file will provide details of all the steps the WCA has taken and can be
passed to Workshare if any difficulties are encountered.
The log file is appended to, not overwritten, in order to retain all logged
information. Therefore the latest details will be at the end of the log file.
NOTESINIFILE_
PATH
Location of the notes.ini file. This should be specified in non-standard IBM Lotus
Notes environments to ensure that Workshare components are added correctly to
the INI file by the install.
Note: The command must be entered on one line. You can use INSTALL, UNINSTALL, REINSTALL or
REPAIR as the preceding switch. The use of “ “ should be used where there is character spacing in file
paths.
Workshare Microsoft Office Integration
Workshare Professional/Compare/Protect can be installed with or without Microsoft Office integration.
If you want to change the integration of Workshare Professional/Compare/Protect with Microsoft Office
applications, go to the Control Panel, select the Workshare product and click Change. This will re-display
the installation dialogs and you can change your integration settings.
By configuring Workshare Professional/Compare/Protect to run without a Microsoft Office integration,
for example, by deselecting the Microsoft Word add-in, there will be no Workshare tab available in
Microsoft Word. In this case, the comparison functionality is only available from the Workshare Compare
application and the metadata removal functionality is only available when sending emails.
15
INSTALLATION OVERVIEW
Workshare OCR Functionality
Workshare Compare includes OCR technology to enable comparison of PDFs that have been created
directly from scanning. Where OCR has not been used and PDFs contain pure images of text, Workshare
Compare applies OCR to the PDFs before performing comparisons.
16
INSTALLATION OVERVIEW
CHAPTER 2. INSTALLATION ON SINGLE
WORKSTATION
This chapter describes the procedure for installing Workshare Professional/Compare/Protect on a single
workstation. It includes the following sections:
• Installing Workshare, page 18, describes the step-by-step procedure required to install
Workshare Professional/Compare/Protect on a single workstation.
• Uninstalling Workshare, page 22, describes how to uninstall Workshare
Professional/Compare/Protect.
The procedure for installing Workshare across a network is described in Chapter 6: Network Deployment.
17
INSTALLATION OVERVIEW
INSTALLING WORKSHARE
The following procedure explains how to install Workshare Professional, Workshare Compare and
Workshare Protect on a single workstation. Before beginning the installation procedure, make sure that
all other programs are closed and disable any anti-virus software.
There is no need to uninstall previous versions of Professional. With an upgrade, any customized settings
(public and user) are migrated whereas with a new install, the default settings are installed. If you are
uninstalling and performing a new install and want to keep your settings, you should back up your
configuration. Refer to Upgrading to Workshare .
During the installation of Workshare Professional, you can select which Workshare products to install
(Compare, Protect and Connect) and during all installations, you can select what Office integrations you
want. With a Workshare Professional, Compare and Protect installation, you can select which DMS
integration(s) (if any) to install - Hummingbird, Autonomy iManage, Worldox, SharePoint or
NetDocuments.
The installation executables are as follows:
Executable
Installs….
Workshare.Professional.Bundle.exe
Workshare Professional (Compare, Protect and Connect)
Workshare.Compare.Bundle.exe
Workshare Compare (Compare and Connect)
Workshare.Protect.Bundle.exe
Workshare Protect (Protect and Connect)
18
INSTALLATION OVERVIEW
To install Workshare:
1. Double-click the install executable. The Workshare Installer is displayed.
2. If you want to select particular products or integrations, click “or choose products to install”. If
not, jump to step 6.
 When installing Workshare Professional, the following is displayed:
19
INSTALLATION OVERVIEW

When installing Workshare Compare, the following is displayed:

When installing Workshare Protect, the following is displayed:
3. Select from the following as available and as required:
Compare: Installs Compare enabling you to compare documents.
Protect: Installs Protect enabling you to clean metadata from documents.
Connect: Installs Connect enabling you to save and share files to Workshare Connect as well as
synchronize between Connect and your desktop.
20
INSTALLATION OVERVIEW
Microsoft Outlook: Integrates the selected products within Microsoft Outlook.
Microsoft Word: Integrates the selected products within Microsoft Word.
Microsoft PowerPoint: Integrates the selected products within Microsoft PowerPoint.
Microsoft Excel: Integrates the selected products within Microsoft Excel.
4. Click Next. If you selected Compare or Protect, the following DMS Integration is displayed.
5. Select from the following as available and as required:
OpenText: Integrates the selected functionality within an OpenText DMS.
Microsoft SharePoint: Integrates the selected functionality within Microsoft SharePoint.
Autonomy iManage: Integrates the selected functionality within an Autonomy iManage DMS.
Worldox GX3: Integrates the selected functionality with Worldox.
NetDocuments: Integrates the comparison functionality with NetDocuments.
Note: Selecting a DMS here does not integrate Connect with the DMS. To integrate Connect
with a DMS, download the relevant file from the Services tab of the Connect Admin Console.
21
INSTALLATION OVERVIEW
6. Click Install. Workshare creates the necessary folders and copy files. The installation process
may take a few minutes. A progress bar indicates the progress of the installation.
7. After this process is completed, click Finish. This completes the installation of Workshare. For a
full description of the Workshare functionality, refer to the relevant Workshare User Guide.
Note: Ensure that the system user has write access to the policy sets folder - ProgramData/Workshare/
PolicySets.
UNINSTALLING WORKSHARE
Workshare Professional/Compare/Protect should be uninstalled using the Control Panel. Uninstalling
Workshare Professional/Compare/Protect will uninstall all the Workshare elements installed during the
installation process.
Note: The uninstall process will not uninstall any prerequisites installed.
22
LICENSING
CHAPTER 3. LICENSING
This chapter describes the installation and licensing procedure for installing Workshare on a single
workstation. It includes the following sections:
• Licensing Workshare Professional, page 24, describes the process for licensing your Workshare
product.
• Viewing License Information, page 29, describes where you can see your entitlements provided
by your license.
• Renewing a License, page 31, describes how to renew a Workshare license.
• Further Information, page 32, explains how to find out further information about licensing.
23
LICENSING
LICENSING WORKSHARE PROFESSIONAL
Licensing of Workshare is done via my.workshare.com. When purchasing a Workshare product, you are
required to create a Workshare Connect account. A license entitlement is created and assigned to the
account, waiting to be used.
The workflow here will depend on whether you are manually installing on a few computers only or
rolling out across a network.
Single Install
Network Deployment
24
LICENSING
One-Time Log In
The first time a user accesses Workshare functionality, for example, by clicking any option in the
Workshare tab, they are prompted to log in to Workshare Connect in order to retrieve their license
entitlements.
Note: They can also open the Workshare Configuration Manager, select the My Products tab and click
Sign in.
They must enter their Workshare Connect credentials (email address and password) and click Sign in.
The license entitlements for your account are retrieved and shown in the My Products tab of the
Workshare Configuration Manager.
Users who do not yet have a Connect account can click Create an account in the login dialog. Workshare
checks their email address and will automatically register them against your corporate Workshare
Connect account and update their license entitlement.
25
LICENSING
Create Accounts for Users
When you are deploying Workshare Professional across your network, you should first add your users to
your Workshare Connect account. Users need a Connect account so that they can log into Connect on
first use of Professional in order to validate their entitlement to Workshare products and receive their
Professional license.
Adding users to your Connect account is a simple process performed on the Connect Admin Console and
you may add them individually or up to 100 at one time using a CSV file. Users are people in your
network using one of your Workshare Connect licenses and all users share the same domain name.
Note: Any user who is part of your domain will be assigned to your company account even if they sign
up for a personal account.
Adding a user “invites” that user to your Workshare Connect account and they receive an email asking
them to validate their account and create a password for it. Only when the invited user validates their
account are they considered a licensed user on your account.
If you do not have access to the Admin Console, for example, you have only Compare installed with a
personal Connect account, you can create accounts for your users following the procedure in Compare
and Protect
To add multiple users:
1. Create a CSV file containing the user account information (up to 100 users). Ensure the file has
the following mandatory headers: “email address” and “first name”. You may also include the
following headers: “last name”, “job title” and “phone number”.
2. Go to my.workshare.com and log in to your account.
3. Click your user name in the Connect topbar.
4. Select Admin Console.
5. Select the User Management tab.
26
LICENSING
6. Click Add Bulk Users.
7. Click Choose File and browse to where you have saved your CSV file with all your user details.
8. Select the file and click Open.
9. In the Add Bulk Users window, click Import. The user details are added to your account and a
registration email is sent to all the email address specified, inviting them to validate their
Connect account.
27
LICENSING
To add a single user:
1. In the User Management tab of the Admin Console, select Add User.
2. In the E-mail field, enter an email address for the user – this must be from your registered email
domain.
3. In the First Name field, enter a name for the user.
Note: The default role for a user is that of User. If you want to create an administrator user
with access rights to the Admin Cconsole, select Account Admin from the Role dropdown list.
4. Complete the other fields and add a picture for the user if required. The user will be able to edit
these personal settings when they have validated their account. The user cannot change their
registered email address.
5. Click Add User. A registration email is sent to the email address specified and the user is invited
to validate their Connect account.
28
LICENSING
Compare and Protect
The Connect Admin Console is only available when you have a User Control or User & Data Control
account on Connect. When you are installing only Compare or Protect and you only have a personal
Connect account, you can create accounts for your users using the following link:
http://workshare.force.com/knowledgebase/CustomerUploads
To add users:
1. Click http://workshare.force.com/knowledgebase/CustomerUploads. This will display the
following page:
2. Create a CSV file containing the user account information (up to 100 users). Ensure the file has
the following mandatory headers: “email address” and “first name”. You may also include the
following headers: “last name”, “job title” and “phone number”.
3. Click Choose File and browse to where you have saved your CSV file with all your user details.
4. Select the file and click Open.
5. Enter your Connect login credentials in the Username and Password fields.
6. Click Import. The user details are added to your account and a registration email is sent to all the
email address specified, inviting them to validate their Connect account.
29
LICENSING
VIEWING LICENSE INFORMATION
Users can view license information in the My Products tab in the Workshare Configuration Manager. If it
is the first time a user has accessed Workshare functionality, they are prompted to log in to Workshare
Connect in order to retrieve their license entitlements.
The My Products tab shows the list of Workshare products that a user has a license for.
30
LICENSING
RENEWING A LICENSE
When a trial license or a term license is coming to an end, a reminder is displayed to all users when they
access any Workshare functionality.
One month before the license expires, a reminder (such as the example shown below) pops up on a daily
basis alerting you as to when the license expires.
Proceed in any of the following ways:
• Click Continue. You can continue using Workshare functionality and the reminder will be
displayed again on the following day.
• Click Purchase Now. You are directed to the Workshare online store where you can purchase a
new license.
• Select Don’t show again and click Continue. You can continue using Workshare functionality and
the reminder will not be displayed on a daily basis until 7 days before the expiry date when it will
again be displayed on a daily basis.
Once you have purchased your license, your entitlement details are updated in Connect and the button
in the reminder becomes Refresh. Click this and the reminder will close. All users in your account will
receive their entitlement from Connect and stop receiving popup reminders. There is no need for users
to log in to Connect.
31
LICENSING
If you do not renew your license before the expiry date, an expiry notice is displayed when you access
any Workshare functionality.
Now you can either click Purchase now to purchase a new license or Exit to close the expiry notice. If you
do not license your Workshare product, you will not be able to use any Workshare functionality.
Suppressing Expiry Reminders
If you want to stop users receiving license reminders so that only you (the administrator) receives a
reminder, you can set the following Registry key.
HKEY_LOCAL_MACHINE\SOFTWARE\Workshare\Options\9.0\General\GeneralAdmin SuppressNag=true
The user will no longer receive a licensing reminder during the 30 days prior to expiry although if a
license has expired and not been renewed, the user will still receive the expiry notice.
FURTHER INFORMATION
If you have any issues with this licensing process, contact your Workshare Customer Success Manager or
Workshare Sales or Workshare Support and ask about global licenses.
32
CONFIGURATION
CHAPTER 4. CONFIGURATION
This chapter describes how to use the Workshare Configuration Manager to configure Workshare
Professional/Compare/Protect. It includes the following sections:
• Introducing the Workshare Configuration Manager, page 34, provides an overview of the
Workshare Configuration Manager and how you can use it to customize Workshare behavior to
suit your organization’s requirements.
• Accessing the Workshare Configuration Manager, page 36, describes how to access the
Workshare Configuration Manager and its parameters.
• Setting Parameters, page 38, describes how to save configuration parameters to a configuration
file as well as deploy the configuration file to other Workshare workstations.
• Deploying Configuration Settings, page 39, describes how to save policy sets and distribute them
to other Workshare workstations.
• Registry Configuration, page 43, describes additional configuration performed directly in the
Registry.
33
CONFIGURATION
INTRODUCING THE WORKSHARE CONFIGURATION
MANAGER
The Workshare Configuration Manager is a separate configuration utility that enables you to configure
Workshare Professional/Compare/Protect and the way they behave as well as modify the configuration
of the default profile (via the parameters in the Protection category).
Note: A profile is a set of policies which contain parameters applied by Workshare Protect when
determining content risk.
Administrator Mode and User Mode
The Workshare Configuration Manager has two modes as follows:
• Administrator Mode: This mode should be used by administrators to make changes to the
default settings on the local machine. Settings made are saved in HKEY_LOCAL_MACHINE in the
Registry.
• User Mode: This mode should be used by users to make changes to the Workshare configuration
to suit their own personal preferences on the local machine. Other users could log in and they
would not have the same configuration settings. Settings made are personal to the user and
saved in HKEY_CURRENT_USER in the Registry.
When Workshare is installed, the default configuration settings (factory defaults) are included in the
installation and the Registry is empty of any of the Workshare Configuration Manager configuration
settings. Once an administrator clicks Apply to Local Machine in the Administrator Mode of the
Workshare Configuration Manager, the Registry (HKEY_LOCAL_MACHINE) is updated with any changes.
Once an administrator clicks Apply to Current User in the Administrator Mode of the Workshare
Configuration Manager, the Registry (HKEY_ CURRENT_USER) is updated with any changes. Additionally,
when a user clicks Apply in the User Mode of the Workshare Configuration Manager, the Registry
(HKEY_CURRENT_USER) is updated with any changes.
When determining what value to assign to each configuration parameter, or when generating the Client
Default policy, Workshare looks in the following locations in the following order:
1. HKEY_LOCAL_MACHINE just for the IgnoredUserOverrides key to see what parameters have
been locked by the administrator
2. HKEY_CURRENT_USER
3. HKEY_LOCAL_MACHINE
4. WMOption.dll which contains an XML file with the factory defaults
It is important to remember that a user’s preferences will take precedence over the default settings and
the factory defaults. However, configuration parameters can be locked so that a user is unable to change
the value of any given parameter.
34
CONFIGURATION
You can use Administrator Mode of the Workshare Configuration Manager to establish global settings
that standardize the use of Workshare across your organization. Once you have finalized the
configuration, you can save the settings as an ADM or REG file and deploy to the Workshare
workstations in your network. Refer to Deploying Configuration Settings, page 39.
Note: An ADM file is a group policy template file that can be rolled out using Group Policy. The ADM
configuration file can be created using the Workshare Configuration Manager or using the ADM files
supplied by Workshare.
The Workshare Configuration Manager can be installed as a standalone application if required. This
would enable you to establish a global set of configuration parameters and deploy them company wide.
As a standalone application, only the Administrator Mode of the Workshare Configuration Manager is
available.
The Workshare Configuration Manager – User Mode will only show those options which are applicable to
the modules which are currently configured for that user. The Administrator Mode will show all options
for Workshare Professional, Compare and Protect regardless of which product is installed and what
modules are configured.
Client Default Policy
When Workshare Protect is checking email attachments or open Microsoft Office documents for content
risk or metadata, it uses the Client Default policy to determine if there is a risk.
Note: When Interactive Protect is configured, Protect checks email attachments against settings in the
Registry.
The Client Default policy is a set of parameters configured in the Protection category of the Workshare
Configuration Manager and saved in a file called WorkshareClient.runtimepolicy file.
The WorkshareClient.runtimepolicy file is automatically generated from the Registry in the following
scenarios:
Action
Location of WorkshareClient.runtimepolicy
Workshare Installation
ProgramData/Workshare/PolicySets/ClientProfiles/Default
Re-running the Workshare Configuration
Assistant
ProgramData/Workshare/PolicySets/ClientProfiles/Default
Applying changes in Administrator Mode
of the Workshare Configuration Manager
ProgramData/Workshare/PolicySets/ClientProfiles/Default
Applying changes in User Mode of the
Workshare Configuration Manager
Users/[current user]/AppData/Roaming/Workshare/
PolicySets/ClientProfiles/Default
Changing Registry values in the Registry
which correspond to the Protection
category options
Users/[current user]/AppData/Roaming/Workshare/
PolicySets/ClientProfiles/Default
35
CONFIGURATION
Note: If you do not want the default policy files to be automatically regenerated in these scenarios,
ensure the Enable automatic generation of default profile parameter (Protection>Administration
category) is NOT selected. If this option is set off BEFORE the installation of Workshare, you must ensure
you have created and placed your own security policy in the Client Default folder in the
ProgramData/Workshare/PolicySets/ClientProfiles location.
When applying the Client Default policy, Workshare will look first in the User location (Users/[current
user]/AppData/Roaming/Workshare/PolicySets/ClientProfiles/Default) and if it does not find a
WorkshareClient.runtimepolicy file there, it will look in the Public location (ProgramData/Workshare/
PolicySets/ClientProfiles/Default).
Note: If you want to create additional security policies, you should use Workshare Policy Designer and
save each .runtimepolicy in a separate directory in ProgramData/Workshare/PolicySets/ClientProfiles.
ACCESSING THE WORKSHARE CONFIGURATION
MANAGER
When the Workshare Configuration Manager is installed as a standalone application, only the
Administrator Mode is available and it is accessed from the Start menu.
The Workshare Configuration Manager – User Mode can be accessed from within Microsoft Office or
from the Start menu.
To access the Workshare Configuration Manager from Microsoft Office:
1. In Microsoft Office, click Options in the Workshare tab, Options group. The Workshare
Configuration Manager opens in User Mode.
2. To access Administrator Mode, click Launch Administrator Mode.
To access the Workshare Configuration Manager from the Start menu:
• When the Workshare Configuration Manager is installed as a standalone application, from the
Start menu, select All Programs > Workshare > Workshare Configuration. The Workshare
Configuration Manager opens in Administrator Mode.
• When the Workshare Configuration Manager is installed as part of Workshare
Professional/Compare/Protect, from the Start menu, select All Programs > Workshare >
Workshare Configuration (User Mode). The Workshare Configuration Manager opens in User
Mode. To access Administrator Mode, click Launch Administrator Mode.
To access the Workshare Configuration Manager from Workshare Compare:
1. Open Workshare Compare.
2. From the Logo menu, select Configuration Manager. The Workshare Configuration Manager
opens in User Mode.
3. To access Administrator Mode, click Launch Administrator Mode.
36
CONFIGURATION
In Administrator Mode, the state of the options reflects the settings in HKEY_LOCAL_MACHINE in the
Registry.
Note: In order to access Administrator Mode, you must have local administrator rights. In Windows
Vista and above, when UAC (user access control) is enabled, the User Access Control dialog is displayed
when you click Launch Administrator Mode. If you do not have administrator rights, you can enter a
user name and password to elevate you to administrator. If you do have administrator rights, you need
to allow the Workshare Configuration Administrator Console (Workshare Configuration Manager) to
access this computer. Click Yes and Administrator Mode is launched.
The configuration parameters for Workshare are grouped into categories (such as Protection,
Comparison) and sub-categories (such as Administration, User Interface). In User Mode, categories are
available according to your installation – Workshare Professional, Workshare Compare or Workshare
Protect. Click a sub-category to display the parameters for that sub-category. The different subcategories and their parameters are described in Workshare Configuration Options.
Searching Parameters
If you know the name of a parameter (or part of its name) but not its location, you can search the
Workshare Configuration Manager using the search box on the top right.
37
CONFIGURATION
Click the parameter in the results list and the relevant category and sub-category is displayed in the
Workshare Configuration Manager.
SETTING PARAMETERS
Most parameters in the Workshare Configuration Manager are set by selecting or deselecting a
checkbox. There are also some that require you to enter a value in a text box.
To specify parameters:
1. In the Workshare Configuration Manager, select a category and then a sub-category.
2. Set a value for a parameter by selecting or deselecting the checkbox or by entering a value in the
text box.
3. Click the padlock icon to unlock/lock a parameter. When you lock a parameter, a user is not able
to change the setting.
Note: The
icon to the right of a parameter indicates that the parameter value has been
changed. In Administrator Mode, the green arrow deployment icon is shown when a parameter
will be included in a deployment script.
4. Continue to select categories and sub-categories and specify parameters as required.
5. Save your settings by clicking Apply to Local Machine. The Registry (HKEY_LOCAL_MACHINE) is
updated with any changes.
A confirmation message is displayed once the settings have been saved.
6. Click OK.
Note: The
icon is no longer displayed to the right of changed parameters but the green
arrow deployment icon will remain.
Recipient Checking
You can specify different metadata removal settings for email attachments sent internally and externally.
For example, you may want to remove all hidden data when sending emails externally, but only remove
track changes and hidden text when emailing internally. Workshare Protect determines whether a
recipient is external or internal as follows:
38
CONFIGURATION
Workshare Protect takes each recipient in the To, Cc and Bcc fields, and looks them up in the configured
address book(s). Usually this is the contacts list or local address book (on your machine) and the global
address book (on the server).
Note: To ensure that Workshare Protect can integrate with the local and global address books when
users are offline, please refer to Chapter 4: Integration.
For each address there are three possible outcomes:
• The address does not exist in any address book. This is then processed as external.
• The address is a distribution list. In this case, the address of each member of the distribution list is
checked.
• The address exists in one of the address books. If so, Workshare Protect does a further check that
checks the type of address. Either it will be an Exchange\Notes address (meaning the address
exists on the email server), or it will be an SMTP address (meaning the email will be routed via the
Internet). If it is a server address, it is processed as internal. If it is an SMTP address, it is
processed as external.
When deciding which metadata removal options to apply, each recipient is checked. If an external
recipient is found, external metadata removal settings are applied. Only if all recipients are internal, are
internal metadata removal settings applied.
Note: Using the Treat the specified addresses as internal (Outlook) parameter (Protection >
Administration category), you can specify external email addresses that you would like to be treated as
internal for the purpose of Workshare Protect applying policies.
DEPLOYING CONFIGURATION SETTINGS
In Administrator Mode, you can save the configuration settings as an ADM or REG file. This will enable
you to distribute these settings to other machines without having to manually set the options on each
machine. You set the configuration parameters for Workshare in a test installation or on any workstation
with the Workshare Configuration Manager installed, save the configuration settings in an ADM or REG
file and then deploy them to other Workshare workstations. This saves time and enables a consistency
within your organization.
Additionally, you can save the configuration settings as a WSO file (Workshare Options file). A WSO file
can be loaded in the Workshare Configuration Manager so you can restore the settings at some point in
the future. This enables you to keep a work-in-progress or project file.
Finally, Workshare has created ADM files which contain all the options and their default values. These
files are very similar to the files created by the Workshare Configuration Manager but contain
placeholders for unconfigured DMS server. Contact Workshare Customer Support for these files.
39
CONFIGURATION
Saving Configuration Files
Configuration settings are saved in Administrator Mode of the Workshare Configuration Manager.
To save configuration settings:
1. In Administrator Mode of the Workshare Configuration Manager, specify configuration
parameters as required. Refer to Setting Parameters.
2. Click the arrow on the Save button and select from the following:
 Save as Workshare Options: To save the settings in a WSO file which can be loaded/opened
in the Workshare Configuration Manager at a later time.
 Save Deployment Script: To save the settings in an ADM or REG file which can be used to
deploy to other workstations.
3. When selecting to save as a Workshare Options file, a Save As dialog is displayed.
4. Name the file as required, navigate to the save location and click Save. The settings are saved in
a WSO file which can be loaded in the Workshare Configuration Manager at a later time.
40
CONFIGURATION
5. When selecting to save as a deployment script, the Deployment Script Settings dialog is
displayed.
6. From the Environment dropdown list, select your environment.
7. From the Registry Target dropdown list, select where in the Registry you want to save the
settings.
Note: Selecting HKCU will replace any personalized settings configured by an individual user on
this machine.
8. From the Generate Script dropdown list, select the type of file to generate. You can create a
script:
 For all options. The resulting ADM or REG file will contain all options. A REG file will set
options that have been marked with the deployment icon and remove all other options by
deleting them from the Registry. This will revert them to the factory default on the target
machine. The ADM file will contain all the options and use the values defined by the
Administrator as the default values. Typically this is used for new deployments – it will
generate a script that will set options that have been changed from the factory defaults and
revert any unchanged options to the factory defaults on the target machine.
 For options with a deployment icon. The resulting ADM or REG file will only contain those
options indicated by a green deployment icon. No other options will be deployed or changed.
Typically this is used when upgrading an existing deployment – it will generate a script that
will only set options that have been changed (indicated by the green arrow icon) and will not
modify any unchanged options on the target machine.
41
CONFIGURATION
9. In the Save Location field, click the browse button.
10. Name the file as required, navigate to the save location.
11. From the Save as type drop down list, select ADM File or Registry Script as the file type.
12. Click Save.
13. Click Save in the Deployment Script Settings dialog. The settings are saved to the specified ADM
or REG file.
You can now deploy the REG file or use the ADM template to deploy settings to other individual
Workshare workstations.
Loading Configuration Files
If you have saved the configuration settings as a Workshare Options (WSO) file, you can open the saved
WSO file in the Workshare Configuration Manager. You can then update the settings on the local
machine or continue developing a set of configuration parameters for future deployment. The save and
re-load functionality enables you to keep a work-in-progress or project file.
42
CONFIGURATION
To load a configuration file into the Workshare Configuration Manager:
• In Administrator Mode of the Workshare Configuration Manager, click the arrow on the Load
button and select from the following:
 Load Workshare Options: Enables you to browse to a WSO file.
 Load Defaults: Resets all the parameters to their factory default settings.
 Load User Settings: Resets all the parameters to the settings specified in the running user’s
HKEY_CURRENT_USER Registry hive.
Note: When you provide user credentials to the UAC prompt then that user is the running user.
The selected settings are displayed in the Workshare Configuration Manager.
Upgrading to Workshare 9
By default, when you deploy Workshare Professional/Compare/Protect to machines which have earlier
versions of Workshare Professional/Compare/Protect, all existing settings and options are transferred –
whether they are user settings or public settings. If you don’t want to migrate the existing options and
settings to the Workshare 9 installation, you must deselect the following parameters in the General >
Administration category of the Workshare Configuration Manager:
• Backup and migrate the configuration for the Current Users
• Backup and migrate the default configuration for All Users
You must then save and deploy the configuration before installing Workshare 9. The installation of
Workshare Professional will then install with only the default.
REGISTRY CONFIGURATION
This section describes configuration of Workshare that is done by making changes in the Registry.
Important: If you use Registry Editor incorrectly, you may cause serious problems that may require you
to reinstall your operating system. Only system administrators should attempt to make changes in the
Registry.
Convert Hyperlinks
When converting documents to PDF files, the Workshare PDF driver does not by default convert
hyperlinks. Some PDF reader will convert hyperlinks within a PDF. If you want the Workshare PDF driver
to convert hyperlinks when creating the PDF, you need to create the Registry value
PDFFileNameOptionsEx in the Registry key SOFTWARE\Workshare\Options\9.00\Internal\PDF with a
string value of 0x00140091. Use HKEY_LOCAL_MACHINE to set an option machine-wide and
HKEY_CURRENT_USER to set an option for a user. Note that enabling this feature will impact
performance and will slow down the PDF conversion process. If you want to turn the Convert Hyperlinks
feature off, you should either remove this Registry value or change the Registry value to 0x00040091.
43
CONFIGURATION
Small Text Removal
When Workshare is configured to clean/delete small text (smaller than 5 points), it will check content for
half sizes as well as full sizes (4.5, 4, 3.5, 3, 2.5, 2, 1.5, 1, 0.5) and this may slow down the cleaning
process. If you want Workshare to just clean full point sizes (4, 3, 2, 1), you need to create the Registry
value HalfPointSmallTextSupport in the Registry key SOFTWARE\Workshare\Options\9.00\Protect
\ProtectAdmin with a string value of true. Use HKEY_LOCAL_MACHINE to set an option machine-wide
and HKEY_CURRENT_USER to set an option for a user.
44
INTEGRATION
CHAPTER 5. INTEGRATION
This chapter describes how to integrate Workshare with your email systems, DMSs and the Workshare
OCR Server. It includes the following sections:
• Introduction, below, introduces integrating Workshare with your email systems and DMSs.
• Document Management Systems Integration, page 47, describes how to integrate Workshare
with your Autonomy iManage, Hummingbird or SharePoint DMS.
• Email System Integration, page 62, describes how to integrate Workshare with your email
system.
45
INTEGRATION
INTRODUCTION
Document Management Systems
Workshare Professional 9, Workshare Compare 9 and Protect 9 have been tested and certified in a
number of DMS environments. If your environment is not included in the following list, it may still be a
compatible environment. Contact Workshare Customer Support (support@workshare.com) for any help.
Note: Unless otherwise stated, all environments are the English version with the en-us language set.
DMS Integration:
Note: Check with your DMS vendor about which Windows operating system supports your DMS.
• NetDocuments
Note: The NetDocuments integration requires that Microsoft Internet Explorer is installed (the
NetDocuments login screen is displayed in an IE iframe) although it does not have to be the
default browser.
• Autonomy iManage:
 FileSite 9.0 Update 5 (+ EMM)
 FileSite 9.0 Update 4 (+EMM)
 DeskSite 9.0 Update 5
 DeskSite 8.5 SP3 Update 5/6
• Open Text:
 eDOCS DM 5.3.1 COM only (Patch 5)
 eDOCS DM 5.3 COM only (Patch 5 Rollup 4&5)
• Worldox GX3
Note: Workshare recommends WBGX Version ID: 6EB.688.D48 (Mar 28 2014) 11.0 or later.
Workshare will endeavor to support future service packs of certified environments.
Email Systems
Workshare is certified with the following email systems:
• Microsoft Outlook 2013 SP1 (32 bit) + Japanese
• Microsoft Outlook 2013 (32 bit) + Japanese
• Microsoft Outlook 2010 SP2 (32 bit) + Chinese Simplified & French
46
INTEGRATION
• Microsoft Outlook 2007 SP3 (32 bit)
• IBM Lotus Notes 9.0.1
• IBM Lotus Notes 9.0
Note: Interactive Protect and the replace email attachment with link feature of Workshare
Protect is not supported in a Lotus Notes environment.
During installation, Workshare automatically detects your email system and configures itself to work
with that system. If you work with both Lotus Notes and Microsoft Outlook, Workshare is configured to
work with Lotus Notes.
Workshare will endeavor to support future service packs of certified environments.
DOCUMENT MANAGEMENT SYSTEMS INTEGRATION
Autonomy iManage Integration – Configuring Server Integration
In order to use Workshare with an Autonomy iManage DMS, you must add the Workshare file types and
the Workshare Compare application to the Autonomy iManage server so that the DMS can recognize and
work with Workshare files. Additionally, it is necessary to add Workshare as an Autonomy iManage class.
Adding File Types to the Autonomy iManage Server
This step includes adding the Workshare Compare file type (WDF), the Combine in Workshare file type
(WWB) and, if it is not already added, the Microsoft Word file type (DOC) to the Autonomy iManage
server.
Note: This must be done for all Autonomy iManage databases, regardless of whether the user has
permissions to a database or not.
To add file types to the Autonomy iManage server:
1. In the Autonomy iManage Database Management window, expand the tree on the left
underneath the database to be integrated with Workshare and select Type. A list of file types
recognized by Autonomy iManage is displayed on the right side of the window.
2. From the Manage menu, select Add. The Add Type dialog is displayed.
47
INTEGRATION
3. Complete the fields as shown below and click OK.
Workshare Compare file type (WDF):
Combine in Workshare file type (WWB)
4. Ensure that the Microsoft Word file type (DOC) appears in the list of recognized file types. If it
does not, complete the above steps to add it.
Adding the Workshare Compare Application to the Autonomy iManage
Server
This step includes specifying the location of the Workshare Compare executable file as well as identifying
the file types used by Workshare Compare. This is done for each Autonomy iManage database that will
be used with Workshare Compare.
To add the Workshare Compare application to the Autonomy iManage Server:
1. From the Start menu on the Autonomy iManage server, select Programs then Autonomy
iManage Server and then Database Administration. The Autonomy iManage Database
Management window is displayed.
2. Expand the tree on the left underneath the database to be integrated with Workshare and click
App Setup. A list of applications set up to work with Autonomy iManage is displayed on the right
side of the window.
3. From the Manage menu, select Add. The Add App Setup Entry dialog is displayed.
48
INTEGRATION
4. Complete the fields as shown below:
Note: Ensure the path points to the location of the Workshare Compare executable file. By
default, this is C:\Program Files\Workshare\Modules\DeltaVw.exe.
5. Click OK.
Adding Workshare Professional as a Class to Autonomy iManage Server
Adding Workshare files as a class (Compare class and Workshare Combine class) in the Autonomy
iManage server enables you to classify Workshare documents accordingly. This is done for each
Autonomy iManage database that will be used with Workshare.
If you do not want to add the Compare class to your Autonomy iManage server, you can specify your
own class for the WDF file. The class that you specify must exist on your server. Refer to the procedure,
To specify your own class, page 50.
To add Workshare as a class:
1. In the Autonomy iManage Database Management window, expand the tree on the left
underneath the database to be integrated with Workshare and select Class. A list of file classes
defined in Autonomy iManage is displayed on the right side of the window.
2. From the Manage menu, select Add. The Add Class dialog is displayed.
49
INTEGRATION
3. Complete the fields as shown below and click OK.
Compare class
Workshare Combine class
To specify your own class:
Set the Alternate Class Name parameter in the Workshare Configuration Manager (Integrations >
Autonomy iManage category). You set this parameter to specify the class that you want to use and
enable it by selecting the Use Alternate Class Name parameter. The class MUST exist on your Autonomy
iManage server.
Autonomy iManage Integration – Configuring Client Integration
There are several configuration procedures you may want to perform on an Autonomy iManage client
when integrating with Workshare Professional, as follows:
• Launching Applications within Autonomy iManage
• Creating a Workshare Compare Icon on the Autonomy iManage Desktop
50
INTEGRATION
Launching Applications within Autonomy iManage
This procedure is only relevant when the Autonomy iManage server application location is different from
your Local Application locations. Autonomy iManage would first use the local location of Workshare
Compare before using the server location.
To launch Workshare Compare, Microsoft Word and Rich Text Format files from Autonomy iManage you
have to add application information to Local Applications settings.
To add application information to Local Applications settings:
1. In the WorkSite ribbon in Outlook, select Local Applications. The Application Setup Information
dialog is displayed.
2. Click the Add button. The Add Local Application dialog is displayed.
3. Complete the fields as shown below:
4. Click OK to save the changes.
51
INTEGRATION
Creating a Workshare Compare Icon on the Autonomy iManage Desktop
In order to launch Workshare Compare via an icon within your Autonomy iManage desktop, follow the
procedure below.
To create a Workshare Compare icon:
1. Open Autonomy iManage.
2. Right-click the toolbar and select Customize. The Customize dialog is displayed.
3. Select the Commands tab.
4. Click and drag the Workshare Compare icon to the Autonomy iManage toolbar. The Workshare
Compare icon now appears on the Autonomy iManage toolbar.
Autonomy iManage Integration - Configuring Workshare
On installation, Workshare automatically copies the Autonomy iManage server settings specified for the
Autonomy iManage client. Workshare again retrieves the Autonomy iManage server settings at the
beginning of each DMS session to keep the list of servers up to date.
If you do not use Autonomy iManage trusted login (so that each user has a unique user name and
password to access the Autonomy iManage server), you must specify your Autonomy iManage user
name and password in the Workshare Configuration Manager.
52
INTEGRATION
To specify/modify Autonomy iManage server settings:
1. In Administrator Mode of the Workshare Configuration Manager, select the Integrations >
Autonomy iManage category.
2. To add details of a new server, click Add. An entry is added to the list of Autonomy iManage
servers in the Servers section.
3. In the Server Name field, enter the name of your Autonomy iManage server.
4. In the UserID and Password fields, enter the user login details that enable login to the specified
server. If you connect to your Autonomy iManage server using your Windows account, select the
TrustedLogin checkbox only.
5. Select the AutoLogin checkbox to automatically connect to the server and authenticate the user
at startup. If you do not select this checkbox, the server can be registered but will not be
authenticated at startup. This may be useful in a multi-server environment when you want to
save the overhead of authenticating all the servers at startup.
Note: If a document ID is passed to a Workshare product for a document on a server for which
it has details (a registered server) but to which it is not connected, then the Workshare product
will automatically connect to that referenced server.
6. Click Test to confirm connection to the specified server.
53
INTEGRATION
To delete a server from the list, click Remove to the right of the server details. To modify details of an
existing server, edit the details in the Servers list.
Hummingbird Integration – DM5
In order to use Workshare with a Hummingbird DMS, you must add the necessary Workshare file types
and identify Workshare Compare as an application in the DMS server so that the DMS can recognize and
work with Workshare files. Additionally, the Workshare Professional, Workshare Compare and the
Microsoft Word applications must be made ‘compatible’ with the Hummingbird DMS.
Note: The Hummingbird server integration procedures only need to be performed once per
Hummingbird server. The procedures can be performed from the server or client machine.
Adding Application and File Types to the DM5 Server
This step includes adding the required file types used by Workshare - the Workshare Compare WDF file
type and the Combine in Workshare WWB file type as well as specifying the location of the Workshare
Compare executable file. The procedure described below is performed from the DM5 client machine.
To add application and file types to the DM5 server:
1. From the Start menu, select Open Text > DM Server > Server Admin Tools > Library
Maintenance. The Library Maintenance window is displayed.
2. Click Applications and then click New. The Application Maintenance dialog is displayed.
3. Complete the fields as shown below:
Note: For PDF Combine, enter application/dcwin as the MIME Type.
Note: To add the file type, click the browse button and click Add in the dialog displayed. Enter
WDF or WWB in the Extension field and Workshare Deltafile or Workshare Combine in the
Description field and click OK and then OK again.
54
INTEGRATION
4. Click OK. The specified application now appears in the list of applications.
5. Double-click the new DeltaView/Combine entry to display the Application Maintenance dialog
again.
6. Click the Launch Methods button. The Application Launch Methods dialog is displayed.
7. Click the New button. The Application Launch Methods dialog is displayed.
Note: If you already have Workshare DeltaView 2.9 or earlier configured, you should create a
separate launch method for Workshare Compare.
8. In the Location field, enter the location of the Workshare Compare/Combine executable file. By
default, this is C:\Program Files\Workshare\Modules\DeltaVw.exe or
Workshare.Pdf.Combine.exe.
9. In the Command Line Parameters field, %FULLPATH /PathEncode=powerDOCS.
Note: Do not forget to enter a space between FULLPATH and the forward slash.
10. From the Integration dropdown list, select ODMA Compliant.
11. Ensure the Enabled checkbox (top right) is selected.
55
INTEGRATION
12. Click OK, and then Close.
Making Workshare Compatible with DM5
In order for files created in Workshare to be retrieved from DM5, Microsoft Word and Workshare
Compare must be made "compatible applications" with DM5.
To make Microsoft Word a compatible application:
1. In the Library Maintenance window, double-click DeltaView.
2. Click Compatible Apps. The Compatible Applications dialog is displayed.
3. From the Non-Compatible Apps. list, select MS Word and click Add. Microsoft Word is added to
the Compatible Apps. list.
4. Click OK, and then OK again.
To make Workshare Compare a compatible application:
1. In the Library Maintenance window, double-click MS Word.
2. Click Compatible Apps. The Compatible Applications dialog is displayed.
3. From the Non-Compatible Apps. list, select DeltaView and click Add. Workshare Compare is
added to the Compatible Apps. list.
4. Click OK, and then OK again.
56
INTEGRATION
Making the Workshare Compare Icon Appear on the Desktop and Within a
User Profile
This section describes how to place the Workshare Compare icon on the DM5 desktop as well as within a
user profile.
To add the Workshare Compare icon:
1. In the Library Maintenance window, double-click DeltaView.
2. Click Options. The Application Options dialog is displayed.
3. Select the Shows on Desktop and Valid on Profile checkboxes.
4. Click Close.
Worldox Integration – Configuring Compare Files
After installing Workshare Professional, you can configure the Worldox Compare Files option (available
in the Worldox toolbar and the right-click menu) so that it works with Workshare.
To configure Compare Files in Worldox:
1. In Worldox, click Compare Files (in the toolbar or via the right-click menu).
2. Click Properties to the right of the Compare using field.
57
INTEGRATION
3. Click Add.
4. In the Compare Program Description field, enter a description such as “Workshare Compare”.
5. Click Browse and browse to the Module folder in the Workshare installation folder.
6. Select Workshare.Worldox.Connector.exe and click OK.
7. In the Pass Parameters field, enter /original=%o /modified=%n.
8. Click OK.
9. Click Close.
Now you can run a comparison using Workshare Compare.
Once you have completed this configuration, right-clicking a file in Worldox or selecting a file and clicking
Compare Files, will display the above dialog with Workshare Compare selected as the application to use
for the comparison.
58
INTEGRATION
SharePoint Integration - Server Installation
In order to use Workshare with SharePoint, the Workshare Professional Extension for SharePoint must
be installed on Microsoft Windows Server 2008 (or later) running Microsoft Windows SharePoint
Services 3.0 (or later).
Before beginning the installation procedure, make sure that all other programs are closed and disable
any anti-virus software.
To install Workshare Professional Extension for SharePoint:
1. Locate the installation package Workshare.Connect.SharePoint.WebService.x64/x86.msi and
double-click to start the installation wizard. The installation welcome screen is displayed.
59
INTEGRATION
2. Click Next.
3. Select the bin folder in the SharePoint virtual directory where Workshare Professional Extension
for SharePoint will be installed. By default this is located at
C:\lnetpub\wwwroot\wss\VirtualDirectories\
80\bin.
4. Click Next.
60
INTEGRATION
5. Select the SharePoint ISAPI directory where the Workshare Professional Extension for
SharePoint web services will be installed. By default, this is located at C:\Program Files\Common
Files\Microsoft Shared\web server extensions\12\ISAPI\.
6. Click Next.
7. Click Next to begin installation or click Back button to change any installation settings.
8. Once the installation has completed, click Finish.
SharePoint Integration - Client Configuration
The SharePoint Integration for Workshare is provided as part of the Workshare installation package and
requires a small amount of configuration on the client to specify SharePoint sites and servers that will be
accessed from Workshare.
SharePoint Site Configuration
When comparing documents, users can select documents from a SharePoint site. The sites available for
selection have to be configured in the Workshare Configuration Manager.
61
INTEGRATION
To configure SharePoint sites:
1. In Administrator Mode of the Workshare Configuration Manager, select the Integrations >
Microsoft SharePoint category.
2. Click Add. An entry is added to the list of SharePoint sites in the Servers section.
3. In the text box, enter the complete URL for the SharePoint site location.
4. From the Metadata Cleaning Policy dropdown list, select how the site is to be considered for
policy application purposes. If you select Internal Cleaning Policy, documents at the specified
SharePoint site will be treated similarly to documents emailed internally. If you select External
Cleaning Policy, documents at the specified SharePoint site will be treated similarly to
documents emailed externally.
5. Click Test to confirm connection to the specified site.
To delete a site from the list, click Remove to the right of the site details. To modify details of an existing
site, edit the details in the Servers list.
EMAIL SYSTEMS INTEGRATION
Workshare uses the mail server address book to determine if recipients are internal or external, and
applies particular settings as a result. Therefore if you want to use Workshare Protect to protect your
documents while working offline, you need to ensure your machine is set up to enable recipients to be
resolved correctly.
If a copy of your mail server address book is not available locally, all recipients are treated as external.
The following sections describe how to create a local copy of your mail server address book in different
email clients.
Setting Up Microsoft Outlook
For Workshare Protect to work correctly with Microsoft Outlook in offline mode, you simply need to
enable offline mode (as specified in the Microsoft Outlook documentation), and ensure that you
download the server address book.
To download the server address book:
1. From the Tools menu, select Send/Receive and then Download Address Book.
2. Select to download the address book.
3. Select to download full details.
4. Ensure the correct server address book is selected.
62
INTEGRATION
Setting Up IBM Lotus Notes
Resolving Email Addresses as Internal - Creating the Internal Domain List
Workshare categorizes the routing of email messages as either Internal or External to determine which
policies to apply. Internal addresses are identified based on the recipient’s domain. For Workshare to
recognize the domain as internal, the internal domain list need to be populated with the value of the
recipient’s domain as it appears on the person's detail page in the Domino directory.
To set the internal domains:
The Internal Domain List can be set in the Workshare Configuration Manager (Protection >
Administration category). If more than one domain is required then the values should be separated with
a semicolon (;), for example, "Domain 1;Domain 2". The value is not case sensitive.
Offline Mode
For Workshare Protect to work correctly with Lotus Notes in offline mode, you need to set up the client
to work offline (as specified in the Lotus Notes documentation), and set up the Mobile Directory Catalog
on the Lotus Domino server. You must then replicate the Mobile Directory Catalog on the Lotus Notes
client.
63
INTEGRATION
Setting Up the Mobile Directory Catalog on the Lotus Domino Server
This step involves creating the database (Mobile Directory Catalog), configuring the database and then
loading the database.
To create the Mobile Directory Catalog:
1. From the File menu, select Database and then New.
2. Next to Server, select the Dircat server you picked to aggregate the directory catalog.
3. Next to Title, enter a title for the directory catalog (Mobile Directory Catalog).
4. Next to Filename, enter a file name for the catalog (‘MobileDC.nsf’).
5. Select Create full text index for searching.
6. Change ‘Template Server…’ to Domino server.
7. Select Show advanced templates.
8. Below Template server, select a server that stores the Directory Catalog template, and then click
OK.
9. Select the Directory Catalog (DIRCAT5.NTF) template.
10. Click OK.
To configure the Mobile Directory Catalog:
1. In the database you created (Mobile Directory Catalog), select Create and then Configuration.
2. Complete the following fields in the Directory Catalog Configuration document:
 Change Directories to include to include the Domino Directories the Dircat task aggregates
(Names.nsf).
 Change Additional fields to include to include MailSystem.
3. Click Save and Close.
To load the Mobile Directory Catalog:
• From the Lotus Domino Server Administrator run the command Load Dircat database to build the
condensed Directory Catalog (Load DirCat MobileDC.nsf).
Replicating the Mobile Directory Catalog on the Lotus Notes Client
This step involves replicating the Mobile Directory Catalog on the Lotus Notes client and setting up the
client to use the Mobile Directory Catalog for name resolution.
To replicate the Mobile Directory Catalog:
1. From the File menu, select Database and then Open.
2. In the Open Database dialog, change the Server to the Domino server and the Database to
Mobile Directory Catalog and click Open.
3. While the Mobile Directory Catalog database is open, from the File menu, select Replication and
then New Replica.
64
INTEGRATION
4. Verify that the server is Local and the file name and title is for the Mobile Directory Catalog
(MobileDC.nsf) and click OK.
To set up the client to use the Mobile Directory Catalog for name resolution:
1. From the File menu, select Preferences and then User Preferences.
2. Select Mail and News.
3. Modify the Local Address Books and add the Mobile Directory Catalog to the existing list
(names.nsf, MobileDC.nsf).
4. Click OK.
Note: This step can only be completed if the Mobile Directory Catalog exists. See Setting Up the Mobile
Directory Catalog on the Lotus Domino Server, page 64.
Issues with Custom Forms (Recipient Fields)
If you work with custom forms and you modify recipients, you should be aware of which address fields
Workshare Protect uses to resolve recipients as internal or external.
In order to determine the internal/external classification of a destination, only the following fields
relating to recipients are extracted from the form by the EM_MAILSENDNOTE event:
• EnterSendTo
• EnterCopyTo
• EnterBlindCopyTo
If you use custom forms, you should note that the fields Recipients, SendTo, CopyTo and BlindCopyTo
are not resolved.
65
NETWORK DEPLOYMENT
CHAPTER 6. NETWORK DEPLOYMENT
This chapter describes how to install and license Workshare across your network. It includes the
following sections:
• Overview, below, introduces the options available for installing Workshare across a network.
• Deploying via the Command Line, page 68, describes the steps required to use the command line
to install and license Workshare across your network.
• Citrix Installation Guidelines, page 75, describes how to install Workshare on Citrix.
• Active Directory Deployment Guidelines, page 76, describes how to deploy Workshare using
Active Directory.
66
NETWORK DEPLOYMENT
OVERVIEW
Deploying Workshare across your network means installing your Workshare products on all workstations
in your network. Workshare can be deployed across your network using the Workshare command line
installation or third party deployment products.
If you want to deploy specific configuration settings with Workshare, you must use a REG file or an ADM
template. Refer to Chapter 3: Configuration. It is recommended to deploy the configuration settings prior
to the Workshare installation.
The executables download prerequisites from the Internet if they are required. For enterprise
deployments, the prerequisites can be extracted from the executables using the /layout command.
Refer to Windows Installer Packages.
Installation File Summary
The installation requires the following prerequisites:
Prerequisite
Version
OS
Office
Notes
Microsoft .NET
Framework 4.5
4.5.50709.17929
Windows 7,
Server 2008,
Server 2008
R2
NA
Microsoft Visual C++
2012 Redistributable
Package (x86)
11.0.61030.0
All (including
x64 versions)
NA
Microsoft Visual C++
2012 Redistributable
Package (x64)
11.0.61030.0
x64 OS
versions
NA
The right-click handler is
written in x64 code and
requires this prerequisite.
Microsoft Visual Studio
2010 Tools for Office
Runtime Setup
10.0.40303.00
All
All
This prerequisite is
required to run Microsoft
Office based solutions
built using Microsoft
Visual Studio 2010, 2012,
and 2013.
Visual Studio itself is NOT
required to install
Workshare.
Note: Microsoft .NET Framework should be installed first. The other prerequisite components can be
installed in any order.
For further information about each prerequisite, refer to Appendix C: Workshare Prerequisites.
67
NETWORK DEPLOYMENT
The extracted files include the following Workshare MSI packages:
Executable
Contents Extracted
Workshare.Professional.Bundle.exe
Workshare.Professional.msi
WorkshareCompareForPowerPoint.msi
Workshare.Desktop.msi
Redist folder including the prerequisite executables
(dotNetFx45_Full_x86_x64.exe, vcredist_x64.exe,
vcredist_x86.exe, vstor_redist.exe)
Workshare.Compare.Bundle.exe
WorkshareCompare.msi
WorkshareCompareForPowerPoint.msi
Workshare.Desktop.msi
Redist folder including the prerequisite executables
(dotNetFx45_Full_x86_x64.exe, vcredist_x64.exe,
vcredist_x86.exe, vstor_redist.exe)
Workshare.Protect.Bundle.exe
WorkshareProtect.msi
Workshare.Desktop.msi
Redist folder including the prerequisite executables
(dotNetFx45_Full_x86_x64.exe, vcredist_x64.exe,
vcredist_x86.exe, vstor_redist.exe)
All Workshare products are installed on a per machine basis.
DEPLOYING VIA THE COMMAND LINE
You can use the executable file or the MSI files found within the executable file to install Workshare from
the command line.
Configuring Modules During Installation
In a Workshare Professional installation, the Compare, Protect and Connect modules (products) are
installed by default and additionally, Microsoft Office integration is installed by default. During the
command line install, you can customize the module selection by setting Registry values.
In a Workshare Compare installation, the Compare module is hard-coded into the installation and
Microsoft Office integrations is installed by default. During the command line install, you can customize
the Connect, Office and DMS integration selection by setting Registry values. You cannot customize the
Compare module.
In a Workshare Protect installation, the Protect module is hard-coded into the installation and the
Connect, Office and DMS integrations are installed by default. During the command line install, you can
customize the Connect and Office integration selection by setting Registry values. You cannot customize
the Protect module selection.
68
NETWORK DEPLOYMENT
Registry
The Registry location HKEY_LOCAL_MACHINE\SOFTWARE\Workshare\Install contains DWORD values
which can define the module state.
Module
Registry Value
DWORD
Value
Available In
Autonomy iManage
ProfInterwovenModule
1
Professional, Compare &
Protect
Compare
ProfCompareModule
1
Professional
Connect
ProfConnectModule
1
Professional, Compare &
Protect
Hummingbird
ProfHummingbirdModule
1
Professional, Compare &
Protect
Microsoft Excel
Integration
OfficeExcelIntegration
1
Professional, Compare &
Protect
Microsoft Outlook
Integration
OfficeOutlookIntegration
1
Professional, Compare &
Protect
Microsoft
PowerPoint
Integration
OfficePowerPointIntegration
1
Professional, Compare &
Protect
Microsoft Word
Integration
OfficeWordIntegration
1
Professional, Compare &
Protect
NetDocuments
ProfNetDocumentsModule
1
Professional, Compare &
Protect
Worldox
ProfWorldoxModule
1
Professional, Compare &
Protect
Protect
ProfProtectModule
1
Professional
SharePoint
ProfSharepointModule
1
Professional, Compare &
Protect
For instance, the following example Workshare Professional Registry script would enable Compare and
Protect and Connect and NetDocuments and disable SharePoint, Hummingbird, Autonomy iManage and
Worldox:
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Workshare\Install]
"ProfCompareModule"=dword:00000001
"ProfProtectModule"=dword:00000001
“ProfConnectModule”=dword:00000001
"ProfHummingbirdModule"=dword:00000000
"ProfInterwovenModule"=dword:00000000
69
NETWORK DEPLOYMENT
"ProfSharepointModule"=dword:00000000
“ProfNetDocumentsModule”=dword:00000001
"ProfWorldoxModule"=dword:00000000
Information in a Registry script can be imported into the Registry using regedit.exe. Assuming that the
above Registry script is in WorkshareModuleState.reg, you could import it into the Registry silently by:
Regedit /s <path to shared directory>\WorkshareModuleState.reg
DisableFeatures.ini
The DisabledFeatures.ini file is no longer supported for installations of Workshare.
In previous versions of Workshare, the module state could be controlled with an INI file called
DisabledFeatures.ini in the installation directory. This INI file has no effect on the installation.
Installation Procedure with the Install Wizard
The Workshare install contains the Workshare Install Wizard and Workshare installs. The Workshare
Install Wizard examines the client desktop, downloads any prerequisites not present, installs the
prerequisites and installs and configures the Workshare installs.
Deploying Workshare with the Executable
As an example, the following procedure describes how to install Workshare Professional using the
Workshare.Professional.Bundle.exe executable.
To install Workshare using the executable:
1. Create a shared directory with relevant permissions so that client machines can access the
Workshare executable during the installation.
2. Copy the executable to the shared directory.
3. The default module state is to install the Compare, Protect and Connect modules. You can
change the installed module state by running a Registry script on the client to set the required
module install state before installing the executable.
4. Run the executable on the client desktop. This will extract the files to the client and run the
Install Wizard on the client machine. Parameters passed to the executable are passed on to the
Install Wizard. The command line is:
<path to Workshare.Professional.Bundle.exe > [/silent]
Installation Procedure using the MSI Files Directly
To install Workshare using the MSI files you must extract the contents of the Workshare executable
using the /layout command and ensure that all prerequisites are installed on the client desktop.
For MSIs you must specify msiexec.exe /i [InstallerPath] [InstallerArgs].
70
NETWORK DEPLOYMENT
To deploy Workshare using MSIs:
1. Create a shared directory with relevant permissions so that client machines can access the
Workshare installation files during the installation.
2. Run Workshare.Professional.Bundle.exe /layout and this will extract and download
the prerequisites and MSIs to a folder called Redist to the directory created in step 1.
3. The default module state is to install the Compare, Protect and Connect modules. You can
change the installed module state by running a Registry script on the client to set the requested
module install state before running the MSI. Alternatively, you can specify modules to install to
the Professional MSI in step 5.
4. Install prerequisites (downloaded in Step 2).
5. Install the product (Workshare.Professional.msi, WorkshareCompare.msi,
WorkshareProtect.msi).
6. (Optional) Install the Compare for PowerPoint msi (WorkshareCompareForPowerPoint.msi).
7. (Optional) Install the Desktop msi (Workshare.Desktop.msi).
In order to deploy Workshare with specific configuration settings, you must use a REG file or an ADM
template. Refer to Deploying Configuration Settings.
Note: The Workshare MSIs must be installed in the order specified above.
First Example Installation
The following example will install Workshare Professional for the first time with the Compare, Protect
and Connect modules enabled on an x64 system, quietly. This is done from the command line or using a
batch (.bat) file and should only be attempted by the network administrator or other qualified personnel.
It assumes that the files have been extracted to a shared directory.
To install Workshare:
1. Enter the following command to install the Professional Client quietly:
msiexec.exe /i <path to shared directory>\Workshare.Professional.msi
REINSTALL=ALL REINSTALLMODE=vomus ALLUSERS=1 SKIP_UPGRADE_WARNING=1
<property1> <property2> <property…> /qn
2. Enter the following command to install Compare for PowerPoint quietly:
msiexec.exe /i <path to shared directory>\
WorkshareCompareForPowerPoint.msi REINSTALL=ALL REINSTALLMODE=vomus
ALLUSERS=1 /qn
3. Enter the following command to install Workshare Desktop quietly:
msiexec.exe /i <path to shared directory>\Workshare.Desktop.msi
MSIINSTALLPERUSER= ALLUSERS=2 ENABLEUPDATES=0 /qn
Note: If you want to turn logging on during the install, add /l*v <path and name of log file> before /qn.
This generates a Windows Installer verbose (descriptive) log file which can be useful should you need to
contact Workshare Customer Support.
71
NETWORK DEPLOYMENT
As an alternative to installing quietly (/qn) use /qn+ to perform a silent install with final notification.
Refer to Appendix A: Additional Msiexec.exe Parameters and Switches, for additional parameters and
switches that can be passed to the msiexec.exe.
Second Example Installation
The following example will silently install Workshare Professional for the first time with the Compare
module only enabled on a system which has all prerequisites installed. This is done from the command
line or using a batch (.bat) file and should only be attempted by the network administrator or other
qualified personnel.
To install Workshare:
Enter the following command to install the Professional Client quietly:
msiexec.exe /i <path to shared directory>\Workshare.Professional.msi
REINSTALL=ALL REINSTALLMODE=vomus ALLUSERS=1 SKIP_UPGRADE_WARNING=1
INSTALL_COMPARE=1 /qn
Note: If you want to turn logging on during the install, add /l*v <path and name of log file> before /qn.
This generates a Windows Installer verbose (descriptive) log file which can be useful should you need to
contact Workshare Technical Support.
Refer to Appendix A: Additional Msiexec.exe Parameters and Switches, for additional parameters and
switches that can be passed to the msiexec.exe.
Compulsory Properties– Professional/Compare/Protect
The following table shows the compulsory properties that must be specified for installation of
Professional/Compare/Protect.
Property
Value
REINSTALL
Ensures that upgrades install correctly.
The required value is ALL.
REINSTALLMODE
Sets the reinstall mode for upgrades.
The default value is vomus. This ensures that the latest versions of the MSI
packages are cached and older files are overwritten.
ALLUSERS
Installs the application per machine.
The required value is 1.
INSTALLDIR
SKIP_UPGRADE
_WARNING
Specifies the installation folder for Workshare. If this property is not
specified, the default value is used which is <ProgramFilesFolder>\
Workshare\Modules
Disables the display of the upgrade warnings when installing Workshare.
Required for silent installations.
The required value is 1.
72
NETWORK DEPLOYMENT
Optional Properties – Professional/Compare/Protect
The following table shows the optional properties that can be specified to the Workshare install
(Professional/Compare/Protect).
Property
Value
LOGFILE
Name and location of the WCA log file. For example,
LOGFILE=”C:WorkshareConfig.log”. The log file can either be stored at
a shared location or stored locally on the workstation. If a location is
not specified for the log file it will be written to the local TEMP folder.
By default the log file is named WorkshareConfig.log.
The WCA log file will provide details of all the steps the WCA has taken
and can be passed to Workshare if any difficulties are encountered.
The log file is appended to, not overwritten, in order to retain all
logged information. Therefore the latest details will be at the end of
the log file.
NOTESINIFILE_PATH
Location of the notes.ini file. This should be specified in non-standard
IBM Lotus Notes environments to ensure that Workshare components
are added correctly to the INI file by the install.
INSTALL_COMPARE
Turns Compare module on. To enable installation of the Compare
module, set INSTALL_COMPARE=ON.
INSTALL_CONNECT
Turns Connect module on (Save/Share from Office and Compare and
Connect panel). To enable installation of the Connect module, set
INSTALL_CONNECT=ON.
INSTALL_DVSHORTCUT
Installs the Workshare Compare shortcut on the desktop. The shortcut
is created by default. To prevent the creation of the shortcut set
INSTALL_DVSHORTCUT=OFF
INSTALL_HUMMINGBIRD
Turns Hummingbird module on. To enable installation of the
Hummingbird module, set INSTALL_HUMMINGBIRD=ON.
INSTALL_INTERWOVEN
Turns Autonomy iManage module on. To enable installation of the
Autonomy iManage module, set INSTALL_INTERWOVEN=ON.
INSTALL_PROTECT
Turns Protect module on. To enable installation of the Protect module,
set INSTALL_PROTECT=ON.
INSTALL_SHAREPOINT
Turns SharePoint module on. To enable installation of the SharePoint
module, set INSTALL_SHAREPOINT=ON.
INSTALL_NETDOCUMENTS
Turns NetDocuments module on. To enable installation of the
NetDocuments module, set INSTALL_NETDOCUMENTS=ON.
INSTALL_WORLDOX
Turns Worldox module on. To enable installation of the Worldox
module, set INSTALL_WORLDOX=ON.
INSTALL_EXCEL_
INTEGRATION
Integrates Workshare into Microsoft Excel. To enable installation of
the Microsoft Excel integration, set
INSTALL_EXCEL_INTEGRATION=ON.
73
NETWORK DEPLOYMENT
Property
Value
INSTALL_OUTLOOK_
INTEGRATION
Integrates Workshare into Microsoft Outlook. To enable installation of
the Microsoft Outlook integration, set INSTALL_OUTLOOK
_INTEGRATION=ON.
INSTALL_POWERPOINT_
INTEGRATION
Integrates Workshare into Microsoft PowerPoint. To enable
installation of the Microsoft PowerPoint integration, set INSTALL
_POWERPOINT_INTEGRATION=ON.
INSTALL_WORD_
INTEGRATION
Integrates Workshare into Microsoft Word. To enable installation of
the Microsoft Word integration, set
INSTALL_WORD_INTEGRATION=ON.
Note: Properties and values are all case sensitive.
The use of “ “ should be used where there is character spacing in file paths.
If none of the Compare, Protect or Connect module properties is specified, the Compare, Protect and
Connect modules will be installed. If any of the Compare, Protect or Connect module property are
specified, then unspecified modules are not installed.
If none of the Microsoft Office integrations is specified, then all integrations are installed and Workshare
will integrate with Microsoft Word, PowerPoint, Excel and Outlook. If one of the Microsoft Office
integrations is specified, then the others are assumed to be “off” unless specifically specified as “on”.
Optional Properties – Desktop Client
The following table shows the optional property that can be specified to the Workshare Desktop Client
install.
Property
Value
UPDATE_CONTROL
Specified how updates are managed. You can specify a value as
follows:
0 – automatically download and install updates (default)
1 – notify user when updates are ready to install
2 – do not download or install updates
If this property is not specified then the Desktop Client will
automatically download and install updates.
74
NETWORK DEPLOYMENT
CITRIX INSTALLATION GUIDELINES
Workshare can be installed on a Citrix server using the standard installation process. To restrict the
number of users who have access to Workshare, you are required to manually modify the Registry keys.
Note: Workshare is configured to install on a per machine basis and not a per user basis.
To install Workshare on the Citrix server:
1. Ensure the Terminal Server is in Install mode.
2. Install Workshare on the Citrix server using the standard installation process. It is recommended
that the default folder structure: “Program Files/Workshare/Modules” is retained. Refer to
Chapter 2: Installation on a Single Workstation, more information.
3. Remove any shortcuts from the desktop if they were created.
The above steps will install Workshare for all users of the Terminal Server. To customize access to
Workshare functionality, use the following approach:
Enable Specific Users: Remove Workshare integration from all Microsoft Office applications and then use
a logon script deployed to specific users (using Active Directory) to reconfigure the Workshare
integration when needed/necessary.
Note: When the installation remains a per machine install, all users using the Citrix server where
Workshare is installed will get Workshare. This may not be required and it will increase the load on the
server.
Enable Specific Users
These steps are best performed immediately after installation of Workshare
Professional/Compare/Protect.
To disable Workshare for all Microsoft Office users:
1. Remove All Users/Current User Registry settings as follows: Execute
CitrixProfessionalDisableLocalMachine.reg/CitrixProfessionalDisableUser.reg.
2. Manually remove Workshare Batch Clean.lnk (if Workshare Protect is enabled) from All
Users/Current User [SendTo] folder, so that the corresponding context menu items in right click
> Send to are removed.
To enable Workshare Professional for individual Microsoft Office users:
1. Enable Current User Registry settings as follows: Execute CitrixProfessionalEnableUser.reg.
2. If you have Workshare Protect enabled, run Workshare.Protect.UserInit.exe to bring back
Workshare Batch Clean.lnk.
75
NETWORK DEPLOYMENT
ACTIVE DIRECTORY DEPLOYMENT GUIDELINES
When working with Windows 2008 Server (or later), you can deploy Workshare across your network
using Active Directory. “Assigned to machine” installation is the preferred method of distributing
Workshare Professional via Active Directory and is described in Deploying Workshare
Professional/Compare/Protect, page 77. Workshare Desktop can be distributed on a “per user” or “per
machine” basis and this is described in Deploying Workshare Desktop, page 81.
The “assigned to user” and “published to user” methods are outlined below.
Assigned/Published to User Methods
In general, it is not recommended to deploy Workshare Professional/Compare/Protect using the
assigned to user or published to user methods. These methods do not complement the way Workshare
works for the following reasons:
• If all previous installations of Workshare were assigned to machine installs, a subsequent
assigned/published to user install will not remove previous versions of Workshare.
• The Workshare application is not designed to support user isolation for either assigned or
published to user in Active Directory deployment. Whilst Workshare will operate normally for the
user for which it is installed, it will also be partially visible to other users - other users on the
machine will see the Workshare menu but will not be able to use it. If an application has been
assigned or published to a user, another user should not be able to see it or operate it at all.
Note: With Workshare, another user has the Workshare menu and button (not the Workshare Panel) in
Microsoft Word but when a menu option or the button is clicked, the error: "WinWord.exe Unable to
perform request: Unexpected exception" is displayed.
Workshare Desktop can be deployed using the assigned to user, published to user or assigned to
machine methods.
The published to user method does not install the software but it installs 'entry points' so that it looks to
the user like the software is installed. However, the software is not installed until it is used - when an
'entry point' is activated, the software is installed. An 'entry point' can be things like a desktop shortcut, a
start menu shortcut, a file extension or a template.
For example, if publishing Adobe Acrobat to a user, the following would happen:
• Shortcuts are placed wherever Adobe Acrobat has assigned its shortcuts (such as the desktop and
start menu).
• File extension associations for PDF are linked to Adobe Acrobat.
• The software will then install if the user either attempts to click on one of the shortcuts or
attempts to open a .PDF.
The published to user method uses a technology called JIT (just-in-time). This enables an administrator to
deploy the software to every user (for example) and the software will only be actually installed to the
users that require it. This saves on bandwidth, licensing and workstation disk space.
76
NETWORK DEPLOYMENT
With Workshare Professional/Compare/Protect, there are no valid entry points.
• There are no shortcuts that users click on to launch Workshare (it is opened via Microsoft Word).
• Workshare does not have a file extension other than W3 files but users will not be opening these
files.
The only feature that will work with published to user is the “add new software” entry under
add/remove programs.
Deploying Workshare Professional/Compare/Protect
Note: Before installing using this method, please refer to the section, Deploying via the Command Line,
page 68.
If you want to deploy specific configuration settings with Workshare, you must use a REG file or an ADM
template. Refer to Chapter 3: Configuration.
The following procedure must be completed for each of the installation components of Workshare –
Workshare.Professional.msi/WorkshareCompare.msi/WorkshareProtect.msi/WorkshareCompareForPow
erPoint.msi. The following example illustrates how to create the Workshare.Professional.msi Active
Directory group policy.
To deploy Workshare Professional using Active Directory:
1. On the Windows Server machine, create a shared folder with relevant permissions so that client
machines can access the Workshare MSI during the automatic installation.
2. Extract the MSI file from the EXE install file and copy it into the folder created in step 1.
3. Create a transform (MST) file. The transform file is used to specify properties, such as
INSTALLDIR, during the installation. The following procedure describes how to create a
transform file using the Orca utility provided in the Windows Installer Software Developers Kit.
4. Launch Orca.
77
NETWORK DEPLOYMENT
5. Open the Workshare.Professional.msi file.
6. From the Transform menu, select Generate Transform and the save the transform file to the
shared folder created in step 1.
7. From the Start menu, launch Active Directory Users and Computers. A list of organizational
units is displayed on the left side.
78
NETWORK DEPLOYMENT
8. You now have to configure a group policy for the users to which you will deploy Workshare
Professional. This is done for each organizational unit that includes users to which you want to
deploy.
9. Right-click an organizational unit and select Properties.
10. In the Group Policy tab, click the New button and enter a name for the new policy.
11. Select the new policy in the upper area and click the Properties button.
12. In the Security tab, click Add. A list of users in the organizational unit is displayed.
13. For all users to which you will deploy Workshare Professional, ensure that at a minimum the
following permissions are selected:
 Read
 Apply Group Policy
14. For any users to which you do not want to deploy Workshare Professional, ensure that the Apply
Group Policy permission is not selected.
15. Click OK.
16. In the Group Policy tab, select the policy in the upper area and click the Edit button. The Group
Policy window is displayed.
79
NETWORK DEPLOYMENT
17. Expand the Computer Configuration tree and the Software Settings node.
18. Right-click Software installation and select New then Package.
19. Browse to the shared folder and select the Workshare.Professional.msi/
WorkshareCompare.msi/WorkshareProtect.msi/WorkshareCompareForPowerPoint.msi file.
20. Click Open. The Deploy Software dialog is displayed.
21. Ensure that the Advanced published or assigned option is selected and click OK.
22. In the Modifications tab, click Add.
23. Browse to the transform (MST) file created in steps 4 to 13 and click Open.
24. Click OK.
25. In the Group Policy window, expand the Administrative Templates node and then the Windows
Components node.
26. Select Windows Installer.
80
NETWORK DEPLOYMENT
27. On the right side of the Group Policy window, double-click Logging.
28. Select the Enabled radio button and in the Logging field, enter voicewarmup.
29. Click OK. Logging of Windows Installer is now enabled. The log file generated will be in the
format msi<random letters and numbers>.log.
30. Close the Group Policy window and close the organization unit’s Properties window.
31. Repeat steps 15 to 36 for other organizational units to select all the users (machines) to which
you want to deploy Workshare Professional.
The Workshare package is now ready to be deployed on a per-machine basis. The next time the client
machines are rebooted, Workshare will be installed.
Note: Client machines may have to be rebooted more than once depending on their configuration.
Deploying Workshare Desktop
Note: Before installing using this method, please refer to the section, Deploying via the Command Line,
page 68.
To deploy Workshare Desktop using Active Directory:
1. On the Windows Server machine, create a shared folder with relevant permissions so that client
machines can access the Workshare MSI during the automatic installation.
2. Extract the Workshare.Desktop.msi file from the EXE install file and copy it into the folder
created in step 1.
81
NETWORK DEPLOYMENT
3. Create a transform (MST) file. The transform file is used to specify properties, such as
ENABLE_UPDATES, during the installation. The following procedure describes how to create a
transform file using the Orca utility provided in the Windows Installer Software Developers Kit.
4. Launch Orca.
5. Open the Workshare.Desktop.msi file.
6. From the Transform menu, select New Transform. In the title bar of the window, transformed
by Untitled is displayed in parenthesis the name of the msi.
7. In the left pane, select the Property table.
8. Right-click in the right pane and select Add Row.
9. Select Property in the upper area and enter ENABLE_UDPATES in the lower area.
10. Select Value in the upper area and enter 0 to disable updates
11. Click OK.
12. Repeat steps 8 to 11 for additional properties as required. You can add any of the properties
specified on page 73.
13. From the Transform menu, select Generate Transform and the save the transform file to the
shared folder created in step 1.
14. From the Start menu, launch Active Directory Users and Computers. A list of organizational
units is displayed on the left side.
15. You now have to configure a group policy for the users to which you will deploy Workshare
Desktop. This is done for each organizational unit that includes users to which you want to
deploy.
82
NETWORK DEPLOYMENT
16. Right-click an organizational unit and select Properties.
17. In the Group Policy tab, click the New button and enter a name for the new policy.
18. Select the new policy in the upper area and click the Properties button.
19. In the Security tab, click Add. A list of users in the organizational unit is displayed.
20. For all users to which you will deploy Workshare Desktop, ensure that at a minimum the
following permissions are selected:
 Read
 Apply Group Policy
21. For any users to which you do not want to deploy Workshare Desktop, ensure that the Apply
Group Policy permission is not selected.
22. Click OK.
23. In the Group Policy tab, select the policy in the upper area and click the Edit button. The Group
Policy window is displayed.
24. Expand the Computer Configuration tree and the Software Settings node. The following
instructions will install Workshare Desktop per machine.
25. Right-click Software installation and select New then Package.
26. Browse to the shared folder and select Workshare.Desktop.msi file.
27. Click Open. The Deploy Software dialog is displayed.
28. Ensure that the Advanced published or assigned option is selected and click OK.
29. In the Modifications tab, click Add.
83
NETWORK DEPLOYMENT
30. Browse to the transform (MST) file created in steps 4 to 13 and click Open.
31. Click OK.
32. In the Group Policy window, expand the Administrative Templates node and then the Windows
Components node.
33. Select Windows Installer.
34. On the right side of the Group Policy window, double-click Logging.
35. Select the Enabled radio button and in the Logging field, enter voicewarmup.
36. Click OK. Logging of Windows Installer is now enabled. The log file generated will be in the
format msi<random letters and numbers>.log.
37. Close the Group Policy window and close the organization unit’s Properties window.
38. Repeat steps 15 to 36 for other organizational units to select all the users (machines) to which
you want to deploy Workshare Desktop.
The Workshare Desktop package is now ready to be deployed on a per-machine basis. The next time the
client machines are rebooted, Workshare Desktop will be installed.
Note: Client machines may have to be rebooted more than once depending on their configuration.
84
ADDITIONAL MSIEXEC.EXE PARAMETERS AND SWITCHES
APPENDIX A. ADDITIONAL MSIEXEC.EXE
PARAMETERS AND SWITCHES
85
ADDITIONAL MSIEXEC.EXE PARAMETERS AND SWITCHES
MSIEXEC.EXE PARAMETERS AND SWITCHES
The executable program that interprets packages and installs products is msiexec.exe. Note that msiexec
also sets an error level on return that corresponds to system error codes. The following table describes
the parameters and switches for this program. For the latest Msiexec.exe Parameters and Switches,
please refer to http://msdn2.microsoft.com/en-us/library/aa367988.aspx.
Switch
Parameters
Meaning
/i
Package|ProductCode
Installs or configures a product.
/f
[p|o|e|d|c|a|u|m|s|v]
Package|ProductCode
Repairs a product. This option ignores any property values
entered on the command line. The default argument list
for this option is 'pecms'. This option shares the same
argument list as the REINSTALLMODE property.
p
Reinstall only if file is missing.
o
Reinstall if file is missing or if an older version is
installed.
e
Reinstall if file is missing or an equal or older version
is installed.
d
Reinstall if file is missing or a different version is
installed.
c
Reinstall if file is missing or the stored checksum
does not match the calculated value. Only repairs files
that have msidbFileAttributesChecksum in the Attributes
column of the File table.
a
Force all files to be reinstalled.
u
Rewrite all required user specific Registry entries.
m Rewrite all required computer-specific Registry
entries.
s
Overwrite all existing shortcuts.
v
Run from source and re-cache the local package. Do
not use the v reinstall option for the first installation of an
application or feature.
/a
Package
Administrative installation option. Installs a product on
the network.
/x
Package|ProductCode
Uninstalls a product.
86
ADDITIONAL MSIEXEC.EXE PARAMETERS AND SWITCHES
Switch
Parameters
Meaning
/j
[u|m]Package
or
Advertises a product. This option ignores any property
values entered on the command line.
[u|m]Package /t Transform
List
u
Advertise to the current user.
m
Advertise to all users of machine.
or
g
Language identification.
[u|m]Package /g LanguageID
t
Applies transform to advertised package.
[i|w|e|a|r|u|c|m|o|p|v|+|!
]Logfile
Specifies path to log file and the flags indicate which
information to log.
/L
i
Status messages
w
Non-fatal warnings
e
All error messages
a
Start up of actions
r
Action-specific records
u
User requests
c
Initial UI parameters
m
Out-of-memory or fatal exit information
o
Out-of-disk-space messages
p
Terminal properties
v
Verbose output
+
Append to existing file
!
Flush each line to the log
"*" Wildcard, log all information except for the v option.
To include the v option, specify "/l*v".
87
ADDITIONAL MSIEXEC.EXE PARAMETERS AND SWITCHES
Switch
Parameters
Meaning
/m
filename
Generates an SMS status .mif file. Must be used with the
install (-i), remove (-x), administrative installation (-a), or
reinstall (-f) options. The ISMIF32.DLL is installed as part
of the SMS and must be on the path.
The fields of the status mif file are filled with the following
information:
Manufacturer - Author
Product - Revision Number
Version - Subject
Locale - Template
Serial Number - not set
Installation - set by ISMIF32.DLL to "DateTime"
InstallStatus - "Success" or "Failed"
Description - Error messages in the following order: 1)
Error messages generated by installer. 2) Resource from
Msi.dll if install could not commence or user exit. 3)
System error message file. 4) Formatted message:
"Installer error %i", where %i is error returned from
Msi.dll
/p
PatchPackage
Applies a patch. To apply a patch to an installed
administrative image you must combine options as
follows:
/p <PatchPackage> /a <Package>
/q
n|b|r|f
Sets user interface level.
q
No UI
qn
No UI
qb
Basic UI. Use qb! to hide the Cancel button.
qr Reduced UI with no modal dialog displayed at the
end of the installation.
qf Full UI and any authored FatalError, UserExit, or Exit
modal dialoges at the end.
qn+ No UI except for a modal dialog displayed at the end.
qb+ Basic UI with a modal dialog displayed at the end.
The modal box is not displayed if the user cancels the
installation. Use qb+! or qb!+ to hide the Cancel button.
qb- Basic UI with no modal dialoges. Please note that
/qb+- is not a supported UI level. Use qb-! or qb!- to hide
the Cancel button.
Note that the ! option is available with Windows Installer
version 2.0 and works only with basic UI. It is not valid
with full UI.
88
ADDITIONAL MSIEXEC.EXE PARAMETERS AND SWITCHES
Switch
Parameters
/? or /h
/y
Meaning
Displays copyright information for the Windows Installer.
Module
Calls the system API DllRegisterServer to self-register
modules passed in on the command line. For example,
msiexec /y my_file.dll.
This option is only used for Registry information that
cannot be added using the Registry tables of the MSI file.
/z
Module
Calls the system API DllUnRegisterServer to unregister
modules passed in on the command line. For example,
msiexec /z my_file.dll.
This option is only used for Registry information that
cannot be removed using the Registry tables of the MSI
file.
The options /i, /x, /f[p|o|e|d|c|a|u|m|s|v], /j[u|m], /a, /p, /y and /z should not be used together. The
one exception to this rule is that patching an administrative installation requires using both /p and /a.
The options /t and /g should only be used with /j. The options /l and /q can be used with /i, /x,
/f[p|o|e|d|c|a|u|m|s|v], /j[u|m], /a, and /p.
89
DEFAULT PROFILE
APPENDIX B.
DEFAULT PROFILE
90
DEFAULT PROFILE
WORKSHARE DEFAULT PROFILE
A profile is a collection of policies that include a set of instructions to Workshare Protect as to what
metadata to remove from an email attachment and whether to convert the attachment to PDF.
Workshare Protect uses a default profile called WorkshareClient.policy at the following location:
ProgramData/Workshare/PolicySets/ClientProfiles/Default/. The same profile can also be found in a
user’s local folder as follows: Users/[current user]/Documents/My Policies. When a new user logs in, the
default profile is copied to their My Policies folder.
Additionally, a copy of this profile is created in a file called WorkshareClient.runtimepolicy at the
following location: ProgramData/Workshare/PolicySets/ClientProfiles/Default/. It is actually the
runtimepolicy file that Workshare Protect applies as the profile.
A user can change the profile by modifying the parameters in the Workshare Configuration Manager.
Any changes made there update the following files: WorkshareClient.runtimepolicy (in the user’s My
Policies folder) and WorkshareClient.runtimepolicy.
The default profile includes the following policies:
Document Conversion Policy
This policy converts Microsoft Office files to PDF when they are emailed.
This policy includes the following expression:
• File type is Word, Excel, PowerPoint or RTF.
The actions to apply when the condition is met are as follows:
• Email Channel Action: Everyone to Internal: PDF; Everyone to External: PDF (meaning the
document is converted to PDF when emailed to an external or an internal recipient)
Hidden Data Policy
This policy prevents the unauthorized disclosure of hidden data such as track changes, speaker notes and
hidden columns. Depending on the type of hidden data and user privilege, the data is either
automatically removed or the user is given the choice to clean the data or disregard the alert.
This policy includes the following expressions:
• Any document (Microsoft Word, Excel or PowerPoint, or RTF) contains high risk hidden data
(comment, track change item, hidden text, small text, white text, version, auto version, link,
speaker notes, hidden slides), or
• Any document contains medium risk hidden data (reviewer, hyperlink, routing slip, variable,
macro, custom property, ink annotations), or
• Any document contains low risk hidden data (attached template, field, built-in property,
document statistic, smart tag)
91
DEFAULT PROFILE
The action to apply when the condition is met is as follows:
• Email Channel Action: Everyone to External: Clean Hidden Data (meaning when the document is
emailed to an external recipient, the hidden data is removed from the document)
Hidden PDF Data Policy
This policy prevents the unauthorized disclosure of hidden data such as markups, properties,
attachments and bookmarks.
This policy includes the following expression:
• Any PDF document contains markups, properties, attachments and bookmarks.
The action to apply when the condition is met is as follows:
• Email Channel Action: Everyone to Internal: Clean hidden data; Everyone to External: Clean
hidden data (meaning when the document is emailed to an external recipient, the hidden data is
removed from the document)
Full Document Restriction Policy
This policy prevents documents that have the Workshare classification “full document restriction” from
being emailed.
This policy includes the following expressions:
• Any file type has a Workshare ‘Full Restriction’ status.
• Custom property ‘WSClassification’ is ‘Full Restriction’
The action to apply when the condition is met is as follows:
• Email Channel Action: Everyone to Internal: Block; Everyone to External: Block (meaning the
document cannot be emailed to an external or an internal recipient)
External Document Restriction Policy
This policy prevents documents that have the Workshare classification “external document restriction”
from being emailed externally.
This policy includes the following expressions:
• Any file type has a Workshare ‘External Only Restriction’ status.
• Custom property ‘WSClassification’ is ‘External Only Restriction’
The actios to apply when the condition is met is as follows:
• Email Channel Action: Everyone to External: Block (meaning the document cannot be emailed to
an external recipient)
92
DEFAULT PROFILE
For Internal Use Only Policy
This policy prevents documents that have the Workshare classification “for internal use only” from being
emailed externally.
This policy includes the following expression:
• Custom property ‘WSClassification’ is ‘For Internal Use Only’
The actions to apply when the condition is met are as follows:
• Email Channel Action: Everyone to External: Block (meaning the document cannot be emailed to
an external recipient)
Confidential Policy
This policy alerts users when documents that have the Workshare classification “confidential” are
emailed the Workshare Protect Email Security dialog is used. This policy does not alert for the Protect
Profile dialog.
This policy includes the following expression:
• Custom property ‘WSClassification’ is ‘Confidential’
The action to apply when the condition is met is as follows:
• Email Channel Action: Everyone to Internal: Alert; Everyone to External: Alert (meaning when the
document is emailed to an external or an internal recipient, the user is alerted)
Highly Confidential Policy
This policy prevents documents that have the Workshare classification “highly confidential” from being
emailed.
This policy includes the following expression:
• Custom property ‘WSClassification’ is ‘Highly Confidential’
The action to apply when the condition is met is as follows:
• Email Channel Action: Everyone to Internal: Block; Everyone to External: Block (meaning the
document cannot be emailed to an external or an internal recipient)
93
WORKSHARE PREREQUISITES
APPENDIX C.WORKSHARE PREREQUISITES
94
WORKSHARE PREREQUISITES
WORKSHARE PREREQUISITES
Summary
The prerequisites for Workshare Professional/Compare/Protect 9 depend on the version of the operating
system and the version of Microsoft Office. They are listed on page 12 and further details provided in this
appendix. Prerequisites for other versions of Workshare Professional/Compare/Protect may be slightly
different.
Microsoft .NET Framework 4.5
The full version of Microsoft .NET Framework 4.5 (no service pack) is required.
The executable file can be downloaded by clicking this link:
http://download.microsoft.com/download/b/a/4/ba4a7e71-2906-4b2d-a0e180cf16844f5f/dotnetfx45_full_x86_x64.exe
Microsoft Visual C++ 2012 Redistributable Package (x86)
Microsoft Visual C++ 2012 Redistributable Package (x86) is required.
The executable file can be downloaded by clicking this link:
http://download.microsoft.com/download/C/6/D/C6D0FD4E-9E53-4897-9B91836EBA2AACD3/vcredist_x86.exe
Microsoft Visual C++ 2012 Redistributable Package (x64)
Microsoft Visual C++ 2012 SP1 Redistributable Package (x64) is required for the native x64 code in the
application.
The executable file can be downloaded by clicking this link:
http://download.microsoft.com/download/A/8/0/A80747C3-41BD-45DF-B505E9710D2744E0/vcredist_x64.exe
Microsoft Visual Studio 2010 Tools for Office Runtime Setup
Required to run Microsoft Office based solutions built using Microsoft Visual Studio 2010 and 2012.
The executable file can be downloaded by clicking this link:
http://download.microsoft.com/download/9/4/9/949B0B7C-6385-4664-8EA83F6038172322/vstor_redist.exe
95