=============================================================================
        Installation and first run
=============================================================================

Download and save ftusbnet-*.tar.gz.
Unpack archive to the /opt:

  tar -zxf ftusbnet-*.tar.gz -C /opt

To run the automated setup script your OS should have systemd, which most
modern Linux distributions include. Run the setup script with -i or --install
option and it will do the rest:

  $ sudo /opt/ftusbnet/bin/ftusbnet-setup.sh -i

Alternatively, you can start the daemon manually. You must run it as a root:

  $ sudo /opt/ftusbnet/sbin/ftusbnetd -d

or:

  $ su -c "/opt/ftusbnet/sbin/ftusbnetd -d"

To see the list of all supported options, run:

  $ /opt/ftusbnet/sbin/ftusbnetd -h

Daemon settings initialization can be done with a configuration file. Further 
daemon management can be done via the graphical user interface application or 
command line utility.

=============================================================================
        Graphical User Interface Application
=============================================================================

GTK 3 is required.

If the program was installed using the setup script, you can launch it in
the usual way. Just click on USB over Network Server in your applications
menu.

Alternatively, to launch the application from the terminal, run:

  $ /opt/ftusbnet/bin/ftusbnetgui

=============================================================================
        Command Line Utility
=============================================================================

Run the command line utility:

  $ /opt/ftusbnet/bin/ftusbnetctl <command> [options]

To see the list of all supported commands, run:

  $ /opt/ftusbnet/bin/ftusbnetctl help

To see the list of the devices available:

  $ /opt/ftusbnet/bin/ftusbnetctl list 
  ID         VID: PID: REV           Location  Device name and status 
  107        07d1:3c03:0001               1-2  802.11 bg WLAN /Shared/ 
  202        046d:c045:2730               2-1  USB Optical Mouse /Unshared/

Here the columns are:

  ID - unique device identifier 
  VID:PID:REV - device hardware identifier (vendor ID, product ID, revision)
	Location - USB device topology (can be "unknown" if your system cannot report
             the device topology)
	Device name and status  - displays the name of the device and its current
	           status (shared/unshared/connected)

You can share the device by its unique ID (an example below shows how to share
USB Optical Mouse from the list above):

  $ /opt/ftusbnet/bin/ftusbnetctl share 202

NOTE: Sharing by the device ID allows you to share separately one of the
devices that have identical VID:PID:REV.

To unshare the device use "unshare" command with the same syntax as "share":

  $ /opt/ftusbnet/bin/ftusbnetctl unshare 202


=============================================================================
        Configuration File
=============================================================================

See the configuration file usage details in the default configuration file
"ftusbnet.conf" that is included in the product package.

To import settings from configuration file, start daemon with '-i' option:

  $ sudo /opt/ftusbnet/sbin/ftusbnetd -i ftusbnet.conf

Alternatively, to reinitialize daemon, you can use command line utility:

  $ sudo /opt/ftusbnet/bin/ftusbnetctl import ftusbnet.conf

To export current daemon settings to configuration file:

  $ /opt/ftusbnet/bin/ftusbnetctl export ftusbnet.conf

=============================================================================
        Converting Trial to Full Version
=============================================================================

By default "ftusbnetd" daemon searches for the license key in the following
file "/etc/ftusbnet.key". You should create this file and paste your license
key in it (including the "BEGIN" and "END" lines). Alternatively, you can
specify a custom location of the license key file with the help of '-k'
option:

  $ sudo /opt/ftusbnet/sbin/ftusbnetd -k license.key.file

We can also provide our corporate customers with the License Server, which
allows to add, remove and administrate license keys for FabulaTech products
and allows to use the Floating Licensing model.

To connect to the License Server, start daemon with the -l option:

  $ sudo /opt/ftusbnet/sbin/ftusbnetd -l SERVER
or
  $ sudo /opt/ftusbnet/sbin/ftusbnetd -l SERVER:TCP_PORT

Here:
  SERVER - License Server IP or network name;
  TCP_PORT - TCP port, optional. Default port is 33033.
