Citrix workspace app linux

Get started

Set up

You can download the installation package, customize the configuration and then install the Citrix Workspace app. You can modify the contents of Citrix Workspace app package and then repackage the files.

Customize installation

1. Expand the Citrix Workspace app package file into an empty directory. The package file is called platform.major.minor.release.build.tar.gz (for example, linuxx86.13.2.0.nnnnnn.tar.gz for the Linux/x86 platform).
2. Make the required changes to the Citrix Workspace app package. For example, you can add a TLS root certificate to use a certificate from Certificate Authority that is not a part of the standard Citrix Workspace app installation.
3. Open the PkgID file.

Add the following line to indicate that the package was modified:

where, traceinfo is information indicating who made the change and when.

Save and close the file.

Open the package file list, platform/platform.psf (for example, linuxx86/linuxx86.psf for the Linux/x86 platform).

Update the package file list to reflect the changes you made to the package. Not updating might cause error when installing the new package. Changes can include updating the size of any files you modified, or adding new lines for any files you added to the package. The columns in the package file list are:

• File type
• Relative path
• Subpackage (always set to cor )
• Permissions
• Owner
• Group
• Size

Save and close the file.

Use the tar command to rebuild Citrix Workspace app package file. For example, tar czf ../newpackage.tar.gz * , where newpackagez is the name of the new Citrix Workspace app package file.

Latest webkit support

Citrix Workspace app for Linux requires libwebkit2gtk (2.16.6+).

libwebkit2gtk has the following advantages:

• Improved UI experience. webkit2gtk is compatible with the browser content redirection feature. Use webkit2gtk Version 2.24 or later for an even better YouTube viewing experience.
• webkit2gtk Version 2.16.6 and later improves the sign-in experience and the time it takes to sign in.
• The app works better with newer Linux distributions and provides with the latest webkit security fixes.

webkit2gtk is not available on some Linux distributions. As a workaround, consider the following options:

• Build webkit2gtk from the source before installing Citrix Workspace app 1906.
• Download the web package from the Downloads page. Only web launches are supported in this package.
• Move to a later Linux distribution that supports webkit2gtk 2.16.6 or later.

Launch

You can start Citrix Workspace app either at a terminal prompt or from one of the supported desktop environments.

Ensure that the environment variable ICAROOT is set to point to the actual installation directory.

The following instruction does not apply to installations made from the Web packages, and where the tarball is used but where the requirements for self-service have not been met.

Terminal prompt

To start the Citrix Workspace app at the terminal prompt, type: /opt/Citrix/ICAClient/selfservice

And press Enter (where /opt/Citrix/ICAClient is the directory in which you installed Citrix Workspace app).

Linux desktop

You can start the Citrix Workspace app from a desktop environment using a file manager.

On some desktops, you can also start Citrix Workspace app from a menu. Citrix Workspace app is located in different menus depending on your Linux distribution.

Preferences

To set preferences, click Preferences from the Citrix Workspace app menu. You can control how desktops are displayed, connect to different applications and desktops, and manage file and device access.

Manage an account

To access desktops and applications, you need an account with XenDesktop or Citrix Virtual Apps. Your IT help desk might ask you to add an account to Citrix Workspace for this purpose. Or they might ask you to use a different Citrix Gateway or Access Gateway server for an existing account. You can also remove accounts from Citrix Workspace.

1. On the Accounts page of the Preferences dialog, do one of the following:
   • To add an account, click Add. Contact your system administrator for more information.
   • To change details of a store that the account uses, such as the default gateway, click Edit.
   • To remove an account, click Remove.
2. Follow the on-screen prompts. Authenticate to the server when asked.

Desktop display

This feature is not available with Citrix Virtual Apps for UNIX sessions.

You can display desktops across the entire screen on your user device (full screen mode), which is the default, or in a separate window (windowed mode).

• On the General page of the Preferences dialog box, select a mode using the Display desktop in option.

Use the You can enable Desktop Viewer toolbar functionality to dynamically modify the window configuration of your remote session.

Desktop Viewer

Your requirements for the way users access virtual desktops can vary from user to user and might vary as your corporate needs evolve.

