About Citrix Receiver for Mac 12.2 Aug 23, 2016 Citrix Receiver for Mac provides users with self-service access to resources published on XenApp or XenDesktop servers. Receiver combines ease of deployment and use, and offers quick, secure access to hosted applications and desktops. Virtual screen tech like Microsoft Remote Desktop an a plethora of standard VNC desktop sharing systems exist so it is not the approach that keeps the latest Citrix Receiver from the store. Bear in mind Citrix Receiver was permitted in the App Store up to the Mar 11, 2011 release but then was 'de-listed'.
Applicable Products
- Citrix Workspace App
- Receiver
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.
Citrix Workspace Update Mac
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:
Citrix Workspace Mac Reset Receiver
- 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.Citrix Receiver Workspace App 1911
Instructions
To enable Session Logging
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.

Citrix Receiver Workspace Client
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

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.
Citrix StoreFront with Safari (MacOS)
Citrix StoreFront with Google Chrome (MacOS)
Citrix StoreFront with Mozilla Firefox (MacOS)
Citrix StoreFront with Safari (MacOS)
Citrix Receiver Workspace App
- Open Safari and browse to https://storefront.lsuhsc.edu.
- Click 'Detect Receiver'
- If you already have the Citrix Workspace installed on your Mac, you can Skip to Step 10 of this document.
- If you do not already have the Citrix Workspace installed on your Mac, StoreFront should prompt you to download it. Click inside the check box next to “I agree with the Citrix licence agreement.” and then click “Download”:
- Safari will now start downloading “CitrixWorkspaceApp.dmg” – Double Click on the downloaded file to open the Disk Image:
- Double click on “Install Citrix Receiver.pkg” and proceed through the prompts by clicking
- 'Allow' then
- “Continue”, 'Continue', “Agree', “Install”
- DO NOT check 'Add Account'
- Click 'Continue'
- Click 'Close”
- Go back to the Safari browser page and click 'Continue'
- Then click “Allow” when prompted to open 'Citrix Workspace Launcher.app'
- Click 'Open' if prompted to open the application for the first time
- You should now see the StoreFront logon dialog, shown below. Simply log on with your typical LSUHSC User ID and password:
- You will now see your available Citrix desktop connections, similar to the screenshot below:
From the above you can launch your Citrix desktop(s) simply by clicking their corresponding icons shown above. If you have any standalone Citrix applications, you can click on the “APPS” button depicted above, and launch the application(s) in a similar way. - Once you are finished working in Citrix, be sure to log off your desktop(s) and close any Citrix apps. Then, if you are still logged on to StoreFront, find the gear icon in the upper right corner of the StoreFront window, click on it, and select “Log off”, as depicted below:
Citrix Receiver Workspace App For Windows
Citrix StoreFront with Google Chrome (MacOS)
- Launch Google Chrome and browse to https://storefront.lsuhsc.edu.
- Click 'Detect Receiver'
- If you already have the Citrix Workspace installed on your Mac, you can Skip to Step 10 of this document.
- If you do not already have the Citrix Workspace installed on your Mac, StoreFront should prompt you to download it. Click inside the check box next to “I agree with the Citrix licence agreement.” and then click “Download”:
- Chrome will now start downloading “CitrixWorkspaceApp.dmg” – Double Click on the downloaded file to open the Disk Image:
- Double click on “Install Citrix Receiver.pkg” and proceed through the prompts by clicking
- 'Allow' then
- “Continue”, 'Continue', “Agree', “Install”
- DO NOT check 'Add Account'
- Click 'Continue'
- Click 'Close”
- Go back to the Chrome browser page and click 'Continue'
- Then check 'Always allow...' and 'Open Citrix Workspace Launcher.app'
- Click 'Open' if prompted to open the application for the first time
- You should now see the StoreFront logon dialog, shown below. Simply log on with your typical LSUHSC User ID and password:
- You will now see your available Citrix desktop connections, similar to the screenshot below:
From the above you can launch your Citrix desktop(s) simply by clicking their corresponding icons shown above. If you have any standalone Citrix applications, you can click on the “APPS” button depicted above, and launch the application(s) in a similar way. - Once you are finished working in Citrix, be sure to log off your desktop(s) and close any Citrix apps. Then, if you are still logged on to StoreFront, find the gear icon in the upper right corner of the StoreFront window, click on it, and select “Log off”, as depicted below:
Citrix StoreFront with Mozilla Firefox (MacOS)
- Open Mozilla Firefox and browse to https://storefront.lsuhsc.edu.
- Click 'Detect Receiver'
- If you already have the Citrix Workspace/Receiver installed on your Mac, you can Skip to Step 10 of this document.
- If you do not already have the Citrix Workspace installed on your Mac, StoreFront should prompt you to download it. Click inside the check box next to “I agree with the Citrix licence agreement.” and then click “Download”:
- Click 'OK'
- Firefox will now start downloading “CitrixWorkspaceApp.dmg” – The Disk Image should automatically open.
- Double click on “Install Citrix Receiver.pkg” and proceed through the prompts by clicking
- 'Allow' then
- “Continue”, 'Continue', “Agree', “Install”
- DO NOT check 'Add Account'
- Click 'Continue'
- Click 'Close”
- Go back to the Firefox browser page and click 'Continue'
- Then check 'Always allow...' and click 'Choose Application'
- Click 'Open Link'
- Click 'Open' if prompted to open the application for the first time
- You should now see the StoreFront logon dialog, shown below. Simply log on with your typical LSUHSC User ID and password:
- You will now see your available Citrix desktop connections, similar to the screenshot below:
From the above you can launch your Citrix desktop(s) simply by clicking their corresponding icons shown above. If you have any standalone Citrix applications, you can click on the “APPS” button depicted above, and launch the application(s) in a similar way. - Once you are finished working in Citrix, be sure to log off your desktop(s) and close any Citrix apps. Then, if you are still logged on to StoreFront, find the gear icon in the upper right corner of the StoreFront window, click on it, and select “Log off”, as depicted below:
Citrix Workspace Mac Vs Receiver
