Skip to content

Installing Workspace client on Linux OS

The document provides a detailed installation process for installing the Workspace Client on Ubuntu and RHEL platforms.

Supported Ubuntu OS

The Workspace client for Ubuntu x64 is compatible with the following Ubuntu distribution versions:

Ubuntu OS
Versions		 Ubuntu-24 LTS Ubuntu-22 LTS Ubuntu-20 LTS Ubuntu-18 LTS Ubuntu-16 LTS Ubuntu Boss
Ubuntu 24.04.2 LTS Ubuntu 22.04.5 LTS Ubuntu 20.04.6 LTS Ubuntu 18.04.6 LTS Ubuntu 16.04.7 LTS Boss GNU/Linux 10 (Pragya)
Ubuntu 24.04.1 LTS Ubuntu MATE 22.04.5 LTS Ubuntu 20.04.4 LTS Ubuntu 18.04.5 LTS Ubuntu 16.04.6 LTS -
Ubuntu 24.04 LTS (Noble) Ubuntu 22.04.3 LTS Ubuntu 20.04.3 LTS Ubuntu 18.04.3 LTS Ubuntu 16.04.5 LTS -
xUbuntu 24.04.2 LTS Ubuntu 22.04.2 LTS Ubuntu 20.04.2 LTS Ubuntu 18.04.2 LTS Ubuntu 16.04.3 LTS -
Ubuntu MATE 24.04.2 LTS Ubuntu 22.04.1 LTS Ubuntu 20.04.1 LTS Ubuntu 18.04.1 LTS - -

Note

  • 32-bit Workspace clients can be picked from previous releases.
  • For PCoIP: it Only Supports Ubuntu 22.04 LTS and 24.04 LTS.

First time installation (Ubuntu 64-bit)

This section of the document consists of the installation process for the Ubuntu client.

Important considerations for Ubuntu Client installation

The Ubuntu 64-bit client must only be installed on the following:

Prerequisites for Workspace Ubuntu client

  • 7zip: Workspace Clients are released in 7z format and thus requires 7zip packages pre-installed. Follow the commands below to install 7-Zip if it is not pre-installed. 

        $ sudo apt-get update.

    $ sudo apt-get install p7zip-full.

  • Internet: Workspace client requires an active internet connection to download dependencies from the internet.

Ubuntu Client Installation Process

  1. Download the Workspace Client from the Release Summary

    • Verify the MD5 sum of the download file.

    • Copy “Accops_Workspace_Client.7z” to the user’s home folder.

  2. Open a terminal and run the following commands:

    • Traverse to the user’s home directory or the location where the Workspace Client package is copied. 

      $ cd /home/<username>

    • Extract the 7-Zip package.

      $ 7z x Accops_Workspace_Client.7z

    • Move to the edcinstaller directory 

      $ cd edcinstaller

    • Start client installation 

      $ sudo ./install_edcclient.sh

  3. The installation will begin, and you will be prompted to indicate if an internet connection is required to download the necessary prerequisites.

    • If prompted, enable the Internet and click OK.

    • In the next prompt, select the installation mode as Desktop Mode and continue the installation.

      • Wait for the installation to be completed.

      • After installation is completed, a prompt will be displayed to reboot the machine.

      • Click Reboot to continue rebooting the system.

      • A shortcut for Client will appear on the desktop.

Silent Installation

Silent installation of the Accops Workspace Ubuntu client typically involves running the installer in a non-interactive mode using command-line options.

  • For silent installation, execute the installation script as usual, but append the argument quiet to the command like this:

    $ sudo ./install_edcclient.sh quiet

  • This will run the installer in quiet mode, suppressing any prompts or user interactions.

Accops OS Client Installation Process

  1. Download the Workspace client from the Release Summary

    • Verify the MD5 sum of the download file.

    • Copy “Accops_Workspace_Client.7z” to the user’s home folder.

  2. Take the SSH of Accops OS with osadmin and run the following commands:

    • Traverse to the user’s home directory or the location where the Workspace Client package is copied.

      $ cd /home/<username>

    • Extract the 7-Zip package.

      $ 7z x Accops_Workspace_Client.7z

    • Traverse to the edcinstaller directory 

      $ cd edcinstaller

    • Start client installation.

      $ sudo ./install_edcclient.sh noboot nano shell