Use the Desktop Viewer when users interact with their virtual desktop. The user’s virtual desktop can be a published virtual desktop, or a shared or dedicated desktop. In this access scenario, the Desktop Viewer toolbar functionality allows the user to switch a session between windowed and full-screen session window, including multi-monitor support for the intersected monitors. Users can switch between desktop sessions and work with more than one desktop using multiple Citrix Virtual Apps and Desktops connections on the same user device. Buttons to minimize all desktop sessions, send the Ctrl+Alt+Del sequence, disconnect, and log off from the session are provided to manage a user’s session conveniently.

Pressing Ctrl+Alt+Break displays the Desktop Viewer toolbar buttons in a pop-up window.

Automatic session reconnect

Citrix Workspace app can reconnect to desktops and applications that are disconnected. For example, a network infrastructure issue.

• On the General page of the Preferences dialog box, select an option in Reconnect apps and desktops.

Access local files

A virtual desktop or application needs access to files on your device. You can control the extent to which this happens.

1. On the File Access page of the Preferences dialog box, select a mapped drive and then one of the following options:
   • Read and write — Allow the desktop or application to read and write to local files.
   • Read only — Allow the desktop or application to read but not write to local files.
   • No access — Do not allow the desktop or application to access local files.
   • Ask me each time — Display a prompt each time the desktop or application needs to access local files.
2. Click Add, specify the location, and select a drive to map to it.

Microphone and Webcam

To set up a microphone or a webcam, you can change the way a virtual desktop or application accesses your local microphone or webcam:

On the Mic & Webcam page of the Preferences dialog box, select one of the following options:

• Use my microphone and webcam — Allow the microphone and webcam to be used by the desktop or application.
• Don’t use my microphone or webcam — Do not allow the microphone or webcam to be used by the desktop or application.

Flash player

You can choose how flash content is displayed. This content is normally displayed in Flash Player and includes video, animation, and applications:

On the Flash page of the Preferences dialog box, select one of the following options:

• Optimize content — Improves playback quality at the risk of reducing security.
• Don’t optimize content — Provides basic playback quality without reducing security.
• Ask me each time — Prompts each time a flash content is displayed.

Connect

Citrix Workspace app provides users with secure, self-service access to virtual desktops and applications, and on-demand access to Windows, web, and Software as a Service (SaaS) applications. Citrix StoreFront or legacy webpages created with Web Interface manage the user access.

To connect to resources using the Citrix Workspace UI

The Citrix Workspace app home page displays virtual desktops and applications that are available to the users based on their account settings (that is, the server they connect to) and settings configured by Citrix Virtual Apps and Desktops administrators. Using the Preferences > Accounts page, you can configure the URL of a StoreFront server or, if email-based account discovery is configured, by entering the email address.

If you use the same name for multiple stores on the StoreFront server, you avoid duplications by adding numbers. The names for such stores depend on the order in which they are added. For Citrix Workspace app, the store URL is displayed and uniquely identifies the store.

After connecting to a store, self-service shows the tabs: FAVORITES, DESKTOPS, and APPS. To launch a session, click the appropriate icon. To add an icon to FAVORITES, click the Details link next to the icon and select Add To Favorites.

Configure connection settings

You can configure some default settings for connections between Citrix Workspace app and Citrix Virtual Apps and Desktops servers. You can also change these settings for individual connections, if necessary.

Although the tasks and responsibilities of administrators and users can overlap, the term “user” is employed to distinguish typical user tasks from those typically performed by administrators.

Connect to resources from a command line or browser

You create connections to servers when you click a desktop or application icon on the Citrix Workspace app home page. In addition, you can open connections from a command line or from a web browser.

To create a connection to a Program Neighborhood or StoreFront server using a command line

Prerequisite:

Ensure that the store is known to Citrix Workspace app. If necessary, add it using the following command:

Obtain the unique ID of the desktop or application that you want to connect to. This is the first quoted string on a line acquired in one of the following commands:

List all of the desktops and applications on the server:

List the desktops and applications that you have subscribed to:

Run the following command to start the desktop or application:

If you cannot connect to a server, your administrator might need to change the server location or SOCKS proxy details. For more information, see proxy server.

To create a connection from a web browser

Configuration for starting sessions from a web browser is typically carried out automatically during installation. Because of the wide variety of browsers and operating systems, some manual configuration can be required.

