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).