Skip to content

Ubuntu Packages Installation and Important Configurations

This section provides information on installing the required packages on Ubuntu Desktops. In this document, detailed steps to configure Ubuntu for both delivery aspects, i.e., single-session and multi-session (virtual apps). The mode chosen during installation determines how subsequent required dependency software is installed and should therefore be selected carefully based on the deployment needs.

In Ubuntu v4.0 releases, various software packages are used to prepare Ubuntu-based virtual desktops and apps for remote delivery to end users. The following packages are available and should be installed as per requirements and deployment:

  • Ubuntu Assistive Packages: Requires installing apps and software to enable the Ubuntu desktop to be delivered as virtual desktops or remote apps.

  • Built-in USB Redirector Package: For single-session Ubuntu deployments to enable the USB redirection module.

  • Virtual Camera Package: Accops latest integration of the Virtual Camera for single-session Ubuntu virtual desktops.

  • HyShell Package for Multi-session Delivery: Advanced desktop customization and file system configuration. Required in multi-session or shared hosted desktop mode deliveries.

Ubuntu Virtual Desktop Preparation: Single-session or Multi-session

In Single-session (VDI) mode, one user is given access to the Ubuntu virtual desktop at a time. In this section, detailed steps for installing and configuring packages for Ubuntu-based single-session desktops are provided.

Packages can be installed as per the deployment requirements in the following high-level order:

  • First to install:

    • Ubuntu Assistive Packages

  • Next: Delivery Mode Specific Packages:

  • For Single-session deployments: In no specific order after assistive packages.

    • Built-in USB Redirector Package

    • Virtual Camera Package

  • For Multi-session deployments: After assistive packages.

    • HyShell Package

Step 1: Prerequisites

Refer to the Requirements section for details.

Internet Requirement: An internet connection is required to ensure the correct installation of all software packages. Any disruption in internet access may result in an incomplete or corrupted installation, leading to functional failures.

Check and download the latest Ubuntu Assistive Packages from the Accops Support portal or website.

Step 3: Ubuntu Assistive Package Installation (Single-session/ Multi-session)

Necessary Preparation:

  • Download and copy all required packages to the home directories of the Linux desktop users.

  • 7-Zip installation (if not available in the system).

    sudo apt install p7zip-full -y

  • Extract the Package and change the directory to the extracted package:

    7z x Linux_Assistive_Package_v4.0.0.170.7z

    cd Linux_Assistive_Package_v4.0.0.170

    • It will have the following files: Install_Readme.txt, install.sh, (Directory) Linux_Assistive_Package, change_sudo_umask.sh.

  • Install the packages according to the delivery mode, using either interactive or silent installation methods.

Interactive (GUI) Installation Method

  • Run command:

    sudo ./install.sh.

  • It will prompt the administrator to choose the options for installation:

    Step Name Options Recommended Option Remarks
    Internet Enabled/ Disabled Enabled Although an option is available, the Internet is required for installation.
    Domain AD/ LDAP/ WG As per the deployment need. As per deployment requirements.
    Mode VDI/ SHD VDI or SHD VDI for single-session deployments and SHD for multi-session or virtual apps deployments.
    SSH Configurations Enabled SSH/ Disable SSH As per the requirement While SSH access can ease troubleshooting and other configuration tasks, the option can be chosen as required.
    Installation Type Full/ Essential Full Full-type installation is recommended for any production installation.
    Essential type installation targets the minimal configuration needed to enable the system for remote delivery.

  • Once confirmed, the installation will begin. The time taken may vary depending on the system and internet speed.

  • Once installation is finished, a prompt will be shown with selected deployment configurations during installation, and options to:

    • Restart or check logs. (Restart is compulsory to use the system.)

Silent (Command line) Installation Method

All of the above installations can be performed without user intervention using command-line options. Please refer to the table below to understand the options:

