Citrix Developer Portal
Looking for:
Citrix workspace linux configuration |
Get started | Citrix Workspace app for Linux - Information
Citrix workspace linux configuration.Get started
The split devices appear in the Desktop Viewer. Earlier when a device was unplugged and plugged in during a session, the device was auto-redirected. As a result, the device was auto connected to the VDA. With this release, you are required to enable auto-redirection manually through configuration file settings.
Auto-redirection of composite USB devices is disabled, by default. USB 2. Such devices employ a single configuration space and shared bus connection where a unique interface number ff is used to identify each child device. When a composite USB device is forwarded, the entire device becomes unavailable to the endpoint. This action blocks the local usage of the device for all applications on the endpoint, including the Citrix Workspace client needed for an optimized HDX remote experience.
If the entire device is forwarded using a generic USB channel, the device becomes unavailable for redirection over the optimized HDX audio channel.
However, you can achieve best experience when the audio is sent through the optimized HDX audio channel unlike the audio sent using host-side audio drivers through generic USB remoting. This is because of the noisy nature of the USB audio protocols.
You also notice issues when the system keyboard or pointing device are part of a composite device with other integrated features required for the remote session support.
When a complete composite device is forwarded, the system keyboard or mouse becomes inoperable at the endpoint, except within the remote desktop session or application.
To resolve these issues, Citrix recommends that you split the composite device and forward only the child interfaces that use a generic USB channel. This setting ensures that the other child devices are available for use by applications on the client endpoint, including, the Citrix Workspace app that provides optimized HDX experiences, while allowing only the required devices to be forwarded and available to the remote session.
Earlier when a device was unplugged and plugged in during a session, the device was redirected automatically. As a result, the device was auto-connected to the VDA. As with regular USB devices, the composite devices for forwarding are selected based on the device rules set in the Citrix Workspace app configuration. Citrix Workspace app uses these rules to decide which USB devices to allow or prevent from forwarding to the remote session.
Each rule consists of an action keyword Allow, Connect, or Deny , a colon : , and zero or more filter parameters that match actual devices at the endpoints USB subsystem. Device rules are clear text with each rule on a single line and an optional comment after a character. Rules are matched top down descending priority order.
The first rule that matches the device or child interface is applied. Subsequent rules that select the same device or interface are ignored. The first six parameters select the USB devices for which the rule must be applied. If any parameter is not specified, the rule matches a device with ANY value for that parameter. You can check the vendor, product, release, and interface IDs of a specific device using a free tool like lsusb:.
When present, the last two parameters apply only to USB composite devices. The split parameter determines if a composite device must be forwarded as split devices or as a single composite device. The intf parameter selects the specific child interfaces of the composite device to which the action must be applied. If omitted, the action applies to all interfaces of the composite device. In a desktop session, navigate to the Desktop Viewer under Devices.
The split USB devices appear. In some circumstances, however, you might require users to connect webcams using USB support. Webcam redirection works for bit and bit applications. For example, Skype, GoToMeeting. Use a bit browser or bit browser to verify webcam redirection online.
For example, www. Webcam usage is exclusive to applications. The version of the GStreamer plug-in must be consistent with the version of the GStreamer framework.
For example, if you install the Gstreamer 1. Do the following steps to activate and configure webcam redirection feature for bit apps on Citrix Workspace app for Linux. Set the AllowAudioInput value to True to enable the webcam redirection feature. If the AllowAudioInput value is set to False , do the following to enable the webcam redirection feature:. Set the AllowAudioInput value to True. This encoder is a software-based encoder with acceptable performance.
However, this encoder supports only bit apps on a VDA. The Theora encoder does not support the webcam redirection feature for bit apps on a VDA. Configure the H encoder option to support the webcam redirection feature for bit apps on VDA. H encoder supports the webcam redirection feature for bit apps on the VDA. To enable the H encoder, you must do the following:. After configuring the H encoder, if the webcam redirection feature does not support bit apps on the VDA verify the system dependencies.
The webcam redirection feature for the bit app is based on the GStreamer framework. Previous versions of ICAClient might fail. You can also run the workspaceappcheck. Apart from the GStreamer 1. For more information to install the preceding plugins , see the GStreamer installation guide. For example, if you install Gstreamer1. Run the following command to check the current version of the GStreamer framework:. For information about troubleshooting, see Webcam in the troubleshooting section.
The Citrix Workspace app package includes a helper application, xcapture. Users can use xcapture to:. Previously, when you were using the custom bit cursor, a black box might appear around the cursor. Starting with version , Citrix Workspace app for Linux supports bit cursor. As a result, the black box around the cursor issue is resolved. Previously, the Citrix Workspace app displayed a dotted cursor that appeared the same in color to the black and white background of a text.
As a result, it was difficult to locate the position of the cursor. Starting with Version , the cursor color inverts based on the background color of a text. As a result, you can easily locate the position of the cursor in the text. ICAClient is already present in the home folder of the current user:. If the. In that case, the default setting for the feature is retained. The cursor does not invert when the value for the Use video codec for compression policy in Citrix Studio is set to Do not use video codec.
Relative Mouse support provides an option to interpret the mouse position in a relative rather than absolute manner.
This capability is required for applications that demand relative mouse input rather than absolute. This feature is available only in sessions running on Citrix Virtual Apps and Desktops 7. This step enables the feature but keeps it inactive until you activate it.
For more information on enabling relative mouse features, see Alternative Relative Mouse values section. Find the vid and pid of the Bloomberg keyboard. For example, in Debian and Ubuntu run the following command:. Add the following entry in the usb. Restart the ctxusbd daemon on the client. Launch a client session.
Make sure that the session has focus while plugging in the Bloomberg v4 keyboard for redirection. However, on thin clients, there were performance issues. This functionality enriches the user experience for BCR. It helps offload network usage, page processing, and graphics rendering to the endpoint. Starting with Version , CEF-based browser content redirection is fully functional. The feature is enabled by default. If needed, you can replace the libffmpeg. The issue occurs on Citrix Workspace app version and later.
As a workaround, run the following command in the terminal to import the self-signed certificate into nssdb :. This topic describes the HDX Broadcast auto-client reconnection feature. Citrix recommends that you use this feature with the HDX Broadcast session reliability feature. Users can be disconnected from their sessions because of unreliable networks, highly variable network latency, or range limitations of wireless devices.
With the HDX Broadcast auto-client reconnection feature, Citrix Workspace app for Linux can detect unintended disconnections of sessions and reconnect users to the affected sessions automatically. When this feature is enabled on the server, users do not have to reconnect manually to continue working. Citrix Workspace attempts to reconnect to the session a set number of times until there is a successful reconnection or the user cancels the reconnection attempts.
If user authentication is required, a dialog box requesting credentials appears to a user during automatic reconnection. Automatic reconnection does not occur if users exit applications without logging off. Users can reconnect only to disconnected sessions.
By default, Citrix Workspace app for Linux waits 30 seconds before attempting to reconnect to a disconnected session and attempts to reconnect to that session three times.
To protect against network dropouts, ensure that Session Reliability is enabled on the server, client, and configured on the AccessGateway. For example, wireless users enter in a tunnel might lose their connection when they enter the tunnel and regain it when they emerge on the other side.
When the connection is re-established, these interactions are replayed into the application. You can now see screen changes when the session reliability begins. With this enhancement, the session window is grayed out and a countdown timer displays the time until the next reconnection attempt occurs. You can alter the grayscale brightness used for an inactive session using the Reconnection UI transparency level policy. By default, this value is set to When a session successfully reconnects, the countdown notification message disappears.
You can interact with the desktop as usual. When auto-client reconnection and session reliability are configured, session reliability takes precedence if there is a connection problem.
Session reliability attempts to re-establish a connection to the existing session. It might take up to 25 seconds to detect a connection problem. And then takes a configurable period the default is seconds to attempt the reconnection.
If session reliability fails to reconnect, then auto-client reconnect attempts to reconnect. If HDX Broadcast session reliability is enabled, the default port used for session communication switches from to HDX Broadcast session reliability requires that another feature, the Common Gateway Protocol, is enabled using policy settings on the server.
The session reliability timeout policy setting has a default of seconds, or three minutes. If needed, you can extend the time session reliability keeps a session open.
It does not prompt you for reauthentication. As you extend the amount of time a session is kept open, you might get distracted and walk away from your device.
This situation potentially leaves the session accessible to unauthorized users. 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. To enable this feature, configure StoreFront to send requests to Workspace launcher to detect the Citrix Workspace app installation.
This feature helps to launch the ICA file automatically and to detect the Citrix Workspace app installation. Citrix Workspace launcher currently works only with direct connections to StoreFront. Keyboard layout synchronization enables you to switch among preferred keyboard layouts on the client device. This feature is disabled by default.
After you enable this feature, the client keyboard layout automatically synchronizes to the virtual apps and desktops. Starting with version , Citrix Workspace app supports the following three different keyboard layout synchronization modes:. Citrix Workspace app provides both UI and configuration settings to enable the three different keyboard layout synchronization modes.
To configure keyboard layout synchronization using the graphical user interface:. From the Citrix Workspace app icon in the notification area, select Preferences. Modify the wfclient. With this feature enabled, when launching a session, the active keyboard layout on the client device is synchronized to VDA. Based on the KeyboardLayout value in the wfclient. If the KeyboardLayout value is set to a specific language, the language-specific keyboard is synchronized to VDA.
Unicode keyboard input mode is the recommended option for the Sync only once — when session launches mode. With this feature enabled, when the keyboard layout changes on the client device during a session, the keyboard layout of the session changes correctly. Unicode keyboard input mode is the recommended option for the Allow dynamic sync mode.
With this feature enabled, the VDA side keyboard layout is used, irrespective of the keyboard layout that is selected in the client device.
Citrix recommends the following keyboard input mode for the different keyboard layout sync options:. You can change the configuration of KeyboardEventMode in the wfclient. However, for best performance, use the Citrix-recommended modes for different scenarios, physical keyboards, and client devices. Previously, you were able to enable different keyboard input modes only by updating the value of KeyboardEventMode in the configuration file. There was no UI option to select the keyboard input mode.
Starting with Citrix Workspace app , you can configure different keyboard input modes from the newly introduced Keyboard input mode settings section. You can select Scancode or Unicode as keyboard input mode. Click Keyboard. You can see the newly added the Keyboard input mode settings section. By default, the Keyboard input mode settings is selected as Unicode.
For more information on keyboard input mode, see the Configure keyboard layout section in the Keyboard layout synchronization documentation. The keyboard configuration changes take effect once you reconnect to the application. If you change the keyboard input mode in the UI, the parameter value of the KeyboardEventMode in the wfclient. So, even if the VDA uses the Russian keyboard layout, the character a appears on the screen.
Starting with Citrix Workspace app version , the Scancode keyboard input mode supports the following extended keyboard layouts:. The Scancode keyboard input mode supports the extended keyboard layouts along with all keyboard layout synchronization modes. Change the value of the KeyboardLayout attribute as follows:. The default value for the KeyboardLayout attribute is User Profile.
A Citrix Virtual Apps Services might also publish a file, rather than an application or desktop. This process is referred to as publishing content, and allows pnabrowse to open the published file. Only when a published application is associated with the file type of the published file:.
Protocols not listed in this key are implicitly disabled and not used to log onto StoreFront. AM attempts to use the protocols in the order they are listed in the key value. Note that these protocol name values match the protocol names that StoreFront offers the client to authenticate with.
Multiple string values must be entered in the configuration file as a list of comma-separated strings with no extra spaces. The ProtocolOrder is not present in the configuration file by default but it has a default value as follows:.
The values are case insensitive. Only the bold protocol names are needed for FC. Set the string values to contain the protocols the client is supposed to use. For username and password credentials, set it to:. Set the ProtocolOrder value to:. To enable it, set the following key value to true under the Protocols node:. The default configuration file contains an example specific for this case, uncomment it to enable HTTPBasic.
This section covers only the configuration affecting FC. Currently, AM, as a client, supports only smart card certificates from smart card devices but not soft certificates. The general client deployment with smart card authentication is for a client to have one smart card reader with one smart card in. The PIN is not bound to a specific smart card or card reader. This is to prevent situations where the cached PIN is used with an inappropriate card and the card becomes locked.
By default, AM uses only a PIN credential from SSO to unlock a smart card certificate if there is one smart card reader and one smart card available on the system. It is possible for customer configurations to involve additional used or unused card readers or multiple smart cards with the same PIN. For example, some smart card middleware solutions create unused virtual smart card reader devices; administrator card enrolment stations can also have multiple cards and readers present. 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.
Citrix workspace linux configuration
Asked by Russ Gentry. Hw do I citrix workspace linux configuration the logging for Citrix Workspace for Linux Debian package via config file to use in a configuration management deployment scheme? Do I configure how Confiburation want logging on a machine I install workspace on then copy the setlog file and use it to replace the default setlog file in my deployments?
I know the debug. Below are the узнать больше здесь values from module. There have been no answers перейти this citrix workspace linux configuration yet. You will be able to leave a comment after signing in. Welcome to the Citrix Discussions. Our site does not support outdated browser or earlier versions. To use our site, please take one of the following actions:.
Jump to content. Upvote if you also продолжить this question or find it interesting. Learn more. Citrix workspace linux configuration, to receive updates on this topic. Sign in to follow this Followers 1. Russ Gentry 0. Russ Gentry 0 Cotrix 4 posts. Posted August 27, Share this post Link to post. Recommended Posts. Please sign in to comment You will be able to leave a comment after signing in Confjguration in now.
To use our site, please take one of the configutation actions: Upgrade your version of Internet Explorer. You can find more information here Install the Google browser. You can find more information here Install the Firefox browser.
Comments
Post a Comment