Drive clipboard filetransfer

The document provides information on mechanisms used to transfer files or content to/from remote servers to client systems.

HyWorks supports the following methods:

1. Clipboard Redirection
2. Drive Redirection
3. Accops File Transfer

Clipboard Redirection

Clipboard redirection allows the use of the local clipboard of the client desktop to perform clipboard operations in remote sessions.

How to enable clipboard redirection: Clipboard redirection can be enabled from the HyWorks Connection profile.
To enable clipboard redirection:

• Go to Local Resources in the connection profile - Select the option Clipboard.

How to disable clipboard redirection from Windows Server: The following group policy can be used on Windows servers to control clipboard redirection at the server level:
Computer Configuration > Administrative Templates > Windows Components > Remote Desktop Services > Remote Desktop Session Host > Device and Resource a Redirection
Do not allow Clipboard redirection.

• If enabled, clipboard redirection will not work.
• If disabled, clipboard redirection will work.
• If not configured, clipboard redirection will work as per the connection profile configuration.

Sharing content through clipboard redirection has the following consequences:

1. No control over content type.
2. Unidirectional controls are not possible.
3. No logging or monitoring of copied content.

Drive Redirection

HyWorks uses a roaming profile with folder redirection or FSLogix to store the user's files and folders.

• Enable users to continue accessing network files, even if there is a network or server outage.
• Optimize bandwidth usage and enhance users' experience in branch offices that access files and folders hosted by offsite corporate servers.
• Enable mobile users to access network files while working offline or over slow networks.

File Transfer using Session Server Extension

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

About Accops EMF Printer:
EMF-based printing solution makes an EMF copy of the print data and sends it to the client. It then sends it to the printer present in the client machine, and print is initiated.

The following printers are added during the installation of session server extensions:

• Accops A4 Printer: Fixed-sized printing on A4 Paper Size.
• Accops Barcode Printer: Fixed-sized printing on standard barcode size (100mm x 50mm).
• 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 they get installed with their respective components:

• The client-side module of the HyPrint/EMF printer gets installed with HyWorks Clients.
• The server-side module of the HyPrint/EMF printer gets installed with DVM Tools or Session Host Server.

Dependencies:

1. HyPrint: For the appropriate functioning of the HyPrint PDF Printer, on the client side, users must have an appropriate PDF reader installed and configured as their default application for PDF files.
2. EMF Printer: No such external dependencies are there. The client component has an EMF print previewer to read and print the EMF files.

Working Mechanism:
Users on their respective hosted applications or desktops (shared or personal) will see the HyPrint PDF printer available for printing. On initiating a print on the HyPrint PDF printer, it will convert it to PDF and will send it to the client-side component. The Client-side HyPrint PDF module will print the document as per the preferences set by the user.

Print Data Flow

Application (Server) > 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 the HyPrint PDF printer, the connection profile must have the below configurations:

• In Connection Profile > Local Resources screen.
• Enable Allow RDP Plugins > Enable Accops HyPrint Printing Plugin.

Important

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

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

Advance Configurations

On the server side, all 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 can be modified 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 string. 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 the left margin of a print job. Default 0 points.
   • lspViewPrinterSize (EMF) - Adjust the print job to size as specified by the printer and not by the application. Default disabled.
   • lspViewScale (EMF) - Adjust the left margin of a print job. Default 100 %.
   • lspViewTopMargin (EMF) - Adjust the top margin of a print job. Default 0 points.
   • OpenOrPrint (EMF) - Print job processing on the user's machine. Print (1), 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 a built-in PDF renderer for printing. Default disabled.
   • UseEncodedPDF (PDF) - Use simple encoding for PDF received as a print job (PDF cannot be opened 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 the left margin of a print job. Default 0 points.
   • lspViewPrinterSize (EMF) - Adjust the print job to the size specified by a printer and not by the application. Default disabled.
   • lspViewScale (EMF) - Adjust the left margin of a print job. Default 100 %.
   • lspViewTopMargin (EMF) - Adjust the top margin of a print job. Default 0 points.

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

Troubleshooting Accops HyPrint/ EMF Printers

1. Log Location:

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

2. Print not coming on the configured printer on client-side:

   • Check client-side logs for analysis.

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

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

   • For other error codes, try to search for them on the internet.
     
     

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

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

   • Verify, on the client side, whether 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

   • Verify on client-side session extensions are registered successfully: Check, if the 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, functions similarly to HyPrint PDF printer or EMF printers but it is developed for legacy printing mechanisms such as COM/ LPT printers.

Printing solution for Windows and Unix based Operating systems: Applications that are built to print using methods can print on Text-based printers or use legacy DOS-based printing methods (Text stream directed to Parallel ports ex. LPT1: LPT2: ). Legacy printing solution creates a 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

On the client side, it receives the print commands and functions using the following fallback model:

1. When only one LPT1 printer is there, the dialog to choose a printer is not shown and the print command is sent to the LPT1 printer itself.

2. When two LPT printers are there and one of them is the default, then the print goes to the default LPT printer, and the dialog is not shown.

3. When two or more LPT printers are there but none of them are default, then a prompt to choose a printer is shown.

Legacy Application Support using Port Mapping (Advance Configurations)

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

Advance Configurations:

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

• Registry Names & Print Type:

  • LPT_Timeout (Text) - Timeout for starting the 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

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

To enable the Remote Desktop Printer Redirection, allow the 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 the name Printer Name (redirected X), where X is the session ID of the user.

Important Group Policies: The 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: To disable printer redirection.
  • Use the Remote Desktop Easy Print printer first.
  • Do not set the default Client printer to be the default printer in a session.

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

Accops HyWorks solution has the following USB redirection driver integrations:

1. Built-in USB Redirection Driver: Integrated default with HyWorks client and HyWorks DVM Tools and recommended for personal virtual desktops.
2. Enhanced USB Redirection Driver: Recommended for shared hosted desktops and comes with an independent installer.

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

To enable USB printer redirection:

1. Enable the following flag in the connection profile:
   • Connection Profile - Local Resources - Redirection all USB devices
2. HyWorks client should be installed with the 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 an endpoint, the following mechanisms are supported:

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

HyLite Printer Redirection

HyLite creates a virtual printer for each user session when connecting to remote servers, and then redirects it to a remote session. On initiating the print command to redirect the HyLite printer, a command is then executed on HyLite and a PDF is generated and previewed to the end-user.

The end user then initiates a print command to any locally configured printer.

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

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

Using HyPrint PDF Printer

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

To use the HyPrint PDF Printer in HyLite sessions:

1. Enable drive redirection and Printer redirection in the 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

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

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

Prerequisites:

1. Google Chrome browser.
   
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, an on-demand or full plugin installer can be used. The full plugin will require administrative privileges on the 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 the client machine.
   

Configuration Flow for end-user:

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