Installing USB Redirector for Linux

System Requirements

USB Redirector for Linux works on the following Linux distributions:

  • Debian 5 - 7
  • Fedora 5 - 21
  • Gentoo 10.1 - 12.1
  • openSUSE 10.3 - 13.2
  • Mandriva 2007 - 2011
  • RedHat 5 - 7
  • Ubuntu 6.06 - 14.10
  • others, which meet the following requirements:
    • kernel version from 2.6.15 to 3.19
    • udev subsystem
    • read-write file system (not read only)
    • kernel source code or kernel headers are required for installation

Supported architectures:

  • x86
  • x86_64(amd64)
  • arm
  • mips


Installation

Before installing USB Redirector for Linux, you must download and extract the installation package which corresponds to your system and CPU.

To install USB Redirector for Linux in USB server mode on your computer:

sudo ./installer.sh install-server


To install USB Redirector for Linux in USB client mode on your computer:

sudo ./installer.sh install-client


To install USB Redirector for Linux in both USB server and USB client modes on your computer:

sudo ./installer.sh install


USB Redirector for Linux Installation Troubleshooter

If you've got an error during driver compilation while installing USB Redirector for Linux, please follow these instructions to compile the driver manually.

Some USB Redirector components are operating in kernel mode. So, you need to compile a special driver to install our software product. Source code of this driver is in usb-redirector-linux.tar.gz/usb-redirector-linux/modules/src/tusbd/ directory

To compile USB Redirector for Linux kernel module, we recommend to use a FULL kernel source code! If you have only kernel header files, please check the presence of the following files:

linux-source-directory/drivers/usb/core/hcd.h

linux-source-directory/drivers/usb/core/hub.h

If there are no such files, please copy them from source code package of your kernel version.


By default, Makefile is searching for kernel source codes in /usr/src/linux directory to compile the driver. If your kernel is in the other directory, you have to specify the path manually:

make KERNELDIR=/usr/src/kernel-source-2.6.17.5


After successful driver compilation there will be tusbd.ko file in the /modules/src/tusbd/ directory. This file is necessary for USB Server operation.

Now you can start installation script again to continue product's installation!

USB Redirector for Linux Startup Troubleshooter

If you get the following error during tusbd driver compilation:

ERROR: "Kernel configuration is invalid.
include/linux/autoconf.h or include/config/auto.conf are missing."


In this case you need to configure and compile your kernel and then retry the driver compilation.


cd /usr/src/linux
make config (make oldconfig or make menuconfig)
make prepare
make modules


If you get the following error:

insmod: error inserting '/usr/local/usb-server/bin/tusbd.ko': -1
Invalid module format


that means your kernel version is not corresponding with the kernel version used during driver compilation. Please verify the version of kernel uname -r and source code kernel version.

Notification for Linux kernels 2.6.25 through 2.6.28.8:


Kernels versions 2.6.25 through 2.6.28.8 have a bug in USB EHCI controller driver that leads to large memory leaks with isochronous devices like webcams or audio devices.

If you have patched your kernel against this bug - please manually recompile the driver executing 'make USE_EHCI_FIX=n' command. Otherwise USB Redirector will try to automatically workaround this bug (without guaranties).

See http://patchwork.kernel.org/patch/13428/ for more information.

Please do not worry about this warning if you are not going to use USB 2.0 isochronous devices on your system.


Uninstallation

To uninstall USB Redirector for Linux, please run uninstall.sh script. It is located in the directory where USB Redirector was installed. By default, it is located in /usr/local/usb-redirector directory.

cd /usr/local/usb-redirector
sudo ./uninstall.sh uninstall


Uninstaller script will remove all installed components of USB Redirector from your computer.

Automatic Startup of USB Redirector at Boot

Normally, installer will setup USB Redirector daemon for autostart during installation process. If it was not able to do this, please use rc.usbsrvd script that is installed in /etc/rc.d (or /etc/init.d) directory to start USB Redirector automatically.


Home | Products | Downloads | Purchase | Support | About | Contacts Us