Printing in Accops

Printing Mechanisms in HyWorks

HyWorks supports following printing mechanisms:

1. Accops HyPrint PDF Printer
2. Accops EMF Printer
3. Remote Desktop Printer Redirection
4. USB Printer Redirection using additional USB Printer Drivers (Built-in and Enhanced USB Printer Drivers)
5. Accops Legacy Printer

Platform Support

Printing Type	Endpoint Support	Server Support
HyPrint PDF Printer	1. HyDesk Hy1000/Hy4000/Hy6000 2. HyWorks Client for Windows Desktops 3. HyWorks Client for Ubuntu 4. HyWorks Client for MAC OS	1. Windows Servers (2019/2016/2012R2/2008R2-SP1) 2. Windows Desktops 32/64-bit (Windows 7, Windows 8/8.1, Windows 10) 3. Linux Desktops (xUbuntu 16.0/1, 18.0/1, 20.0/1: As supported for Linux Shared/Personal Desktop Delivery in Accops )
HyPrint EMF Printer	HyWorks Client for Windows Desktops	1. Windows Servers (2019/2016/2012R2/2008R2-SP1) 2. Windows Desktops 32/64-bit (Windows 7, Windows 8/8.1, Windows 10)
Accops Legacy Printer	HyWorks Client for Windows Desktops	1. Windows Servers (2019/2016/2012R2/2008R2-SP1) 2. Windows Desktops 32/64-bit (Windows 7, Windows 8/8.1, Windows 10)
Remote Desktop Printer Redirection	HyWorks Client for Windows Desktops	1. Windows Servers (2019/2016/2012R2/2008R2-SP1) 2. Windows Desktops 32/64-bit (Windows 7, Windows 8/8.1, Windows 10)
USB Printer Redirection (Built-in)	1. HyDesk Hy1000/Hy4000/Hy6000 2. HyWorks Client for Windows Desktops 3. HyWorks Client for Ubuntu	1. Windows Servers (2019/2016/2012R2/2008R2-SP1) 2. Windows Desktops 32/64-bit (Windows 7, Windows 8/8.1, Windows 10) 3. Linux Desktops (xUbuntu 16.0/1, 18.0/1, 20.0/1: As supported for Linux Personal Desktop Delivery in Accops)
USB Printer Redirection (Enhanced)	1. HyDesk Hy1000/Hy4000/Hy6000 2. HyWorks Client for Windows Desktops 3. HyWorks Client for Ubuntu	1. Windows Servers (2019/2016/2012R2/2008R2-SP1) 2. Windows Desktops 32/64-bit (Windows 7, Windows 8/8.1, Windows 10)

Printers, Configurations & Troubleshooting

HyPrint PDF Printer and Accops EMF Printer

Accops HyPrint PDF Printer:

Accops HyPrint PDF printer is PDF based printer, which works with client and server side of components. Prints initiated to the HyPrint PDF printer are converted to PDF and sent to client for printing.

Accops EMF Printer:

EMF Based printing solution. This printer makes an EMF copy of the print data and sends it to the client, which then sends to the printer present in the client machine and print is initiated.

Following printers are added during the installation of session server extensions:

• Accops A4 Printer: Used for fixed sized printing on A4 size paper.
• Accops Barcode Printer: Used for fixed sized printing on standard barcode size (100mm x 50mm) page.
• Accops EMF Printer: Application selectable paper size for printing.

Installation, Dependencies and Working Mechanism

Installation:

HyPrint PDF printer and Accops EMF printer are sub-modules of Accops Session Extensions and are installed with their respective components:

• Client side module of HyPrint/EMF printer gets installed with HyWorks Clients
• Server side module of HyPrint/EMF printer gets installed with DVM Tools or Session Host Server

Dependencies:

1. HyPrint: For appropriate functioning of HyPrint PDF Printer, appropriate PDF reader must be installed and configured as the default application for PDF files on the client side.
2. EMF Printer: There are no external dependencies. Client component is having a EMF print previewer to read and print the EMF files.

Working Mechanism:

Users will see HyPrint PDF printer available for printing on their respective hosted application or desktop (shared or personal). On initiating print on HyPrint PDF printer, document is converted to PDF and send it to the client side component. Client side HyPrint PDF module will print document as per the user preferences.

Print Data Flow