If you set up .mailcap and MIME files for Firefox, Mozilla, or Chrome manually, use the following file modifications so that .ICA files start up the Citrix Workspace app executable, wfica. To use other browsers, modify the browser configuration accordingly.

Run the following commands for non-administrator installation of Citrix Workspace app. The settings of ICAROOT might be changed if they are installed to a non-default location. You can test the result with the command

xdg-mime query default application/x-ica , which must return “wfica.desktop.”

xdg-icon-resource install —size 64

$ICAROOT/icons/000\_Receiver_64.png Citrix Workspace app

xdg-mime default wfica.desktop application/x-ica

xdg-mime default new\_store.desktop application/vnd.citrix.receiver.configure

Create or extend the file /etc/xdg/mimeapps.list (for administrator installation) or $HOME/.local/share/applications/mimeapps.list (mimeapps.list) . The file must start with [Default Applications], and follow by:

You might need to configure Firefox on its Preferences/Applications setting page.

For “Citrix ICA settings file content,” select:

“Citrix Workspace app Engine (default)” in the drop-down menu

“Use other …” and then select the file /usr/share/applications/wfica.desktop (for an administrator installation of Citrix Workspace app)

$HOME/.local/share/applications/wfica.desktop (for a non-administrator installation).

Connection Center

Users can manage their active connections using the Connection Center. This feature is a useful productivity tool that enables users and administrators to troubleshoot slow or problematic connections. With Connection Center, users can manage connections by:

• Closing an application.
• Logging off a session. This step ends the session and closes any open applications.
• Disconnecting from a session. This step cuts the selected connection to the server without closing any open applications (unless the server is configured to close applications on disconnection).
• Viewing connection transport statistics.

Manage a connection

To manage a connection using the Connection Center:

On the Citrix Workspace app menu, click Connection Center.

The servers that are used appear and, each active sessions are listed.

Do one of the following:

• Select a server, disconnect or log off, or view its properties.
• Select an application, close the window.

Источник

Install, Uninstall, and Upgrade

You can install the Citrix Workspace app by downloading the file from the Citrix website at Downloads.

Manual install

Download the following packages from the Citrix Downloads page.

Debian packages

Install one of the Icaclient packages, or one of the IcaclientWeb packages based on your OS architecture.

To use generic USB redirection, install one of the ctxusb packages based on your OS architecture.

Package name	Contents
Debian packages (Ubuntu, Debian, Linux Mint etc.)
icaclient_20.06.0.15_amd64.deb	Self-service support, 64-bit x86_64
icaclient_20.06.0.15_i386.deb	Self-service support, 32-bit x86
icaclient_20.06.0.15_armhf.deb	Self-service support, ARM HF
icaclientWeb_20.06.0.15_amd64.deb	Web Receiver only, 64-bit x86_64
icaclientWeb_20.06.0.15_i386.deb	Web Receiver only, 32-bit x86
icaclientWeb_20.06.0.15_armhf.deb	Web Receiver only, ARM HF
ctxusb_20.06.0.15_amd64.deb	USB package, 64-bit x86_64
ctxusb_20.06.0.15_i386.deb	USB package, 32-bit x86
ctxusb_20.06.0.15_armhf.deb	USB package, ARM HF

Install using a Debian package

When installing Citrix Workspace app from Debian package on Ubuntu, open the packages in the Ubuntu Software Center.

In the following instructions, replace packagename with the name of the package that you are trying to install.

This procedure uses a command line and the native package manager for Ubuntu, Debian, or Mint. You can also install the package by double-clicking the downloaded .deb package in a file browser. This typically starts a package manager that downloads any missing required software. If no package manager is available, Citrix recommends you to use the gdebi, a command-line tool.

You must install the icaclient package or the icaclientWeb package.

To install the package using the command line:

1. Log on as a privileged (root) user.
2. Open a terminal window.

Run the installation for the following three packages by typing gdebi packagename.deb . For example:

• gdebi icaclient\_19.0.6.6\_amd64.deb
• gdebi icaclientWeb\_19.0.6.6\_i386.deb
• gdebi ctxusb\_2.7.6\_amd64.deb

To use dpkg in the above examples, replace gdebi with dpkg -i .

