Oct 19, 2018 And while performance for me has gotten much better (and an annoying issue that's plagued Citrix based Cerner on the Mac for 10+ years has finally been resolved), if you are logged in for a few hours, performance does degrade. Not as horrible as before I set the PreferMetalRendering to NO, but still, there is a noticeable delay. Jun 23, 2018 Citrix Receiver for Mac cannot be removed from Launchpad. Data / Files / Shortcuts / Icon that is related to Citrix Receiver for Mac have been found in the later use on your Mac. The manual removal of Citrix Receiver on Mac requires advanced knowledge about how macOS file.
Applicable Products
- Receiver for Mac
Objective
This article provides an overview of logging features available with Receiver for Mac, and explains how to use them in the Receiver.
Receiver for Mac has the logging interface in the Advanced tab of the Receiver 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 Receiver for Mac: Installer Logging, Session Logging, Store Logging, Always-on Logging, and Receiver Updates Logging. Installer logging, Always-on and Receiver Updates logging are enabled by default. Conversely, Session Logging and Store Logging are disabled by default. Installer Logging captures debug messages from the Receiver during the installation.
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. As expected, the AuthManager handles the authentication between the user and the Receiver Store or Site. The StoreComms manages the information about the Store configurations and connection settings.
Receiver for Mac 12.2 introduced the Always-on Logging feature, which helps collect important one-time event. This feature is enabled by default and turns on basic level of logging regardless of the logging configuration.Store Logging includes logging of AuthManager and StoreComms. As expected, the AuthManager handles the authentication between the user and the Receiver Store or Site. The StoreComms manages the information about the Store configurations and connection settings.
Log files generated by Always-on Logging are stored in ~/Library/Logs/Citrix Receiver. Always-on Logging keeps 2 log files for the ReceiverHelper/Citrix Receiver/Citrix Receiver Launcher/NPAPI plugin component, and 10 files for Citrix Viewer.Log files for the Citrix Receiver Launcher and NPAPI plugin component contain logs related to session launch from a web browser. The NPAPI plugin is used while launching using Safari web browser and Citrix Receiver Launcher for launch using Chrome and Firefox. Citrix Receiver Updates logging is enabled by default with Citrix Receiver for Mac Version 12.6 and later. This is helpful when troubleshooting Receiver auto-update related issues.
Instructions
Select Connection Diagnostics or Full in the Session Logging.There are two settings within Session Logging- Connection Diagnostics and Full Logging. Connection Diagnostics logging is specific to identifying errors while connecting so 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.
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.
Once enabled, the Receiver will store up to 10 Session Logs after which they are deleted starting with the oldest to maintain 10 logs. 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. Select Disabled in the Session Logging and Disabled in the Store Logging.
The Receiver 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 Receiver/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 Receiver/com.apple.WebKit.Plugin.64_<time_stamp>.txt ~/Library/Logs/Citrix Receiver/Citrix Receiver Launcher_<time_stamp>.txt |
Receiver Helper Logging | ~/Library/Logs/Citrix Receiver/ReceiverHelper_<time_stamp>.txt | |
Citrix Receiver Logging | ~/Library/Logs/Citrix Receiver/Citrix Receiver_<time stamp>.txt | |
Citrix Viewer Logging | ~/Library/Logs/Citrix Receiver/CitrixViewer_<time_stamp>.txt (*) | |
Citrix Receiver Updater Logging | ~/Library/Logs/Citrix Receiver/Citrix Receiver 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.
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.
Applicable Products
- ShareFile
Information
NOTE:
Apple’s latest macOS Catalina has released on October 7. Citrix Files for Mac users must upgrade their version of Citrix Files for Mac to version 19.10 for full compatibility.
TIPS! Need Citrix Files for Mac? Download it here: http://dl.sharefile.com/cfmac |
Citrix Files makes accessing your files from a Mac much easier. It allows you to access files and folders from ShareFile directly through Finder on your Mac. Content is streamed when it is accessed and not permanently stored on your computer. Changes made to files in the ShareFile folder are automatically saved back to the cloud. Most Finder operations like drag and drop, copy and paste, move and rename, and others will automatically update to the cloud.
System Requirements
- macOS 10.12 Sierra
- macOS 10.13 High Sierra
- macOS 10.14 Mojave
Note:
Installation on macOS 10.11 El Capitan is possible, but Citrix no longer supports this version.
Installation on macOS 10.11 El Capitan is possible, but Citrix no longer supports this version.
Install
Download the installer DMG. Open the installer package and follow the prompts to install Citrix Files. You will be required to provide an administrator password to complete the installation.
After installation, a volume named “Citrix Files” will appear. You may access this volume by clicking on the Citrix Files menu bar item and then clicking the folder icon. It will also appear in the Favorites sidebar in Finder windows. This volume displays all of the files and folders from your Citrix Files account.
Sign in
When starting the Citrix Files Desktop app for the first time, you are prompted to sign in with your Citrix Files Credentials.
Basic Operations
Citrix Files allows you to manage the files in your Citrix Files account the same way that you would manage files normally through Finder.
Operation | Description |
---|---|
Open and Edit | Double click on a file in the Citrix Files folder. Make any edits necessary and then save the changes. Citrix Files uploads the edited file. |
Download | Drag and drop file(s) or folder(s) from the Citrix Files folder to another folder on your computer. You may also copy and paste files and folders. |
Upload | Drag and drop file(s) or folder(s) from the Citrix Files folder to another folder on your computer. You may also copy and paste files and folders. |
Delete | Right click on a file or folder and select Move to Trash. You may also drag files and folders to the trash. |
Move | Drag and drop file(s) or folder(s) from one location in the Citrix Files folder to another. |
New Folder | Create a new folder in Citrix Files folder. |
Icon Overlays
Files and Folders will have an icon overlay representing the status of that item. The following defines what each icon overlay represents:
Citrix For Macbook Pro
Right Click Menu
When you right click on a file or folder within Citrix Files, you will see some additional options. These options give you access to the functions available in Citrix Files for these items. Options will vary based on the types of files or folders you have selected, permissions, and account settings.
Operation | Available For | Description |
---|---|---|
Share | Files and Folders | Copy Link - Copies a Citrix Files download link. Link settings will be determined by the Share options in your Preferences. Email with Citrix Files - Send a download link through email. Email options may be customized before sending, or by modifying default options in your Preferences. Email with mail app - Opens the Mail app in Mac OS. A new message is generated that contains a Citrix Files download link Initiate Approval - (For a single file only) Initiate an approval workflow on a file |
Request Files | Single Folder | Copy Link - Copies a Citrix Files upload link. Link settings will be determined by the Share options in your Preferences. Email with Citrix Files - Send a upload link through email. Email options may be customized before sending, or by modifying default options in your Preferences. Email with mail app - Opens the Mail app in Mac OS. A new message is generated that contains a Citrix Files upload link |
Check Out | Single File | Check Out a file to prevent other users from making changes |
View Details | Single File or Folder | View detailed information for a file or folder. The details window provides access to multiple file versions, notes, or checkout details |
Refresh Contents | Single Folder | Folder contents should update automatically as changes are made, but you may refresh contents manually using this function |
Additional actions are available under More Options.
Operation | Available For | Description |
---|---|---|
Download | Files and Folders | For file(s) and folder(s), download allows you to download file(s) or folder(s) to a specific location on your computer. Note: For improved performance, use this option for large file downloads or downloading a large number of items. These downloads are optimized for bulk operations and do not store data in the cache. |
Upload | Single Folder | Right click on a folder and upload allows you to upload files and folders from a specific location on your computer. Note: For improved performance, use this option for large file uploads or uploading a large number of items These downloads are optimized for bulk operations and do not store data in the cache. |
Manage Permissions | Single Folder | Add users to a folder, modify folder permissions, and copy folder permissions from one user to another. |
Add to Favorites | Single File or Single Folder | Adds the file or folder to the Favorites folder. |
Preview | Single File | Stream a video file without downloading it (Available for .mp4, .ogg, .ogv, and .webm file types). |
Menu Bar Icon
This icon displays the current status of Citrix Files. A spinner over the icon indicates activity.
Uploads in progress or edits that are being saved back to Citrix Files will be indicated by a spinner. You will also see a spinner when navigating to a folder. The spinner indicates that the contents of a folder are being fetched and should appear after the spinner disappears.
Uploads in progress or edits that are being saved back to Citrix Files will be indicated by a spinner. You will also see a spinner when navigating to a folder. The spinner indicates that the contents of a folder are being fetched and should appear after the spinner disappears.
Dashboard
Clicking on the menu bar icon will open the dashboard.
Recent Files - Files that have been uploaded or edited will appear in the list of recent files. Double click on a file to open it.
Workflow button - Open up a window containing Workflows where you can view
Open Citrix Files Folder - Opens the Citrix Files location in Finder
Recent Files - Files that have been uploaded or edited will appear in the list of recent files. Double click on a file to open it.
Workflow button - Open up a window containing Workflows where you can view
Open Citrix Files Folder - Opens the Citrix Files location in Finder
Overflow Menu
This provides access to Preferences, Send Feedback, Help Launch Website, and Quit.Provide a rating for the app and leave detailed comments.
Help - Provides links to support and legal resources. This menu also allows you to report a technical problem with the app to the development team.
Citrix For Mac 10.13.6
Launch Website - Opens the Citrix Files website.
Quit - Quits the App.
Preferences - Opens the Preferences for the App.
Preferences
Preference | Description |
---|---|
Account | Log out - Logs you out of your account. Cached files are deleted |
App Settings | Cache - Hover over the ? for details and cache usage Clear Cache - This removes ached files Reset App settings - Removes folder structure archive and cached files. Doing this will quit and relaunch Citrix Files for Mac to please save any work before resetting Uninstall - This uninstalls the application. Administrator permissions are required. |
Share Options | Notifications - Set default notifications that are applied when sharing Security - Set default security options that are applied when sharing |
Open and Edit
Open and Edit has been tested with the following applications:
- Adobe Acrobat Reader DC
- Adobe Photoshop
- Keynote
- Numbers
- Microsoft Excel 2008, 2011, 2016, 2017
- Microsoft PowerPoint 2008, 2011, 2016, 2017
- Microsoft Word 2008, 2011, 2016, 2017
- Pages
- Preview
- Sketch
- TextEdit
Other applications will be tested and fully supported during the course of the Beta program. Please report any issues you experience with open and edit.
Users are welcome to use Citrix Files for Mac with any application, however when using applications that are not listed above, we recommend saving local copies before uploading to Citrix Files until compatibility has been tested.
Users are welcome to use Citrix Files for Mac with any application, however when using applications that are not listed above, we recommend saving local copies before uploading to Citrix Files until compatibility has been tested.
Conflict Prevention
Citrix Files for Mac provides end user notifications when another user uploads a new version of a file or checks a file out while you are also viewing / editing the file, in order to prevent file conflicts.
Notification when someone uploads a new version of the file you also have open:
Notification when someone checks out a file while you also have that file open:
Notification when someone uploads a new version of the file you also have open:
Notification when someone checks out a file while you also have that file open:
Citrix Files Drive Unavailable
Citrix Files gives you access to the files on your Workspace account by making them available as a storage drive (like an SD card or a thumb drive). This drive needs to mount itself into your Mac's file system before files can be accessed from Citrix Files. If the Citrix Files app experiences an issue with mounting, the app menu bar icon will show a warning symbol. You will need to ensure the drive mounts properly before you may use Citrix Files.
Reconnect the Drive
- Click the Citrix Files menu bar icon.
- Click Reconnect.
Relaunch the App
You may need to relaunch Citrix Files app in case the app experiences an issue with mounting.
- Close any files that may be open in Citrix Files (Ex: You have opened a Word document in Citrix Files).
- Click on the Citrix Files menu bar icon.
- Click on (...).
- Select Quit.
- Open Citrix Files app in your Applications folder.
Reinstall Citrix Files
Citrix For Mac Sierra
Citrix Files installs a kernel extension or kext to mount the drive.
Citrix For Mac 19.10
- Click the Citrix Files menu bar icon.
- Click on (...).
- Select Preferences.
- Click Uninstall and Confirm.
- Download and install Citrix Files again.
Additional Resources
CTX237344 - Citrix Files for Mac Known Issues
CTX119253- Language Support for Citrix Products
CTX119253- Language Support for Citrix Products