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

Download and save ftlicsrv-*.tar.gz. Unpack archives to the /opt:

    $ sudo tar -zxf ftlicsrv-*.tar.gz -C /opt

License Server daemon requires 'ftlic' system user.
Create a new system user:

    $ sudo adduser --system --group --no-create-home ftlic

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/ftlicsrv/bin/ftlicsrv-setup.sh -i

Alternatively, you can start the server manually. In some distributions of
Linux you need administrator rights for server correct functioning. You must
run it as a root:

    $ sudo /opt/ftlicsrv/sbin/ftlicsrvd

or:

    $ su -c "/opt/ftlicsrv/sbin/ftlicsrvd"

Normally, the server starts in a non-debug mode and is daemonized.
To see the list of all supported options, run:

    $ /opt/ftlicsrv/sbin/ftlicsrvd -h

The server uses a TCP port to operate (default 33033). If a firewall is used,
this TCP port should be added to it's exceptions.

=============================================================================
        License management
=============================================================================

Use command line utility for management:

    $ /opt/ftlicsrv/bin/ftlicsrvctl <command> [options]

To add a license from a text file, run:

    $ /opt/ftlicsrv/bin/ftlicsrvctl add path_to_license_key

To see the list of the licenses, run:

    $ /opt/ftlicsrv/bin/ftlicsrvctl list

To see the list of all supported commands, run:

    $ /opt/ftlicsrv/bin/ftlicsrvctl help

=============================================================================
        Getting statistics
=============================================================================

Use command line utility for getting reports:

    $ /opt/ftlicstat/bin/ftlicstatctl <command> [options] <year> [month]

In order to get verbose report for May 2024 do the following:

    $ /opt/ftlicstat/bin/ftlicstatctl report 2024 may > report.txt

Supported commands:

    ftlicstatctl report [-d|-D] YEAR [MON]
        -d - detailed report
        -D - detailed report sorted by product
        YEAR - 4 digit year
        MON - month number or name (e.g., 5 or may)
