License Server AdministrationΒΆ

To use the JCMsuite floating licensing system you have to start a central license server JCMlicenseServer on a machine reachable to all JCMsuite clients. The executable JCMlicenseServer is placed within in the license folder of your JCMsuite installation or can be downloaded here:

As a stand-alone command line tool you can copy the executable to the computer hosting the license server.

The license server itself requires a node-locked license for the computer running the server. The granted licensed instances are then distributed by the license server to the clients. Please see the command line help documentation of JCMlicenseServer for instructions on how to register the server hardware identification, to install the license and how to start and stop the server:

Note: JCMwave requires the hardware identification of the server running
      JCMlicenseServer before it can grant a floating license.
      You can create a hardware identification file using the following command:

         >> JCMlicenseServer hwid [--out <outputfile>]

      and submit this file either via email or our website to JCMwave.
      Alternatively, if the server is connected to the Internet, you can register it
      directly using your email address:

         >> JCMlicenseServer register --email <your email address>

       JCMwave will provide you with an activation key. You can use this key to download
       a license file from our website or, if the server has Internet access, use it
       directly to start JCMlicenseServer.

Usage:

  >> JCMlicenseServer start --license_file <Path to license file> --port <serverPort>
      , or
  >> JCMlicenseServer start --activation_key <key> --port <serverPort>
       (starts the license server on local machine running on the TCP/IP port <serverPort>)
  >> JCMlicenseServer stop [--wait]
       (shuts down the server running at <host:port>; waits for unfinished jobs if --wait is specified)
  >> JCMlicenseServer renew --license_file <Path to license file>
      , or
  >> JCMlicenseServer renew --activation_key <key>
       (renews the license file; specify either an activation key or a license file)
  >> JCMlicenseServer usage_summary
       (prints summary of license usage)
  >> JCMlicenseServer set_op_password
       (sets a password that allows non-admin users (operators) to free licenses
        Warning: DO NOT USE ANY OF YOUR PRIVATE PASSWORDS.)
  >> JCMlicenseServer help
        Displays this help message and exits.

The following commands can also be run from a remote client computer:
  >> JCMlicenseServer status --url <host:port>
       (prints license server status and information)
  >> JCMlicenseServer list --url <host:port> [--host <hostname>] [--user <username>]
       (lists currently checked-out licenses; if a hostname or username is specified,
       the output is restricted to matching instances)
  >> JCMlicenseServer free [--url <host:port>] [--op] --job_id <job id>
       (frees a blocked license instance. The owning process will terminate.
        When called from a remote client, the --op option is required, and the caller
        is prompted for the operator password.)

If you have created a hardware identification file please follow the instructions in Offline application to apply for a license. JCMlicenseServer runs as a service in the background. We recommend to include the JCMlicenseServer start commands within the startup scripts of your system.