Installing the ScrewDrivers® Scanning Endpoint Client for Linux

The ScrewDrivers® Scanning Endpoint Client for Linux automatically maps your local SANE Scanner into the remote desktop session (via the Citrix Workspace, FreeRDP, or Igel client)

The remote desktop must have either ScrewDrivers Essentials or ScrewDrivers Enterprise installed and configured to allow local scanner mapping.

Installation

1. Install the appropriate remote desktop client for your environment

   • Citrix: Install, Uninstall, and Upgrade (citrix.com)

   • FreeRDP:

     $ sudo apt-get install freerdp2-x11

2. Download the latest ScrewDrivers Client install script from Tricerat | ScrewDrivers | Client Downloads

3. Run the 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

• Citrix
  Our install script places entries in Citrix's /etc/icaclient/nls/en/module.ini file so that it automatically loads our client plugin on launch.

• FreeRDP
  Launch the FreeRDP client with /dvc:vt2freerdp as an argument:

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

Troubleshooting

If a scanner you believe is connected to the client does not appear on the server, you can verify the scanner is recognized by SANE by running the following command on the client, which will display a list of all connected devices:

If you run into issues performing scanning, the Xsane application can be used to troubleshoot.

1. Install the application using the command:

   $ sudo apt-get install xsane

2. Launch the xsane application using the command:

   $ xsane

3. Adjust the scanner options relative to the type of image you are trying to produce and select the "Scan" button.

If you run into additional problems, please contact Tricerat Support for assistance.

Logging

If you are instructed by Tricerat Support to turn on ScrewDrivers Client logging, you can find the configuration in /etc/opt/tricerat/vt2client.conf. Open the file and change the log: enable setting to true:

Logs are stored in var/log/tricerat