If you are using dpkg , install any missing dependencies by typing sudo apt-get -f install. .

• The ctxusb package is optional to support the generic USB redirection feature.
• Starting with Version 2101, an interactive prompt appears asking you to install app protection.

Installing the app protection component on Debian packages

Starting with Version 2102, app protection is supported on the Debian version of Citrix Workspace app.

For silent installation of the app protection component, run the following command from the terminal before installing Citrix Workspace app:

Installing Service Continuity on Debian packages

Starting with Version 2106, you can install Service Continuity on Debian version of Citrix Workspace app.

Run the following commands from the terminal before installing Citrix Workspace app:

sudo apt-get update

sudo apt-get install libwebkit2gtk-4.0-37 gnome-keyring libsecret-1-0

Red Hat packages

Install one of the ICAClient packages, or one of the ICAClientWeb packages based on your OS architecture.

To use generic USB redirection, install one of the ctxusb packages based on your OS architecture.

Package name	Contents
Redhat packages (Redhat, SUSE, Fedora etc.)
ICAClient-rhel-20.06.0.15-0.x86_64.rpm	Self-service support, Red Hat (including Linux VDA) based, 64-bit x86_64
ICAClient-rhel-20.06.0.15-0.i386.rpm	Self-service support, Red Hat based, 32-bit x86
ICAClientWeb-rhel-20.06.0.15-0.x86_64.rpm	Web Receiver only, Red Hat based, 64-bit x86_64
ICAClientWeb-rhel-20.06.0.15-0.i386.rpm	Web Receiver only, Red Hat based, 32-bit x86
ICAClient-suse-20.06.0.15-0.x86_64.rpm	Self-service support, SUSE based, 64-bit x86_64
ICAClient-suse-20.06.0.15-0.i386.rpm	Self-service support, SUSE based, 32-bit x86
ICAClientWeb-suse-20.06.0.15-0.x86_64.rpm	Web Receiver only, SUSE based, 64-bit x86_64
ICAClientWeb-suse-20.06.0.15-0.i386.rpm	Web Receiver only, SUSE based, 32-bit x86
ctxusb-20.06.0.15-1.x86_64.rpm	USB package, 64-bit x86_64
ctxusb-20.06.0.15-1.i386.rpm	USB package, 32-bit x86

The SuSE 11 SP3 Full Package (Self-Service Support) RPM package is deprecated.

Install using an RPM package

If you are installing Citrix Workspace app from the RPM package on SUSE, use the YaST or Zypper utility. The RPM utility installs the .rpm package. An error occurs if the required dependencies are missing.

To set up the EPEL repository on Red Hat

Download the appropriate source RPM package from the Fedora/Red Hat page.

For example, on Red Hat Enterprise 7.x, you can install the EPEL repository by using following command:

RPM Package Manager does not install any missing required software. To download and install the software, we recommend using zypper install at a command line on OpenSUSE or yum localinstall on Fedora/Red Hat.

To install from the RPM package

You must install the icaclient package or the icaclientWeb package.

1. Set up the EPEL repository.
2. Log on as a privileged (root) user.

Run the installation for the following three packages by typing zypper in

• ctxusb is an optional package. Install the package to support Generic USB Redirection.
• ctxappprotection is an optional package. Install the package only if you want to install the app protection component.

Open a terminal window.

For SUSE installations:

zypper in ICAClient-suse-19.12.0.19-0.x86_64.rpm

zypper in ICAClient-suse-19.12.0.19-0.i386.rpm

zypper in ctxusb-2.7.19-1.x86\_64.rpm

zypper in ctxappprotection-21.4.0.2-0.x86_64.rpm

For Red Hat installations:

yum localinstall ICAClient-rhel-19.12.0.19-0.i386.rpm

yum localinstall ICAClientWeb-rhel-19.12.0.19-0.i386.rpm

yum localinstall ctxusb-2.7.19-1.i386.rpm

yum localinstall ctxappprotection-21.4.0.2-0.x86_64.rpm

Accept the EULA.

To install a missing package

On a Red Hat based distribution (RHEL, CentOS, Fedora, and so on), if the following error message appears:

