Wibu Dongles: Difference between revisions

Content deleted Content added
Line 1:
=Introduction=
TUFLOW Products are licenced via Wibu Codemeter locks, available in three forms; WIBU USB-2 Dongles (Hardware lock), WIBU Software Licences (Software lock) and WIBU Cloud locks.<br>
* '''WIBU Hardware Lock''': WIBU hardware locks are physical dongles (USB-2) that contain TUFLOW licences. Licences are coded onto the dongle and can be moved between computers. WIBU hardware locks are recognised by the 2006-06-BD release onwards.
*'''WIBU Software Lock''': WIBU software locks are coded onto the computer's or server's motherboard, it cannot be transferred to a different host. WIBU software locks are recognised by the 2016-03-AF release onwards.
Line 8:
=Installation=
==Installing CodeMeter RunTime Kit==
The first step inwhen using thea Wibu licence for TUFLOW modelling is to install CodeMeter User Runtime. ThisIt needs to be installed for anyall computers that will be running TUFLOW asor wellconfigured as for thea network licence server.<br>
The latest version of CodeMeter User Runtime can be downloaded from CodeMeter site:<br>
* <u>[https://www.wibu.com/support/user/downloads-user-software.html https://www.wibu.com/support/user/downloads-user-software.html]</u>
=== Installing CodeMeter RunTime Kit for Windows ===
<br>
TheDownload correctthe filelatest to download is the '''CodeMeter Runtime Kit for Windows''' installer<br>
[[File:CodeMeter_RuntimeKit_Download_02.png|550px]]
<br>Install the software
<br>
If a computer is used as network licenselicence server, please select the "Network Server" option during the installation,. soSelecting thatthis CodeMeteroption canwill configure the appropriate TCP and UDP protocols in the Windows Firewall.<br>
[[File:CodeMeter_Network_Server_install_02.png|550px]]
<br>
<br>
Once installed the configuration depends on if the TUFLOW licence is a local, network or software licence.
* If this is the first time the licence has been used, or your existing licence has expired. You will need to update your licence file. Please progress to the <u>[[#Request_a_licence_update| Request a licence update]]</u> section
* If there is already an active licence associated with the dongle:
:* For a local licence, the dongle can now be inserted into the machine and TUFLOW simulations can be started.
:* For a network and software licence, continue to the <u>[[#Configuring_Network_Server | configure network server]]</u> and <u>[[#Configuring_Access_to_Network Licence | configure network access]]</u> sections below.
 
===Silent Install===
It is possible to do a silent install of the CodeMeter Runtime kit. CodeMeter support staff have advised that this can be done with the following parameters:<br>
Line 45 ⟶ 41:
=Updating=
There are a number of reasons that the Wibu licence may need to be updated, for example:
* To add additional moduleslicences
* To update to new support year
* To add rental licences
For each change to the dongle, it will be necessary to provide a licence update request file to the TUFLOW staff.<br> The procedure is the same for local and network licences, the request will need to be generated from the computer which has the licence container (eg. USB-2 hardware lock, software lock).
The procedure is the same for local and network licences, the request will need to be generated from the computer which has the dongle plugged in.
==Request a licence update==
The instructions for creating a licence request differ slightly depending whetheron the dongle haslicence notcontainer previouslytype beenand codedoperating for TUFLOW simulations or if the dongle has not been provided by BMTsystem. <br>
'''Hardware Licence (USB)''' <br>
* <u>[[WIBU_Licence_Update_Request | Wibu licence update request for Windows (normal)]]</u> - Unless specified otherwise by the TUFLOW staff, this option is the correct one tofor chosea USB-2 hardware lock.
* <u>[[WIBU_Licence_Update_Request_Uncoded | Wibu licence update request for Windows (uncoded or blank dongle)]]</u> - If you have been provided with a blank dongle or are using a non BMT dongle the TUFLOW producer code needs to be added when requesting the licence update.<br>
* <u>[[WIBU_Licence_for_Linux | Wibu licence update request for Linux]]</u>
Line 64 ⟶ 59:
 
==Import a licence update==
Once a licence update has been created, an update file will be provideprovided to you via email. This update file will have the extension '''.WibuCmRaU'''. TheWhen samean methodupdate is usedapplied, forthis network,modifies localthe andcontents softwareof licencesthe licence container (eg. USB-2 hardware lock, software lock), it does not need to be applied on each computer that will be used for TUFLOW modelling!<br><br>
'''Hardware Licence (USB)'''
* <u>[[WIBU_Licence_Update_Import | Importing a Wibu licence update for Windows]]</u>
* <u>[[WIBU_Licence_for_Linux | Importing a Wibu licence update request for Linux]]</u>
<br>
When an update is applied, this modifies the content of the dongle, it does not need to be applied on each computer that will be used for TUFLOW modelling!<br>
'''Software Licence (File)'''
* <u>[[WIBU_Licence_Update_Softlock_Import |Importing a Wibu licence update for Windows]]</u><br>
'''Cloud Licence'''
* <u>[[WIBU_Cloud_Licence_Import | Importing a WIBU Cloud Licence]]</u>.
<br>
 
Line 84 ⟶ 79:
==Diagnostics==
===cmDust===
When the CodeMeter runtimeRuntime kitKit is installed a diagnostics utility call '''cmDust''' is also installed. InstructionsThe forfollowing creatinglink provides instructions how to create a diagnostics file. This file may be request by <u>support@tuflow.com</u> when solutions to licensing issues are being investigated:
* <u>[[WIBU_create_cmDust | Create CM Dust Diagnostics File]]</u>
 
===Enabling Logging===
Codemeter allows you to write extended log files to youyour local drive. ToThe setupfollowing theselink featuresprovides instructions how to enable this feature:
* <u>[[Codemeter_Enable_Logging | Enable Codemeter Logging]]</u>
 
=== Enabling Network Server License Monitoring===
Codemeter allows you to conduct real-time licence network monitoring. To setupThe thesefollowing featureslink provides instructions how to enable this feature:
* <u>[[Network_Server_License_Monitoring | Network License Monitoring]]</u>