View source for WIBU Licence for Linux

For the process of requesting a Wibu-Systems Software License for a ''Windows'' licence host, please refer to  [[WIBU Licence Update Request|Wibu Software Licence Update Request]]. This article describes the process of setting up a software licence container and installing licence updates from a <i>Linux</i> command line interface, like one you would access on an SSH console. It applies to both Local and Network software licences, not cloud-based licences.

The Linux commands used on this wiki should work on most modern Linux distributions but were tested on CentOS and Debian. This article assumes you have downloaded and installed an appropriate version of the [https://www.wibu.com/support/user/user-software.html CodeMeter Runtime (download)] for your Linux host and CodeMeter is running as a service. If you are uncertain, you can run <pre>systemctl | grep codemeter</pre> and you should see both `codemeter.service` and `codemeter-webadmin.service` as `running` or `exited`. For the CodeMeter service, you can also check <pre>systemctl status codemeter.service</pre> which should report CodeMeter Server as running. By default, your CodeMeter Control Center web application would be hosted on <font color="#3366CC">http://<your hostname>:22352/</font> or <font color="#3366CC">https://<your hostname>:22353/</font> and accessible from <font color="#3366CC">http://<your hostname>:22350/</font>.

For a basic setup of CodeMeter on Linux, refer to [[Installing_Wibu_CodeMeter_Linux | Installing Wibu CodeMeter on Linux]].

Software licences are an alternative option to hardware USB dongle licences. Please select the licence host carefully as a software-based dongle will be bound to it when it is first imported. If over time you decide you want to move to another computer, we will need to re-issue you with a new software licence (which will incur a small administration fee).

== Setting up a new software licence container ==

Email <u>[mailto:sales@tuflow.com sales@tuflow.com]</u> to request a software licence. You will be sent an empty licence container file (*.WibuCmLif). 

Install the licence container file with:
<pre>cmu --import --file Universal_Firm_Code_CmActLicense_6000224.WibuCmLif</pre>
Which should result in something like:
<pre>cmu - CodeMeter Universal Support Tool.
Version 6.60a of 2018-Feb-26 (Build 2878) for Linux
Copyright (C) 2007-2018 by WIBU-SYSTEMS AG. All rights reserved.

The file contains 1 Update:
  CmActLtLicense binding information: FirmCode 6000224

Execute Update ...
The file contains 1 Update:
  CmActLtLicense update: Serial number xxx-xxxxxxxxxx, FirmCode 6000224.
   --> successful
1 successful update done</pre>

After installing the licence container file, the CodeMeter WebAdmin interface may report an error if you try to check the new container (e.g. 'Error 407: Unknown error'). This can be resolved by restarting the CodeMeter service after installing the licence container:
<pre>sudo systemctl restart codemeter.service</pre>

Make a note of the serial number displayed. You can list serial numbers of installed dongles and software licence containers with the command:
<pre>cmu --list</pre>

== Updating licences in an existing licence container ==

Once you have an existing licence container for either local or network licences, you can update it with licences by first creating a licence update request.

For hardware-based licences, on a dongle:<pre>cmu --context 101139 --serial x-xxxxxxx --file x-xxxxxxx.WibuCmRaC</pre>For software-based licences:<pre>cmu --context 6000224 --serial xxx-xxxxxxxxxx --file xxx-xxxxxxxxxx.WibuCmRaC</pre>Where "xxx-xxxxxxxxxx" / "x-xxxxxxxxxx" is the serial number of your licence container. E-mail the created licence request file (.WibuCmRaC) file to [mailto:sales@tuflow.com sales@tuflow.com].

Once your licence request is processed, you will receive a licence update file (.WibuCmRaU) in return, which you can install with
<pre>cmu --import --file <serial>.WibuCmRaU</pre>
Which should result in something like (this example for a software-based licence):
<pre>cmu - CodeMeter Universal Support Tool.
Version 6.60a of 2018-Feb-26 (Build 2878) for Linux
Copyright (C) 2007-2018 by WIBU-SYSTEMS AG. All rights reserved.

The file contains 1 Updates:
  CmActLtLicense binding information: FirmCode 6000224
  CmDongle update for 130-3796453031 (FirmCode 6000224).

Execute Update ...
The file contains 1 Updates:
  CmActLtLicense update: Serial number xxx-xxxxxxxxxx, FirmCode 6000224.
   --> successful
1 successful update done</pre>

Once your licence update has been imported, you should see your installed licences in the CodeMeter WebAdmin. If they fail to show up, restart the CodeMeter Service:
<pre>sudo systemctl restart codemeter.service</pre>
==Using the installed licenses==
If you are running a model on another machine and have installed the license on a remote license host, refer to <u>[[WIBU_Configure_Network_Server|Wibu Configure Network Server]]</u> and <u>[[WIBU_Configure_Network_Client|Wibu_Configure Network Client]]</u> to learn how to connect to it.

If the software license container is the only license container (i.e. you have no dongle installed), you can test using the installed license by simply starting a model run that requires it (i.e. some run other than a benchmark or tutorial model). 

However, if you have both a dongle and software license container installed, you can ensure TUFLOW prefers the software license by creating a license control file (.lcf) for your model, with the line: <pre>WIBU Firm Code Search Order == 6000224 101139</pre> This ensures that TUFLOW will prefer a software license container (6000224) over a dongle license container (101139) to obtain a license. You can learn more about where such a file can be placed and what the followed logic for obtaining a license is in the <u>[https://docs.tuflow.com/classic-hpc/manual/latest/ TUFLOW Manual]</u>.
<br>