Citrix workspace linux configuration.
Looking for:
Citrix workspace linux configuration |
Citrix workspace linux configuration.workspace-linux-oem-guide/ at master · citrix/workspace-linux-oem-guide · GitHub
- Citrix workspace linux configuration
Incoming session reliability connections use port , unless you change the port number defined in the session reliability port number policy setting. For information on configuring session reliability policies, see Session reliability policy settings. Session reliability is enabled by default at the server.
To disable this feature, configure the policy managed by the server. These technologies improve the user experience when connecting to hosted applications and desktops, as follows:. HDX MediaStream Windows Media Redirection overcomes the need for the high bandwidths required to provide multimedia capture and playback on virtual Windows desktops accessed from Linux user devices.
Windows Media Redirection provides a mechanism for playing the media run-time files on the user device rather than on the server.
As a result, reduces the bandwidth requirements for playing multimedia files. Windows Media Redirection improves the performance of Windows Media Player and compatible players running on virtual Windows desktops. A wide range of file formats are supported, including:. Citrix Workspace app includes a text-based translation table, MediaStreamingConfig.
You can update the translation table to do the following:. The server is responsible for directing the user device to the media, and for sending control commands including Play, Pause, Stop, Volume, Seek.
But the server does not handle any media data. This feature requires advanced multimedia GStreamer libraries on the device. Install GStreamer 0.
Typically, you install GStreamer before you install Citrix Workspace app to allow the installation process to configure Citrix Workspace app to use it. Most Linux distributions include GStreamer. To enable client-side fetching, install the required GStreamer protocol source plugins for the file types that users play on the device. You can verify that a plug-in is installed and operational using the gst-launch utility.
If gst-launch can play the URL, the required plug-in is operational. For example, run gst-launch In releases earlier to , GStreamer 0. Starting with the release, you can configure GStreamer 1. Install the GStreamer 1. In this case, download the source code and build all binaries locally:.
To configure GStreamer 1. HDX MediaStream Flash Redirection enables Adobe Flash content to play locally on user devices, providing users with high definition audio and video playback, without increasing bandwidth requirements. Verify that your user device meets the feature requirements.
For more information, see System requirements. Add the following parameters to the [WFClient] section of wfclient. By default, this value is set to Never. Also, users are presented with a dialog box asking them if they want to optimize Flash content when connecting to webpages containing that content. Enables or disables server-side content fetching for Citrix Workspace app. By default this value is set to Disabled. Enables or disables HTTP cookie redirection.
By default, this value is set to Disabled. Enables or disables client-side caching for web content fetched by Citrix Workspace app. By default, this value is set to Enabled.
Defines the size of the client-side cache, in MB. This value can be any size between 25 MB and MB. When the size limit is reached, existing content in the cache is deleted to allow storage of new content. Defines the type of caching used by Citrix Workspace app for content fetched using server-side content fetching.
By default, this value is set to Persistent. Flash redirection is disabled by default. HDX RealTime provides a webcam video compression option to improve bandwidth efficiency during video conferencing.
To do this connection, you must do the following:. For more information, see default settings. Open the usb. Secure access to SaaS applications provides a unified user experience that delivers published SaaS applications to the users.
SaaS apps are available with single sign-on. For this protection, you can filter access to specific websites and website categories. The service enables administrators to provide a cohesive experience, integrating single sign-on, and content inspection. Verify that the libgtkglext1 package is available. Citrix Workspace app supports the display of H. This support uses the deep compression codec feature, which is enabled by default.
The feature provides better performance of rich and professional graphics applications on WAN networks compared with the existing JPEG codec. Follow the instructions in this topic to disable the feature and process graphics using the JPEG codec instead.
You can also disable text tracking while still enabling deep compression codec support. This setting helps to reduce CPU costs while processing graphics that include complex images but relatively small amounts of text or non-critical text. If you do, H. In the wfclient. This setting also disables text tracking. With deep compression codec support enabled, in the wfclient. You can improve the way that JPEG-encoded screen tiles are processed using the direct-to-screen bitmap decoding, batch tile decoding, and deferred XSync features.
Note: Enabling batch tile decoding also enables deferred XSync. In earlier versions, the debug. Also as of Version , the debug.
Logging captures the Citrix Workspace app deployment details, configuration changes, and administrative activities to a logging database. When Citrix Workspace app is installed, a user called citrixlog is created to handle the logging functionality. The following table lists various modules and their corresponding trace class values. Use the following table for a specific command-line log value set:. The Citrix Workspace-Preferences dialog appears.
Due to the large amount of data that can be generated, tracing might significantly impact the performance of Citrix Workspace app. The Verbose level is recommended only if necessary for troubleshooting. Click Save and Close after you select the desired logging level.
The changes are applied in the session dynamically. Click the settings icon next to the Logging option drop-down menu. The Citrix Log Preferences dialog appears. If you delete the ICAClient. To collect logs for a particular module, open the debug. You can add different classes separated by the pipe symbol. The following table lists the wfica modules and their corresponding trace class values:. The following table lists the connection center module and their corresponding trace class value:.
If ctxlogd turns unresponsive, the logs are traced in the syslog. For information about getting new and refreshed logs in subsequent launches, see Syslog configuration. For example,. To verify that a new syslog is available, delete syslog and run the command: sudo service rsyslog restart. Server-side configuration: uncomment the following lines in the rsyslog. Client-side configuration: add the following line in the rsyslog. Previously, there was no tool available to collect the log files in Citrix Workspace app.
Log files were present in different folders. You had to manually collect log files from different folders. Starting with version, Citrix Workspace app introduces collectlog. You can run the tool using the command line. The log files are generated as a compressed log file. You can download it from the local server. Starting with Version , two new files are added to collect log files using the collectlog. By default, the [hdxteams] component is added in the logcollector.
However, you can add other components also in the logcollector. Run the following command:. The default path of the logcollector. The difference is that, we bundle all the necessary components for Microsoft Teams optimization into the VDA and the Workspace app for Linux. Citrix Workspace app for Linux supports audio, video, and screen-sharing features with Microsoft Teams optimization. For information on how to enable logging, follow the steps mentioned under Logging for Microsoft Teams.
For information on system requirements, see Microsoft Teams optimization requirements. If Microsoft Teams configures auto gain control and noise suppression options, Citrix-redirected Microsoft Teams honors the values as configured. Otherwise, these options are enabled by default. However, starting from Citrix Workspace app , the echo cancellation option is disabled by default.
Starting from Citrix Workspace app , admins can change the default settings to troubleshoot Audio issues like robotic voice, high CPU causing choppy audio, and so on by doing the following:.
The HdxRtcEngine. Possible values are p, p, p, and p. The performance estimation process uses macroblock code to determine the best resolution that can be achieved with the particular endpoint. The Codec negotiation during a call setup includes the highest possible resolution. The Codec negotiation can be between the peers, or between the peer and the conference server.
The following table lists the four performance categories for endpoints that have its own maximum available resolution:. To set the outgoing video encoding resolution value, for example to p, run the following command from the terminal:. Modify the [HDXTeams] section as follows:.
Starting with the release, a new dependency called the libunwind library is added for llvm However, by default, it does not exist in the original repository. Install the libunwind library manually in the repository using the following steps:. Enter the following line to install the llvm repository key file:. Enter the following line to configure the llvm repository source list:. Starting with version for Citrix Workspace app, the echo cancellation feature is disabled by default.
We recommend that you do not use your built-in speakers and microphone for calls. Use headphones instead. This fix aims to address choppy audio issues noticed on thin clients. Previously, when you clicked Screen sharing , preview of a default or main monitor was only available for screen sharing. With this version, preview of all screens is displayed on the screen picker menu.
You can select any screen for screen sharing in the VDA environment. A red square appears on the selected monitor and a small picture of the selected screen content appears on the screen picker menu. In seamless mode, you can select one from all screens to share. When the Desktop Viewer changes the window mode maximized, restore, or minimize , the screen share stops.
The following features are available only after the roll-out of a future update from Microsoft Teams. When the update is rolled-out by Microsoft, you can check CTX for the documentation update and the announcement.
With this release, you can request control during a Microsoft Teams call when a participant is sharing the screen. Once you have control, you can make selections, edits, or other modifications to the shared screen.
To take control when a screen is being shared, click Request control at the top of the Microsoft Teams screen. While you have control, you can make selections, edits, and other modifications to the shared screen. With this release, Citrix Workspace app supports dynamic emergency calling. The notification is provided based on the current location of the Citrix Workspace app running on the endpoint, instead of the Microsoft Teams client running on the VDA.
You can pop out the conversations or meetings in various ways. However, you will have a minimum of nine months after this feature is GA to upgrade to a version of the VDA or Citrix Workspace app that supports multiple windows and greater.
This feature is available only after the roll-out of a future update from Microsoft Teams. For example, consider that you have set a speaker as the Secondary ringer and your endpoint is connected to a headphone. In this case, Microsoft Teams sends the incoming call signal to the speaker even though your headphones are the primary peripheral for the audio call itself.
To know when the update is rolled-out by Microsoft, see the Microsoft roadmap. You can also refer to CTX for the documentation update and the announcement. Citrix Optimized Teams in Citrix Workspace app for Linux now supports background blurring and background replacement. Previously available as an experimental feature, the NSAP virtual channel feature is fully supported starting with version This approach improves the scalability and the performance of sessions. The NSAP virtual channel is enabled by default.
This feature retains the session monitor layout information across endpoints. The session appears at the same monitors as configured. Click Save Layout on the Desktop Viewer toolbar to save the current session layout. A notification appears at the bottom right of the screen, indicating success. When you click Save layout, the icon grays out. This color change indicates that saving is in progress. When the layout is saved the icon appears normal.
Citrix introduces the Workspace launcher WebHelper to launch published desktops and applications. Previously, the browser plug-in provided along with Citrix Workspace app for Linux enabled users to launch published desktops and applications was based on the NPAPI. As a solution, Citrix is introducing the Workspace launcher WebHelper. However, for Tarball packages, consider a scenario where you have installed the earlier version of the app in one folder and you have installed the newer version of the app in a different folder.
In this scenario, both versions of the app might exist in your system. The Citrix Workspace screen overlay appears on the first launch of the app, when you update, and when you uninstall and reinstall the app.
Click Got it to continue using Citrix Workspace app, or click Learn more for more details. The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation. The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Citrix product purchase decisions.
Citrix Workspace app for Linux. View PDF. This content has been machine translated dynamically. Give feedback here. Thank you for the feedback. Translation failed! The official version of this content is in English. Some of the Citrix documentation content is machine translated for your convenience only.
Citrix has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Citrix product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Citrix, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated.
The following configuration values should be sufficient to enable Fast Connect to work in most typical use cases. Skip to content. Star 2. Permalink master. Branches Tags. Could not load branches. Could not load tags. A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior.
Are you sure you want to create this branch? This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository. Raw Blame. Edit this file. You can customize Citrix Workspace app configuration before installation by modifying the contents of the package and then repackaging the files. Your changes will be included in every Citrix Workspace app installed using the modified package.
To change advanced or less common session settings, you can modify Workspace app's configuration files. These are read each time wfica starts. You can update various different files depending on the effect you want the changes to have. Be aware that, if session sharing is enabled, an existing session might be used instead of a newly reconfigured one. This might cause the session to ignore changes you made in a configuration file. If you want to change the default for all Citrix Workspace app users, modify the module.
For changes to apply to all connections, update wfclient. If you want the changes to apply to all connections for a particular user, modify the wfclient. ICAClient directory. The settings in this file apply to future connections for that user. Note: If an entry appears in more than one configuration file, a value in wfclient. The parameters listed in each file are grouped into sections. Each section begins with a name in square brackets indicating parameters that belong together; for example, [ClientDrive] for parameters related to client drive mapping CDM.
Defaults are automatically supplied for any missing parameters except where indicated. It can restrict values of parameters or set them exactly. If no value is found in any of these files, the default in the Citrix Workspace app code is used. Note: There are exceptions to this order of precedence. For example, the code reads some values directly from wfclient. This topic guides you through the steps for customizing the Workspace app user interface UI and Workspace app connections.
This might require you to modify configuration files, run command-line utilities with options that you specify, or develop plug-ins. In addition to the information presented here, consult the User experience topics in the Workspace app for Linux section on the Product Documentation site.
Citrix provides a set of graphics assets that you can use to modify the Citrix Workspace app UI in this release. To obtain these assets and a specification to help with the modifications, contact the Citrix Ready team.
You can customize Workspace app by wrapping your own UI around the storebrowse command-line utility. When used with Citrix StoreFront, storebrowse is equivalent to the deprecated pnabrowse utility.
Unlike an application's display name, which can be duplicated, a resource name is unique. Therefore, all operations such as launch take the resource name as the argument, and icons are stored with the resource name as the root of the file name. Resource names are long and not necessarily human readable, but result in efficient scripts. To understand the command-line options that you can use with storebrowse, see the Reference information section of this document. If you are migrating from a pnabrowse environment to a storebrowse one, the following information may help with any customizations that you make using that command-line utility:.
Adding stores with storebrowse serves two purposes: it defines which stores can be used by the self-service command, and it allows Service Record daemon, which is responsible for gateway management, to function correctly.
Older versions of StoreFront version 3. If the store being added does not immediately require the user to authenticate, the given credentials are cached in the SSO container for later use. The credentials stored in the SSO container are shared among storebrowse calls as long as they are not removed from the cache or as long as Authentication Manager is running, that is, terminating AM would clear the credential cache. When a set of credentials have been inserted, they can be omitted in any subsequent usage of storebrowse that requires that same credentials.
When it adds a store, storebrowse displays the URL that you should use to specify that store. Deleting a store does not remove any credential from the SSO container, as that particular store might have been added without specifying SSO credentials, or the cached SSO credentials might still be required by any of the remaining stores. To remove the credentials from SSO, use the specific command: storebrowse -K. The store URL passed to the command must match the value that was written to standard output when it was added.
This can be shown by the command: storebrowse -l. The credentials can be omitted if they have been already inserted in SSO by a previous storebrowse call. The store URL must match the value that is shown by storebrowse -l. The following command lines remove the most recent set of credentials stored in the SSO cache:.
The command returns successfully even when no credentials are actually present in the internal credential cache. The following example specifies the default gateway for a store. For example, machines in two locations might access the same store through two different gateways. The following example command line enumerates all of the available resources on a Program Neighborhood Agent server.
The server's URL is specified in the final argument. The command line outputs the default information and saves the bit icon associated with the resource.
The file name is part of the output. You can customize the appearance of the self-service user interface UI in Citrix Workspace app. Note: For X1 connections the core self-selection interface is configurable on the server. For the now legacy green UI, it is still possible to modify it locally. Because the legacy green UI is based on the Workspace app for Web, you can use that component's customization interface to modify the UI. For example, you can rebrand the UI by creating a new skin based on an alternative CSS and your own images.
Note: You cannot customize the logon dialog boxes in this way. Use the Workspace app UI dialog library instead. For more information, see UI Dialog library. These contain the Workspace app for Web code, which is rendered by the self-service UI as its interface:. To help modify the self-service UI, you can run the underlying web code in a standalone mode using a web browser. This lets you use standard web tools for example, Firebug for Firefox to inspect and modify the site.
In addition to the self-selection UI, it is also possible to rebrand some other screens. For complex customizations, you can replace configmgr. Note: Many of the configuration options were available in wfcmgr, which is no longer available. For more information on them than is provided here, consult an earlier version of this document.
The Accounts page uses the following storebrowse commands to add, remove and edit stores. If you have multiple stores, use the following command to define which one is displayed when the user first starts Workspace app.
Replace the? The following access level flags in the wfclient. Workspace app connections can be customized by creating plug-ins to perform one or more of the following functions:. You can develop plug-ins for decoding independently of the other types listed, unless they also need to control memory allocation. To test any plug-ins that you develop, you may need to rename them and you must copy them to the Workspace app installation directory.
Citrix Workspace app supports additional plug-ins for accelerated audio and video codecs, but no SDK is provided for these in this release. Workspace app can also be configured to use GStreamer for webcam and multimedia functions. These plug-ins are standard GStreamer components and are not covered in this document. Important: Plug-in development in a non-X-Window system might require a specialized toolkit and customization of the UI dialog library in the Workspace app.
The following tables describe the shared library files that you should be aware of when developing plug-ins with the Platform Optimization SDK. If Workspace app cannot locate or use a file, the fallback file where available is used instead. You can enable or configure some plug-ins using the following files and additional system components.
In these cases, no fallback files are employed and source files, for plug-in development, are not supplied. For maximum flexibility in exploiting on-chip decoders and hardware rendering support, plug-ins can take full control of the decoding, overlay, and rendering process.
Plug-ins that support hardware-accelerated JPEG decoding can improve graphics performance for sessions when not using H. Improvements in the server graphics encoding technology have resulted in a lower bandwidth profile, lower server CPU usage and higher overall visual quality than if H.
JPEG fallback is employed if necessary to ensure images are displayed efficiently on the user device. The following decoders are used in this order:. Hardware-accelerated plug-ins for H. If you are using the plug-in for memory allocation, you must supply only two functions. The header file for memory allocation plug-ins is mainloop.
Before using this code as a model for your own plug-in, pay careful attention to the comments in the code. Parts of it are present only for backward compatibility with decoder plug-ins that were developed for obsolete versions of Citrix Workspace app.
In some environments using X11, other drawing methods might be faster than the calls to XShmPutImage that are used by default. When these alternative entry points are used, you do not additionally have to implement the memory allocation functions.
❿
Comments
Post a Comment