Installing USB Redirector for Linux

System Requirements:

USB Redirector for Linux works on the following Linux distributions:

  • Debian 5 - 6
  • Fedora 5 - 13
  • Gentoo 10.1
  • openSUSE 10.3 - 11.3
  • Mandriva 2007 - 2010
  • RedHat 5
  • Ubuntu 6.06 - 10.10
  • others, which meet the following requirements:
    • Kernel should be of v.2.6.15 to 2.6.35
    • 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, you must download an installation package which corresponds to your system and CPU and extract it.

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

./installer.sh install-server



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

./installer.sh install-client



To install USB Redirector for Linux in both USB Server and USB Client mode on your computer:

./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 a 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.tar.gz/usb-redirector/modules/src/tusbd/ directory

To compile USB Server & USB Client for Linux 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 with EHCI USB controllers that leads to large memory leaks with isochronous devices like Webcams or Sound cards.

If you have patched your kernel against this bug - please manually recompile the driver executing 'make USE_EHCI_FIX=n' command. Otherwise USB Server 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.


USB Redirector uninstallation:

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

./uninstall.sh uninstall


Installation script will remove all installed components of USB Server from your computer.

Automatic start 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 directory to start USB Redirector automatically.


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