How-to Softlock License Server - Command Line Options
The command line options available differ for each operating system. A brief listing for each platform is given here
.
Windows & macOS
The options for Windows and macOS follow. The most common operations when setting up a server is to first use the -a option to activate the server, then the -i option to install and run the server.
Usage: qps-license-server
-x [OPTION]... (1st form)
or: qps-license-server
-i [OPTION]... (2nd form)
or: qps-license-server
-u [OPTION]... (3rd form)
or: qps-license-server
-d [OPTION]... (4th form)
or: qps-license-server
-a [OPTION]... (5th form)
or: qps-license-server
-p [OPTION]... (6th form)
1st form: runs the floating license from commandline manually.
2nd form: installs the floating license server to be run by the system.
(Windows & Mac OS X only)
3rd form: stops & uninstalls the floating license server from the system.
(Windows & Mac OS X only)
4th form: runs the floating license server as a daemon.
(all non-Windows operating systems)
5th form: activates the floating license server on the computer. This must
be done before the floating license server can be used.
6th form: generates the XML <user /> entry with the bcrypt-hashed password
that can be used in the configuration file to allow access via the
TurboFloat Server manager.
-x Starts the floating license server from
commandline.
-pdets=FILEPATH Specify a custom location to the product
details file (TurboActivate.dat).
-config=FILEPATH Specify a custom location to the config file.
-i Installs this floating license server as a
Windows Service to run when the system boots.
-u Uninstalls this floating license server.
-h Display this help and exit.
-v Output version and activation details then exit.
-a[=PRODUCTKEY] Activates or re-activate this server.
-areq=FILEPATH Generates an "offline activation" request file.
This must be used with the "-a" option.
-aresp=FILEPATH Uses the "offline activation response" file to
activate the floating license server. This
must be used with the "-a" option.
-deact[=FILEPATH] De-activates this server so that it can be
activated on another computer. If you specify
a FILEPATH then an "offline deactivation"
request file is generated.
-p="PASSWORD" Generate an XML <user /> entry with the
bcrypt-hashed password. Must use the -user
switch as well to generate the full XML element.
And you can use the -silent switch to just
output the element and not any of the explanations.
-user="USERNAME" The username that will be output in the XML
<user /> entry.
-wf=WORK_FACTOR The work factor to use when generating the password
hash. If this is not present then an ideal work factor
is chosen (12 or higher depending on the version and
other factors). Choose a work factor between 4 and
31. All numbers outside that range will be ignored in
favor of our default work factor.
-silent Don't output to the screen.
Linux
The command line options for Linux follow. Note that unlike Windows or macOS, there is no -i option. Instead, the option to run the server from the command line, -x, and an option to run as a daemon, -d, are used instead. For testing, it can be convenient to star the server with -x to determine that the server is starting properly. To make managing the server easier, there is a-pidfile option that will write out a lock file to the specified destination. This can help automated scripts to find the correct server to start and stop it. To stop a server, just send SIGTERM to the process.
Again, the usual usage would be to use the -a option to activate a license, then the -x option to verify and test that the server is working initially,then kill the server with Ctrl-C and start itgain with the -d option for operation. Adding the command to /etc/rc.local with the -d and -pidfile options would be recommended. Usually, PID files are written to /var/run, e.g. /var/run/qimera-pro-server.pid
for the Qimera Pro server, for example. The file will contain the PID number for that server process. To stop the server, a command such as: e.g.kill `cat var/run/qimera-pro-server.pid` could be used/ An init script could also be written to start and stop the server using the usual init control scripts.
Usage: qps-license-server
-x [OPTION]... (1st form)
or: qps-license-server
-i [OPTION]... (2nd form)
or: qps-license-server
-u [OPTION]... (3rd form)
or: qps-license-server
-d [OPTION]... (4th form)
or: qps-license-server
-a [OPTION]... (5th form)
or: qps-license-server
-p [OPTION]... (6th form)
1st form: runs the floating license from commandline manually.
2nd form: installs the floating license server to be run by the system.
(Windows & Mac OS X only)
3rd form: stops & uninstalls the floating license server from the system.
(Windows & Mac OS X only)
4th form: runs the floating license server as a daemon.
(all non-Windows operating systems)
5th form: activates the floating license server on the computer. This must
be done before the floating license server can be used.
6th form: generates the XML <user /> entry with the bcrypt-hashed password
that can be used in the configuration file to allow access via the
TurboFloat Server manager.
-x Starts the floating license server from
commandline.
-d Starts the floating license server as a daemon.
-pdets=FILEPATH Specify a custom location to the product
details file (TurboActivate.dat).
-config=FILEPATH Specify a custom location to the config file.
-h Display this help and exit.
-v Output version and activation details then exit.
-a[=PRODUCTKEY] Activates or re-activate this server.
-areq=FILEPATH Generates an "offline activation" request file.
This must be used with the "-a" option.
-aresp=FILEPATH Uses the "offline activation response" file to
activate the floating license server. This
must be used with the "-a" option.
-deact[=FILEPATH] De-activates this server so that it can be
activated on another computer. If you specify
a FILEPATH then an "offline deactivation"
request file is generated.
-p="PASSWORD" Generate an XML <user /> entry with the
bcrypt-hashed password. Must use the -user
switch as well to generate the full XML element.
And you can use the -silent switch to just
output the element and not any of the explanations.
-user="USERNAME" The username that will be output in the XML
<user /> entry.
-wf=WORK_FACTOR The work factor to use when generating the password
hash. If this is not present then an ideal work factor
is chosen (12 or higher depending on the version and
other factors). Choose a work factor between 4 and
31. All numbers outside that range will be ignored in
favor of our default work factor.
-silent Don't output to the screen.
-pidfile=FILEPATH Write the process ID to a file