Basic installation of Ubuntu Client

The Workspace Ubuntu Client offers two installation options: Basic and Full.

The Basic installation includes only those components required for features supported by the HySecure Gateway, excluding components for VDI/SHD and USB redirection.

In contrast, the Full installation installs every component, enabling all available features

Basic Installation

When a basic installation is performed, the following components will not be installed on the endpoints.

  • VNC Server

  • SSH Server

  • PCoIP

  • CUPS PDF Printer components

  • Eltima

  • SEP

  • Pulse Audio

Command for Basic Installation

For basic installation, execute the installation script with the argument basic.

$ ./install_edcclient.sh basic

Full Installation

Full installation installs all the components.

For full installation, execute the installation script without any arguments. 

$ ./install_edcclient.sh

Upgrade

Pushing Upgrade from Controller

Follow the steps to upgrade the clients to the latest version:

  1. Download the Upgrade file from the download location specified in the section Download Links for Latest Packages

  2. Copy the 7z Upgrade file to the following location:

    C:\Program Files (x86)\Accops\Workspace\Service\Contents\Firmware\Upgrade

  3. Update the Ubuntu upgrade info file with the following content:

    Filename= Accops_WorkspaceClient_Installer_FULL+UPGRADE.7z

    Note

    This should be the exact file name copied in the Upgrade folder.

    Version= 7111019

  4. Info file location

    For Ubuntu 64-bit client / Accops OS 64-bit: Update the info.ini file located at below location: 

    (C:\Program Files (x86)\Accops\Workspace\Service\Contents\Firmware\ EDCOS64UBU016)

  5. Save the file.

    Note

    • For Workspace v3.3-RC4+HF2 (10965) or later, modification of file changes requires the service to be restarted to refresh information from updated file content.
    • All previous versions can be updated without requiring any restarts or additional workarounds.
    • Workaround if service restart is not possible:
      • Log in to the Workspace Controller Management Console with Super-administrator privileges.
      • Go to System > Advanced Configurations.
      • Change configuration, Show Device Alert Counts on Dashboard, and save settings.
      • Again, change the configuration Show Device Alert Counts On Dashboard to its original value and update the settings.
      • This will initiate reading file contents, and information will be updated without a restart.

Steps to upgrade the client on a single device:

  1. Log in to the Workspace Controller Management Console and go to Devices.

  2. Confirm that the device to be upgraded is listed and accessible.

  3. Select the specific device to upgrade.

  4. Click the Device Settings button.

  5. Navigate to the Upgrade Settings tab within Device Settings.

  6. Enable the Auto Update Client option.

  7. Save the updated device settings.

  8. The client on the device will automatically download the update and perform the upgrade accordingly.

Steps to upgrade the client on all the Linux devices:

  1. Log in to the Workspace Controller Management Console and navigate to Devices.

  2. Ensure that all target devices are listed and reachable.

  3. Do not select any devices; instead, click on the Default Settings option.

  4. Under Default Settings, go to the Upgrade Settings tab.

  5. Check the box labelled Auto Update Client.

  6. Devices inheriting the upgrade settings from Default will automatically download and upgrade to the new client version.

Manually Upgrade by running setup

The manual upgrade process is the same as a fresh installation.

  1. Download upgrade setup files on the endpoint running a 64-bit client on 64-bit systems or any other intermediate 64-bit client.

  2. Open the Terminal and extract the 7z setup using the command (It is assumed that the system already has 7-Zip installed). 

    7z x edcclient.7z

  3. It will create the edcinstaller directory and run the install_edcclient.sh installer.

    cd edcinstaller

./install_edcclient.sh

  4. The system will automatically perform the upgrade and restart. Once completed, the new client will be installed and fully operational with Workspace.

Upgrade from HySecure Gateway (Old to Latest Workspace client)

