WIBU Cloud Licence Import

From Tuflow
Revision as of 13:00, 2 December 2024 by Chris Huxley (talk | contribs) (→‎Troubleshooting)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Introduction

This page contains instructions for configuring a computer to access a TUFLOW cloud licence. This requires that you have:

Method

  1. Open the CodeMeter Control Center via the start menu:
    CodeMeter Start.png

  2. Drag and drop the provided *.wbc cloud license file from TUFLOW Sales onto the Codemeter Control Centre as shown in the below video:


  3. The machine should now be configured to access the cloud TUFLOW license.
    • If this is a Cloud Direct licence, the connection can be checked by double clicking on a TUFLOW executable on the machine.
    • If this is Cloud Server licence, further configuration is required. See:

Troubleshooting

  • My web licence is not picked up by TUFLOW
    1. After installing the licence as shown in the recording above, ensure that the 'Status' is 'Connected' and that there are no error messages reported.
    2. Ensure your licence was added successfully to CodeMeter on the computer you added the licence on:
      • You can check this in a web browser by visiting http://localhost:22352/container.html on that computer, which should show your licence number with 'CmCloud'.
      • You can also check from the command line, by running:
        • Powershell: `& 'C:\Program Files\CodeMeter\Runtime\bin\cmu.exe' --list-content`
        • Command Prompt: `"C:\Program Files\CodeMeter\Runtime\bin\cmu.exe" --list-content`
        • Linux shell: `cmu --list-content`
        And a CmContainer should be listed with 'Box Status' of '0x400000 CmCloud'.
      • Or you can generate a `CmDust-Result.log` file by starting the CmDust utility that is installed along with the CodeMeter Runtime. If you decide to contact TUFLOW Support with your web licence issue, it will help us if you generate and include this file.
  • After adding the licence to CodeMeter, the 'Status' is 'Disconnected' and on the 'Events' tab I see error messages that read
    "Error code 60: SSL certificate problem: self-signed certificate in certificate chain." CodeMeter web licences are secured with a certificate from Wibu, the supplier of Codemeter. Their certificate is not self-signed but signed by GlobalSign. This is a common certificate authority (CA), and as a root CA, their certificate is 'self-signed', which is what the error message is referring to.
    This error occurs when your computer that has the web licence installed cannot check the validity of this certificate. There are several reasons this can happen:
    • The computer itself may be unable to reach wibu.cloud
    • A computer elsewhere in your infrastructure, part of a proxy provider service for example, may be unable to reach wibu.cloud
  • Whatever the cause of a 'Status' of 'Disconnected' in the CodeMeter License Central, you will likely need your IT staff to ensure that the relevant computers can resolve the `wibu.cloud` name and are allowed to access the address, so that they can retrieve and validate the certificate.
    Check the following:
    • Firewall settings on the machine that has CodeMeter and the licence installed; CodeMeter needs to access wibu.cloud over https and does so over port 443.
    • DNS issues: CodeMeter needs to resolve `wibu.cloud` into an IP number (e.g. ` 213.221.108.10`), and security software or network proxy services your organisation uses may prevent that from happening.
    • Routing issues: CodeMeter needs to contact the computer at the resolved IP number over the internet, and security software or network proxy services your organisation uses may prevent that from happening.
    • Routing issues with SSL verification: CodeMeter will try to check the https SSL certificate with the CA, and security software or network proxy services your organisation uses may prevent that from happening.
  • To verify basic access, on the computer where you have installed the licence, use any type of web client like a normal browser to visit https://wibu.cloud/59492. You should see an error message reporting an ‘HTTP Error 405’ or something very similar, depending on your browser. The 405 error is an indication that the server is up and reachable, but the HTTP method used in the request is not supported for the requested resource - in this case, the specific error message serves to show that things are working as expected.
  • If your cloud licence is a TUFLOW Network Cloud Server licence (instead of a TUFLOW Network Cloud Direct licence), you will need to make sure the server can be reached from computer running TUFLOW. See WIBU Network Troubleshooting for Windows, or if your server is running Linux, see Installing Wibu CodeMeter Linux


Up
Go-up.png Return to WIBU Licensing Main Page