Applicable Products
If the launch.ica file is correctly associated with the Citrix Receiver or Workspace application, there will be a blue and white icon as shown below. If there is any other icon shown for the file, the association needs to be changed. Go to your downloads folder and locate launch.ica file, right click, select Open with. For Mac OS X 10.9, 10.10, 10.11 - Citrix Receiver v12.2. For Mac OS X 10.8, 10.9, 10.10, 10.11 - Citrix Receiver v12.1. Mac OS Catalina 10.15.2 use Workspace: SSL Certificates (only needed if connection stating certificate is 'untrusted'). Update to Citrix Workspace app for Mac documentation: Known issues in Citrix Workspace app 2005 for Mac: 05 Jun 2020: Release of Citrix Workspace app for Windows: What’s new in Citrix Workspace app 2006.1 for Windows. Note: Re-release of Version 2006 as 2006.1. Apple computers and devices (MacBook, iMac, Mac mini, iPad) Citrix Workspace app replaces the Citrix Receiver App. When accessing your BVN desktop for the first time via an Apple device, a free program called Citrix Workspace App will need to be installed onto the computer or device. Download for macOS. Select Uninstall Citrix Workspace App and follow the on-screen instructions. The.dmg file is the file that is downloaded from Citrix when installing Citrix Workspace app for Mac for the first time. If the file is no longer on your computer, download the file again from Citrix Downloads to uninstall the application.
- Receiver
Information
This article is intended for Citrix administrators and technical teams only. Non-admin users must contact their company’s Help Desk/IT support team and can refer to CTX297149 for more informationApple released Mac OSX 10.10 on October 16th. Changes in Mac OSX 10.10 require changes in Citrix Receiver for full operation.
Citrix will release a tech preview release of Receiver for Mac 11.9 designed to support OSX 10.10.
Users upgrading to OSX 10.10 who want to continue to use Receiver should install the Receiver for Mac 11.9 Tech Preview.
How will existing users of Receiver 11.8.2 and XenApp and XenDesktop be impacted?
Users may experience issues with unresponsive keyboard input while using Receiver or may not be able to connect through NetScaler Gateway.
As this is a major OSX update, the full extent of possible issues user may experience with Receiver for Mac 11.8.2 is unknown.
Reporting issues for tech preview
Tech preview is not supported by Citrix tech support. Users on Mac OSX 10.10 using the Receiver for Mac 11.9 – Tech Preview should report issues to the Tech Support Discussions Forum.
Additional Resources
CTX200212 - Keyboard Input Fails in Citrix Session from Receiver for Mac with OSX 10.9.5
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 .
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
Connection Diagnostics
Citrix Workspace For Mac Download
logging is specific to identifying errors while connecting. All logging will be enabled up until the point when the session is deemed successful.Citrix Workspace For Mac 10.11.6
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.
Citrix Workspace Mac 10.10
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/.
Citrix Workspace Mac 10.12
| 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 For Mac 10.11
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.