Gateway Configuration

Client upgrades can be done using 3 methods:

  • Client upgrade through the HySecure Gateway.

  • Client upgrade through URL.

  • Client downloads through the HyLite portal.

Method 1: Workspace Client upgrade through HySecure Gateway

  1. Upload the installer file with the file name linux_release_64bit.7z to the Gateway at the publicly accessible location.

  2. In the globalsetting.js file, add or change the available Linux client version to the version number string.

    • Workspace Linux Client 64-bit
      LINUX_UPGRADE_ENABLED_64=true
LINUX_FORCE_ENABLED_64=false
LINUX_NOTIFICATION_ENABLED_64=true
LINUX_CLIENT_VERSION_64=7011078
LINUX_UPGRADE_FROM_WEBLINK_64=false
LINUX_UPGRADE_FROM_GATEWAY_64=true
LINUX_UPGRADE_WEBLINK_64=""
LINUX_CLIENT_MD5_64=9070ba305dd785e47aedb4a1454ee04f

  3. Set the Upgrade mode as ask the user or enforce.

  4. In the HySecure gateway, navigate to Client Settings > Enable HySecure Client Upgrade Notification to Users.

  5. Specify the client version in the .js file.

Steps to Download Client and Upgrade Consent in Accops Workspace

  1. Launch the Workspace Client.

  2. Connect to the HySecure Gateway and select the appropriate realm.

  3. A Client download notification consent pop-up will appear.
  4. User consent is required for the download. Click Start Download to proceed.
  5. The Client will be downloaded to the AccopsUpdater folder. Path of AccopsUpdater folder /home/< User >/AccopsUpdater.
  6. If the download fails, it may be due to a network issue, an incomplete download, or other errors. An error message with an option to download again will appear.
  7. Once the download is complete, a consent notification for the upgrade will appear when the user logs in, logs out, or relaunches the Client.
  8. Click Install to approve the upgrade. The new version of the Workspace Client will be installed.
  9. Client upgrade logs can be found in the Accopsupdater folder.
  10. When Force upgrade is enabled from the HySecure Gateway, users must provide consent for the upgrade by default before proceeding.

Method 2: Client upgrade through URL

Configuring Third-party websites

  • Upload the installer file to a designated location on the third-party website and create a downloadable URL. Ensure the download link works by testing it in a browser.

  • Ensure that the third-party website has a valid certificate(HTTPS is valid).

  • In the globalclient settings, add or change the available Linux client version to reflect the correct version number string.

  • Configure the Upgrade client hash in the globalclient settings.

  • Enable the Upgrade from the third-party website flag.

  • Set the URL in the configuration.

  • Choose the Upgrade mode, either prompt the user for confirmation or enforce the upgrade automatically.

Client downloads workflow

When the client is launched, it downloads the client settings from the gateway.

If the upgrade flag is enabled, the following checks will occur in the client settings:

  • The version and self-version will be compared. If the self-version is lower than the version specified in the client settings:

    • The system will check if the installer file is present in the AccopsUpdater folder.

    • If the installer file exists, it will verify the hash of the setup file against the default client settings.

    • If the hash matches, the upgrade process will be initiated.

    • If it does not match:

      • The system will determine whether to download from the gateway or a third-party website.

      • If downloading from the gateway, it will retrieve the client and place it in the AccopsUpdater location on the system.

      • If downloading from a third-party website, it will use the download URL specified in the client settings to obtain the client and store it in a temporary location on the system.

Upgrade workflow

  • Ensure that the ask user to upgrade flag is enabled:

    • If yes, prompt the user to confirm whether they want to proceed with the upgrade.

    • If the user agrees, execute the installer with administrator privileges.

    • If the user declines, take no action and wait till the next execution.

Method 3: Client downloads through the HyLite portal

  • Upload the new client setup file (i.e., linux_release_64bit.7z) to the gateway at the publicly accessible location and grant all permissions to the file.

  • Rename the client setup file in the loginpage.htm file located at /home/fes/public/portal/act.