add an EPEL repository (details can be found at https://docs.fedoraproject.org/en-US/epel/).

Tarball packages

Install one of the following packages based on your OS architecture.

Package name	Contents
Tarballs (Script install for any distribution)
linuxx64-20.06.0.15.tar.gz	64-bit Intel
linuxx86-20.06.0.15.tar.gz	32-bit Intel
linuxarmhf-20.06.0.15.tar.gz	ARM HF

The difference between packages that offer support for Web Workspace app and those packages that support self-service is that the latter packages include dependencies required for self-service in addition to those needed for the Web Workspace app. Dependencies for self-service are a superset of those required for Web Workspace app, but the files installed are identical.

• If you require only workspace app for web, or your distribution does not have the necessary packages to support self-service, install only the workspace app for web package.
• Otherwise, install Citrix Workspace app from the Debian package or the RPM package. These files are easier to use because they automatically install any required packages.
• If you want to customize the installation location, install Citrix Workspace app from the tarball package.

• Do not use two different installation methods on the same machine. If you do, you might see error messages and unwanted behavior.

Install using a tarball package

The tarball package does not perform dependency checks nor install dependencies. All system dependencies must be resolved separately.

1. Open a terminal window.
2. Extract the contents of the .tar.gz file into an empty directory. For example, type: tar xvfz packagename.tar.gz .
3. Type ./setupwfc and then press Enter to run the setup program.
4. Accept the default of 1 (to install Citrix Workspace app) and press Enter.

Type the path and name of the required installation directory and then press Enter, or press Enter to install Citrix Workspace app in the default location.

The default directory for privileged (root) user installations is /opt/Citrix/ICAClient .

The default directory for non-privileged user installations is $HOME/ICAClient/platform . Platform is a system-generated identifier for the installed operating system, for example, $HOME/ICAClient/linuxx86 for the Linux/x86 platform).

If you specify a non-default location, set it in $ICAROOT in $HOME/.profile or $HOME/.bash\_profile .

If you have previously installed GStreamer, you can choose whether to integrate GStreamer with Citrix Workspace app, and thus, support HDX MediaStream Multimedia Acceleration. To integrate Citrix Workspace app with GStreamer, type y at the prompt.

On some platforms, installing the client from a tarball package can cause the system to become unresponsive after prompting you to integrate with KDE and GNOME. This issue occurs with the first-time initialization of gstreamer-0.10. If you encounter this issue, terminate the installation process (using the keys ctrl+c) and run the command gst-inspect-0.10 — gst-disable-registry-fork —version . After running the command, you can rerun the tarball package without experiencing the issue.

If you log on as a privileged user (root), choose to install USB support for Citrix Virtual Apps and Desktops published VDI applications. Type y at the prompt to install USB support.

If you are not logged on as a privileged user (root), the following warning appears:

“USB support cannot be installed by non-root users. Run the installer as root to access this install option.”

Uninstall

This procedure has been tested with the tarball package. Remove the RPM and Debian packages using your operating system’s standard tools.

The environment variable ICAROOT must be set to the installation directory of the client. The default directory for non-privileged user installations is $HOME/ICAClient/platform . The platform variable is a system-generated identifier for the installed operating system, for example, $HOME/ICAClient/linuxx86 for the Linux/x86 platform. Privileged user installation defaults to /opt/Citrix/ICAClient .

To uninstall Citrix Workspace app, you must be logged in as the same user who performed the installation.

To uninstall Citrix Workspace app on the tarball package

1. Run setup by typing $ICAROOT/setupwfc and press Enter.
2. To remove the client, type 2 and press Enter.

To uninstall Citrix Workspace app on Debian/Ubuntu Operating systems

Run the following command from the Citrix Workspace app installation folder:

apt remove icaclient apt autoremove

apt remove icaclient apt purge icaclient

To uninstall Citrix Workspace app on Fedora/RHEL/CentOS Operating systems

Run the following command from the Citrix Workspace app installation folder:

yum remove icaclient

Upgrade

To upgrade from Citrix Receiver to Citrix Workspace app, download and install the latest Citrix Workspace app from Citrix Downloads.

The Citrix Workspace screen overlay appears on the first launch of the app, when you upgrade, and when you uninstall and reinstall the app. Click Got it to continue using Citrix Workspace app, or click Learn more for more details.

Источник