Updating a license on a license server without an Internet connection

In certain situations, for example in secured data centers, the license server on which the license container is operated has no direct Internet access.

Tip: If the license container is a USB dongle, we recommend that you temporarily plug it into a computer with an Internet connection. Then, on the computer with the Internet connection, proceed as described on the following linked page (Updating a license on a license server). After a successful update on a computer with an Internet connection, reconnect the USB dongle to the license server without Internet access.

Only if this procedure is not possible, you will need to update the license file-based and proceed with the following steps.

Prerequisites for the file-based license update

  • A current version of the CodeMeter Runtime Kit software is installed on the license server (Setting up a license server).
  • A current version of the PTV License Manager (Server) tool is installed on the license server.
  • You have access rights to the license server. This can also be done via a remote desktop connection.
  • You have access to another computer that has an Internet connection to communicate with the PTV server.
  • A PTV Vision product or the PTV License Manager (Standard) tool is installed on the computer with the Internet connection.

Short overview of file-based license update

The following diagram shows a concise overview of the file-based license update process, categorized by a license server without Internet access (red) and a computer with Internet connection (blue).

A detailed description is given in the following sections:

Creating a license request file

1.  Open the PTV License Manager tool on the license server.

2.  Click the Edit CodeMeter settings  symbol.

The CodeMeter settings window opens.

3.  In the License Container section, select the container where you want to update the license.

4.  Click the Generate license request/receipt (file-based) symbol.

The Browse For Folder window opens.

5.  Save the generated license request file ...RaC on the license server, and then transfer the file to the computer with an Internet connection (e.g., via email or storage device).

Tip:  

You can alternatively create the license request file ...RaC by using the command line.

To do this, open the CodeMeter Command Prompt app and enter the following command line parameters. Here XXXXXXXX stands for the serial number of the soft container and the f marks the beginning of the name of the license request file to be generated.

Under Windows

  • For a soft container license: cmu32 --serial 130-XXXXXXXX -c6000459 -f130-XXXXXXXX.WibuCmRaC
  • For a USB dongle license: cmu32 --serial 3-XXXXXXXXXX -c100321 -f3-XXXXXXXXXX.WibuCmRaC
  • For a USB dongle license with borrowing function: cmu32 --serial 3-XXXXXXXXXX -c6000459 -f130-XXXXXXXX.WibuCmRaC

Under Linux

  • For a soft container license: cmu --serial 130-XXXXXXXX -c6000459 -f130-XXXXXXXX.WibuCmRaC
  • For a USB dongle license: cmu --serial 3-XXXXXXXXXX -c100321 -f3-XXXXXXXXXX.WibuCmRaC
  • For a USB dongle license with borrowing function: cmu --serial 3-XXXXXXXXXX -c6000459 -f130-XXXXXXXX.WibuCmRaC
Uploading the license request file

In this section, you save the license request file on the computer with Internet access. The file is then transferred to the PTV server in the background, which subsequently returns the license activation file.

6.  On the computer with the Internet connection, open the License Management window (Opening the license management in the product) or (Managing licenses with the PTV License Manager).

7.  In the license list, select the desired license you want to update.

b) Alternatively, if the desired license is not visible, ensure that no license is selected in the list, and then copy the license key for the update to the Clipboard. To deselect a license, hold down the Ctrl key while you click on the selection. The following steps describe this procedure.

8.  Click the  Update license symbol.

The License update window for the product opens and the license key is displayed.

9.  Click the Next button.

10.  If necessary, enter the serial number of the license container you selected in step 3 into the Serial Number window and click OK.

Note: You can find the serial number in the License Management window under Licenses in the Serial Number (Container) column.

11.  If necessary, select the option On a different computer (file-based) and click Next.

The Step 1 of 2: Upload license request window opens.

12.  In the Step 1 of 2: Upload license request window, click the Select button.

13.  Navigate to the saved license request file ...RAC and click the Open button.

14.  Click the Next button.

The Step 2 of 2: Transfer license window opens. In the background, the license request file is transferred to the PTV server, which then returns the license activation file.

Transferring the license activation file from the computer with Internet access to the license server

15.  On the computer with the Internet connection, in the Step 2 of 2: Transfer License window, click the Open folder button.

16.  Copy the license activation file ...RaU and transfer it to the license server (e.g., via email or storage device).

17.  Go to the CodeMeter settings window on the license server and click the Import license update (file-based) symbol.

18.  Navigate to the license activation file ...RaU and click the Open button.

Tip:  

You can alternatively import the license activation file ...RaU by using the command line.

To do this, open the CodeMeter Command Prompt app and enter the following command line parameters.

Under Windows

  • For a soft container license: cmu32 -i -f130-XXXXXXXXXX.WibuCmRaU
  • For a USB dongle license: cmu32 -i -f3-XXXXXXXXXX.WibuCmRaU

Under Linux

  • For a soft container license: cmu -i -f130-XXXXXXXXXX.WibuCmRaU
  • For a USB dongle license: cmu -i -f3-XXXXXXXXXX.WibuCmRaU
Generating and transferring the receipt file on the license server

Create a receipt file to finalize the update process.

19.  In the CodeMeter settings window on the license server, within the License containers section, select the correct license container.

20.  Click the Generate license request/receipt (file-based) symbol.

21.  Save the receipt file ...RaC.

22.  Transfer the receipt file ...RaC from the license server to the computer with an Internet connection (e.g., via email or storage medium) and replace the license request file ...RaC there.

23.  On the computer with the Internet connection, click the Finish button in the Step 2 of 2: Transfer License window.

The license of your choice is updated on the license server.