WIBU Configure Cloud Client

From TUFLOW FV Wiki
Jump to navigation Jump to search

Introduction

This page contains instructions for configuring a client computer to access a cloud TUFLOW 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 client computer should now be configured to access the cloud TUFLOW license. This can be checked by double clicking on the TUFLOW FV Executable (TUFLOWFV.exe) on the client computer. A DOS window should open prompting you to 'Enter input file:'. Ignore this request and hit the enter key to report the contents. Review the licence information listed (the licence types and numbers will be different to the example shown below).
    CM LAN licence check.jpg
    Note: The Licence Update Request and Import steps listed above should only be required once annually to provide access to new major releases of the software (unless licence configuration changes are requested).

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. If your web licence is a local licence, it should be installed on the computer running TUFLOW; if it is a network licence, it needs to be installed on your CodeMeter Network Server and CodeMeter on the computer running TUFLOW needs to point to that server.
    3. 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 help you 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.