Client download and installation

  • Step 1: In the HyLite portal of the HySecure gateway, locate the section labelled Download Accops Workspace Client and click on the Linux Client to download.

  • Step 2: A new setup file will be downloaded. Use this file to install the Accops Workspace Client for Linux.

Uninstall the Workspace client completely

Steps to uninstall the Workspace Full Client

  1. Copy the builds to the user’s machine and open the terminal.

  2. Extract the build command: 

    7z x Accops_Workspace_client.7z.

  3. The edcinstaller directory is created at the location where the files are extracted.

  4. Go to the edcinstaller directory and run the command 

    sudo ./run_uninstall.sh

  5. Once the uninstallation is complete, the device will automatically reboot to finalize the process.

Installing Workspace client on RHEL OS (RHEL v9.0 to 9.6)

Prerequisites

  1. The system is registered with Red Hat Subscription Manager

  2. An active internet connection is available

  3. Software Prerequisites:

    a. 7-Zip install

    b. Run lsb_release

    c. epel repository Enable

    d. Disable Wayland

    Note

    In the absence of the prerequisites, please execute the script rhel_pre_post.sh using the command:

    ./rhel_pre_post.sh pre

Installation Steps

  1. Obtain Required Files

    • Download both rhel9_pre_post.sh (setup script) and the Workspace Client archive file (e.g., workspace_client.7z) and place them in your ~/Downloads directory.

  2. Set Executable Permission for the Script

    • Launch a terminal window.

    • Change to the Downloads directory:

      cd ~/Downloads

    • Make the setup script executable:

      chmod +x rhel9_pre_post.sh

  3. Run Pre-Installation Script

    • Execute the following command to install the necessary packages and configure X11:
      ./rhel9_pre_post.sh pre

  4. Extract the Workspace Client Archive

    • Use the 7za utility to decompress the workspace client archive:

      7za x workspace_client.7z

    • Replace workspace_client.7z with the actual file name.

    • This will create a new directory named edcinstaller.

  5. Install the Workspace Client

    • Navigate into the installer directory and begin installation:

      cd edcinstaller

./install_edcclient.sh

    • Follow any installation prompts. Once the process is complete, you will be prompted to reboot.

  6. Reboot Your Computer

    • Restart the system as instructed.

  7. Launch the Workspace Client

    • Once the post-install step is done, launch the Workspace Client from your application menu or terminal. It should function as expected.

Known limitations of this release

  1. Session launch using PCoIP is not supported

  2. Kiosk mode not supported

  3. SEP not supported

  4. Upgrade from the controller is not supported

  5. Touch Screen Display

Troubleshooting

  1. Ensure all commands are run with appropriate permissions (use sudo when needed).

  2. If SELinux issues persist, verify audit2allow and semodule steps were completed without errors.

  3. If using a minimal install of RHEL, additional desktop environment packages might be required.

Support

Contact the Accops Support team at support.accops.com for any assistance or queries.

Custom conf and log path on Ubuntu OS

Step 1: Extraction of the Client Files

  • Use the following command to extract the client files: 7z x

  • Replace with the actual name of your file.

Step 2: Locating the edcinstaller Folder

  • After extraction, navigate to the edcinstaller folder. Inside, you will find a file named template.ini.

Step 3: Configuring the template.ini File

  • Open the template.ini file. It contains several tags that need to be updated:

    • conf_path

    • logs_path

    • userconf_path

Updating the Tags:

  • conf_path: Set the configuration path. For example, if you want to save configurations in /var/lib/customconf, you will write:

    conf_path= /var/lib/customconf

  • logs_path: Set the log path. For example: logs_path=/var/log/customlogs

  • userconf_path: Set the user configuration path as needed. userconf_path=/var/lib/userconf

    Important Note

    1. Do not add a trailing slash after mylogs.
    2. For logs, .edc/logs will be appended automatically in front of provided path.
    3. For userconf_path, .edc will be appended automatically in front of provided path.

Step 4: Post Updating Configuration in template.ini

  • After updating the template.ini, proceed with the installation. Your logs and other configurations will be saved based on your settings.