Step Name Description Values Remarks
Internet Internet availability 1 = Enabled
0 = Disabled		 Though an option is available, the Internet is mandatory for installation.
Domain Target environment type AD / LDAP / WG Choose based on deployment requirements.
Mode Delivery Mode selection VDI/ SHD VDI for single-session, SHD for multi-session or virtual app deployment.
SSH Configurations Enabled SSH/ Disable SSH 1 = Enable
0 = Disable		 Useful for remote access and troubleshooting; optional.
Silent Silent install 1 = Enable
0 = Disable		 If set to 0, installation runs in interactive mode despite other options.
Installation Type Install type FULL / ESSENTIAL Default is FULL; ESSENTIAL installs only core components.

  • Single-session Installation Example:

    sudo ./install.sh --internet=1 --domain=AD --mode=VDI --ssh=1 --installation_type=FULL

  • SHD Installation Example:

    sudo ./install.sh --internet=1 --domain=AD --mode=SHD --ssh=1 --installation_type=FULL

Step 4: Installation Verification

  • Verify the assistive package version:

    cat /etc/accops/assistivepkg/version.info

  • Verify the desktop agent version:

    cat /etc/accops/dvm/product.info

  • To check the delivery mode:

    cat /etc/accops/dvm/agentmode.ini

Step 5: Delivery Mode Specific Package Installation

Built-in USB Redirector and Virtual Camera Redirection in Single-session Delivery

Once the assistive packages are installed in Single-session (VDI) mode, the administrator can use this section to install Built-in USB Redirector Packages and/ or Virtual Camera.

Built-in USB Redirector Package Installation

Follow the steps below to install the Built-in USB Redirector Package on an Ubuntu Virtual Desktop with assistive packages installed in Single-session (VDI) mode.

  • Preparation:

    • Assistive packages are installed in Single-session (VDI) mode.

    • 7-Zip is already installed for package extraction.

    • The Internet is available.

    • Built-in USB Redirection package is downloaded and copied to the admin user's home directory on the Ubuntu Single-session desktop.

  • Extract the Built-in USB Redirector Package, then navigate to the extracted directory.

    7z x Eltima_Package_Ubuntu_4.0.0.4.7z.

    cd Eltima_Package_Ubuntu_4.0.0.4.

  • Run the installer to install the required packages.

    sudo ./install_eltima.sh

  • Once installation is finished, reboot the system.

Virtual Camera Package Installation

Virtual Camera enables webcam redirection inside the desktop session. Follow the steps below to install the virtual camera module on Ubuntu Virtual Desktop, having assistive packages installed in Single-session (VDI) mode.

  • Preparation:

    • Assistive packages are installed in Single-session (VDI) mode.

    • 7-Zip is already installed for package extraction.

    • The Internet is available.

    • The virtual camera package is downloaded and copied to the admin user's home directory on the Ubuntu Single-session desktop.

  • Extract the virtual camera Package, then navigate to the extracted directory.

    sudo tar -xf linux_camera_patch_ubuntu22_24.tar.

    cd linux_camera_patch_ubuntu22_24.

  • Run the installer to install the required packages.

    sudo ./install.sh --internet=1

  • Once the installation is complete, reboot the system and enable the virtual camera through the etc/accops/dvm/agentconfig.json file.

    EnableVirtualCamera: True

  • Applying Changes: After updating the configuration, restart the service: sudo systemctl restart edcdvm

HyShell Package Installation in Multi-session Delivery

Once the assistive packages are installed in Multi-session (SHD) mode, the administrator can use this section to install HyShell packages.

  • Preparation:

    • Assistive packages are installed in Multi-session (SHD) mode.

    • 7-Zip is already installed for package extraction.

    • The Internet is available.

    • The HyShell package is downloaded and copied to the admin user's home directory on the Ubuntu Multi-session desktop.

  • Extract the HyShell Package, then navigate to the extracted directory.

    7z x Hyshell_Package_4.0.0.3.7z

    cd Hyshell_Package_4.0.0.3

  • Run the installer to install the required packages.

    sudo ./install_hyshell.sh --internet=1

  • Wait for the installation to complete. Recommended to reboot the system after installation:

    sudo reboot

Note

The HyShell installation may take some time, depending on the system and internet speed.

This section covers only the installation of important modules. Enabling and configurations are covered in Ubuntu.