Nuance Central Licensing
If you want to
use page-based licenses with your released application (where your
application is
typically a server with multiple worker boxes) you must install the
'Nuance Central
Licensing Service' on one of your customer's machines. You (and your
customers) can
use the GUI based 'Nuance Licensing Tool' to control the licensing
service either
locally or from a remote machine.
Both of these
applications are .NET programs, called NuanceLS.exe and NuanceLT.exe.
You must install
the mono package (mono-devel or mono-complete) to run them on Linux.
See
http://www.mono-project.com/download/#download-lin on how to install mono on
your customer's
distribution. (Use the CentOS information for Red Hat distributions.)
You need to
install all the files found in the '%NCLS_SERVER%' subdirectory to your
customer's
licensing server machine, in the path of your choice. The service will need
to be started
with root access rights!
You also need to
install all the files found in the '%NCLS_TOOL%' subdirectory to
one or more of
your customer's machines (usually only on the licensing server machine,
because only the
administrator will control licensing). The tool does not need root
access rights; in
fact it must not be used by root!
Configuring the
'Nuance Central Licensing Service':
Before installing
and starting NuanceLS.exe you have to specify the port on which
the service
should listen. The default value of the listening port is 18018. If
this default
value is inadequate, change it with the following command (privileged
user is
required):
sudo mono NuanceLS.exe --port=12345
Make sure that
the given port isn't used by another process and can be accessed from
other machines.
Starting 'Nuance
Central Licensing Service' manually:
A simple 'ncls'
script file is provided next to this documentation. If you want to use
it, edit the
script and replace the following parameters:
PATH
Check that
mono-service is installed to the default place as "/usr/bin/mono-service",
otherwise add its
path to the PATH variable.
APPLICATION_ROOT
The folder where
you installed the NCLS service binaries; its default in the script is
"%INSODIR_SYMLNK%/%NCLS_SERVER%",
but you may choose any
other location.
PID_FILE
The location of
the pid file. This file will be created/modified/deleted when the ncls
is
started/stopped. The default value of this parameter is
"/tmp/${APPLICATION_NAME}.lock"
Normally you do
not need to change it.
Finally make the
ncls file executable:
chmod +x ncls
You need root
rights to control the service manually:
sudo ./ncls start
sudo ./ncls status
sudo ./ncls stop
Starting 'Nuance
Central Licensing Service' automatically at boot-time:
This section
describes how to install the 'Nuance Central Licensing Service' to
start
automatically when the machine starts up.
Copy the prepared
ncls file into the /etc/init.d folder:
sudo cp ncls /etc/init.d
Change the access
right and owner of the ncls file:
sudo chmod 755 /etc/init.d/ncls
sudo chown root:root /etc/init.d/ncls
Install the init
script:
This is
distribution dependent, check it in your machine's manual. One of the
below commands
might work:
sudo update-rc.d ncls defaults
or
sudo insserv ncls
or
sudo chkconfig --add ncls
Starting 'Nuance
Licensing Tool':
A very simple
'nclt' script file is provided next to this documentation. If you want
to use it, edit
the script and replace the following parameter:
APPLICATION_ROOT
The folder where
you installed the tool's binaries; its default in the script is
"%INSODIR_SYMLNK%/%NCLS_TOOL%",
but you may choose any
other location.
Make the ncls
file executable (chmod +x nclt) and install it to your customer's bin
folder (/use/bin
or /usr/local/bin or ~/bin or the folder of your choice).