(Server) Application > GDI > Virtual Printer > Spooler > Print Processor > Printer Driver > Port Monitor > Encrypted RDP Virtual channels > (User's machine ) > RDP Client > Printing Client > Physical or Document Printer.

Enable HyPrint PDF or Accops EMF Printer

To enable HyPrint PDF printer:

• Go to Connection Profile > Local Resources
• Select (enable) Allow RDP Plugins > Select (enable) Accops HyPrint Printing Plugin

Important

• Only HyWorks Client on Windows can use above flags to enable or disable the HyPrint and EMF printer

• HyPrint on 'HyWorks Client for Linux' is always enabled and can not be disabled from connection profile on controller.

Advance Configurations

On the server side, all the printing configurations are saved in registries. These registry keys can be used to update configurations of specific printers.

1. Registry Path : HKEY_LOCAL_MACHINE\SOFTWARE\Accops\HyPrint Registry Name & Print Type:

   • cmdline (PDF) - PDF generator command line parameters. Modify to insert any specific command line attribute for printing.

2. Registry Path : HKEY_LOCAL_MACHINE\SOFTWARE\Accops\LightSpeed Registry Names:

   • lspDrvLogLevel (EMF) - Log level for Print Driver.
   • lspGenPDFLogLevel (EMF) - Log level for PDF Generator.
   • lspIntfLogLevel (EMF) - Log level for Print Driver UI.
   • lspPrnProcLogLevel (EMF) - Log level for Print Processor.
   • lspToolsLogLevel (EMF) - Log level for internal tools.
   • lspViewerLogLevel (EMF) - Log level for EPF Print previewer and Renderer.

3. Per Printer Settings: Registry Path : HKEY_LOCAL_MACHINE\SOFTWARE\Accops\LightSpeed Registry Names:

   • AutoRotate (EMF) - Rotate print job based on print data. Default -Enabled.
   • lspHyLitePrinter (EMF) - Reprint print job to HyLite printer name sring. Default - Accops HyLite Printer.
   • lspPDFPrinter (EMF) - Reprint print job to PDF printer name string. Default - HyPrint PDF Printer.
   • lspRePrintToHyLite (EMF) - Reprint print job to HyLite printer. Default - Disabled.
   • lspRePrintToPDF (EMF) - Reprint print job to PDF printer. Default -Disabled.
   • lspViewLeftMargin (EMF) - Adjust left margin of print job. Default - Zero (0) points.
   • lspViewPrinterSize (EMF) - Adjust print job to size as specified by printer and not by application. Default - Disabled.
   • lspViewScale (EMF) - Adjust left margin of print job. Default 100 %.
   • lspViewTopMargin (EMF) - Adjust top margin of print job. Default - Zero (0) points.
   • OpenOrPrint (EMF) - Print job processing on user's machine. Print (1) or Open (2) or Both (3). Default - Print.
   • PDFPrintQuality (EMF) - If PDF is generated, adjust PDF generation quality. Default - 300 dpi.

4. Configurable Advance Settings on Client (User's machine): Common Settings: Registry Path : HKEY_CURRENT_USER\Software\Accops\HyPrint Registry Name & Print Type:

   • UseBuiltinPDF (PDF) - Use built-in PDF renderer for printing. Default -Disabled.
   • UseEncodedPDF (PDF) - Use simple encoding for PDF received as print job (PDF cannot be open and viewed). Default - Disabled.

5. Registry Path : HKEY_CURRENT_USER\Software\Accops\LightSpeedClient Registry Names & Print Type:

   • AutoRotate (EMF) - Rotate print job based on print data. Default - Enabled.
   • lspViewerLogLevel (EMF) - Log level for EPF Print Previewer and Renderer.
   • lspViewLeftMargin (EMF) - Adjust left margin of print job. Default - Zero (0) points.
   • lspViewPrinterSize (EMF) - Adjust print job to size specified by printer and not by application. Default - Disabled.
   • lspViewScale (EMF) - Adjust left margin of print job. Default - 100 %.
   • lspViewTopMargin (EMF) - Adjust top margin of print job. Default - Zero (0) points.

6. Size modification to map user printer (Available on server for all users, also available on user device).

Troubleshooting Accops HyPrint/ EMF Printers

1. Log Location:

   • Client side: %temp%\Accops\VirtChannels
   • Server side: C:\Windows\Temp\Accops\HyPrint

2. Print is not coming on configured printer on client side:

   • Check the client side logs for analysis

     • Failed to print file with error code [1155], return value [31]:

       • Verify if appropriate PDF reader is installed or not
       • Verify if installed PDF reader is set as default program for PDF files

   • For any other error codes, search internet

3. Error: Printing [Document Name] - Channel creation failed!!: Usually this error occurs, when HyPrint server module is not able to communicate with the HyPrint client module. Verify following areas to understand the cause of failure:

   • Check if Accops HyPrint Printing Plugin is enabled in connection profile - Local Resources.

   • On client side, verify that the Accops Session Server Extensions are installed and files are available at the appropriate locations

     • Windows Client: C:\Program Files\Accops\AccopsRDPExtensionClient
     • Windows Client On-demand: %localappdata%\Accops\AccopsRDPExtensionClient

   • On the client side, verify that the session extensions are registered successfully. Check if registry has the correct path of server extensions:

     • Windows Client:
       • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Terminal Server Client\Default\Addins\hyprint
       • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Terminal Server Client\Default\Addins\hyprn32
     • Windows Client On-demand:
       • hyprint and hyprn32 sub-keys should be present under this registry key - HKEY_CURRENT_USER\Software\Microsoft\Terminal Server Client\Default\AddIns

Accops Legacy Printer

Accops legacy printer and HyPrint PDF printer or EMF printers function in the similar manner except that Accops legacy printer is developed for legacy printing mechanisms like COM/LPT printers.

Printing solution for Windows and Unix based Operating systems for applications, that print on Text based printers or use legacy DOS based printer (Text stream directed to Parallel ports ex. LPT1:, LPT2:.)

Accops Legacy printing solution, creates Text based printer and virtual ports in user sessions to capture prints.

• Printer & Driver: "Accops Legacy Printer" / "Generic / Text Only" - based on Text driver from Microsoft.
• Ports: LPT1 and LPT2, configurable up to LPT8.

Client side Behavior

It receives print commands and functions in the following fall back model:

1. In case of one LPT1 printer, dialog to choose printer is not shown and print command is sent to LPT1 printer itself.

2. In case of two LPT printers and one of them is the default printer, print goes to the default LPT printer and dialog is not shown.

3. In case of two or more LPT printers and none of them is the default printer, prompt to choose printer is shown.

Legacy Application Support using Port Mapping (Advance Configurations)

Applications can send prints to the Accops legacy printer, which will be printed to respective printers on client side. However some legacy applications, designed to give print on LPT ports may not work correctly and thus below advance configurations can be done to map LPT ports with Accops Legacy printer. Once mapped, all the prints initiated in LPT1 will be received by Accops Legacy printer on server side.

Advance Configurations:

• Registry Path : HKEY_LOCAL_MACHINE\SOFTWARE\Accops\LightSpeed\PortMapper

• Registry Names & Print Type:

  • LPT_Timeout (Text) - Timeout for starting next print job. Default - 500ms.
  • LPT1 (Text) - Printer name string to which port data will be sent. Default - Accops Legacy Printer.
  • LPT2 (Text) - Printer name string to which print data will be sent. Default - Accops Legacy Printer
  • LPT3 (Text) - Printer name string to which print data will be sent. Default - Accops Legacy Printer.
  • LPT4 (Text) - Printer name string to which print data will be sent. Default - Accops Legacy Printer.
  • LPT5 (Text) - Printer name string to which print data will be sent. Default - Accops Legacy Printer.
  • LPT6 (Text) - Printer name string to which print data will be sent. Default - Accops Legacy Printer.
  • LPT7 (Text) - Printer name string to which print data will be sent. Default - Accops Legacy Printer.
  • LPT8 (Text) - Printer name string to which print data will be sent. Default - Accops Legacy Printer.
  • LPT9 (Text) - Printer name string to which print data will be sent. Default - Accops Legacy Printer.
  • PortMapping (Text) - Number of virtual parallel ports to be created and monitored for print data. Default - 2 (i.e. LPT1 and LPT2).

Remote Desktop Printer Redirection

This printing mechanism is supported only for Windows (Client) to Windows (Server) deployments.

To enable Remote Desktop Printer Redirection, allow printer redirection in Connection Profile > Local Resources > Printer (Enabled).

• Now all the printers available on the client side will be redirected inside of the remote session and will be shown with name as Printer Name (redirected X), where X is the session Id of the user.

Important Group Policies: Following group policies on the server can be used to enable/disable printer redirection:

• Computer Configuration\Administrative Templates\Windows Components\Remote Desktop Services\ Remote Desktop Session Host \Printer Redirection
  • Do not allow client printer redirection: Do disable printer redirection
  • Use Remote Desktop Easy Print printer first
  • Do not set default Client printer to be default printer in a session

USB Printer Redirection (Built-in/ Enhanced USB Redirection Driver)

Accops HyWorks solution has following two USB redirection driver integrated:

1. Built-in USB Redirection Driver: It comes integrated with HyWorks client and HyWorks DVM Tools. Built-in USB redirection drive is recommended for personal virtual desktops.
2. Enhanced USB Redirection Driver: Recommended for shared hosted desktops and comes with independent installer.

Any of these drivers, based on deployment model can be used to redirect the USB printers to remote desktop sessions.

To enable USB printer redirection:

1. Following flag in connection profile should be enabled:
   • Connection Profile - Local Resources - Redirection all USB devices
2. HyWorks client should be installed with appropriate USB redirection driver and it should be configured correctly from device settings.

Printing with HyLite

Accops HyLite allows users to access corporate virtual desktops and applications, from anywhere, using any device simply through a modern & compatible web browser.

For printing with HyLite as endpoint, following mechanisms as supported:

1. HyLite Printer Redirection
2. Using HyPrint PDF Printer
3. Plugin based Printing

HyLite Printer Redirection

In HyLite printer redirection, while connecting to the remote servers HyLite creates a virtual printer for every user session which is then redirected into remote session. On initiating print command to redirected HyLite printer, the command is then executed on HyLite and a PDF is generated and previewed to end-user.

End-user then initiates a print command to any locally configured printer.

To enable HyLite printer, following configurations need to be enabled:

1. Enable Printing on HySecure gateway (This will be global control and if disabled, HyWorks configurations will be overwritten.)
2. Enable Printer Redirection in HyWorks Connection Profile

Using HyPrint PDF Printer

While working with HyLite, users can also use HyPrint PDF printer to generate PDF based print and send to browser for printing. In this mechanism, the print command is sent to HyPrint PDF printer and appropriate PDF file is generated. The PDF file, then is sent to the HyLite and can be previewed on browser, end-user will be able to initiate print from there.

To use HyPrint PDF Printer in HyLite sessions:

1. Enable drive redirection and Printer redirection in HyWorks Connection Profile.
2. Enable Shared Drive Redirection, Printer redirection and option HyPrint PDF Printer redirection in HyLite settings on HySecure Gateway.

Plugin based Printing

This printing mechanism is supported only on the HyLite that is being used from Windows OS and from Chrome browser only.

Using this mechanism, the print files are transferred from server to client and then prints are initiated by client module to configured printer.

Prerequisites: 1. Browser: Chrome 2. Client Operating System: Windows 3. Plugin Installer is kept on HySecure Gateway for downloading 1. Location: /home/fes/public 2. Based on user privileges, on-demand or full plugin installer can be used. Full plugin will require administrative privileges on client system, on-demand plugin can be installed without administrator privileges. 4. Connection Profile: 1. Allow all RDP Plugins - Option should be enabled 5. HySecure Gateway - HyLite Settings: 1. Enable RDP plugins redirection 2. Disable HyPrint PDF Printer redirection 6. Internet is enabled on client machine

Configuration Flow for end-user:

1. User will login into HyLite and will initiate connection to application or desktop (the connection profile will have plugin enabled)
2. HyLite will evaluate if accessed remote server requires plugins to be enabled
3. A prompt to install Google extension will be shown
4. Confirm and add extension Accops Native Client on Google chrome browser
5. Once extension is added, in second step it will ask to download and install plugin on user system
   1. Download and install plugin on user system
6. Now user will be given access to the accessed virtual application or desktop.
7. On initiating print command to HyPrint PDF printer, any of EMF printers or legacy printers, the actual print will be sent to plugin on client-side
   1. Plugin will initiate the print as per printer configurations on client system.