UniPrint Administrator’s Guide
UniPrint Version 7.0
Released: February 2011
Revised: 12 September 2012 2:49 pm
ii
UniPrint Version 7.0
Copyright Notice
UniPrint, a division of ACCEO Solutions, Inc. and its affiliates, makes no representations or
warranties with respect to the contents or use of this publication. UniPrint, a division of ACCEO
Solutions, Inc. specially disclaims any expressed or implied warranties, merchantability or fitness for
any particular purpose. UniPrint, a division of ACCEO Solutions, Inc. reserves the right to make
any changes in specifications and other information contained in this publication without prior
notice and without obligation to notify any person or entity of such revisions or changes.
© Copyright 1999 - 2011 UniPrint, a division of ACCEO Solutions, Inc. All rights reserved.
Information in this document is subject to change without notice. Companies, names and data
used in examples herein are fictitious unless otherwise noted. Other than printing one copy for
personal use, no part of this document may be reproduced or transmitted in any form or by any
means, electronic or mechanical, for any purposes, without the expressed written consent of:
UniPrint, a division of ACCEO Solutions, Inc.
1 Eva Road, Suite 309
Toronto, Ontario
Canada M9C 4Z5
(416) 503-9800
Toll Free: (866) 488-3188 (North America only)
www.uniprint.net
Trademark Acknowledgements
UniPrint is a trademark of UniPrint, a division of ACCEO Solutions, Inc. United States Patent
No. 7,064,856.
Microsoft, Windows, Windows 2003/2008, Windows XP, Vista, Windows 7, Microsoft Access,
Microsoft Word, Remote Desktop Protocol (RDP), ASP.NET and Active Directory are either
registered trademarks or trademarks of Microsoft Corporation.
Citrix, MetaFrame, Presentation Server, XenApp and ICA (Independent Computing Architecture)
are registered trademarks or trademarks of Citrix Systems.
Adobe, Acrobat, Reader are registered trademarks of Adobe Systems Inc.
All other trademarks and registered trademarks are the property of their owners.
iii
Document Revision History
Date
Notes
April 7, 2010
First release.
August 9, 2010
Added UniPrint Suite 7.0.1 features and updated screen shots.
Revised description and instructions for double-sided printing,
formerly known as duplex mode.
Revised description and instructions for font replication plug-in.
Added installation, removal, configuration and usage information on
UniPrint PrintPAL 7.0.
November 3, 2010
Added UniPrint Suite 7.0.2 features and updated screen shots.
Added description and instructions for detailed license usage snapshot.
Added installation and configuration information for installing
UniPrint Gateway Edition in both Windows Server 2003 and 2008
failover cluster.
February 22, 2011
Added UniPrint Suite 7.0.3 features and updated screen shots.
Added instructions for disabling Windows printer mapping on the
terminal server.
Added descriptions for new components and driver updates.
September 12, 2012
Updated with changes to parent company name.
iv
UniPrint Version 7.0
v
Table of Contents
Introduction ....................................................................................................... 1
What’s New in 7.0.3? ........................................................................................................... 2
UniPrint Server .............................................................................................................. 2
Redesigned UniPrint Management Console ............................................................. 2
Improved Licensing Scheme ..................................................................................... 2
UniPrint Gateway Edition .............................................................................................. 2
Support for Thin Client USB Printers ...................................................................... 2
Improved Printer Properties Support ........................................................................ 2
Font Replication ...................................................................................................... 2
Support for Secure Printing ...................................................................................... 2
Support for Advanced Printer Functions ................................................................... 2
UniPrint PrintPAL ................................................................................................... 3
Installing & Removing UniPrint ................................................................. 5
Planning Your UniPrint Installation ...................................................................................... 5
Minimum System Requirements .................................................................................... 5
UniPrint Spool Server .............................................................................................. 5
UniPrint Print Server ............................................................................................... 5
UniPrint Server ........................................................................................................ 6
Recommended Installation Order .................................................................................. 6
Rich-client Solution ................................................................................................. 6
Thin Client & Combined Thin and Rich-client Solution ......................................... 6
Cluster Environment ...................................................................................................... 7
Disabling Client Printer Mapping on the Terminal Server .............................................. 7
Installing UniPrint Spool Server ........................................................................................... 9
Installing UniPrint Spool Server from the Command Line .............................................11
Syntax .....................................................................................................................11
/q ............................................................................................................................11
INSTALLDIR .........................................................................................................11
Installing UniPrint Print Server ...........................................................................................12
Installing UniPrint Print Server from the Command Line ..............................................14
Syntax .....................................................................................................................14
/q ............................................................................................................................14
INSTALLDIR .........................................................................................................14
UP_SETTING_ SPOOLIP .....................................................................................14
Installing UniPrint Server ....................................................................................................14
Installing UniPrint Server from the Command Line ......................................................16
Syntax .....................................................................................................................16
/q ............................................................................................................................16
INSTALLDIR .........................................................................................................17
RUN_PRINTPAL ..................................................................................................17
UP_SETTING_ SPOOLIP .....................................................................................17
UP_SETTING_ PAPERSIZE=n ............................................................................17
UP_SETTING_ UNIPRINT_AS_ DEFAULT .......................................................17
UP_SETTING_ GPO ............................................................................................18
UP_SETTING_ LOGLEVEL=n ............................................................................18
UP_SETTING_ PASSTHROUGH=n ...................................................................18
vi
UniPrint Version 7.0
Installing UniPrint through Active Directory ...................................................................... 18
Obtaining and Applying a UniPrint License ....................................................................... 20
Obtaining a UniPrint License ....................................................................................... 20
Applying a UniPrint License ......................................................................................... 22
Removing UniPrint ........................................................................................................... 22
Removing UniPrint Server ........................................................................................... 23
Removing UniPrint Print Server .................................................................................. 23
Removing UniPrint Spool Server ................................................................................. 23
UniPrint Gateway in a Failover Cluster ............................................................... 25
Planning your UniPrint Spool Server Installation for a Failover Cluster ............................... 25
Minimum System Requirements .................................................................................. 25
Installing UniPrint Spool Server on a Windows 2003 Cluster Node ................................... 25
Configuring UniPrint Spool Server Cluster Resources in Windows 2003 ........................... 26
Creating a Spooler Resource ........................................................................................ 26
Creating a UniPrint Routing Service Resource ............................................................ 27
Creating a UniPrint Control Service Resource ............................................................. 28
Installing UniPrint Spool Server on a Windows 2008 Cluster Node ................................... 29
Configuring UniPrint Spool Server Cluster Resources in Windows 2008 ........................... 30
Adding the Print Server Role ....................................................................................... 30
Adding & Configuring the Print Server Service ............................................................ 30
Adding & Configuring UniPrint Control Service Resource .......................................... 32
Adding & Configuring UniPrint Routing Service Resource ......................................... 32
Planning your UniPrint Print Server Installation for a Failover Cluster ................................ 33
Minimum System Requirements .................................................................................. 34
Installing UniPrint Print Server on a Windows 2003 Cluster Node .................................... 34
Configuring UniPrint Print Server Cluster Resources in Windows 2003 ............................ 35
Creating a Spooler Resource ........................................................................................ 35
Creating a UniPrint Control Service Resource ............................................................. 36
Installing UniPrint Print Server on a Windows 2008 Cluster Node .................................... 36
Configuring UniPrint Print Server Cluster Resources in Windows 2008 ............................ 37
Adding the Print Server Role ....................................................................................... 37
Adding & Configuring the Print Server Service ............................................................ 38
Adding & Configuring UniPrint Control Service Resource .......................................... 39
Installing Printers on the UniPrint Print Server in a Windows 2008 Failover Cluster .......... 40
Upgrading to UniPrint 7.0 ................................................................................. 43
Planning your UniPrint Upgrade ........................................................................................ 43
Recommended Upgrade Procedure .............................................................................. 43
Minimum System Requirements .................................................................................. 44
UniPrint Spool Server ............................................................................................ 44
UniPrint Print Server ............................................................................................. 44
UniPrint Server ...................................................................................................... 44
Upgrading UniPrint Spool Server ...................................................................................... 45
Upgrading UniPrint Server ................................................................................................ 47
Upgrading UniPrint Print Server ....................................................................................... 48
Upgrading and Applying Your UniPrint License ................................................................. 50
UniPrint Tools and Utilities ............................................................................... 53
vii
UniPrint Management Console ..........................................................................................53
Console Home ..............................................................................................................54
Detailed View of License Usage ...............................................................................55
Save Detailed License Usage Snapshot To File ..........................................................56
Copy Detailed License Usage Snapshot to the Clipboard .........................................56
Properties & Settings > Printers ....................................................................................57
Changing Printer(s) Properties .................................................................................58
Page size ............................................................................................................60
To define a custom form on the application (Citrix/RDS) server: ......................60
To use the Custom paper size during a user session: ...........................................61
Resolution .........................................................................................................61
Orientation ........................................................................................................61
Dimensions (mm) ..............................................................................................61
Physical Margins (mm) .......................................................................................61
Paper Source .....................................................................................................62
Double sided printing ........................................................................................62
Auto Center ......................................................................................................62
Fit to page .........................................................................................................62
Resizing ............................................................................................................62
Postscript emulation ...........................................................................................63
Font options ......................................................................................................63
Color options ....................................................................................................64
Black and White compression ............................................................................64
Color image compression ..................................................................................64
Adding a Gateway printer ........................................................................................65
Adding a Lexmark/HP FTP Printer ........................................................................65
Deleting a Printer ....................................................................................................66
Changing Publishing Options ..................................................................................66
Convert a Printer Instance into a Thin-client printer ...............................................68
Properties & Settings > Components .............................................................................69
PrintPAL Server ......................................................................................................70
UniPrint Control Service ........................................................................................70
Edit UniPrint Spool Server Connection Information .........................................71
Printing Fault Tolerance ....................................................................................71
UniPrint Printer Driver ...........................................................................................71
UniPrint Session Application ...................................................................................71
To Ensure Only Gateway Licenses Are Utilized .................................................72
Connected node management plug-in .....................................................................72
Font replication plug-in ...........................................................................................73
Enable Font Replication ....................................................................................73
viii
UniPrint Version 7.0
Font request processor ............................................................................................. 73
FTP print job processor .......................................................................................... 74
License manager plug-in ......................................................................................... 74
License request processor ........................................................................................ 74
Log file maintenance plug-in ................................................................................... 74
Node identification plug-in ..................................................................................... 74
Node request processor ........................................................................................... 74
Printer creation processor ........................................................................................ 75
Printer lookup optimization plug-in ....................................................................... 75
Printer discovery plug-in ........................................................................................ 75
Print job processor .................................................................................................. 75
Process delegation plug-in ....................................................................................... 76
Quorum synchronization plug-in ............................................................................ 76
Remote Console query processor ........................................................................... 76
Thin-client printer (USB) request processor ............................................................ 76
Thin-client printer management plug-in ................................................................. 76
Thin-client print job processor ................................................................................ 76
UniPrint driver install plug-in ................................................................................. 77
UniPrint printer install plug-in ............................................................................... 77
UniPrint spool server 64-bit layer plug-in ............................................................... 77
UniPrint spool service discovery plug-in ................................................................. 77
UniPrint Routing Service ....................................................................................... 77
Discovery mode ................................................................................................ 77
Production mode .............................................................................................. 78
Properties & Settings > Policies .................................................................................... 78
User policy ............................................................................................................. 78
Machine policy ....................................................................................................... 78
User settings ........................................................................................................... 78
Machine settings ..................................................................................................... 79
Network Connections > Sessions (UniPrint Server only) .............................................. 79
Protocol .................................................................................................................. 79
Pass-Through .......................................................................................................... 80
Logon Options ....................................................................................................... 80
Set UniPrint as default printer ........................................................................... 80
Delete leftover print jobs ................................................................................... 80
Run PrintPAL .................................................................................................. 80
Optional Features .................................................................................................... 80
Enable Email ..................................................................................................... 80
Mail server address ............................................................................................ 80
Sender email address ......................................................................................... 80
Mail server requires authentication .................................................................... 80
E-mailing print jobs in user sessions ................................................................... 80
Enable Save ....................................................................................................... 82
Save to user’s Documents .................................................................................. 82
Save to other location ....................................................................................... 82
Saving Print Jobs in User Sessions ..................................................................... 82
ix
Network Connections > Services .................................................................................84
UniPrint Control Service ........................................................................................84
Connected node management plug-in .....................................................................84
License manager plug-in ..........................................................................................84
Print job processor ...................................................................................................84
Thin-client printer management plug-in ..................................................................84
UniPrint Remote Console Listener .........................................................................84
UniPrint Routing Service .......................................................................................85
Configuring UniPrint Using Administrative Templates in Windows ....................................85
Loading a Classic Administrative Template .....................................................................85
Loading and Configuring an Administrative Template in Windows Vista or later ...........86
UniPrint PrintPAL ..............................................................................................................88
Planning your UniPrint PrintPAL Configuration ...........................................................88
PrintPAL on the UniPrint Management Console ..........................................................89
Group Map .............................................................................................................90
Objects Mapped To The Group ...............................................................................90
Printers Mapped To The Group ..............................................................................90
Objects Available For Mapping ................................................................................90
Buttons ....................................................................................................................91
Configuring PrintPAL Settings ......................................................................................91
Creating Groups ............................................................................................................93
Mapping Network Objects to Groups ...........................................................................94
Adding an IP Range of Objects ...............................................................................95
Adding A Device .....................................................................................................96
Mapping Printers to Groups ..........................................................................................97
Setting Default Printers .................................................................................................98
Testing PrintPAL Mappings ...........................................................................................98
Testing By Device Name, IP Address or User Name ................................................99
Testing A Current Session ........................................................................................99
Using PrintPAL Client ................................................................................................101
Add Printer ...........................................................................................................101
Session Info ...........................................................................................................102
Refresh ..................................................................................................................103
Exit .......................................................................................................................103
Printer Profiler ..................................................................................................................103
To Create a New Printer Profile ..................................................................................104
To Edit an Existing Printer Profile ...............................................................................106
To Delete a Profile ......................................................................................................106
Using Printer Profiles ..................................................................................................107
To Enable Secure Print ................................................................................................108
To Disable Secure Print ...............................................................................................108
Using Secure Print ......................................................................................................108
UniPrint Adobe Plug-in ...................................................................................................109
Installing the UniPrint Plug-in for Acrobat ..................................................................110
Printing from Acrobat or Reader to UniPrint ..............................................................110
Replacing the Print function with Print to UniPrint .............................................111
Upgrading the UniPrint Plug-in for Acrobat ...............................................................112
Troubleshooting .............................................................................................. 113
x
UniPrint Version 7.0
Citrix Issues ..................................................................................................................... 113
Citrix Seamless Application Sessions not terminating when an application is closed ..... 113
Third-party Printer Driver Issues ...................................................................................... 113
Some third-party printer drivers may exhibit sporadic behavior ................................... 113
Contact and Support ........................................................................................ 115
UniPrint Support ............................................................................................................. 115
North America ..................................................................................................... 115
Europe, Middle East and Africa ............................................................................. 115
E-mail .................................................................................................................. 115
Office Location ................................................................................................................ 115
Address ................................................................................................................. 115
Paper Sizes ...................................................................................................... 117
CHAPTER
1
UniPrint Version 7.0
Introduction
Introduction
The UniPrint Suite is a comprehensive printing solution for Server-based
Computing (SbC) and virtualized desktop environments. UniPrint offers a
printing solution that provides end users with the flexibility to print to any
type of device from a Citrix and/or Remote Desktop Services (formerly
known as Terminal Services) session with the additional benefits of Portable
Document Format (PDF).
With UniPrint, printing to network or local printers, USB printers or even
specialized devices, is all performed by a single Universal Printer Driver,
eliminating extra configuration and confusing options for end users. The basic
UniPrint solution (UniPrint Server) supports both RDS and Citrix
architectures but there is also a solution designed for RDS only. UniPrint also
has three other printing solutions: Gateway Edition, VDI Edition and Host
Edition. These editions provide the functionality of UniPrint to support thin
and remote clients, Virtual Desktop Infrastructure and mixed host systemWindows environment printing.
This Administrator’s Guide is a reference manual for the following UniPrint
products:
• UniPrint Server
• UniPrint Terminal Server Edition (TSE)
• UniPrint Gateway Edition
• UniPrint Gateway TSE
• UniPrint VDI Edition
• UniPrint VDI Edition with Thin Client Support
UniPrint Server, Terminal Server Edition and VDI Edition all follow the same
installation instructions. For UniPrint Gateway TSE and UniPrint VDI with
Thin Client Support follow the same installation procedures as UniPrint
Gateway Edition.
2
UniPrint Version 7.0
What’s New in 7.0.3?
UniPrint Server
Redesigned
UniPrint
Management
Console
Improved
Licensing
Scheme
The UniPrint Management Console has been redesigned to improve
efficiency and usability, making it more intuitive to use and configure
UniPrint components on remote servers as well as the local server. Licenses
can also be managed from any server. Debugging options have been moved to
the Components screen, under Properties & Settings.
UniPrint is still licensed per application server, however, applying a different
license file on each individual application server is no longer required.
UniPrint now utilizes a license server component that is installed on one of
the UniPrint Spool Servers and the license file is applied to this designated
license server. Network administrators also have the ability to monitor and
track license usage in real time. The ability to view and save a detailed
snapshot of license usage has also been added.
UniPrint Gateway Edition
Support for Thin
Client USB
Printers
Extending the support for thin-client devices running Windows XPe/
Embedded Standard, UniPrint now also supports USB printers attached to
thin-client devices running Windows CE/Embedded CE.
Improved Printer
Properties
Support
For printer properties like paper tray, forms and resolution, the actual printer
property value is now imported from the native printer driver.
Font Replication
Font replication is a new functionality that further reduces print job size,
improves overall printing speed and reduces bandwidth consumption. Once a
day at a pre scheduled time UniPrint queries all application servers for newly
installed fonts and replicates them to all print servers. This feature creates a
smaller print job and improves the overall printing speed and print job quality.
Additionally, fonts can be replicated on demand.
Support for
Secure Printing
UniPrint now supports HP printers with secure printing capability where
print jobs are not printed until users enter their PIN codes at the physical
printer. Currently, the following printer drivers are supported: HP Universal
Printing PCL 5, HP Universal Printing PCL 5 (v 5.0 or later), HP Universal
Printing PCL 6, HP Universal Printing PCL 6 (v 5.0 or later), HP Universal
Printing PS and HP Universal Printing PS (v 5.0 or later).
Support for
Advanced Printer
Functions
Network administrators can now create unique printer profiles with different
combinations of advanced printer functionality (such as stapling, hole
punching, binding, etc.) enabled according to users’ specific printer
requirements.
Chapter 1: Introduction
UniPrint PrintPAL
3
UniPrint PrintPAL 7.0 has been integrated into this latest version. PrintPAL is
a network object-to-printer mapping utility that provides a simple user
interface that enables network administrators to control or restrict which
Gateway printers a user can access during their application server session.
4
UniPrint Version 7.0
CHAPTER
2
UniPrint Version 7.0
Installing & Removing UniPrint
Installing & Removing UniPrint
UniPrint Server and UniPrint TSE support rich clients. When a user prints
using the UniPrint printer driver, a PDF document is created and sent to the
connected client using Citrix ICA or Microsoft RDP virtual channel
technology. The UniPrint Client that is installed on the end user’s machine
spools the PDF print job using client-side printer drivers.
UniPrint Gateway Edition, UniPrint Gateway TSE and UniPrint VDI
Edition support both rich and thin clients. With thin clients, when a user
prints using the UniPrint printer driver, a PDF document is created and sent
to the UniPrint Spool Server which then routes the print job to the
appropriate UniPrint Print Server.
There are three main components that make up UniPrint 7.0:
• UniPrint Spool Server
• UniPrint Print Server
• UniPrint Server
Planning Your UniPrint Installation
Minimum System Requirements
To ensure the installation of UniPrint Version 7.0 is successful, ensure that
your system meets the minimum system requirements.
NOTE
Microsoft Windows Installer 3.1 or later is required for all UniPrint
installation packages and can be downloaded from www.microsoft.com.
UniPrint Spool
Server
UniPrint Spool Server requires .NET Framework 2.0 or later and one of the
following:
• Microsoft Windows Server 2003.
• Microsoft Windows Server 2008.
UniPrint Print
Server
UniPrint Print Server requires .NET Framework 2.0 or later and one of the
following:
• Microsoft Windows XP Professional.
6
UniPrint Version 7.0
•
•
•
•
UniPrint Server
Microsoft Windows Vista.
Microsoft Windows 7.
Microsoft Windows Server 2003.
Microsoft Windows Server 2008.
UniPrint Server requires .NET Framework 2.0 or later and one of the
following:
• Microsoft Windows Server 2003 with Terminal Services installed in
Application Server Mode.
• Microsoft Windows Server 2008 with Terminal Services role installed.
For UniPrint VDI, UniPrint Server is installed on each virtual desktop image
with .NET Framework 2.0 or later and one of the following software
requirements:
• Microsoft Windows XP Professional.
• Microsoft Windows Vista.
• Microsoft Windows 7.
Recommended Installation Order
Rich-client
Solution
For rich-client support, UniPrint Server, TSE and VDI consists of three
required components and the recommended installation order is as follows:
1. UniPrint Spool Server (one is designated as the license server). See
”Installing UniPrint Spool Server” on page 9 for detailed instructions.
2. Ensure that client printer mapping is disabled on the terminal server
before installing UniPrint Server. See ”Disabling Client Printer
Mapping on the Terminal Server” on page 7 for instructions.
3. UniPrint Server. See”Installing UniPrint Server” on page 14 for
instructions.
4. UniPrint Client. Refer to the UniPrint Client Administrator’s Guide
included in the UniPrint Client download package for information on
installing and configuring UniPrint Client.
In this solution, the UniPrint Spool Server acts as a license server and validates
UniPrint licenses when each UniPrint Server machine connects.
Thin Client &
Combined Thin
and Rich-client
Solution
For environments where only thin clients or both types of clients exist,
UniPrint Gateway, UniPrint Gateway TSE and UniPrint VDI with Thin
Client Support can be utilized. The recommended installation order is as
follows:
Chapter 2: Installing & Removing UniPrint
7
1. UniPrint Spool Server (NOTE: Only one is designated as the license
server and only one can have PrintPAL Server installed. The license
server component and PrintPAL Server do not need to be installed on
the same UniPrint Spool Server appliance.) See ”Installing UniPrint
Spool Server” on page 9.
2. UniPrint Print Server. See”Installing UniPrint Print Server” on
page 12 for detailed instructions.
3. Ensure that client printer mapping is disabled on the terminal server
before installing UniPrint Server. See ”Disabling Client Printer
Mapping on the Terminal Server” on page 7 for instructions.
4. UniPrint Server. See ”Installing UniPrint Server” on page 14 for
instructions.
In this scenario, UniPrint Spool Server acts not only as a license server but
also as a relay between the UniPrint Print Server and UniPrint Server
machines. When the UniPrint Print Server and UniPrint Server components
start, they immediately try to establish a connection with the UniPrint Spool
Server.
If you are upgrading to UniPrint 7.0 from UniPrint 6.1.5, see ”Planning your
UniPrint Upgrade” on page 43 for detailed upgrade planning and installation
instructions.
Cluster Environment
UniPrint Gateway Edition supports full redundancy by enabling clustering of
its Spool Server and Print Server as separate clusters with Windows. For
installation guidelines on installing UniPrint Gateway in a cluster
environment, see Chapter 3: ”UniPrint Gateway in a Failover Cluster” on
page 25.
Disabling Client Printer Mapping on the Terminal Server
It is highly recommended that client printer mapping be disabled prior to
installing UniPrint. The following instructions assume that the terminal server
role has been added to Windows Server 2008.
1. Click Start, point to Administrative Tools and then click Server
Manager.
2. In the console tree, expand Roles and then Terminal Services.
3. Click Terminal Services Configuration.
8
UniPrint Version 7.0
4. Under Connections, right-click RDP-Tcp and then select
Properties.
5. Click the Client Settings tab.
6. Under Redirection, select Windows Printer and Default to main
client printer to disable these options.
7. Click Apply and then click OK.
Chapter 2: Installing & Removing UniPrint
9
Installing UniPrint Spool Server
UniPrint Spool Server is the first UniPrint component to be installed in all
scenarios. The UniPrint Spool Server acts as a license server and validates
UniPrint licenses when each of the UniPrint Server machines connects. In a
UniPrint Gateway environment, the UniPrint Spool Server also acts as a print
job router and print queues are shared from the UniPrint Spool Server to user
sessions on the application server. By installing the UniPrint Spool Server
first, connectivity can be verified among the remaining components
(UniPrint Server and UniPrint Print Server).
Non-interactive command line installation of UniPrint Spool Server is
available. For command line installation instructions, see ”Installing UniPrint
Spool Server from the Command Line” on page 11.
The following instructions assume that you are installing on Windows Server
2008. If you are installing on another platform, you will need to adjust the
steps to account for any interface differences. Consult the product
documentation for your operating system.
NOTE
When installing UniPrint Spool Server on Windows 2008 or later with UAC
enabled and you are not logged in as an administrator, run the bootstrap,
Setup.exe.
1. Log on to the server with administrative rights.
2. Run the installation program UPSpoolServer703.msi or Setup.exe.
10
UniPrint Version 7.0
3. If running Setup.exe with UAC enabled, the User Account
Control dialog box will appear. Click Yes to continue.
4. In the UniPrint Spool Server 7.0.3 Installation dialog box, click
Next.
5. In the License Agreement dialog box, click I accept the license
agreement and then click Next to proceed with the installation.
6. In the Destination Folder dialog box, click Next to accept the
default location for the UniPrint Spool Server program files. Click
Browse to change the default location.
7. In the Select Features dialog box, click Next to install the License
Server on this machine. If you don’t want to designate this machine as
the License Server, click
beside License Server and then click
install it, click
. For PrintPAL, if you choose not to
beside PrintPAL Server and then click
. PrintPAL can be installed later by
changing the installation through Programs and Features.
NOTE
PrintPAL is only operational in a UniPrint Gateway environment. If you are
installing UniPrint Server, UniPrint TSE or UniPrint VDI Edition, do not
install PrintPAL Server. 

