What is supported

• Standalone scanners.
• Dedicated virtual channel for printing. For more information, see https://support.citrix.com/article/CTX137939 and https://docs.citrix.com/en-us/citrix-virtual-apps-desktops/printing.html
• UPD postscript printer drivers, provided the following conditions are met :
  1. The printer driver is installed on the macOS client.
  2. Core printing on macOS can work with the vendor-provided driver successfully.
  3. Changes in macOS impact the printing behavior (core printing APIs on macOS). Core Printing APIs have not been updated lately and might be prone to errors. For example, we had issues with double-sided printing on Catalina, which were resolved in Big Sur.

What is not supported

• Multi-function scanners. A multifunction is a composite device that has more than one interface.
• USB device splitting feature in GUSB virtual channel. Citrix Workspace app on Mac does not have the capability to differentiate between different interfaces of a composite device. This problem is not limited to our app, but printing on macOS in general. For more information, see https://discussions.apple.com/thread/5244577. On some printers, when printed from a session in Citrix Workspace app on Mac, printing is always either duplex or single sided depending on the printer. It ignores the Duplex/Single-sided settings issued from the VDA. This is a limitation on the macOS. When using the core printing Apple framework, macOS printing is being overridden by the printing settings in the CUPS printing system. This is a new behavior on the macOS 10.15 (Catalina) onwards. As a workaround, change the settings in CUPS printing system on macOS. You have to manually set the Duplex/Single-sided settings on CUPS.
• Printer redirection through third party drivers.

External dependencies for printing (Apple/HP)

• macOS drivers for creating the print job.
• Print support for macOS is very fragile as we depend on HP driver on VDA, explicitly signed by Microsoft. This is a limitation for compatibility with macOS.
• On VDA 'HP LaserJet PS 2800 (Microsoft)' drivers signed by Microsoft is mandatorily required for client printer redirection on macOS.
• macOS default: https://www.howtogeek.com/309677/how-to-stop-two-side-printing-from-being-the-default-in-macos/ workaround may be used to change settings in the CUPS daemon.

downloadWhy can't I download this file?

Objective

This article provides an overview of logging features available with Citrix Workspace App for Mac, and explains how to use them in the Citrix Workspace App.

Logging Interface

The logging interface is located in the Advanced tab of the CWA Preferences. The Preferences menu can be accessed from the Desktop Viewer Window or the Apple application bar along the top.

There are five types of logging available in CWA for Mac and some are enabled by default:

• Installer Logging (default: Enabled)
• Always-on Logging (default: Enabled)
• CWA Updates Logging (default: Enabled)
• Session Logging (default: Disabled)
• Store Logging (default: Disabled)

Installer Logging

Installer Logging captures debug messages from the CWA during the installation.

Session and Store Logging

Session Logging includes all the diagnostic logging from the ICA session. Therefore, it only applies to the Citrix Viewer when the session is up. Use this logging for any problem within the ICA session, perhaps unexpected behavior in an ICA session.
Store Logging includes logging of AuthManager and StoreComms modules. AuthManager handles user authentication to the CWA Store. The StoreComms manages the information about the Store configurations and connection settings.

Always-on Logging

The Always-on Logging feature continuously collects a subset of important logs.This feature is enabled by default and turns on basic level of logging regardless of the logging configuration.
Always-on Logging keeps log files for the following components:

• ReceiverHelper
• Citrix Receiver
• Citrix Viewer
• Citrix Workspace Launcher & NPAPI plugin components: Includes ogs related to session launch from a web browser. The Citrix Workspace Launcher for launching using Chrome and Firefox and NPAPI plugin is used while launching using Safari web browser .

NOTE: Support for NPAPI was deprecated by Apple in Safari 12.0. See here for more info.

CWA Updater Logging

CWA Updater Logging is enabled by default with Citrix Receiver for Mac Version 12.6 and later. This is helpful when troubleshooting CWA auto-update related issues.

Instructions

To enable Session Logging

Citrix Workspace App 2006 For Mac

Connection Diagnostics logging is specific to identifying errors while connecting. All logging will be enabled up until the point when the session is deemed successful.
Full Logging will log everything including the Connection Diagnostics and Session Logging. Once enabled, the CWA will store up to 10 Session Logs after which they are deleted starting with the oldest to maintain 10 logs.
Note: Full Logging can impact performance and must only be used while troubleshooting an issue because of the amount of data. It must not be left on during normal use.
The user enabling this logging will get a warning that must be acknowledged to continue.

To enable Store Logging

Select Normal or Verbose in the Store Logging.
The two levels of the Store Logging are Normal and Verbose. With Verbose, the AuthManager will provide more detailed debugging information. Use Normal when only StoreComms logging is necessary.

To disable Session/Store Logging

Select Disabled in the Session Logging and Disabled in the Store Logging.
The CWA log files are stored in the local Mac user’s home directory: ~/Library/Logs/.

Type of logging		Log file location
Installer logging		~/Library/Logs/ReceiverInstall.log
Session logging		~/Library/Logs/Citrix Workspace/CitrixViewer_<time_stamp>.txt (*)
Store logging	Normal	~/Library/Logs/CitrixServerCommunication.log
	Verbose	~/Library/Logs/com.citrix.AuthManager.log, com.citrix.AuthManager_1.log andServiceRecord.log (along with CitrixServerCommunication.log)
Always-on logging	Web Browser Launch Logging (Citrix Receiver Launcher/NPAPI plugin component)	~/Library/Logs/Citrix Workspace/com.apple.WebKit.Plugin.64_<time_stamp>.txt ~/Library/Logs/Citrix Workspace /Citrix Workspace Launcher_<time_stamp>.txt
	Receiver Helper Logging	~/Library/Logs/Citrix Workspace /ReceiverHelper_<time_stamp>.txt
	Citrix Workspace App Logging	~/Library/Logs/Citrix Workspace /Citrix Workspace _<time stamp>.txt
	Citrix Viewer Logging	~/Library/Logs/Citrix Receiver/CitrixViewer_<time_stamp>.txt (*)
CWA Updater Logging		~/Library/Logs/Citrix Workspace /Citrix Workspace Updater_<time_stamp>.txt

(*) The log files for Always-on logging (for Citrix Viewer) and Session logging are the same. Viewer log files generated by Always-on logging contains only the most important logs. However, if Session logging is enabled, other logging along with the Always-on logswill be written to the log file.

Email Log Files

Citrix Workspace App 2006 For Macbook Pro

You can click “Email Log Files” available in the Logging screen to zip Session/Store/Always-on/Citrix Receiver Updater log files, and send it as an attached file via email using your default email client.