Installing USB Redirector for Linux
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 - 18.10
- others, which meet the following requirements:
- kernel version from 2.6.26 to 4.17
- udev subsystem
- read-write file system (not read only)
- kernel source code or kernel headers are required for 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:
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:
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.
make config (make oldconfig or make menuconfig)
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 22.214.171.124:
Kernels versions 2.6.25 through 126.96.36.199 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.
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.
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.