Difference between revisions of "WIBU Configure Cloud Client"
Jump to navigation
Jump to search
(→Method) |
Chris Huxley (talk | contribs) |
||
| (30 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
=Introduction= | =Introduction= | ||
| − | This page contains instructions for configuring a | + | This page contains instructions for configuring a computer to access a TUFLOW cloud licence. This requires that you have: |
| − | * CodeMeter Runtime kit installed on the client machine, see [[Wibu_Dongles | + | * CodeMeter Runtime kit installed on the client machine, see <u>[[Wibu_Dongles| Install Licencing Dongle Drivers (CodeMeter RunTime Kit)]]</u> on your computer. |
| − | * | + | * Have been provided with a cloud license file. It will have a '.wbc' file extension. If you do not have this file, please contact [mailto:sales@tuflow.com sales@tuflow.com].<br> |
=Method= | =Method= | ||
| Line 9: | Line 9: | ||
[[File:CodeMeter_Start.png]]<br> | [[File:CodeMeter_Start.png]]<br> | ||
<br> | <br> | ||
| − | < | + | <li>Drag and drop the provided *.wbc cloud license file from TUFLOW Sales onto the Codemeter Control Centre as shown in the below video: |
| − | + | {{Video|name=Cloud_License_Update.mp4|width=1000}} | |
| − | {{Video|name= | ||
<br> | <br> | ||
| − | <li> | + | |
| + | <li>The client machine should now be configured to access the cloud TUFLOW license. This can be checked by double clicking on a TUFLOW executable on the client machine. | ||
| + | |||
| + | </ol> | ||
| + | |||
| + | =Troubleshooting= | ||
| + | <ul> | ||
| + | <li>My web licence is not picked up by TUFLOW | ||
| + | <ol> | ||
| + | <li>After installing the licence as shown in the recording above, ensure that the 'Status' is 'Connected' and that there are no error messages reported.</li> | ||
| + | <li>Ensure your licence was added successfully to CodeMeter on the computer you added the licence on: | ||
| + | <ul> | ||
| + | <li>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'.</li> | ||
| + | <li>You can also check from the command line, by running: | ||
| + | <ul> | ||
| + | <li>Powershell: `& 'C:\Program Files\CodeMeter\Runtime\bin\cmu.exe' --list-content`</li> | ||
| + | <li>Command Prompt: `"C:\Program Files\CodeMeter\Runtime\bin\cmu.exe" --list-content`</li> | ||
| + | <li>Linux shell: `cmu --list-content`</li> | ||
| + | </ul> | ||
| + | And a CmContainer should be listed with 'Box Status' of '0x400000 CmCloud'.</li> | ||
| + | <li>Or you can generate a `CmDust-Result.log` file by starting the CmDust utility that is installed along with the CodeMeter Runtime. <b>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</b>.</li> | ||
| + | </ul> | ||
| + | </li> | ||
| + | </ol> | ||
| + | </li> | ||
| + | <li>After adding the licence to CodeMeter, the 'Status' is 'Disconnected' and on the 'Events' tab I see error messages that read<br/>"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. <br> | ||
| + | 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:<ul> | ||
| + | <li>The computer itself may be unable to reach wibu.cloud</li> | ||
| + | <li>A computer elsewhere in your infrastructure, part of a proxy provider service for example, may be unable to reach wibu.cloud</li> | ||
| + | </ul> | ||
| + | <li>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. <br> | ||
| + | Check the following:<ul> | ||
| + | <li>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. </li> | ||
| + | <li>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. </li> | ||
| + | <li>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. </li> | ||
| + | <li>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. </li> | ||
| + | </ul> | ||
| + | <li>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.</li> | ||
| + | </ul> | ||
<br> | <br> | ||
| − | [[ | + | {{Tips Navigation |
| − | + | |uplink=[[Wibu_Dongles| Return to WIBU Licensing Main Page]] | |
| − | + | }} | |
| − | |||
| − | |||
Latest revision as of 20:03, 20 November 2024
Introduction
This page contains instructions for configuring a computer to access a TUFLOW cloud licence. This requires that you have:
- CodeMeter Runtime kit installed on the client machine, see Install Licencing Dongle Drivers (CodeMeter RunTime Kit) on your computer.
- Have been provided with a cloud license file. It will have a '.wbc' file extension. If you do not have this file, please contact sales@tuflow.com.
Method
- Open the CodeMeter Control Center via the start menu:
- Drag and drop the provided *.wbc cloud license file from TUFLOW Sales onto the Codemeter Control Centre as shown in the below video:
- The client machine should now be configured to access the cloud TUFLOW license. This can be checked by double clicking on a TUFLOW executable on the client machine.
Troubleshooting
- My web licence is not picked up by TUFLOW
- After installing the licence as shown in the recording above, ensure that the 'Status' is 'Connected' and that there are no error messages reported.
- 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`
- 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.
| Up |
|---|
 Return to WIBU Licensing Main Page
|