Skip to main content

Installing the ScrewDrivers Scanning Client for Linux

The ScrewDrivers Scanning Client for Linux automatically redirects your local SANE scanners into remote desktop sessions, letting you scan documents from within Citrix Workspace, FreeRDP, or IGEL environments.

Before you begin, make sure your remote desktop server has either ScrewDrivers Essentials or ScrewDrivers Enterprise installed and configured to allow local scanner mapping.

Installation​

Start by installing the remote desktop client you'll be using:

Citrix Workspace: Follow the Citrix installation guide for your Linux distribution.

FreeRDP: Install via your package manager:

$ sudo apt-get install freerdp2-x11

Once your remote desktop client is ready, download and install the ScrewDrivers Scanning Client:

  1. Download the latest ScrewDrivers Scanning Client install script from https://www.tricerat.com/client-downloads
  2. Extract and run the installation script:
$ tar -zxvf ScrewDriversScanningEndpoint_7.3.0.20560_Linux.tar.gz
$ cd ScrewDriversScanningEndpoint_7.3.0.20560_Linux
# Run ./install.sh -h for detailed usage, or to install all plugins:
$ ./install.sh -i citrix freerdp igel

Launching the Client​

The launch procedure depends on which remote desktop client you're using:

Citrix Workspace: The install script automatically configures Citrix to load the ScrewDrivers scanning plugin by adding entries to /etc/icaclient/nls/en/module.ini. Just launch Citrix normally—the plugin loads automatically.

FreeRDP: Launch FreeRDP with the /dvc:vt2freerdp argument to enable the ScrewDrivers scanning plugin:

$ freerdp /v:termserv.mycompany.com /u:myusername /dvc:vt2freerdp

Troubleshooting​

Verifying Scanner Detection​

If a scanner you've connected doesn't appear in your remote session, first verify that SANE recognizes it on the Linux client. Run this command to display all connected scanning devices:

$ scanimage -L

Testing with Xsane​

If you're having trouble scanning, the Xsane application can help you determine whether the problem is with SANE, the scanner itself, or the ScrewDrivers integration.

  1. Install Xsane:
$ sudo apt-get install xsane
  1. Launch Xsane:
$ xsane
  1. Adjust the scanner options for the type of image you want to produce and click "Scan."

If scanning works in Xsane but not in your remote session, contact Tricerat Support for assistance.

Enabling Logging​

If Tricerat Support asks you to enable logging for troubleshooting, you'll find the configuration file at /etc/opt/tricerat/vt2client.conf. Open it and change the log: enable setting to true:

[log]
enable=true

Once you've enabled logging, the client will write detailed diagnostic information to /var/log/tricerat.