Only one UniPrint Spool Server needs to have PrintPAL Server installed.
Chapter 2: Installing & Removing UniPrint
11
8. In the Ready to Install the Application dialog box, click Install to
begin the installation. UniPrint Setup will now copy files to your hard
disk drive.
9. Click Finish to complete the installation.
10. Click Start, point to All Programs, click UniPrint Suite, and then
click UniPrint Management Console.
11. The top banner displays the host name and IP address of the Spool
Server.
12. Record the IP Address of the Spool Server. This information is
required when installing the other UniPrint components.
13. Click Start, point to Administrative Tools and then click Services.
Check that the following services have been created and are started:
• UniPrint Control Service
• UniPrint Routing Service
Installing UniPrint Spool Server from the Command Line
Command line installation is available for UPSpoolServer703.msi with the
following options:
NOTE
If UAC is enabled, msiexec.exe must be run as an administrator. To run a
command line as an administrator do the following:
1. Click Start and then click All Programs. Click Accessories.
2. Right-click Command Prompt and select Run as administrator.
Syntax
/q
INSTALLDIR
msiexec /q /i c:\UPSpoolServer703.msi [INSTALLDIR = ”path”]
Function: Runs the Setup in silent mode (no user intervention required).
Remarks: Must be used with the /i Windows Installer parameter. If no
additional parameters are passed, default values will be used.
Example: msiexec /q /i C:\UPSpoolServer703.msi
Function: Specifies a custom installation path for the UniPrint Spool Server
program files.
Remarks: The full path specified must be enclosed in double quotation
marks (“ ”) if spaces exist in the path.
Example: msiexec /q /i C:\UPSpoolServer703.msi
INSTALLDIR=”C:\Program Files\UniPrint\SpoolServer”
12
UniPrint Version 7.0
Installing UniPrint Print Server
In a UniPrint Gateway, Gateway TSE and VDI environment, UniPrint Print
Server is the second UniPrint component to be installed. UniPrint Print
Server is responsible for rendering print jobs and directing them to the
appropriate printer.
In enterprises where users are located in different geographic regions or
where printing requirements vary greatly from branch office to branch office,
UniPrint Print Servers should be stationed remotely. Deploying multiple
UniPrint Print Servers has several advantages:
• It distributes the printing workload between remote locations.
• It accommodates differences in regional printing environments.
• It reduces bandwidth consumption by transferring compressed PDF
files instead of raw data files across the network.
Some Lexmark/HP printer models have the capability to interpret PDF files
directly without rendering print jobs into raw data files. These printers are
considered UniPrint-ready and when defined on the UniPrint Spool Server,
each printer acts as its own UniPrint Print Server. Deploying multiple
UniPrint-ready Lexmark/HP printers has the following advantages:
• It reduces overall bandwidth consumption from server to printer.
• It can accept PDF print jobs directly without the need for a separate
print server or native printer driver.
For a list of UniPrint-ready Lexmark/HP printers, visit the UniPrint Web site
www.uniprint.net.
Before installing UniPrint Print Server, ensure that your server meets the
minimum system requirements.
NOTE
When installing UniPrint Print Server on Windows Vista or later with UAC
enabled and you are not logged in as an administrator, run the bootstrap,
Setup.exe.
For non-interactive command line installation instructions, see ”Installing
UniPrint Print Server from the Command Line” on page 14.
1. Log on to the server with administrative rights.
2. Run the installation program UPPrintServer703.msi or Setup.exe.
Chapter 2: Installing & Removing UniPrint
13
3. If running Setup.exe with UAC enabled, the User Account
Control dialog box will appear. Click Yes to continue.
4. In the UniPrint Print Server 7.0.3 Installation dialog box, click
Next.
5. In the License Agreement dialog box, click I accept the license
agreement and then click Next to proceed with the installation.
6. In the Destination Folder dialog box, click Next to accept the
default location for the UniPrint Print Server program files. Click
Browse to change the default location.
7. In the Spool Server Configuration dialog box, enter the IP
Address of the UniPrint Spool Server or click Auto Locate to run
an auto-discovery function to find an already installed and running
UniPrint Spool Server. NOTE: If using the Auto Locate function in an
environment where there are multiple UniPrint Spool Servers, ensure that the
IP address located is that of the intended UniPrint Spool Server before
proceeding. Click Next to continue.
8. In the Ready to Install the Application dialog box, click Install to
begin installing UniPrint Print Server. UniPrint Setup will now copy
files to your hard disk drive.
9. Click Finish to complete the installation.
10. Click Start, point to Administrative Tools and then click Services.
Ensure that the UniPrint Control Service has been created and
started.
14
UniPrint Version 7.0
Installing UniPrint Print Server from the Command Line
Command line installation is available for UPPrintServer703.msi with the
following options:
NOTE
If UAC is enabled, msiexec.exe must be run as an administrator. To run a
command line as an administrator do the following:
1. Click Start and then click All Programs. Click Accessories.
2. Right-click Command Prompt and select Run as administrator.
Syntax
/q
INSTALLDIR
msiexec /q /i C:\UPPrintServer703.msi [INSTALLDIR = “path”]
[UP_SETTING_SPOOLIP=nnn.nnn.nnn.nnn:ppppp]
Function: Runs the Setup in silent mode (no user intervention required).
Remarks: Must be used with the /i Windows Installer parameter. If no
additional parameters are passed, default values will be used.
Example: msiexec /q /i C:\UPPrintServer703.msi
Function: Specifies the full custom installation path for the UniPrint Print
Server program files.
Remarks: The full path specified must be enclosed in double quotation
marks (“ ”) if spaces exist in the path.
Example: msiexec /q /i C:\UPPrintServer703.msi
INSTALLDIR=”C:\Program Files\UniPrint\PrintServer”
UP_SETTING_
SPOOLIP
Function: Specifies the IP Address and port number of the UniPrint Spool
Server. To install UniPrint Spool Server with the default port number, 999,
just type in the IP address without the colon (:) and leave the port number
blank.
Example: msiexec /q /i C:\UPPrintServer703.msi
UP_SETTING_SPOOLIP=192.0.2.100:123
Installing UniPrint Server
UniPrint Server consists of the Universal Printer Driver (UniPrint)
responsible for rendering server-based print jobs as PDF compatible files. This
component is installed on an application server. For UniPrint VDI, UniPrint
Server is installed on the virtual desktop image.
Before starting, ensure that you have recorded the IP address of the UniPrint
Spool Server.
Chapter 2: Installing & Removing UniPrint
15
In UniPrint Gateway and Gateway TSE environments, it is recommended
that UniPrint Server NOT be installed on the same machine as UniPrint
Spool Server and UniPrint Print Server.
NOTE
When installing UniPrint Server on Windows Vista or later with UAC
enabled and you are not logged in as an administrator, run the bootstrap,
Setup.exe.
For non-interactive command line installation instructions, see ”Installing
UniPrint Server from the Command Line” on page 16.
1. Log on to the Citrix/RDS/virtual desktop image with administrative
rights.
2. Run the installation program UPServer703.msi or Setup.exe.
3. If running Setup.exe with UAC enabled, the User Account
Control dialog box will appear. Click Yes to continue.
4. In the UniPrint Server 7.0.3 Installation dialog box, click Next.
5. In the License Agreement dialog box, click I accept the license
agreement and then click Next.
6. In the Destination Folder dialog box, click Next to accept the
default location for the UniPrint Server program files and to install the
Adobe Plug-in. Click Browse to change the default location. If you
16
UniPrint Version 7.0
don’t want to install the Adobe plug-in, clear the Install Adobe®
plug-in check box.
7. In the Spool Server Configuration dialog box, enter the IP
Address of the UniPrint Spool Server or click Auto Locate to run
an auto-discovery function to find an already installed and running
UniPrint Spool Server. NOTE: If using the Auto Locate function in an
environment where there are multiple UniPrint Spool Servers, ensure that the
IP address located is that of the intended UniPrint Spool Server before
proceeding. Click Next to continue.
8. In the Ready to Install the Application dialog box, click Install.
UniPrint Setup will now copy files to your hard disk drive.
9. Click Finish to complete the installation.
10. Click Start, point to Administrative Tools and then click Services.
Check that the UniPrint Control Service has been created and
started.
11. Click Start, point to Settings and then click Printers and Faxes.
Confirm that the UniPrint printer exists and the status is set to Ready.
Installing UniPrint Server from the Command Line
Command line installation is available for UPServer703.msi with the
following options:
NOTE
If UAC is enabled, msiexec.exe must be run as an administrator. To run a
command line as an administrator do the following:
1. Click Start and then click All Programs. Click Accessories.
2. Right-click Command Prompt and select Run as administrator.
Syntax
/q
msiexec /q /i C:\UPServer703.msi [INSTALLDIR= “path”]
[RUN_PRINTPAL={0|1}]
[UP_SETTING_SPOOLIP=nnn.nnn.nnn.nnn:ppppp]
[UP_SETTING_PAPERSIZE=n]
[UP_SETTING_UNIPRINT_AS_DEFAULT={0|1}]
[UP_SETTING_GPO={M|U|S|D}] [UP_SETTING_LOGLEVEL=n]
[UP_SETTING_PASSTHROUGH=n]
Function: Runs the Setup in silent mode (no user intervention required).
Chapter 2: Installing & Removing UniPrint
17
Remarks: Must be used with the /i Windows Installer parameter. If no
additional parameters are passed, default values will be used.
Example: msiexec /q /i C:\UPServer703.msi
INSTALLDIR
Function: Specifies a custom installation path for the UniPrint Server
program files.
Remarks: The path specified must be enclosed in double quotation marks
(“ ”) if spaces exist in the path.
Example: msiexec /q /i C:\UPServer703.msi
INSTALLDIR=”C:\Program Files\UniPrint\Server”
RUN_PRINTPAL
Function: Enables or disables the Run PrintPAL option under Logon
options in the Sessions screen of the UniPrint Management Console.
Remarks: If enabled, the PrintPAL Client will automatically launch when a
session is started. Default is 0(Disabled).
Example: msiexec /q /i C:\UPServer703.msi RUN_PRINTPAL=1
UP_SETTING_
SPOOLIP
Function: Specifies the IP Address and port number of the UniPrint Spool
Server. To install UniPrint Spool Server with the default port number, 999,
just type in the IP address without the colon (:) and leave the port number
blank.
Remarks: If a valid IP address is provided, Gateway Mode will be enabled in
the UniPrint Server installation.
Example: msiexec /q /i C:\UPServer703.msi
UP_SETTING_SPOOLIP=192.0.2.100:123
UP_SETTING_
PAPERSIZE=n
Function: Specifies the default paper size for the UniPrint printer.
Remarks: Alternatively, this option can be set through the UniPrint
Management Console after installation is complete. The more common paper
sizes are listed below. For a complete list of paper sizes, see ”Paper Sizes” on
page 117.
n
Description
1
Letter (8.5 x 11 in)
5
Legal (8.5 x 14 in)
8
A3 (297 x 420 mm)
9
A4 (210 x 297 mm)
Example: msiexec /q /i C:\UPServer703.msi
UP_SETTING_PAPERSIZE=9
UP_SETTING_
UNIPRINT_AS_
DEFAULT
Function: Sets UniPrint as the default printer for all users when set to 1.
Remarks: Alternatively, this option can be set through the UniPrint
Management Console after installation is complete. Default is 1.
Example: msiexec /q /i C:\UPServer703.msi
UP_SETTING_UNIPRINT_AS_DEFAULT=0
18
UniPrint Version 7.0
UP_SETTING_
GPO
Function: Specifies the order in which UniPrint applies settings from Active
Directory Group Policy Objects.
Remarks: If a source is not specified, configurations from that source will not
be applied. Do not use a comma or space between sources. The default order
is UMD.
U
User Policy
M
Machine Policy
S
User Settings
D
Local Machine Settings
Example: msiexec /q /i C:\UPServer703.msi UP_SETTING_GPO=MUD
UP_SETTING_
LOGLEVEL=n
Function: Specifies the debugging log level for troubleshooting purposes.
Remarks: Alternatively, this option can be set through the UniPrint
Management Console after installation is complete. The default level is 1.
n
Description
0
None
1
Errors
2
Info
3
Debug (Full)
Example: msiexec /q /i C:\UPServer703.msi
UP_SETTING_LOGLEVEL=3
UP_SETTING_
PASSTHROUGH=n
Function: Disables or enables UniPrint pass-through.
Remarks: If enabled, UniPrint will treat this application server as a passthrough client, routing print jobs printed from another application server that
has UniPrint Server installed.
n
Description
1
RDP connections only
2
Legacy ICA (9.x and earlier) connections
3
RDP and Legacy ICA (9.x and earlier) connections
4
ICA 10.x and later connections only
5
RDP and ICA 10.x and later connections
6
Legacy ICA (9.x and earlier) and ICA 10.x and later connections
7
RDP, Legacy ICA (9.x and earlier), and ICA 10.x and later
connections
Example: msiexec /q /i C:\UPServer703.msi
UP_SETTING_PASSTHROUGH=5
Installing UniPrint through Active Directory
For each UniPrint MSI package that you want to install through Active
Directory follow these instructions.
Chapter 2: Installing & Removing UniPrint
19
1. From your domain controller, click Start, point to Programs,
Administration Tools and then click Active Directory Users and
Computers.
NOTE
Microsoft Windows Installer 3.1 or later must be installed on the domain
controller, UniPrint Spool Server, UniPrint Print Server, UniPrint Server,
application server and each client image, if you wish to deploy UniPrint
components through Active Directory.
2. Right-click on the Organizational Unit containing the server(s) or
virtual desktop image(s) on which you want a UniPrint component to
be installed and then click Properties.
NOTE
Applying this software installation policy at the domain level may result in the
UniPrint components being deployed to all devices with Windows 2003 or
later, including client devices.
3. Click the Group Policy tab and either select an existing policy or
create a new one. Click Edit to modify the desired Group Policy
Object.
4. Expand Computer Configuration and then expand Software
Settings. Right-click Software Installation, point to New and then
click Package.
NOTE
The MSI packages must be located in a network location that is accessible by
the domain controller, UniPrint Spool Server, UniPrint Print Server,
UniPrint Server, Citrix/RDS servers and virtual desktop images on which
you wish to have UniPrint components installed.
5. Enter the UNC path to locate the UniPrint component MSI package,
for example, \\FileServer\...\...\UPSpoolServer703.msi.
6. In the Deploy Software dialog box, select Assigned and then click
OK. The UniPrint component will now appear in the Group Policy
Object Editor.
20
UniPrint Version 7.0
7. Right-click on the UniPrint component and click Properties.
8. From the UniPrint component Properties dialog box, click the
Deployment tab. Ensure that the Installation user interface
options is set to Maximum.
9. Click OK to apply changes and close the Group Policy Object
Editor.
Obtaining and Applying a UniPrint License
A license file is required for UniPrint to produce print jobs without a
watermark printed across each page. This file is a registry file that needs to be
imported to the UniPrint Spool Server that is also the designated license
server.
Obtaining a UniPrint License
1. Log on to the UniPrint Spool Server machine that has the license
server component installed.
2. Click Start, point to All Programs, click UniPrint Suite and then
click UniPrint Management Console.
3. The top banner displays the license server’s information. Take note of
the server’s IP address and host name.
Chapter 2: Installing & Removing UniPrint
21
NOTE
In a dual NIC environment, UniPrint will detect the first NIC address
reported.
4. Go to the UniPrint Web site, www.uniprint.net. Click Sign in. If
you are a new customer, click Registration. Complete the form and
then click Register.
Under Returning Customer, enter your credentials and then click GO.
5. In your License Profile, click Add a License. An e-mail with a
unique serial number was sent when you purchased a UniPrint
product.
6. Enter the Serial Number (from the e-mail), UniPrint Spool Server
Name and Server IP Address information.
22
UniPrint Version 7.0
NOTE
For a failover cluster, enter the Serial Number (from the e-mail), the Cluster
Name and the Cluster IP Address. For more information on installing
UniPrint in a failover cluster, see ”Removing UniPrint” on page 22.
7. Click Add License and a license file will be sent to the e-mail address
used for signing in.
NOTE
The license file is sent electronically from [email protected]. To ensure
this message is received, verify that anti-spam filters are not blocking messages
from this e-mail address.
Applying a UniPrint License
1. Log on to any UniPrint server with administrative rights.
2. Click Start, point to All Programs, click UniPrint Suite and then
click UniPrint Management Console.
3. Click Add License and then click
License file (*.reg).
to browse for the UniPrint
4. Click the license file and then click Open.
5. Select the license you want to add and then click Finish.
6. The license information should appear under the top banner.
Removing UniPrint
Before proceeding ensure that all user sessions have ended, and that new logons
to the application server/virtual desktop image have been disabled. Removing
UniPrint components requires that the machine be restarted to release files locked
by the operating system.
NOTE
In Windows Server 2003, for a UniPrint Spool Server failover cluster, ensure
that both the UniPrint Routing Service resource and the UniPrint Control
Service resource are deleted prior to removing the UniPrint Spool Server
Chapter 2: Installing & Removing UniPrint
23
component from the nodes. For a UniPrint Print Server failover cluster,
ensure that the UniPrint Control Service resource is deleted prior to
removing the UniPrint Print Server component from the nodes.
Removing UniPrint Server
1. Click Start and then click Control Panel.
2. Click Programs and Features.
3. From the list of installed applications, click the UniPrint Server
7.0.3.
4. Click Uninstall to start the uninstall process.
5. Click Yes to confirm that you want to remove UniPrint Server 7.0.3.
6. Click Yes to restart the server.
Removing UniPrint Print Server
1. Click Start and then click Control Panel.
2. Click Programs and Features.
3. From the list of installed applications, click the UniPrint Print
Server 7.0.3.
4. Click Uninstall to start the uninstall process.
5. Click Yes to confirm that you want to remove UniPrint Print Server
7.0.3.
6. Click Yes to restart the server.
Removing UniPrint Spool Server
1. Click Start and then click Control Panel.
2. Click Programs and Features.
3. From the list of installed applications, click the UniPrint Spool
Server 7.0.3.
4. Click Uninstall to start the uninstall process.
24
UniPrint Version 7.0
5. Click Yes to confirm that you want to remove UniPrint Spool Server
7.0.3.
6. Click Yes to restart the server.
CHAPTER
3
UniPrint Version 7.0
UniPrint Gateway in a Failover Cluster
UniPrint Gateway in a Failover Cluster
Planning your UniPrint Spool Server Installation for a
Failover Cluster
UniPrint Spool Server should be the first UniPrint Gateway component to be
installed. The UniPrint Spool Server acts as a print job router and print
queues are shared from the UniPrint Spool Server to user sessions on the
application server. By installing the UniPrint Spool Server first, connectivity
can be verified among the remaining components (UniPrint Server and
UniPrint Print Server).
NOTE
In a failover cluster, it is recommended that UniPrint Spool Server be installed
on a local hard disk drive on every node, not on the shared Quorum, for
failover to function properly.
Before installing UniPrint Spool Server in a failover cluster, ensure that your
cluster is correctly set up and working properly.
Minimum System Requirements
Each UniPrint Spool Server node requires one of the following:
• Microsoft Windows Server 2003, Enterprise Edition.
• Microsoft Windows Server 2008, Enterprise Edition.
Installing UniPrint Spool Server on a Windows 2003
Cluster Node
1. Log on to the active node with administrative rights and run the
installation program, UPSpoolServer703.msi.
2. In the UniPrint Spool Server 7.0.3 Installation dialog box, click
Next.
26
UniPrint Version 7.0
3. In the License Agreement dialog box, click I accept the license
agreement and then click Next to proceed with the installation.
4. In the Destination Folder dialog box, click Next to accept the
default location for the UniPrint Spool Server program files. Click
Browse to change the default location.
5. In the Select Features dialog box, click Next to install the License
Server and PrintPAL Server on this machine. If you choose not to
install License Server or PrintPAL Server, click
beside the
component and then click
.
6. In the Ready to Install the Application dialog box, click Install to
begin the installation. UniPrint Setup will now copy files to your hard
disk drive.
7. Click Finish to complete the installation.
8. Click Start, click Administrative Tools and then click Cluster
Administrator.
9. Record the Cluster IP Address. This information is required when
installing the other UniPrint Gateway components.
10. Install UniPrint Spool Server on the remaining cluster nodes.
Configuring UniPrint Spool Server Cluster Resources in
Windows 2003
NOTE
The print spooler resource must be created in Cluster Group. It is also
recommended that the UniPrint Routing Service Resource and UniPrint
Control Service Resource only be created in Cluster Group.
Creating a Spooler Resource
The following instructions describe how to create a print spooler resource. If
you already have a print spooler resource, proceed to ”Creating a UniPrint
Routing Service Resource” on page 27.
1. From any node, click Start, click Administrative Tools and then
click Cluster Administrator.
Chapter 3: UniPrint Gateway in a Failover Cluster
27
2. Under the cluster name, expand Groups and then click to select
Cluster Group.
3. In the File menu, point to New, and then click Resource.
4. In the New Resource dialog box, beside Name, type MySpooler
and then from the Resource type list, select Print Spooler. Click
Next.
5. In the Possible Owners dialog box, from the Available nodes list,
hold down CTRL and click all of the nodes. Click Add to make all
nodes in the cluster Possible owners of the MySpooler resource. Click
Next.
6. In the Dependencies dialog box, from the Available resources list,
hold down CTRL and click Cluster Name and a shared disk. Click
Add to make them dependencies. Click Next.
7. In the Print Spooler Properties dialog box, specify a spool folder
path and then click Finish.
8. Click OK.
9. Right-click MySpooler and select Bring Online.
Creating a UniPrint Routing Service Resource
1. From any node, click Start, click Administrative Tools and then
click Cluster Administrator.
2. Under the cluster name, expand Groups and then right-click Cluster
Group.
3. Click New and then click Resource.
4. Beside Name, type UniPrint Routing Service and then from the
Resource type list, select Generic Service. Click Next.
5. In the Possible Owners dialog box, from the Available nodes list,
hold down CTRL and click all of the applicable nodes. Click Add
and then click Next.
6. In the Dependencies dialog box, from the Available resources list,
hold down CTRL and click Cluster Name, Cluster IP Address,
and MySpooler. Click Add to make them dependencies. Click Next
28
UniPrint Version 7.0
7. In the Generic Service Parameters dialog box, beside Service
Name, type UPSplSvc. Click Next.
8. In the Registry Replication dialog box, click Add and then type
Software\UniPrint. Click OK and then click Finish.
9. Click OK.
10. Right-click UniPrint Routing Service and select Bring Online.
Creating a UniPrint Control Service Resource
1. From any node, click Start, click Administrative Tools and then
click Cluster Administrator.
2. Under the cluster name, expand Groups and then right-click Cluster
Group.
3. Click New and then click Resource.
4. Beside Name, type UniPrint Control Service and then from the
Resource type list, select Generic Service. Click Next.
5. In the Possible Owners dialog box, from the Available nodes list,
hold down CTRL and click all of the applicable nodes. Click Add
and then click Next.
6. In the Dependencies dialog box, from the Available resources list,
click UniPrint Routing Service. Click Add to make it a
dependency. Click Next
7. In the Generic Service Parameters dialog box, beside Service
Name, type UPCtlSvc. Click Next.
8. In the Registry Replication dialog box, click Add and then type
Software\UniPrint. Click OK and then click Finish.
9. Click OK.
10. Right-click UniPrint Control Service and select Bring Online.
11. Click Start, click Administrative Tools and then click Services.
Check that the following services have started:
• UniPrint Control Service
• UniPrint Routing Service
Chapter 3: UniPrint Gateway in a Failover Cluster
29
Installing UniPrint Spool Server on a Windows 2008
Cluster Node
1. Log on to the active node with administrative rights and run the
installation program, UPSpoolServer703.msi.
2. In the UniPrint Spool Server 7.0.3 Installation dialog box, click
Next.
3. In the License Agreement dialog box, click I accept the license
agreement and then click Next to proceed with the installation.
4. In the Destination Folder dialog box, click Next to accept the
default location for the UniPrint Spool Server program files. Click
Browse to change the default location.
5. In the Select Features dialog box, click Next to install the License
Server and PrintPAL Server on this machine. If you choose not to
install License Server or PrintPAL Server, click
beside the
component and then click
.
6. In the Ready to Install the Application dialog box, click Install to
begin the installation. UniPrint Setup will now copy files to your hard
disk drive.
7. Click Finish to complete the installation.
8. Click Start, point to Administrative Tools and then click Failover
Cluster Management.
9. In the console tree, click to select the cluster name.
10. In the center pane, click Cluster Core Resources to expand this
section.
11. Expand the cluster name and record the cluster IP address. This
information is required when installing the other UniPrint Gateway
components.
12. Click Start, click Administrative Tools and then click Services.
Ensure that the following services have been created and are set to
Automatic Startup:
• UniPrint Control Service
• UniPrint Routing Service
30
UniPrint Version 7.0
NOTE
Since in a failover cluster, services are controlled by Microsoft Cluster
Services, the startup type will change to Manual after these services are
configured for high availability. For more information, see ”Configuring
UniPrint Spool Server Cluster Resources in Windows 2008” on page 30.
13. Install UniPrint Spool Server on the remaining nodes.
Configuring UniPrint Spool Server Cluster Resources in
Windows 2008
Adding the Print Server Role
The following instructions describe how to add the Print Server role. The
Print Server role must be added to each node in the cluster. If the Print Server
role has already been added, proceed to ”Adding & Configuring the Print
Server Service” on page 30.
1. Click Start, click Administrative Tools and then click Server
Manager.
2. In the left pane, right-click Roles and then click Add Roles.
3. In the Before you Begin dialog box, click Next.
4. In the Select Server Roles dialog box, select Print Services and
then click Next.
5. In the Print Services dialog box, click Next.
6. In the Select Role Services dialog box, ensure the Print Server is
selected and then click Next.
7. In the Confirm Installation Selections dialog box, click Install.
8. In the Installation Results dialog box, click Close.
Adding & Configuring the Print Server Service
Follow the instructions below to add and configure the Print Server service
for high availability. If you already have a Print Server service, proceed to
”Adding & Configuring UniPrint Routing Service Resource” on page 32.
Chapter 3: UniPrint Gateway in a Failover Cluster
31
1. From any UniPrint Spool Server node, click Start, click
Administrative Tools and then click Failover Cluster
Management.
2. If the console tree is collapsed, expand the tree under the cluster
name.
3. Right-click Services and Applications and then click Configure a
Service or Application. This will invoke the High Availability
Wizard.
4. In the Before You Begin dialog box, click Next.
5. In the Select Service dialog box, click Print Server and then click
Next.
6. In the Client Access Point dialog box, type MySpooler, select a
network and then type an IP address that will be used. Click Next.
7. In the Select Storage dialog box, select a storage volume that the
clustered print server should use and then click Next.
8. In the Confirmation dialog box, review the information provided
and then click Next. The wizard will make Print Server highly
available on your network.
9. In the Summary dialog box, click Finish to close the wizard.
10. Click Start and then click Run.
11. In the Run dialog box, type regedit and then click OK.
12. In the registry, expand HKEY_LOCAL_MACHINE\
SOFTWARE\UniPrint\Control Service.
13. On the Edit menu, click New and then click String Value.
14. Type the name of this new key, clusternetworkname.
15. Right-click clusternetworkname and then click Modify.
16. In the Edit String dialog box, under Value data, type MySpooler
and then click OK.
17. On the File menu, click Exit to exit the Registry Editor.
32
UniPrint Version 7.0
NOTE
If the quorum drive is set up on a non-default location in the cluster, the
shared path registry key is required. Enter the path of your quorum under
HKEY_LOCAL_MACHINE\SOFTWARE\UniPrint\Control
Service\SharedPath.
Adding & Configuring UniPrint Control Service Resource
1. From any UniPrint Spool Server node, click Start, point to
Administrative Tools and then click Failover Cluster
Management.
2. If the console tree is collapsed, expand the tree under the cluster
name.
3. Expand Services and Applications, right-click MySpooler, point
to Add a resource and then click Generic Service.
4. In the Select Service dialog box, click to select UniPrint Control
Service and then click Next.
5. In the Confirmation dialog box, click Next.
6. In the Summary dialog box, click Finish.
7. In the center pane, right-click UniPrint Control Service and then
click Properties.
8. Click the Dependencies tab, click Insert and then from the
Resource list, select Print Spooler. Click OK.
9. Click the Registry Replication tab and then click Add.
10. In the Registry Key dialog box, enter SOFTWARE\UniPrint and then
click OK.
11. Right-click UniPrint Control Service, and then click Bring this
resource online.
Adding & Configuring UniPrint Routing Service Resource
1. Under Services and Applications, right-click MySpooler, point to
Add a resource and then click Generic Service.
Chapter 3: UniPrint Gateway in a Failover Cluster
33
2. In the Select Service dialog box, click to select UniPrint Routing
Service and then click Next.
3. In the Confirmation dialog box, click Next.
4. In the Summary dialog box, click Finish.
5. In the center pane, right-click UniPrint Routing Service and then
click Properties.
6. Click the Dependencies tab, click Insert and then from the
Resource list, select Print Spooler.
7. Click Insert and then from the Resource list select the IP address
of the Print Spooler. Click OK.
8. Click the Registry Replication tab and then click Add.
9. In the Registry Key dialog box, enter SOFTWARE\UniPrint and then
click OK.
10. Right-click UniPrint Routing Service, and then click Bring this
resource online.
Planning your UniPrint Print Server Installation for a
Failover Cluster
UniPrint Print Server is the second UniPrint Gateway component to be
installed. UniPrint Print Server is responsible for directing print jobs to the
appropriate printer. This component hosts the specific printer definitions and
drivers required for your printing environment.
NOTE
In a failover cluster, it is recommended that UniPrint Print Server be installed
on the local hard disk drive on every node, not the shared Quorum, for
failover to function properly.
Before installing UniPrint Print Server in a failover cluster, ensure that your
cluster is correctly set up and working properly. For more information on
setting up a print server in a failover cluster, refer to http://
technet.microsoft.com/en-us/library/cc771509%28WS.10%29.aspx.
34
UniPrint Version 7.0
Minimum System Requirements
Each UniPrint Print Server node requires one of the following:
• Microsoft Windows Server 2003, Enterprise Edition.
• Microsoft Windows Server 2008, Enterprise Edition.
Installing UniPrint Print Server on a Windows 2003 Cluster
Node
1. Log on to the active node with administrative rights and run the
installation program, UPPrintServer703.msi.
2. In the UniPrint Print Server 7.0.3 Installation dialog box, click
Next.
3. In the License Agreement dialog box, click I accept the license
agreement and then click Next to proceed with the installation.
4. In the Destination Folder dialog box, click Next to accept the
default location for the UniPrint Print Server program files. Click
Browse to change the default location.
5. In the Spool Server Information dialog box, enter the IP Address
of the UniPrint Spool Server machine. Click Next to continue.
NOTE: Auto Locate will not function correctly when Print Servers are
clustered.
6. In the Ready to Install the Application dialog box, click Install to
begin installing UniPrint Print Server. UniPrint Setup will now copy
files to your hard disk drive.
7. Click Finish to complete the installation.
8. Click Start, click Administrative Tools and then click Services.
Check that the UniPrint Control Service has been created, set to
Automatic and started.
9. Install UniPrint Print Server on the remaining nodes.
Chapter 3: UniPrint Gateway in a Failover Cluster
35
Configuring UniPrint Print Server Cluster Resources in
Windows 2003
NOTE
It is recommended that the UniPrint Control Service Resource only be
created in the Cluster Group.
Creating a Spooler Resource
The following instructions describe how to create a print spooler resource. If
you already have a print spooler resource, proceed to ”Creating a UniPrint
Control Service Resource” on page 36.
1. From any node, click Start, click Administrative Tools and then
click Cluster Administrator.
2. Under the cluster name, expand Groups and then click to select
Cluster Group.
3. In the File menu, point to New, and then click Resource.
4. In the New Resource dialog box, beside Name, type MySpooler
and then from the Resource type list, select Print Spooler. Click
Next.
5. In the Possible Owners dialog box, from the Available nodes list,
hold down CTRL and click all of the nodes. Click Add to make all
nodes in the cluster Possible owners of the MySpooler resource. Click
Next.
6. In the Dependencies dialog box, from the Available resources list,
hold down CTRL and click Cluster Name and a shared disk. Click
Add to make them dependencies. Click Next.
7. In the Print Spooler Properties dialog box, specify a spool folder
path and then click Finish.
8. Click OK.
9. Right-click MySpooler and select Bring Online.
36
UniPrint Version 7.0
Creating a UniPrint Control Service Resource
1. From any node, click Start, click Administrative Tools and then
click Cluster Administrator.
2. Under the cluster name, expand Groups and then right-click Cluster
Group.
3. Click New and then click Resource.
4. Beside Name, type UniPrint Control Service and then from the
Resource type list, select Generic Service. Click Next.
5. In the Possible Owners dialog box, from the Available nodes list,
hold down CTRL and click all of the applicable nodes. Click Add
and then click Next.
6. In the Dependencies dialog box, from the Available resources list,
hold down CTRL and click Cluster Name, Cluster IP Address
and MySpooler. Click Add to make them dependencies. Click Next
7. In the Generic Service Parameters dialog box, beside Service
Name, type UPCtlSvc. Click Next.
8. In the Registry Replication dialog box, click Add and then type
Software\UniPrint. Click OK and then click Finish.
9. Click OK.
10. Right-click UniPrint Control Service and select Bring Online.
11. Click Start, click Administrative Tools and then click Services.
Check that UniPrint Control Service has started.
Installing UniPrint Print Server on a Windows 2008 Cluster
Node
1. Log on to the active node with administrative rights and run the
installation program, UPPrintServer703.msi.
2. In the UniPrint Print Server 7.0.3 Installation dialog box, click
Next.
3. In the License Agreement dialog box, click I accept the license
agreement and then click Next to proceed with the installation.
Chapter 3: UniPrint Gateway in a Failover Cluster
37
4. In the Destination Folder dialog box, click Next to accept the
default location for the UniPrint Print Server program files. Click
Browse to change the default location.
5. In the Spool Server Information dialog box, enter the cluster IP
Address. Click Next to continue. NOTE: Auto Locate does not
function properly when Print Servers are clustered.
6. In the Ready to Install the Application dialog box, click Install to
begin installing UniPrint Print Server. UniPrint Setup will now copy
files to your hard disk drive.
7. Click Finish to complete the installation.
8. Click Start, point to Administrative Tools and then click Services.
Ensure that the UniPrint Control Service has been created and is
set to Automatic Startup.
NOTE
Since in a failover cluster, services are controlled by Microsoft Cluster
Services, the startup type will change to Manual after the service is made
highly available. For more information, see ”Configuring UniPrint Print
Server Cluster Resources in Windows 2008” on page 37.
9. Install UniPrint Print Server on the remaining nodes.
Configuring UniPrint Print Server Cluster Resources in
Windows 2008
Adding the Print Server Role
The following instructions describe how to add the Print Server role. The
Print Server role must be added to each node in the cluster. If the Print Server
role has already been added, proceed to ”Adding & Configuring the Print
Server Service” on page 38.
1. Click Start, click Administrative Tools and then click Server
Manager.
2. In the left pane, right-click Roles and then click Add Roles.
3. In the Before you Begin dialog box, click Next.
38
UniPrint Version 7.0
4. In the Select Server Roles dialog box, select Print Services and
then click Next.
5. In the Print Services dialog box, click Next.
6. In the Select Role Services dialog box, ensure the Print Server is
selected and then click Next.
7. In the Confirm Installation Selections dialog box, click Install.
8. In the Installation Results dialog box, click Close.
Adding & Configuring the Print Server Service
Follow the instructions below to add and configure the Print Server service
for high availability. If you already have a Print Server service, proceed to
”Adding & Configuring UniPrint Control Service Resource” on page 39.
1. From any UniPrint Print Server node, click Start, click
Administrative Tools and then click Failover Cluster
Management.
2. If the console tree is collapsed, expand the tree under the cluster
name.
3. Right-click Services and Applications and then click Configure a
Service or Application. This will invoke the High Availability
Wizard.
4. In the Before You Begin dialog box, click Next.
5. In the Select Service dialog box, click Print Server and then click
Next.
6. In the Client Access Point dialog box, type MySpooler, select a
network and then type an IP address that will be used. Click Next.
7. In the Select Storage dialog box, select a storage volume that the
clustered print server should use and then click Next.
8. In the Confirmation dialog box, review the information provided
and then click Next. The wizard will make Print Server highly
available on your network.
9. In the Summary dialog box, click Finish to close the wizard.
Chapter 3: UniPrint Gateway in a Failover Cluster
39
10. Click Start and then click Run.
11. In the Run dialog box, type regedit and then click OK.
12. In the registry, expand HKEY_LOCAL_MACHINE\
SOFTWARE\UniPrint\Control Service.
13. On the Edit menu, click New and then click String Value.
14. Type the name of this new key, clusternetworkname.
15. Right-click clusternetworkname and then click Modify.
16. In the Edit String dialog box, under Value data, type MySpooler
and then click OK.
17. On the File menu, click Exit to exit the Registry Editor.
NOTE
If the quorum drive is set up on a non-default location in the cluster, the
shared path registry key is required. Enter the path of your quorum under
HKEY_LOCAL_MACHINE\SOFTWARE\UniPrint\Control
Service\SharedPath.
Adding & Configuring UniPrint Control Service Resource
1. From any UniPrint Print Server node, click Start, point to
Administrative Tools and then click Failover Cluster
Management.
2. If the console tree is collapsed, expand the tree under the cluster
name.
3. Expand Services and Applications, right-click MySpooler, point
to Add a resource and then click Generic Service.
4. In the Select Service dialog box, click to select UniPrint Control
Service and then click Next.
5. In the Confirmation dialog box, click Next.
6. In the Summary dialog box, click Finish.
40
UniPrint Version 7.0
7. In the center pane, right-click UniPrint Control Service and then
click Properties.
8. Click the Dependencies tab, click Insert and then from the
Resource list, select Print Spooler. Click OK.
9. Click the Registry Replication tab and then click Add.
10. In the Registry Key dialog box, enter SOFTWARE\UniPrint and then
click OK.
11. Right-click UniPrint Control Service, and then click Bring this
resource online.
Installing Printers on the UniPrint Print Server in a
Windows 2008 Failover Cluster
Proceed with the following instructions after creating a UniPrint Print Server
cluster.
1. On a UniPrint Print Server node, click Start, point to
Administrative Tools and then click Failover Cluster
Management.
2. If the console tree is collapsed, expand the tree under the cluster
name.
3. Expand Services and Applications, and then click MySpooler
Print Server.
4. On the right-hand side, under Actions, click Manage Printers.
Print Management will appear in the console tree.
5. In the console tree, under Print Management, click Print Servers.
6. Right-click MySpooler Print Server and then click Add Printer.
Follow the instructions in the wizard to add the printer.
7. To close Failover Cluster Management with Print Management
in the console tree, click File and then click Exit.
8. To test your failover settings, right-click MySpooler Print Server,
click Move this service or application to another node and then
click an available node.
Chapter 3: UniPrint Gateway in a Failover Cluster
9. In the Please confirm action dialog box, click Move [clustered
print server] to [available node].
10. Status changes can be observed in the center pane.
41
42
UniPrint Version 7.0
CHAPTER
4
UniPrint Version 7.0
Upgrading to UniPrint 7.0
Upgrading to UniPrint 7.0
Planning your UniPrint Upgrade
Upgrade is only supported for UniPrint 6.1.5 or later. With UniPrint 7.0,
we’ve introduced the license server component to the UniPrint Spool Server.
With this addition, you will need to first determine which UniPrint Spool
Server will accommodate the license server component.
To ensure a successful upgrade to UniPrint 7.0, you must:
• Have the following UniPrint components already installed:
• UniPrint Spool Server version 6.1.5 or later for UniPrint Gateway
and VDI installations only.
• UniPrint Print Server version 6.1.5 or later for UniPrint Gateway
and VDI with thin-client support installations only.
• UniPrint Server or UniPrint VDI version 6.1.5 or later.
• Ensure that the server meets the minimum system requirements for
that component.
• If you have more than one UniPrint Spool Server installed, you will
need to decide which Spool Server will host the license server
component and record this server’s IP address and host name.
NOTE
To upgrade to UniPrint 7.0.3 apply the patch files, UPSpoolServer703.msp,
UPPrintServer703.msp and UPServer703.msp.
Recommended Upgrade Procedure
To successfully upgrade your UniPrint environment:
1. Install UniPrint Spool Server 7.0 on your existing UniPrint Spool
Server 6.1.5 machine. The license server component must be installed
on one of the UniPrint Spool Servers. DO NOT remove UniPrint Spool
Server 6.1.5.
2. Install UniPrint Server 7.0 on your existing UniPrint Server 6.1.5
machine or UniPrint VDI 6.1.5 virtual desktop image. DO NOT
44
UniPrint Version 7.0
remove UniPrint Server 6.1.5. or UniPrint VDI 6.1.5. For UniPrint
Server, TSE and VDI rich-client environments proceed directly to
step 5.
3. For UniPrint Gateway, Gateway TSE and VDI with thin-client
support environments, install UniPrint Print Server 7.0 on your
existing UniPrint Print Server 6.1.5 machine. DO NOT remove
UniPrint Print Server 6.1.5.
4. Verify that all printers are created successfully on the UniPrint Spool
Server.
5. Upgrade the UniPrint 6.1.5 licenses to UniPrint 7.0 licenses through
www.uniprint.net.
6. Apply the UniPrint 7.0 licenses to the UniPrint Spool Server that has
the license server component installed.
7. To upgrade to version 7.0.3, apply the following patch files:
UPSpoolServer703.msp, UPServer703 and UPPrintServer703.msp.
Minimum System Requirements
NOTE
Microsoft Windows Installer 3.1 or later is required for UniPrint Gateway
install packages and can be downloaded from www.microsoft.com.
UniPrint Spool
Server
UniPrint Spool Server requires .NET Framework 2.0 or later and one of the
following:
• Microsoft Windows Server 2003.
• Microsoft Windows Server 2008.
UniPrint Print
Server
UniPrint Print Server requires .NET Framework 2.0 or later and one of the
following:
• Microsoft Windows XP Professional.
• Microsoft Windows Vista.
• Microsoft Windows 7.
• Microsoft Windows Server 2003.
• Microsoft Windows Server 2008.
UniPrint Server
UniPrint Server requires .NET Framework 2.0 or later and one of the
following:
• Microsoft Windows Server 2003 with Terminal Services installed in
Application Server Mode.
Chapter 4: Upgrading to UniPrint 7.0
•
45
Microsoft Windows Server 2008 with Terminal Services role installed.
For UniPrint VDI, UniPrint Server is installed on each virtual desktop image
with .NET Framework 2.0 or later and one of the following software
requirements:
• Microsoft Windows XP Professional.
• Microsoft Windows Vista.
• Microsoft Windows 7.
Upgrading UniPrint Spool Server
NOTE
When installing UniPrint Spool Server on Windows Server 2008 or later with
UAC enabled and you are not logged in as an administrator, run the bootstrap,
Setup.exe.
1. Log on to the server with administrative rights.
2. Run the installation program UniPrintSpoolServer70.msi or
Setup.exe.
3. If running Setup.exe with UAC enabled, the User Account
Control dialog box will appear. Click Yes to continue.
4. In the UniPrint Spool Server 7.0 Installation dialog box, click
Next.
46
UniPrint Version 7.0
5. In the License Agreement dialog box, click I accept the license
agreement and then click Next to proceed with the upgrade process.
6. In the Upgrade Information dialog box, select Proceed through
the upgrade process and then click Next.
7. In the Previous Version Detected dialog box, ensure that Backup
/ Restore Gateway Printers is selected and then click Next.
8. In the Select Features dialog box, click Next to install the License
Server on this machine. If you don’t want to designate this machine as
the License Server, click
beside License Server and then click
.
9. In the Ready to Install the Application dialog box, click Install to
begin the removal of UniPrint 6.1.5 components and installation of
UniPrint 7.0 components.
10. Click Finish to complete the installation.
11. Click Yes to restart the server.
12. Click Start, point to All Programs, click UniPrint Suite, and then
click UniPrint Management Console.
13. The top banner displays the host name and IP address of the Spool
Server.
14. Record the IP Address of the Spool Server. This information may be
required when upgrading the other UniPrint components.
15. Click Start, point to Administrative Tools and then click Services.
Check that the following services have been created and are started:
• UniPrint Control Service
• UniPrint Routing Service
16. To upgrade to version 7.0.3, run UPSpoolServer703.msp.
Chapter 4: Upgrading to UniPrint 7.0
47
Upgrading UniPrint Server
NOTE
When installing UniPrint Server on Windows Vista or later with UAC
enabled and you are not logged in as an administrator, run the bootstrap,
Setup.exe.
1. Log on to the server/virtual desktop image with administrative rights.
2. Run the installation program UniPrintServer70.msi or Setup.exe.
3. If running Setup.exe with UAC enabled, the User Account
Control dialog box will appear. Click Yes to continue.
4. In the UniPrint Server 7.0 Installation dialog box, click Next.
5. In the License Agreement dialog box, click I accept the license
agreement and then click Next to proceed with the upgrade process.
6. In the Upgrade Information dialog box, select Proceed through
the upgrade process and then click Next.
7. In the Destination Folder dialog box, click Next to accept the
default location for the UniPrint Server program files and to install the
Adobe Plug-in. Click Browse to change the default location. If you
don’t want to install the Adobe plug-in, clear the Install Adobe®
plug-in check box.
48
UniPrint Version 7.0
8. In the Ready to Install the Application dialog box, click Install to
begin the removal of UniPrint 6.1.5 components and installation of
UniPrint 7.0 components.
9. In the Files In Use dialog box, click Automatically close all
applications and attempt to restart them after setup is
complete or if you want to manually restart the server, click Do not
close applications. (A reboot will be required.) and then click
OK.
10. Click Finish to complete the installation.
11. Click Yes to restart the server.
12. Click Start, point to Administrative Tools and then click Services.
Check that the UniPrint Control Service has been created and
started.
13. Click Start, point to Settings and then click Printers and Faxes.
Confirm that the UniPrint printer exists and the status is set to Ready.
14. To upgrade to version 7.0.3, run UPServer703.msp.
Upgrading UniPrint Print Server
NOTE
When installing UniPrint Print Server on Windows Vista or later with UAC
enabled and you are not logged in as an administrator, run the bootstrap,
Setup.exe.
1. Log on to the server with administrative rights.
2. Run the installation program UniPrintPrintServer70.msi or
Setup.exe.
Chapter 4: Upgrading to UniPrint 7.0
49
3. If running Setup.exe with UAC enabled, the User Account
Control dialog box will appear. Click Yes to continue.
4. In the UniPrint Print Server 7.0 Installation dialog box, click
Next.
5. In the License Agreement dialog box, click I accept the license
agreement and then click Next to proceed with the upgrade process.
6. In the Upgrade Information dialog box, select Proceed through
the upgrade process and then click Next.
7. In the Previous Version Detected dialog box, ensure that Backup
/ Restore Gateway Printers is selected and then click Next.
8. In the Ready to Install the Application dialog box, click Install to
begin the removal of UniPrint 6.1.5 components and installation of
UniPrint 7.0 components.
9. Click Finish to complete the installation.
10. Click Yes to restart the server.
11. Click Start, point to Administrative Tools and then click Services.
Ensure that the UniPrint Control Service has been created and
started.
12. To upgrade to version 7.0.3, run UPPrintServer703.msp.
50
UniPrint Version 7.0
Upgrading and Applying Your UniPrint License
Since UniPrint 7.0 utilizes a license server, you no longer have to apply a
license file on each individual application server. License files now contain the
number of application servers, the license server host name and IP address.
You will be able to change the license server information when you initially
upgrade your license to version 7.0 online.
Follow the steps below to upgrade your UniPrint licenses.
1. Log on to any UniPrint server and open the UniPrint Management
Console. To access the Console, click Start, click All Programs,
click UniPrint Suite and then click UniPrint Management Console.
2. From the upper banner, record the license server’s host name and IP
address.
3. In a Web browser, navigate to www.uniprint.net and click Sign in.
Chapter 4: Upgrading to UniPrint 7.0
51
Under Returning Customer, enter your credentials and then click GO.
4. From your License Profile, click to select the version 6 products that
you would like to upgrade and then click Upgrade Key.
5. If you have already installed UniPrint 7.0 and have a license server,
you can select an existing license server or enter the Server Name
and Server IP address of the new license server.
52
UniPrint Version 7.0
NOTE
Ensure that the license server information is correct. After this initial upgrade,
you will no longer be able to change this information online. To change the
license server information, you will be required to complete and submit the
UniPrint License Server Information Change Request Form, which can be
downloaded from www.uniprint.net after you sign in to the Web site. Only
after this form is submitted will you receive new license files by e-mail.
6. Click to select the servers you wish to upgrade and then click Next.
7. Verify that the information is correct and then click Submit.
8. A confirmation screen will appear and an e-mail with a new license
file will be sent to the e-mail address used to sign in to this Web site.
There will be a new license file e-mail for each existing serial number.
Click Back to Manage Licenses.
9. Download the new license file from the e-mail, save it to an accessible
location and apply them to the license server, see ”Applying a
UniPrint License” on page 22.
CHAPTER
5
UniPrint Version 7.0
UniPrint Tools and Utilities
UniPrint Tools and Utilities
UniPrint Management Console
The UniPrint Management Console is a container for UniPrint management
tools or snap-ins and is installed with each UniPrint component.
The UniPrint Management Console enables administrators to configure
different settings and preferences on the UniPrint Spool Server, UniPrint
Print Server and UniPrint Server. The different snap-ins enable administrators
to:
• Manage all network printers from any location and change the default
properties of each available printer.
• Set the default UniPrint printer settings such as image compression,
font embedding, paper layout, and resolution.
• Apply UniPrint policy changes.
• Gather debugging information. If required, administrators can log
information to assist with troubleshooting any of the UniPrint
components.
• Set options for e-mail and saving print jobs as PDF files.
To start the UniPrint Management Console on any server:
• Click Start, click All Programs, click UniPrint Suite and then click
UniPrint Management Console.
• Alternatively, the console (Console.exe) can be launched from the
application folder, for example, C:\Program Files\UniPrint Suite\
Console.
The following describes all the available settings and options of the UniPrint
Management Console. For the most part, UniPrint Management Console is
the same on each appliance, with the exception of Printer Profiler, which is
installed only on the UniPrint Print Server and UniPrint PrintPAL, which is
installed on the UniPrint Spool Server.
54
UniPrint Version 7.0
Console Home
From the Console Home screen, the top banner displays current appliance
information like server name, IP address and operating system. You also have
access to the license server and can add licenses or view them as they are being
utilized in real time. Additionally, you can now take a detailed snapshot of
license usage.
You can also navigate to any of the setting categories:
• Properties & Settings
• Network Connections
• Tools & Utilities
Under Properties & Settings, you have access to the following settings:
• Printers: Use this screen to manage printers installed on both the
UniPrint Spool Server and on remote UniPrint Print Server(s).
• Components: Use this screen to configure UniPrint component
properties and to access debugging logs. The components displayed
differ depending on which UniPrint appliance is being accessed.
• Policies: Use this screen to manage how Group Policy Objects affect
UniPrint settings.
Under Network Connections, you have access to the following settings:
• Sessions (UniPrint Server only): From this screen you can configure
how UniPrint interacts with user sessions.
• Services: From this screen you can configure local UniPrint services.
The services displayed differ depending on which UniPrint appliance
is being accessed.
Chapter 5: UniPrint Tools and Utilities
55
Under Tools & Utilities, you have access to the following:
• PrintPAL: This utility is only accessible from the UniPrint Spool
Server and UniPrint Server machines and is used to manage session
printer mappings.
Detailed View of
License Usage
To view a detailed snapshot of license usage, under Installed UniPrint
Licenses on [SERVERNAME] ([Server IP Address]), double-click the
license.
A list of users, the license type, the server they are logged into and their
session IDs will appear. Note: This is only a snapshot. Users that log in afterwards
will not be reflected in this view.
56
UniPrint Version 7.0
Save Detailed
License Usage
Snapshot To File
To save the detailed license usage snapshot as a comma-delimited file, do the
following:
1. In the License Usage dialog box, click
.
2. In the Save File dialog box, select a destination to save to and then
type a file name. Click Save.
Copy Detailed
License Usage
Snapshot to the
Clipboard
To copy the detailed license usage snapshot to the Clipboard, do the
following:
1. In the License Usage dialog box, click to select the entry to copy. To
select multiple entries, hold down CTRL and then click an entry. For
Chapter 5: UniPrint Tools and Utilities
57
adjacent entries, hold down SHIFT, click the first entry and then
click the last entry.
2. Click
.
Properties & Settings > Printers
This snap-in resides and is accessible from all UniPrint appliances, however
different settings can be configured on different UniPrint appliances. From
any UniPrint appliance you can view and change printer settings by clicking
on the drop-down menu and selecting a different appliance.
58
UniPrint Version 7.0
On the UniPrint Spool Server administrators have the ability to change the
default printer properties, delete, pause an available printer and create new
FTP printer instances. To create a new FTP printer instance, see ”Adding a
Lexmark/HP FTP Printer” on page 65.
From the UniPrint Print Server, administrators can add new Gateway
printers, publish them to the UniPrint Spool Server, specify how printers are
published, access the Printer Profiler utility and convert printers into thin
client printers.
On the UniPrint Server, only the UniPrint printer is displayed. To edit the
properties of the UniPrint printer, click to select it and then click Properties.
Changing
Printer(s)
Properties
From the UniPrint Spool Server the administrator can change the default
configuration of a single or multiple printers for all users. From the UniPrint
Server, the default printer properties of the UniPrint printer can be
configured. Although the screen shots below are taken from a UniPrint
Gateway printer, the steps outlined are the same for changing UniPrint
printer properties on the UniPrint Server.
1. Select a printer or multiple printers from the details pane. Multiple
printers can be selected by pressing CTRL and then clicking the
desired printers.
2. Click Properties.
3. If multiple printers are selected, only the common properties are
shown. Blank fields indicate that the properties are not the same.
Chapter 5: UniPrint Tools and Utilities
59
Changing a property will change it for all selected printers. In the
General tab, only the location and comment can be changed.
NOTE
The name and shared name of a UniPrint Gateway printer can be changed by
using Publish Options on the UniPrint Print Server and then republishing the
printer to the UniPrint Spool Server, see ”Changing Publishing Options” on
page 66.
60
UniPrint Version 7.0
4. In the Configuration tab, you can set the following properties:
Page size
This option sets the default paper size for the printer. The various paper sizes
and forms listed match those supported by UniPrint and include standard sizes
as well as any custom forms defined on the application server. For a full list of
paper sizes supported by UniPrint, see ”Paper Sizes” on page 117.(Default is
Letter; User Configurable)
To define a custom form on the application (Citrix/RDS) server:
1. Click Start and then click Printers.
2. Point to any white space in the Printers dialog box, right-click and
select Server Properties.
3. In the Forms tab, enable the Create a new form option and specify
a Form name and the appropriate measurements.
4. Click Save Form to create the custom form.
Chapter 5: UniPrint Tools and Utilities
61
Once the custom form is defined on the application server, it will be available
in UniPrint’s Page Size list.
To use the Custom paper size during a user session:
1. Invoke the Print dialog box from any application.
2. Select UniPrint from the Printer list and bring up the Printing
Preferences dialog box.
3. On the Configuration tab, select Custom from the Paper size list
and enter the appropriate Width and Length (in millimeters)
information.
4. Click OK to close the UniPrint Printing Preferences dialog box
and print.
Resolution
The resolution for a document can be set to 75, 150, 300, 600, or 1200 dots
per inch (dpi). This option affects mainly image resolution but text precision
can also be improved by increasing this value. The designated printer must, of
course, be capable of printing at the desired resolution setting. (Default is 300
dpi; User Configurable)
Orientation
The orientation of a document can be set to either Portrait or Landscape.
Portrait orients the print job vertically while Landscape orients the print job
horizontally. Applications that set this parameter internally take precedence.
Microsoft Word, for example, sets the Layout Orientation internally. (Default
is Portrait; User Configurable)
Dimensions (mm)
For custom forms you can define the width and height in millimeters.
Physical Margins (mm)
Most printers have a minimum physical margin outside of which they cannot
generate any output. Each printer’s mechanical design dictates the size of this
printable area and the size of the margins. Applications use this value to
prevent users from drawing outside the printable area. Horizontal specifies
the margin from the left and right edge of the paper. Vertical specifies the
margin from the top and bottom edge of the paper. (Default is 6mm; User
Configurable)
62
UniPrint Version 7.0
NOTE
For users using Adobe Reader on their client workstations to process print
jobs, setting Adobe’s Page Scaling option to anything other than None may
affect the margins set in the documents.
Paper Source
For the UniPrint printer this option sets the paper tray source. The available
options are Auto Select, Manual Feed, Envelope Feed and up to six Tray
selections. For UniPrint Gateway printers, the options displayed may differ
since they are imported from the native printer driver installed on the
UniPrint Print Server. (Default is Auto Select; User Configurable)
Double sided printing
This option sets the double-sided printing functionality. The available options
are Off (print on one side), Flip pages up and Flip pages sideways. Flip pages
up refers to tablet style documents and Flip pages sideways refers to book style
documents. The designated printer must have duplexing capabilities. (Default
is Off; User Configurable)
Auto Center
When set, document content will be centered on the page both horizontally
and vertically. This option is only applicable to UniPrint Gateway printers.
(Default is On; User Configurable)
Fit to page
Reduces each page to fit a specified paper size for printing purposes only; this
option shrinks the content in the print output but does not actually reduce
the document size. To change the document size and save it as a PDF file,
select Scale to Fit in the Resizing option. This option is only applicable to
UniPrint Gateway printers. (Default is Off; User Configurable)
Resizing
Although PDF files can be created as large as 38 100 000 cm in either
direction, most desktop printers cannot print large documents. To print
oversized documents you can Scale to Fit on a specified paper size, set
Chapter 5: UniPrint Tools and Utilities
63
scaling to a % of actual size by a specified percentage, or you can print out
Multi-pages per sheet, also known as N-up printing, and specify the
number of pages per sheet. Multi-pages per sheet is done intelligently to
maximize legibility with the number of pages per sheet selected and the
original orientation of the document. Resizing changes the document size so
that it can be saved as a PDF. (Default is None; User Configurable)
5. In the Fonts & Images tab, you can define the following properties:
Postscript emulation
Some applications query the printer and modify their drawing operations if
the printer is a PostScript printer to produce higher quality images. Enabling
this option emulates the UniPrint printer driver as a PostScript printer to the
application. This is particularly useful when printing documents with vector
graphics such as WordArt objects or semi-transparent backgrounds from
Microsoft Office. (Default is Enabled; User Configurable)
Font options
Full font embedding enables the driver to include all TrueType and Type 1
(PostScript) fonts used by the document in the output PDF file. This results in
larger files but ensures a consistent look of the document on any platform.
64
UniPrint Version 7.0
Minimal font embedding enables the driver to include only portions of the
font file that are used by the document. The options are as follows:
• Standard fonts: If enabled, the UniPrint driver will embed Arial and
Times New Roman font files. These fonts are not embedded by
default as they are provided with Adobe Reader. (Default is Disabled;
User Configurable)
• Licensed fonts: If enabled, the UniPrint driver will embed licensed
fonts that are installed on the application server. However, the fonts
may not be embedded if the font license agreement prohibits
embedding. (Default is Disabled; User Configurable)
• Unicode fonts: If enabled, the UniPrint driver will convert
characters that are not in Western European or US character sets (such
as Eastern European and Far Eastern characters). This conversion
tends to increase the file size. (Default is Disabled; User Configurable)
Color options
The following describes each available color option when printing. (Default is
Color; User Configurable)
• Grayscale: This option is optimized for black and white image
printing. It will convert color images into shades of black and white
that best fits the original image.
• Color: This option is best for printers that utilize R(Red), G(Green),
B(Blue) color space and is also recommended for documents that will
be displayed online or viewed on a monitor.
• CMYK: This option works best for printers that utilize the C(Cyan),
M(Magenta), Y(Yellow) and K(Black) color space.
Black and White compression
The following is a description of each available compression scheme. (Default
is Default; User Configurable)
• Default: Does not compress black and white images.
• CCITT Fax Group 4: This algorithm is recommended to reduce
the size of black and white images. Image quality is not affected by this
type of compression but file sizes can be greatly reduced.
Color image compression
The following is a description of each available compression scheme. (Default
is Automatic; User Configurable)
• Default: Makes use of color palettes to reduce the overall size of all
images. This algorithm works well as long as the number of colors in
the images do not exceed 256.
• 256: Computes the most used 256 colors in an image and replaces all
other color pixels by their closest match. This compression algorithm
works very well with most applications but is relatively slow on large
images with a greater number of colors.
Chapter 5: UniPrint Tools and Utilities
•
•
65
JPEG: Produces excellent results with real life true color images with
a small distortion of the source image. Since it removes image data and
may reduce image quality, compressing images that have already been
compressed using JPEG compression will lead to additional loss of
information. It is, therefore, not recommended for graphics other than
photographs. The Image quality box allows users to choose from
level 1 to 9. Level 1 produces lower quality images with very large
compression ratios. Level 9 produces higher quality images with
medium compression ratios. The default level is 7, which produces
image quality suitable for most situations.
Automatic: With this compression algorithm, each image is analyzed
separately to determine the best suited compression algorithm. The
best suited compression algorithm is then applied to the individual
image. The Image quality selection box appears, allowing users to
choose between Maximum, High, Medium, Low and Minimum. The
default level is Maximum, which will provide optimal results.
6. Click Save.
Adding a
Gateway printer
Adding a Gateway printer is done on the UniPrint Print Server.
1. On the UniPrint Print Server, click Start and then click Printers.
2. Click Add a Printer and then follow the printer manufacturer’s
instructions for installing their printer driver.
3. In the UniPrint Management Console, under Properties &
Settings, click Printers. Click Refresh.
4. On the UniPrint Spool Server, under Properties & Settings, click
Printers. Click Refresh.
5. The new printer should appear in the printer list of type Gateway.
Adding a
Lexmark/HP FTP
Printer
UniPrint-ready Lexmark/HP FTP printers can be defined and configured to
send print jobs directly to these printers without going through a UniPrint
Print Server. Since each UniPrint-ready Lexmark/HP FTP printer acts as its
own print server, it can directly interpret PDF files without installing native
printer drivers.
1. From the UniPrint Spool Server, under Properties & Settings, click
Printers.
2. Click Add Printer.
3. Enter the new printer name, then click Create it.
66
UniPrint Version 7.0
4. In FTP tab, enter the information that is relevant to your
configuration.
• Address: The IP address of the Lexmark/HP FTP printer.
• Port: The FTP listener port of the Lexmark/HP FTP printer.
Default is 21.
• Anonymous Login: Click to select if anonymous logins are
allowed. If this check box is cleared enter the Username, Password
and Confirm Password.
• Username: The FTP account for submitting print jobs to the
Lexmark/HP FTP printer.
• Password: The FTP account password for submitting print jobs
to the Lexmark/HP FTP printer.
• Confirm Password: Enter the FTP account password again.
5. In the General tab, enter the Location and Comment for the
Lexmark/HP FTP printer.
6. Click the Configuration tab to change the default printer properties
as desired. For more information on the Configuration tab, see
”Changing Printer(s) Properties” on page 58.
7. Click the Fonts & Images tab to change the default settings as
desired. For more information on the Fonts & Images tab, see
”Changing Printer(s) Properties” on page 58.
8. Click Save. The new printer should appear in the printer list as type
FTP.
Deleting a
Printer
Deleting a printer from the UniPrint Spool Server does not delete it from the
UniPrint Print Server.
1. Click to select the printer that you want to delete.
2. Click Delete.
3. Click Yes to confirm that you want to delete the selected printer.
NOTE
To recreate the printer later, click Publish on the UniPrint Print Server’s
Printers screen.
Changing
Publishing
Options
Part of the UniPrint Print Server’s function is to enumerate available printers
on each print server and make them available on the UniPrint Spool Server. If
a printer is deleted from the UniPrint Spool Server, the UniPrint Print Server
Chapter 5: UniPrint Tools and Utilities
67
can republish the printer to the UniPrint Spool Server. The way in which
printers are published to the UniPrint Spool Server is managed from the
UniPrint Print Server.
1. On the UniPrint Print Server, click the drop-down arrow beside
Publish and then click Publish Options.
2. In the Publish Options dialog box, placeholders are used to
represent variables. For example, %PRINTER% represents the printer
name. These placeholders can be rearranged or deleted depending on
how you would like the printers to be published and displayed on the
UniPrint Spool Server.
%PRINTER%
Printer name.
%HASH%
Hash number assigned by
UniPrint to ensure each
Gateway printer is unique.
%COMMENT%
Comments provide general
information about the printer.
UniPrint imports this information from the Comment
field of the local Print Server
queue.
%LOCATION%
Location describes where the
printer is situated. UniPrint
imports this information from
the Location field of the local
Print Server queue.
%MACHINE%
Print server name.
%DOMAIN%
Domain name of the print
server.
68
UniPrint Version 7.0
3. Edit how you would like your printers to be published and then click
OK. For example, if it is better not the display the unique UniPrint
Gateway printer ID number, then remove [%HASH%] from the
Name field. All printers published to the UniPrint Spool Server will
appear as instructed through the Publish Options dialog box. Any
previously published printers will remain unchanged.
NOTE
Adding a hash number to the printer name ensures distinctiveness between
printers on the UniPrint Spool Server. For example, if two printers with
identical printer name are published from two different UniPrint Print Servers
to the same UniPrint Spool Server, then only one printer will be successfully
added to the UniPrint Spool Server.
Convert a Printer
Instance into a
Thin-client
printer
For thin-client devices running Windows CE/Embedded CE that require
support for USB printers directly attached to them, a printer instance can be
converted into a UniPrint thin-client printer.
NOTE
To use the UniPrint thin-client printer, when a user connected from a thinclient device prints from an ICA/RDP session, instead of printing to a
Gateway printer the user needs to print to the UniPrint printer. The print job
Chapter 5: UniPrint Tools and Utilities
69
is rendered on the UniPrint Print Server and then transferred to the USB
printer through the thin-client device.
1. On the UniPrint Print Server, install the printer driver following the
manufacturer’s instructions.
2. In the UniPrint Management Console, under Properties &
Settings, click Printers. The printer should appear in the printer list.
To convert this printer driver into a thin-client printer, right-click the
printer and then click Convert to Thin Client.
3. Click Yes to confirm that you want to convert the printer into a thin
client printer.
4. The printer will now change from type Published Local to Thin Client
and the shared printer queue will be deleted from the UniPrint Spool
Server.
Properties & Settings > Components
Debugging capability is implemented on all UniPrint appliances to provide
additional information for troubleshooting.
Four logging levels are available: None, Errors, Info and Debug (Full). To
change the debug level of a component, do one of the following:
• Click to select the component, click Trace level and then click the
desired debug level.
70
UniPrint Version 7.0
•
Right-click a component and then click the desired debug level.
All log files are created in \\Program Files\UniPrint Suite\Log Files.
To change component settings, click to select a component and then click
Properties or right-click a component and then click Properties.
Different components reside on different UniPrint appliances. All
components are described below.
PrintPAL Server
This component resides on the UniPrint Spool Server and is responsible for
mapping printers to user sessions based on a combination of network
administrator-defined settings and user preferences.
If enabled, a log file, UPPPSvr_%timestamp%.log is created. This information
can be used to troubleshoot mapping issues with PrintPAL.
UniPrint Control
Service
This component resides on all UniPrint appliances and maintains information
exchange connections with UniPrint routing servers and controls execution
of UniPrint plug-ins and on-demand processors. You can edit the Port, Log
Level and add, edit or delete a spool server. The default port is 998.
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot connectivity issues with the UniPrint
Spool Server.
Chapter 5: UniPrint Tools and Utilities
71
Edit UniPrint Spool Server Connection Information
To edit Spool Server connection information, right-click UniPrint Control
Service and then click Properties. Click the Spool Servers tab. From here
you can add, edit properties or delete a Spool Server’s IP address or port
number.
Printing Fault Tolerance
When more than one UniPrint Spool Server is specified and if the first
UniPrint Spool Server becomes unavailable, UniPrint will failover to the next
UniPrint Spool Server in the list. If a server failure occurs on the UniPrint
Spool Server that also hosts the license server component then the failover
will allow users to continue to print but a watermark will be printed across
each page since licenses can no longer be validated. To add a UniPrint Spool
Server, click
, enter the corresponding IP Address and Port information
and then click OK.
UniPrint Printer
Driver
This component resides on the UniPrint Server only. If enabled, a log file
UP_Driver_%timestamp%.log is created in the user’s temp directory, for
example, C:\Users\DMorgan\AppData\Local\Temp. Only the Log Level
can be edited.
UniPrint Session
Application
This component resides on the UniPrint Server only. If enabled, a log file
Logscript-Administrator-SID1_%timestamp%.log is created in the user’s temp
directory. From the user’s session, the log file Logscript-AdministratorSID1_%timestamp%.log can be viewed by right-clicking the UniPrint icon in
the notification area and selecting View Log.
72
UniPrint Version 7.0
To Ensure Only Gateway Licenses Are Utilized
For environments that utilize both UniPrint Server and UniPrint Gateway
licenses, do the following:
1. Right-click UniPrint Session Application and then click
Properties.
2. Click the Environment tab and select Requires Gateway licenses.
Selecting this check box will ensure that this server will utilize
Gateway licenses only.
3. Click OK.
NOTE
For environments that utilize only one license type, the Require Gateway
licenses check box must be clear.
Connected node
management
plug-in
This component resides on the UniPrint Spool Server and manages the
presence of active UniPrint nodes and services node-related requests. Only
the Port and Log Level settings can be edited. The default port is 25469.
If enabled, a log file UPCtlSvc_%timestamp%.log is created. This information
can be used to troubleshoot active nodes and services.
Chapter 5: UniPrint Tools and Utilities
Font replication
plug-in
73
This component resides on the UniPrint Print Server and manages font
availability by requesting fonts from UniPrint Server(s) once daily at the
scheduled time. Font replication eliminates the occasional need to embed
fonts when printing through UniPrint. The Log Level and polling schedule
can be set.
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot issues regarding font replication on
the UniPrint Print Server.
Enable Font Replication
1. Right-click Font replication plug-in and then click Properties.
2. Click the Schedule tab and select Enabled.
3. Enter a time for the UniPrint Print Server to query UniPrint Server(s)
for newly installed fonts and replicate them on the UniPrint Print
Server. Default time is set to 02:00 AM.
4. To run font replication on demand, click Run now.
Font request
processor
This component resides on the UniPrint Server and marshals and completes
font list and font requests from remote print servers. Only the Log Level can
be edited.
74
UniPrint Version 7.0
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot issues regarding font replication.
FTP print job
processor
This component resides on the UniPrint Spool Server and enables printing
directly to FTP-enabled printers. Only the Log Level can be edited.
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot a Lexmark/HP FTP printer.
License manager
plug-in
This component resides on the UniPrint Spool Server and is responsible for
active license administration and distribution. Only the Port and Log Level
can be edited. The default port is 25467.
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot license management issues.
License request
processor
This component resides on the UniPrint Spool Server and marshals license
requests from remote servers and relays these requests to the license manager
plug-in. Only the Log Level can be edited.
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot license requests from remote
application servers.
Log file
maintenance
plug-in
This component resides on all UniPrint servers and enables the application of
user-defined values to prevent the UniPrint logging structure from exceeding
applied thresholds. The Log Level can be edited to provide greater detail and
the limits for Maximum Folder Size and Maximum File Size can be modified
to better suit available server resources.
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot issues regarding log file thresholds
and cleanup.
Node
identification
plug-in
This component resides on all UniPrint appliances and serves to identify itself
on the UniPrint node network. Only the Log Level can be edited.
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot issues regarding local node
identification.
Node request
processor
This component resides on the UniPrint Spool Server and marshals
connected node requests from remote servers and relays these requests to the
Node identification plug-in. Only the Log Level can be edited.
Chapter 5: UniPrint Tools and Utilities
75
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot issues regarding remote node
requests.
Printer creation
processor
This component resides on the UniPrint Spool Server and handles the
creation and maintenance of UniPrint Gateway queues from remote print
servers. Only the Log Level can be edited.
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot printer replication from a connecting
UniPrint Print Server.
Printer lookup
optimization
plug-in
This component resides on both the UniPrint Spool Server and UniPrint
Print Server and is responsible for generating and maintaining a list of available
printers. It optimizes performance since the list can be used to lookup up
printers before enumerating the Windows spooler.
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot load balancing and printer
unavailability issues.
Printer discovery
plug-in
This component resides on the UniPrint Print Server and monitors local print
server printers and relays changes to the UniPrint Spool Server. The Log
Level can be edited to provide greater detail and publishing naming formats
can be rearranged as desired. For information on editing the publishing
naming formats, see ”Changing Publishing Options” on page 66.
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot issues regarding print server printer
monitoring.
Print job
processor
This component resides on the UniPrint Print Server and accepts print jobs
from servers and relays information to the UniPrint rendering engine. It is
also responsible for monitoring and reporting print job status back to the
originating server. The Log Level and Port number can be edited and print
jobs can be set to be saved with a specified naming convention. The default
port is 2468 and naming convention is %USER%-%FILE% which are
placeholders for user name and file name. The naming convention refers to
the print job name displayed in the print queue. If the Save jobs option is
enabled, print jobs are saved on the UniPrint Print Server in \\Program
Files\UniPrint Suite\Services\Data\PrintJob.
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot issues regarding print job monitoring
and reporting.
76
UniPrint Version 7.0
Process
delegation plugin
This component resides on all UniPrint appliances and starts and monitors
UniPrint-related processes. The Log Level can be edited and processes can be
added or removed.
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot issues regarding UniPrint-related
processes.
Quorum
synchronization
plug-in
This component resides on both the UniPrint Spool Server and UniPrint
Print Server and maintains synchronization of cluster quorum files with
locally stored UniPrint configuration files.
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information is only relevant for failover clusters and can be used to
troubleshoot issues regarding quorum path availability.
Remote Console
query processor
This component resides on all UniPrint appliances and enables UniPrint
console to process commands initiated from remote system nodes. Only the
Log Level can be edited.
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot issues regarding command processing
from remote UniPrint appliances.
Thin-client
printer (USB)
request
processor
This component resides on the UniPrint Spool Server and marshals thinclient printer requests from remote servers and relays these requests to the
thin-client printer management plug-in. Only the Log Level can be edited.
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot issues regarding printing requests
from thin-client printers.
Thin-client
printer
management
plug-in
This component resides on the UniPrint Spool Server and maintains a list of
printers designated as UniPrint thin-client printers along with their associated
print servers. The Port and Log Level can be changed. The default port is
25470.
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot issues regarding UniPrint thin-client
printers.
Thin-client print
job processor
This component resides on the UniPrint Print Server and accepts print jobs
from thin clients and relays information to the UniPrint rendering engine. It
is responsible for monitoring and reporting print job status back to the
originating server. Only the Log Level can be edited.
Chapter 5: UniPrint Tools and Utilities
77
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot issues regarding thin-client printer
print job monitoring and reporting.
UniPrint driver
install plug-in
This component resides on the UniPrint Spool Server and the UniPrint
Server and installs the UniPrint printer driver. Only the Log Level can be
edited.
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot issues regarding driver and port
installation and removal.
UniPrint printer
install plug-in
This component resides on the UniPrint Server and installs the UniPrint
printer, port and port monitor. Only the Log Level can be edited.
If enabled, a log file UPCtlSvc_%timestamp%.log is created. This information
can be used to troubleshoot issues regarding the UniPrint printer installation.
UniPrint spool
server 64-bit
layer plug-in
This component resides on the UniPrint Spool Server and provides
compatibility for 32-bit to 64-bit UniPrint Gateway printing. Only the Log
Level can be edited.
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot issues regarding the Windows-OnWindows support layer.
UniPrint spool
service discovery
plug-in
This component resides on the UniPrint Spool Server and is responsible for
responding to UniPrint Spool Server IP discovery requests. Only the Log
Level can be edited.
If enabled, a log file, UPCtlSvc_%timestamp%.log is created. This
information can be used to troubleshoot issues regarding Spool Server IP
requests from remote appliances.
UniPrint Routing
Service
This component resides on the UniPrint Spool Server and authenticates and
manages connections between UniPrint Control Services. The Port, Log
Level and Mode can be changed. The default port is 999.
If enabled, a log file UPSplSvc_%timestamp%.log is created. The information
can be used to troubleshoot issues regarding incoming connections from other
UniPrint nodes.
Discovery mode
Allows any Print Server or UniPrint Server to become a subscriber of the
UniPrint Gateway domain.
78
UniPrint Version 7.0
Production mode
When enabled, new subscribers are not allowed to join the UniPrint Gateway
domain.
Properties & Settings > Policies
Administrators can configure how UniPrint applies configuration settings
from alternate sources. Alternate sources include: Active Directory group
policy and saved user preferences.
Selecting the Enable policies option instructs UniPrint to apply settings in
the order of precedence set in this list. Configuration sources at the top of the
list have the highest priority. To disable a source, clear the check box beside it
in the list.
Clearing the Enable policies option forces UniPrint to apply settings based
solely on the ones set from the UniPrint Management Console. This is useful
when troubleshooting a configuration issue.
User policy
Machine policy
User settings
When selected, settings configured for specific users or user groups through
Active Directory group policy will be applied. This policy is only applicable
to the UniPrint Server.
When selected, settings configured for specific UniPrint components through
Active Directory group policy will be applied.
When selected, certain settings configured by users will be persistent across
multiple ICA/RDP sessions. These settings include: Orientation, Page Size,
Chapter 5: UniPrint Tools and Utilities
79
Resolution, Paper Source and Double sided printing. They may, however, be
overridden by a group policy listed higher in the processing order. This policy
is only applicable to the UniPrint Server.
Machine settings
Machine settings are default settings configured from the UniPrint
Management Console and cannot be disabled. These settings always have the
lowest priority. To enforce machine settings, clear all other alternate source
check boxes.
Network Connections > Sessions (UniPrint Server only)
Protocol
UniPrint supports two virtual channel protocols: RDP and ICA. Based on the
connecting client’s protocol, UniPrint creates a private, protocol-specific
virtual channel between the application server and the client device for
transferring rendered print jobs. Available options include:
• RDP: Does not require Citrix to be installed on the RDS server.
• ICA Virtual Channel: Does not require client drive mapping to be
enabled on the Citrix server.
• Client Drive Mapping: Requires client drive mapping to be
enabled on the Citrix server and is compatible with both Windows
and non-Windows clients.
• Mac Client: Allows a Macintosh machine to access an application
server.
To change the order UniPrint uses when auto detecting the transfer protocol,
click the protocol name and then click the arrow buttons to move the selected
protocol up and down in the list. Only the first detected transfer protocol is
used. (Default is RDP, ICA Virtual Channel, Client Drive Mapping, Mac Client)
80
UniPrint Version 7.0
Pass-Through
Selecting this option allows UniPrint to treat this application server as a passthrough client, routing print jobs printed from another application server that
has UniPrint Server installed. As a pass-through client, UniPrint spools print
jobs through chained ICA/RDP sessions where users connect from one ICA/
RDP session to another by launching a second ICA/RDP session within their
original session. Pass-through printing allows UniPrint to send print jobs
seamlessly through multiple ICA/RDP sessions to the first client workstation
in the chain. (Default is Cleared)
Logon Options
Set UniPrint as default printer
When this option is selected, all users who have access to the UniPrint printer
will have it set as their default printer in their sessions. (Default is Selected)
Delete leftover print jobs
Deletes any leftover print jobs from disconnected sessions when the same user
logs back on to the application server. (Default is check box is Cleared)
Run PrintPAL
Launches the PrintPAL Client when a session is started. The PrintPAL Client
icon will appear in the notification area at startup. (Default is check box is
Cleared)
Optional
Features
Enable Email
Selecting this option allows users to e-mail a copy of their print job as an
attachment via Simple Mail Transfer Protocol (SMTP). (Default is check box is
Cleared)
Mail server address
Specifies the e-mail server to use for this feature. The server defined here must
have an SMTP service running. (Default is Blank; Port is 25)
Sender email address
All email sent through UniPrint will appear to be sent from this e-mail
address. (Default is Blank)
Mail server requires authentication
This option must be enabled if the e-mail server specified in Mail server
address option requires authentication. If the e-mail server does not require
authentication, this option must be disabled. When enabling this option, the
Mail user and Mail password information fields to authenticate to the email server must be entered. (Default = check box is Cleared)
E-mailing print jobs in user sessions
When the Send Email check box is selected and e-mail information is
completed in the Email tab of the Gateway or UniPrint Printing
Preferences, the print job is attached as a PDF file and sent to the e-mail
Chapter 5: UniPrint Tools and Utilities
81
addresses listed. To send to multiple addresses separate each address with a
semi-colon (;). To print and e-mail the print job at the same time, click Print
& Email.
To print and e-mail or only e-mail the print job each and every time you
print to the specified UniPrint or Gateway printer, select Always use these
settings.
WARNING
If Always use these settings is enabled then a PDF of the print job will be
sent to the specified e-mail address(es) every time you print, even if you close
your session and log back in again. Enable this setting only if this is really what
you want to do.
82
UniPrint Version 7.0
Enable Save
Selecting this option allows users to save their print jobs as PDF files to any
network accessible location. (Default is Selected)
Save to user’s Documents
If selected, the user’s individual Documents folder will be the default save
location. Changes made to this location within user sessions will be saved in
users’ profiles, overriding the location specified in Save to other location.
(Default is Selected)
Save to other location
Network administrators can specify to which directory users can save their
PDF files. The location must already exist since a new folder will not be
created if the location is invalid and Save will be disabled. (Default is Blank)
Saving Print Jobs in User Sessions
Users can specify a file name and change the save location in the Save tab of
Gateway or UniPrint Printing Preferences by clicking Browse. To print
and save the print job at the same time, click Print & Save.
To print and save or only save the print job each and every time you print to
the UniPrint or specified Gateway printer, select Always use these settings.
WARNING
If Always use these settings is enabled then a PDF of the print job will be
saved to the specified location every time you print, even if you close your
Chapter 5: UniPrint Tools and Utilities
83
session and log back in again. Enable this setting only if this is really what you
want to do
84
UniPrint Version 7.0
Network Connections > Services
UniPrint-related services can be stopped, paused and restarted. The properties
of these services can also be edited by clicking the service to select it and then
clicking Properties.
UniPrint Control
Service
This service resides on all UniPrint appliances. For more information, see
”UniPrint Control Service” on page 70.
Connected node
management
plug-in
This service resides on the UniPrint Spool Server. For more information, see
”Connected node management plug-in” on page 72.
License manager
plug-in
This service resides on the UniPrint Spool Server. For more information, see
”License manager plug-in” on page 74.
Print job
processor
This service resides on the UniPrint Print Server. For more information, see
”Print job processor” on page 75.
Thin-client
printer
management
plug-in
This services resides on the UniPrint Spool Server. For more information, see
”Thin-client printer management plug-in” on page 76.
UniPrint Remote
Console Listener
This service resides on all UniPrint appliances and accepts console commands
from remote appliances. Only the Port can be edited. The default port is
2658.
Chapter 5: UniPrint Tools and Utilities
UniPrint Routing
Service
85
This service resides on the UniPrint Spool Server. For more information, see
”UniPrint Routing Service” on page 77.
Configuring UniPrint Using Administrative Templates in
Windows
Most configuration can be done through the UniPrint Management Console,
however, UniPrint has provided administrative templates to standardize
configuration for a larger number of users.
An ADM, ADMX and ADML (Administrative Template) files are available in
the UniPrint Suite installation directory, for example C:\Program
Files\UniPrint Suite\ADM Templates. Using an administrative template
file, network administrators can configure default UniPrint settings in a
structured manner for all users.
Loading a Classic Administrative Template
To load the classic administrative template, UniPrint701_*.adm, into Active
Directory:
1. From your domain controller, click Start, point to Programs,
Administrative Tools and then click Active Directory Users and
Computers.
2. Right-click the domain you want UniPrint701_*.adm to be applied
to and select Properties.
3. Click the Group Policy tab. Select the Group Policy setting you
want to edit and then click Edit to open the Group Policy Object
Editor.
4. Under either Computer Configuration or User Configuration,
right-click Administrative Templates and then click Add/
Remove Templates.
5. Click Add and browse to the location where UniPrint701_*.adm is
stored. Click Open to add the new template and then click Close.
86
UniPrint Version 7.0
6. Settings are divided into several categories and by default are Not
configured. To edit any of these settings, double-click the setting and
select Enabled. For more information on each setting, click the
Explain tab.
7. To ensure that the ADM settings are set on the domain controller,
expand Computer Configuration, Administrative Templates,
System, and Group Policy.
8. Double-click on Registry Policy Processing and select Enabled.
Enable the Process even if Group Policy objects have not
changed option and click OK.
9. Close the Group Policy Editor and click OK to return to Active
Directory Users and Computers.
Loading and Configuring an Administrative Template in Windows Vista or later
Windows Vista, Windows 7 and Windows Server 2008 support XML-based
ADM files, ADMX and ADML. ADML are XML-based ADM files that
contain language-specific settings. Unlike, ADM files, ADMX files are not
stored in individual Group Policy Objects and do not need to be “loaded”,
only copied to the appropriate folders.
1. From a Windows Vista or later workstation, copy
UniPrint701_*.admx from C:\Program Files\UniPrint Suite\ADM
Templates to the domain controller \\SysVol\PolicyDefinitions.
Chapter 5: UniPrint Tools and Utilities
87
2. Copy UniPrint701_*.adml from C:\Program Files\UniPrint
Suite\ADM Templates\en-US to \\SysVol\PolicyDefinitions\en-US.
3. From your domain controller, click Start, point to Programs,
Administrative Tools and then click Active Directory Users and
Computers.
4. Right-click the domain you want UniPrint701_*.admx to be
applied to and select Properties.
5. Click the Group Policy tab. Select the Group Policy setting you
want to edit and then click Edit to open the Group Policy Object
Editor.
NOTE
In Windows Server 2008 or later, the Group Policy Management feature
must be enabled first.
6. In the Console tree, under Administrative Templates, click
UniPrint Suite.
7. Settings are divided into several categories and by default are Not
Configured. To modify a setting, double-click the setting and select
Enabled. More information on the setting can be found in the Help
pane.
88
UniPrint Version 7.0
UniPrint PrintPAL
UniPrint PrintPAL is a client device-to-printer mapping utility that easily
plugs into UniPrint Gateway Edition 7.0.3. It is installed on the same
appliance as UniPrint Spool Server and provides a simple user interface that
enables administrators to control or restrict which Gateway printers a user can
access. Administrators first create groups of client devices, OUs, user groups
and users and then map them to specific printers.
Configuration for PrintPAL is done through the PrintPAL plug-in, in the
UniPrint Management Console. To access PrintPAL, do the following:
a. Click Start, click All Programs, click UniPrint Suite and then
click UniPrint Management Console.
b. Under Tools & Utilities, click PrintPAL.
Planning your UniPrint PrintPAL Configuration
It is highly recommended that time be taken to plan out how PrintPAL
should be configured. Taking time to think about your network topology and
security concerns in advance will enable you to configure PrintPAL more
efficiently.
You can plan for the majority of your PrintPAL setup by examining your
network topology, the client devices on your network and how you want to
group them with Gateway printers. Grouping client devices and Gateway
printers may depend on your organizational structure, corporate security
policies and network environment. Some parameters to consider are the
following:
• Geographic location (country, province/state, city)
• Complex or campus name
• Building name
• Floor or level
• Department
• Job function or job title.
As the network administrator, you will also need to determine which client
has access to which Gateway printers. This can be based on proximity to the
printer, that is, a particular workstation can only access the printer closest to
it. Or it can be based on corporate security policies, for example, since HR
tends to print out sensitive information you can restrict access to printers in
the HR department to HR client devices only. This can be done using an IP
range since you can assign an IP range for a particular department using
PrintPAL.
Chapter 5: UniPrint Tools and Utilities
The following are two examples of how to group your client devices.
PrintPAL on the UniPrint Management Console
89
90
UniPrint Version 7.0
PrintPAL is comprised of four panes. The panes on the left hand side
represents the PrintPAL map and the pane on the right hand side represents
mappable objects which consists of network objects and Gateway printers.
Group Map
This pane represents your device group mapping in tree form. Use this pane
to create parent and child groups to which devices and printers are mapped.
Groups can be organized geographically, departmentally and are typically
dependant on your network topology. For more information on how to plan
out groups, see ”Planning your UniPrint PrintPAL Configuration” on
page 88.
Objects Mapped
To The Group
This pane displays the devices (for example, servers, PCs, thin clients and
PDAs), users, user groups and organizational units assigned to the selected
group. The screen shot above contains a list of objects assigned to the
Marketing group on the 1st Floor in Montreal.
Printers Mapped
To The Group
This pane displays the printers available to the devices listed in the Objects
Mapped To The Group pane. During a client session, a user can add any of
the Gateway printers listed in this pane using PrintPAL.
Objects Available
For Mapping
This pane represents the objects that are available for mapping from the
domain specified in PrintPAL Settings and is divided into two tabs. The
Network Objects tab lists all of the devices, users, user groups and OUs.
The Gateway Printers tab lists all of the mappable printers. Objects can be
dragged into the Objects Mapped To The Group pane and printers can be
dragged to the Printers Mapped To the Group pane, which assigns them
to a specific group.
Chapter 5: UniPrint Tools and Utilities
91
Buttons
Creates a new device, IP range or group.
Refreshes the Network Objects and
Gateway Printers tabs.
Saves changes made to PrintPAL.
Deletes the selected device, OU, user, user
group, IP range, group or printer.
Invokes PrintPAL Settings, which allows you
to change the Browsing Options by adding,
deleting or editing a domain LDAP path.
Invokes a utility that allows you to test
session mappings.
Configuring PrintPAL Settings
The initial PrintPAL setup must be done from the UniPrint Spool Server
appliance. Managing PrintPAL can be done from any application server
however, PrintPAL performs best when managed from the UniPrint Spool
Server appliance.
1. From the UniPrint Spool Server, click Start, click All Programs,
click UniPrint Suite and then click UniPrint Management
Console.
2. Under Tools & Utilities, click PrintPAL.
3. Click Settings. In the Browsing tab, click
.
4. In the Domain dialog box, under LDAP path, enter the URL of
your LDAP server. If your LDAP server requires authentication, select
92
UniPrint Version 7.0
the Supply credentials check box and then type in a User name
and Password.
Chapter 5: UniPrint Tools and Utilities
93
5. Click OK and PrintPAL will attempt to connect to your LDAP server.
If successful, it should appear in the Settings dialog box.
Creating Groups
1. In the Group Map pane, select a parent group. If you are starting
with a blank pane, click Root.
2. Click New and then click Group.
3. In the New Group dialog box, enter the group name and then select
the Inherit printers from parent group check box if you want this
group to inherit devices and printers from the parent group. Note:
94
UniPrint Version 7.0
spaces and other special characters are not accepted, except the
underscore (_). Click OK.
4. Continue with steps 1 to 3 until all groups are created.
5. Click Save to save your groupings.
NOTE
indicates that the group has inherited objects and printers from the
parent group.
indicates that the group has not inherited any objects and
printers from the parent group.
Mapping Network Objects to Groups
1. In the Group Map pane, click to select the group you want to map
objects to.
2. Under Mappable Objects, click the Network Objects tab.
Chapter 5: UniPrint Tools and Utilities
95
3. In the From list, click the domain that you wish to map to. In the
Type list, click the type of object you want to map, for example,
Devices, OUs, Users or User Groups.
4. In Objects Available For Mapping pane, drag the object you want
to add to the Objects Mapped To The Group pane.
NOTE
To add multiple objects that appear consecutively in the list, click the first
object you want to add, press SHIFT and then click the last object. Drag your
selection into the Objects Mapped To The Group pane. To add multiple
objects that do not appear consecutively in the list, click an object, press
CTRL, and then click the next object. Continue to hold down CTRL and
while clicking objects. Drag your selection into the Objects Mapped To
The Group pane.
5. Continue selecting groups and mapping objects to these groups as
required.
6. Click Save to save your object mapping.
Adding an IP
Range of Objects
This feature is good for a group of objects that utilizes static IP addresses. This
feature saves time since the network administrator does not need to go
through the lengthy Objects Available For Mapping list.
96
UniPrint Version 7.0
1.
In the Group Map pane, click the group you want to add an IP
range to.
2. Click New and then click IP Range.
3. In the New Range dialog box, enter the Range name and the
beginning and ending IP addresses.
4. Click OK. Click Save to save your object mapping.
Adding A Device
This feature is good for adding devices that do not necessary belong to a
domain, for example, devices that belong to a workgroup.
1. In the Group Map pane, click to select the group you want to add
the device to.
2. Click New and then click Device.
Chapter 5: UniPrint Tools and Utilities
97
3. In the New Device dialog box, type in the name of the device and
then click OK.
4. Click Save to save your object mapping.
Mapping Printers to Groups
1. In the Group Map pane, click the group you want to map printers
to.
2. Under Mappable Objects, click the Gateway Printers tab.
3. In the Server list, click the UniPrint Spool Server whose Gateway
Printers you want to map.
4. In the Objects Available For Mapping pane, drag a printer to the
Printers Mapped To The Group pane.
NOTE
To add multiple printers that appear consecutively in the list, click the first
printer you want to add, press SHIFT and then click the last printer. Drag
your selection into the Printers Mapped To The Group pane. To add
multiple printers that do not appear consecutively in the list, click a printer,
press CTRL, and then click the next printer. Continue to hold down CTRL
and while clicking printers. Drag your selection into the Printers Mapped
To The Group pane.
98
UniPrint Version 7.0
5. Continue selecting groups and mapping printers as required.
6. Click Save to save your printer mapping.
Setting Default Printers
PrintPAL can be used to define a default printer for a group of devices.
However, during an ICA/RDP session, a user can redefine their default
printer through the PrintPAL Client.
1. In the Group Map pane, click a group you want to define a default
printer for.
2. In the Printers Mapped To The Group pane, right-click a printer
and then click Set default. The printer icon will change to
.
3. Click Save.
Testing PrintPAL Mappings
A testing utility has been provided to test your object-to-printer mapping.
With complex mappings, the resulting printer list may not be obvious. You
can test mappings by the following parameters: device name, IP address, user
name or you can test a current session. The result of using this utility is a
consolidated list of which printers are mapped to a particular parameter.
For example, a user name is mapped to printers 1, 2, and 3 and there exists an
IP range that is mapped to printers X, Y and Z. If that user logs onto a device
that is within the IP range, not only will the user have access to printers 1, 2
and 3, but they should also have access to printers X, Y and Z as well. If a
network administrator were to test that particular user session, printers 1, 2, 3,
X, Y and Z would be visible in the printer list.
Chapter 5: UniPrint Tools and Utilities
Testing By
Device Name, IP
Address or User
Name
99
1. Click
and then select the parameter you would like to
test, for example, device name, IP address or user name. Type in the
appropriate information and then click Show Printers.
2. All of the Gateway printers that are mapped to that particular object
should appear in the printer list.
Testing A Current
Session
1. To test a current session, click browsing an existing session below.
100
UniPrint Version 7.0
2. Click to select the session to test and then click OK.
3. The Device Name, IP Address and UserName parameters will be
populated. Click Show Printers.
Chapter 5: UniPrint Tools and Utilities
101
4. All of the Gateway printers that are mapped to this session will appear
in the printer list.
Using PrintPAL Client
Use UniPrint PrintPAL Client to add or remove Gateway printers and set a
default printer. Using PrintPAL to manage your printers will override any
settings made in \\Control Panel\Hardware and Sound\Devices and Printers.
When a session is started the PrintPAL client icon
notification area.
will appear in the
To access PrintPAL Client tasks, right-click the PrintPAL client icon located
in the notification area.
Add Printer
1. To add a new printer during an ICA/RDP session, click Add
Printer.
102
UniPrint Version 7.0
2. In the Add Printers dialog box, click one or more printer(s).
•
•
•
If you want to set this new printer as your default printer, click Set as
my default printer.
If you want this printer to be added each and every time you log into
a session from the current computer, click Always re-add this
printer.
If you want this printer to be added each and every time you log into
a session no matter which computer you log in from, Click From
any computer I log into.
3. Click OK.
Session Info
To display information about your ICA/RDP session, click Session Info.
The information displayed is as follows:
• The application server name you are logged into.
• Your client computer name and IP address.
Chapter 5: UniPrint Tools and Utilities
Refresh
Exit
103
While you are logged into a session, the network administrator may add new
Gateway printers or map new printers to your group. Click Refresh to see
these new printers in the Printers dialog box.
Click Exit to close the PrintPAL Client. To restart PrintPAL Client, click
Start, Computer, Local Disk (C:), Program Files, UniPrint Suite,
Console and then click PrintPALClient.exe.
Printer Profiler
The UniPrint Printer Profiler utility resides on the UniPrint Print Server and
can be used to enable advanced printer properties such as stapling, hole
punching, binding, etc., that some printers support since it accesses the native
printer driver directly.
Printer Profiler can also used to enable the Secure Print feature that HP
Universal Print Drivers support. This Secure Print feature ensures print jobs
are not released for printing until the user enters a matching PIN code at the
physical printer. Secure Print is currently supported for the following printer
drivers:
• HP Universal Printing PCL 5
• HP Universal Printing PCL 5 (v 5.0 or later)
• HP Universal Printing PCL 6
• HP Universal Printing PCL 6 (v 5.0 or later)
• HP Universal Printing PS
• HP Universal Printing PS (v 5.0 or later)
To access Printer Profiler, do one of the following:
• Click Start, click All Programs, click UniPrint Suite and then
click Printer Profiler.
• From the UniPrint Management Console on the UniPrint Print
Server, under Properties & Settings, click Printers and then click
Printer Profiler.
• On the UniPrint Print Server, launch UPPrnPfl.exe from \\Program
Files\UniPrint Suite\Printer Profiler.
The following describes the buttons that appear on the Printer Profiler:
Saves a profile.
104
UniPrint Version 7.0
Create a new profile.
Edit an existing profile.
Delete a profile.
Enable Secure Print.
Disable Secure Print.
To Create a New Printer Profile
1. Log on to the UniPrint Print Server with administrative rights.
2. Click Start, click All Programs, click UniPrint Suite and then
click UniPrint Management Console.
3. Under Properties & Settings, click Printers and then click Printer
Profiler.
4. In the console tree, click to select a printer and then click
.
Chapter 5: UniPrint Tools and Utilities
105
5. Under the Profile Info tab, enter the Profile Name and the Profile
Description.
6. Click the Overrides tab. Select the printer properties that you would
like to allow users to override. If a check box is selected, the user
setting will take precedence over the profile setting. If a check box is
cleared, then the printer profile setting will take precedence.
106
UniPrint Version 7.0
7. Click Printer Properties. This invokes the native driver’s printer
property dialog box. Edit the printer settings as necessary.
8. Click Finish to complete the printer profile.
9. Click
to
to save the profile. The profile icon will change from
.
To Edit an Existing Printer Profile
1. Click Start, click All Programs, click UniPrint Suite and then
click UniPrint Management Console.
2. Under Properties & Settings, click Printers and then click Printer
Profiler.
3. In the console tree, click to select a printer profile to be edited and
then click
.
4. Edit the necessary settings in the profile and then click Finish.
5. Click
to
to save the profile. The profile icon will change from
.
To Delete a Profile
1. Open the UniPrint Management Console.
Chapter 5: UniPrint Tools and Utilities
107
2. Under Printers & Settings, click Printers and then click Printer
Profiler.
3. In the console tree, click to select a printer profile to be deleted.
4. Click
.
Using Printer Profiles
1. Select the desired Gateway printer from the application’s Print dialog
box and click Properties.
2. Click the Print Profiles tab and then click to select a profile. The
Print Profiles tab is not visible until a printer profile is created.
108
UniPrint Version 7.0
3. Click OK.
To Enable Secure Print
1. Open the UniPrint Management Console.
2. Under Printers & Settings, click Printers and then click Printer
Profiler.
3. In the console tree, click to select a printer that you want to enable
Secure Print on. You can also enable Secure Print on a group of
printers by selecting the parent printer driver.
4. Click
. The printer icon should change from
to
.
To Disable Secure Print
1. Open the UniPrint Management Console.
2. Under Printers & Settings, click Printers and then click Printer
Profiler.
3. In the console tree, click to select a printer that you want to disable
Secure Print on. You can also disable Secure Print on a group of
printers by selecting the parent printer driver.
4. Click
. The printer icon should change from
to
.
Using Secure Print
1. Select the desired Gateway printer from the application’s Print dialog
box and click Properties.
Chapter 5: UniPrint Tools and Utilities
109
2. Click the Secure Print tab and then enter a PIN. Enter the PIN
again to confirm it.
3. Click OK.
4. You must now enter the PIN at the printer to print out your
document.
UniPrint Adobe Plug-in
At times re-rendering a document that is already in PDF format may produce
undesirable results. In such cases, users can utilize the UniPrint Adobe Plug-in
tool to inform the UniPrint driver not to re-process the file.
110
UniPrint Version 7.0
The UniPrint Adobe Plug-in is compatible with Adobe Acrobat or Adobe
Reader 5.0 or later.
Installing the UniPrint Plug-in for Acrobat
The UniPrint Adobe Plug-in is packaged with the UniPrint Server
installation program.
If Adobe Acrobat or Adobe Reader is installed on the server, the Install
Adobe plug-in option will appear during UniPrint Server installation.
When this option is selected the UniPrint Adobe Plug-in file,
UPPlugin.api, will be placed in the Adobe plug-ins directory. If Adobe
Acrobat or Adobe Reader is installed after UniPrint Server is already installed
on the server, the UniPrint Adobe Plug-in file will need to be copied from
the \\Program Files\UniPrint Suite folder to the Adobe plug-ins
directory manually.
Printing from Acrobat or Reader to UniPrint
There are two ways to print from Adobe Reader 9 or earlier to UniPrint, do
one of the following:
• Click the UniPrint
icon in the Adobe toolbar.
• In the File menu, click Print to UniPrint.
Chapter 5: UniPrint Tools and Utilities
111
In Adobe Reader X, do one of the following:
• Click Tools to open the Tools panel, click Plug-in UniPrint and
then click the UniPrint
icon.
• In the File menu, click Print to UniPrint.
Replacing the
Print function
with Print to
UniPrint
By default, the PDF document will be re-rendered by the UniPrint driver if
users select Print instead of Print to UniPrint in the File menu. UniPrint
Adobe Plug-in version 2.1.6 or later provides a registry key that will change
this functionality.
To prevent re-rendering of PDF documents by editing the registry:
1. Click Start and then click Run.
2. Type regedit and then click OK to edit the registry.
3. In HKEY_LOCAL_MACHINE\SOFTWARE\UniPrint
\Adobe Plugin key edit the value entry
AdobePluginPrintReplace to 1. To edit the value entry double-
112
UniPrint Version 7.0
click AdobePluginPrintReplace and type 1 in the Value data
field.
4. Click OK. Exit the Registry Editor.
Upgrading the UniPrint Plug-in for Acrobat
To upgrade the UniPrint Acrobat Plug-in:
1. Ensure that the older version of UniPrint*.api in the \\Program
Files\Adobe\Acrobat\Reader\plug_ins folder is replaced with
the new UPPlugin.api found in the \\Program Files\UniPrint
Suite folder.
NOTE
Only one UniPrint Adobe Plug-in file should reside in the Adobe folder.
Having multiple UniPrint Adobe Plug-in files in this folder (even when the
version is different) will cause a conflict and prevent the plug-in from
functioning properly.
2. If the AdobePluginPrintReplace.reg file was imported in an older
version, delete the Server registry sub key found under
HKEY_LOCAL_MACHINE\SOFTWARE\UniPrint.
CHAPTER
6
UniPrint Version 7.0
Troubleshooting
Troubleshooting
The following are work-arounds that involve issues with third-party
applications and how they interact with UniPrint. UniPrint is not responsible
for these third-party applications and only recommends these work-arounds.
All work-arounds should be tested prior to implementing them in
production.
Citrix Issues
Citrix Seamless Application Sessions not terminating when an application is closed
If you have trouble with Citrix Seamless Application Sessions not terminating
when a user closes an application, do the following:
1. On the Citrix server, click Start and then click Run.
2. Type regedit and then click OK to edit the registry.
3. In HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet
\Control\Terminal Server\SysProcs, add a DWORD value. To
add a DWORD value, click Edit, point to New and then click
DWORD (32-bit) Value.
4. Rename this new value to WFShell.exe. This is a Citrix process.
5. Exit the Registry Editor.
Third-party Printer Driver Issues
Some third-party printer drivers may exhibit sporadic behavior
The UniPrint Print Server uses OEM provided printer drivers to
communicate with the physical printer. Some third-party printer drivers
exhibit sporadic behavior. As a result, UniPrint Print Server may fail to print a
document due to a specific compatibility issue with one of these printer
drivers. To resolve this issue, UniPrint recommends testing alternative printer
drivers. For example, if a PCL 6 printer driver is no functioning correctly, it is
114
UniPrint Version 7.0
advisable to test with the PostScript version of the same printer driver. If
available, a PCL 5 printer driver may also resolve this issue. You may also wish
to notify UniPrint Support of any OEM printer drivers that appear to behave
incorrectly.
CHAPTER
7
UniPrint Version 7.0
Contact and Support
Contact and Support
UniPrint Support
Contact us if you require assistance with any of the UniPrint products.
North America
Hours of Operation
06:00 to 19:00 Eastern Time (UTC -5)
Monday to Friday
Toll Free Phone Number (North America Only)
(866) 488-3188 option 3
Phone Number
(416) 503-9800 option 3
Europe, Middle
East and Africa
Hours of Operation
11:00 to 24:00 Coordinated Universal Time (Greenwich Mean Time)
Monday to Friday
Phone Number
(44) 0134 420 6144
E-mail
[email protected]
Office Location
Address
UniPrint, a division of ACCEO Solutions, Inc.
1 Eva Road, Suite 309
Toronto, ON M9C 4Z5
Canada
Phone Number
(416) 503-9800
Toll Free Phone Number (North America Only)
(866) 488-3188
116
UniPrint Version 7.0
APPENDIX
A
UniPrint Version 7.0
Paper Sizes
Paper Sizes
Use this table for the UP_SETTING_PAPERSIZE = n, when installing
UniPrint Server from the command line.
The following is a list of paper sizes supported by UniPrint:
n
Description
1
Letter (8 1/2 x 11 in)
2
Letter Small (8 1/2 x 11 in)
3
Tabloid (11 x 17 in)
4
Ledger (17 x 11 in)
5
Legal (8 1/2 x 14 in)
6
Statement (5 1/2 x 8 1/2 in)
7
Executive (7 1/4 x 10 1/2 in)
8
A3 (297 x 420 mm)
9
A4 (210 x 297 mm)
10
A4 Small (210 x 297 mm)
11
A5 (148 x 210 mm)
12
B4 (JIS) (257 x 364 mm)
13
B5 (JIS) (182 x 257 mm)
14
Folio (8 1/2 x 13 in)
15
Quarto (215 x 275 mm)
16
10 x 14 in
17
11 x 17 in
18
Note (8 1/2 x 11 in)
19
Envelope #9 (3 7/8 x 8 7/8 in)
20
Envelope #10 (4 1/8 x 9 1/2 in)
118
UniPrint Version 7.0
n
Description
21
Envelope #11 (4 1/2 x 10 3/8 in)
22
Envelope #12 (4 3/4 x 11 in)
23
Envelope #14 (5 x 11/2 in)
24
C size sheet (17 x 22 in)
25
D size sheet (22 x 34 in)
26
E size sheet (34 x 44 in)
27
Envelope DL (110 x 220 mm)
28
Envelope C5 (162 x 229 mm)
29
Envelope C3 (324 x 458 mm)
30
Envelope C4 (229 x 324 mm)
31
Envelope C6 (114 x 162 mm)
32
Envelope C65 (114 x 229 mm)
33
Envelope B4 (250 x 352 mm)
34
Envelope B5 (176 x 250 mm)
35
Envelope B6 (176 x 125 mm)
36
Envelope Italy (110 x 230 mm)
37
Envelope Monarch (3.875 x 7.5 in)
38
6 3/4 Envelope (3 5/8 x 6 1/2 in)
39
Std Fanfold (14 7/8 x 11 in)
40
German Std Fanfold (8 1/2 x 12 in)
41
German Legal Fanfold (8 1/2 x 13 in)
42
B4 (ISO) (250 x 352 mm)
43
Japanese Postcard (100 x 148 mm)
44
9 x 11 in
45
10 x 11 in
46
15 x 11 in
47
Envelope Invite (220 x 220 mm)
50
Letter Extra (9 1/2 x 12 in)
Appendix A: Paper Sizes
n
Description
51
Legal Extra (9 1/2 x 15 in)
52
Tabloid Extra (11.69 x 18 in)
53
A4 Extra (9.27 x 12.69 in)
54
Letter Transverse (8 1/2 x 11 in)
55
A4 Transverse (210 x 297 mm)
56
Letter Extra Transverse (9 1/2 x 12 in)
57
SuperA/SuperA/A4 (227 x 356 mm)
58
SuperB/SuperB/A3 (305 x 487 mm)
59
Letter Plus (8.5 x 12.69 in)
60
A4 Plus (210 x 330 mm)
61
A5 Transverse (148 x 210 mm)
62
B5 (JIS) Transverse (182 x 257 mm)
63
A3 Extra (322 x 445 mm)
64
A5 Extra (174 x 235 mm)
65
B5 (ISO) Extra (201 x 276 mm)
66
A2 (420 x 594 mm)
67
A3 Transverse (297 x 420 mm)
68
A3 Extra Transverse (322 x 445 mm)
69
Japanese Double Postcard (200 x 148 mm)
70
A6 (105 x 148 mm)
71
Japanese Envelope Kaku #2 (240 x 332 mm)
72
Japanese Envelope Kaku #3 (216 x 277 mm)
73
1Japanese Envelope Chou #3 (20 x 235 mm)
74
Japanese Envelope Chou #4 (90 x 205 mm)
75
Letter Rotated (11 x 8 1/2 in)
76
A3 Rotated (420 x 297 mm)
77
A4 Rotated (297 x 210 mm)
78
A5 Rotated (210 x 148 mm)
119
120
UniPrint Version 7.0
n
Description
79
B4 (JIS) Rotated (364 x 257 mm)
80
B5 (JIS) Rotated (257 x 182 mm)
81
Japanese Postcard Rotated (148 x 100 mm)
82
Double Japanese Postcard Rotated (148 x 200 mm)
83
1A6 Rotated (48 x 105 mm)
84
Japanese Envelope Kaku #2 Rotated (332 x 240 mm)
85
Japanese Envelope Kaku #3 Rotated (277 x 216 mm)
86
Japanese Envelope Chou #3 Rotated (235 x 120
mm)
87
Japanese Envelope Chou #4 Rotated (205 x 90 mm)
88
B6 (JIS) (128 x 182 mm)
89
B6 (JIS) Rotated (182 x 128 mm)
90
12 x 11 in
91
Japanese Envelope You #4 (235 x 105 mm)
92
Japanese Envelope You #4 Rotated (105 x 235 mm)
93
PRC 16K (146 x 215 mm)
94
PRC 32K (97 x 151 mm)
95
PRC 32K(Big) (97 x 151 mm)
96
PRC Envelope #1 (102 x 165 mm)
97
PRC Envelope #2 (102 x 176 mm)
98
PRC Envelope #3 (125 x 176 mm)
99
PRC Envelope #4 (110 x 208 mm)
100
PRC Envelope #5 (110 x 220 mm)
101
PRC Envelope #6 (120 x 230 mm)
102
PRC Envelope #7 (160 x 230 mm)
103
PRC Envelope #8 (120 x 309 mm)
104
PRC Envelope #9 (229 x 324 mm)
105
PRC Envelope #10 (324 x 458 mm)
Appendix A: Paper Sizes
n
Description
106
PRC 16K Rotated (215 x 146 mm)
107
PRC 32K Rotated (97 x 151 mm)
108
PRC 32K(Big) Rotated (97 x 151 mm)
109
PRC Envelope #1 Rotated (165 x 102 mm)
110
PRC Envelope #2 Rotated (176 x 102 mm)
111
PRC Envelope #3 Rotated (176 x 125 mm)
112
PRC Envelope #4 Rotated (208 x 110 mm)
113
PRC Envelope #5 Rotated (220 x 110 mm)
114
PRC Envelope #6 Rotated (230 x 120 mm)
115
PRC Envelope #7 Rotated (230 x 160 mm)
116
PRC Envelope #8 Rotated (309 x 120 mm)
117
PRC Envelope #9 Rotated (324 x 229 mm)
118
PRC Envelope #10 Rotated (324 x 458 mm)
121