Extracting Native Apps And Server Offline Licenses

This scenario is useful for mobility reasons when you are traveling for business purposes.

In this scenario, you will extract assigned native app offline licenses for use either when connected to a remote 3DEXPERIENCE platform from outside your office premises, or completely unconnected (the native app and 3DEXPERIENCE platform are installed on your laptop).

Note: You will not be allowed to extract casual named user licenses.

  1. Select the Start > All Programs > Dassault Systemes 3DEXPERIENCE R2021x > Tools > Local Key Management command.

    The Local License Key Management tool appears:

  2. Select the command Offline Named User > Logon to 3DEXPERIENCE Platform.

    You must log onto the3DEXPERIENCE platform before extracting offline licenses.

    The following message appears:

    Once the logon process has started, if you are unable to
provide a correct logon, the application will close. Do you want to continue?

  3. Click Yes to continue.
    First, a dialog box appears allowing you to choose the platform from which to extract the licenses. Select the platform, then click OK. A dialog box then appears allowing you to log in to the 3DEXPERIENCE platform.
  4. Enter your username and password, then select the 3DEXPERIENCE platform:



    then click Login.

    For the moment, you have not yet extracted any offline licenses. Note that the Local Key Management tool is divided into two panes. The upper pane will display your locally extracted offline licenses once you have extracted them.

    The contents of the lower pane depend on whether you are connected to the 3DEXPERIENCE platform or not:

    • when you are connected to the 3DEXPERIENCE platform, the lower pane displays only concurrent user licenses (and not named user licenses) available for extraction, for example:



    • when you are not connected to the 3DEXPERIENCE platform (as shown in the dialog box illustrated in step 1 in this scenario), the lower pane displays only concurrent licenses corresponding to all installed roles declared on the servers referenced on your license client (in the DSLicSrv.txt file).

      A separate line is displayed for each server when a keyword is set (a lock is present), and a single line is displayed for all servers when no keyword is set.

      For example, let's assume there are four logical license servers (either standalone or failover) and that the same feature is enrolled on all four servers. Let's also assume that on two of the four servers, an offline authorization rule with a keyword has been set for extraction of the given feature, whereas on the other two servers, no offline authorization rule has been set for extraction of the given feature.

      In this case, the tool will display three lines for offline extraction of the feature:

      • two lines, each with a lock
      • one line without a lock

      The license server name is also displayed in the Server column for the lines having a lock, but not for the line without lock.

      In the following example, the tool is connected to several license servers containing the same licensed features (M3D and MDG):

      Two M3D licenses are available via two different license servers: a lock is displayed for the same feature on each server since an authorization rule for different extraction durations has been set. The same applies to the MDG feature.

    The maximum extraction duration set on the license server is displayed, and the Restricted column displays a padlock when a keyword is set on the license server. The Description column displays the English name of the license feature. For add-ons, only the base name is displayed. If the product is not installed, its description is not provided.

    If you wish to extract licenses, you must select them in the lower pane, right-click then select the Extract command.

    If a given license feature is protected by a keyword on one license server and not protected by a keyword on another license server, the Local Key Management tool prompts you to enter the keyword.

    If a given license feature is protected by a keyword on one license server and protected by another keyword on another license server, the Local Key Management tool prompts you to enter the keyword. The license will be extracted from the license server which validates the correctly entered keyword.

    When the Local Key Management tool extracts assigned licenses (when connected to the 3DEXPERIENCE platform), the appropriate keyword must be entered for each license requiring a keyword. So users may be prompted to enter several keywords.

    When attempting to extract a license governed by an authorization rule, a popup prompts you to specify the keyword:

    Note: The tool will in all cases prevent you from extracting licenses which are not assigned to you.

  5. If you want to extract only native app licenses assigned to you, select the command Offline Named User > Extract Native App Assigned Licenses.
    The following message appears:
    Are you sure you want to extract all rich client licenses 
assigned to this logon?

    Click Yes.

    The license duration slider appears.

    The license can be extracted. This is because this is the only native app license assigned to this specific username.

  6. Set the license extraction duration (for example, 3 days) using the slider, then click OK.

    If you succeeded in extracting the offline license, the following message will be displayed:

    XXX license successfully extracted

    Click OK again.

    The extracted licenses appear in the upper pane

    To extend the extraction period, right-click the license, select the Extend command, and set the period as desired. You can only extend the license on the same license server from which it was extracted.

    Once the license has been extracted, it is no longer available on the license server, and is identified as Offline in the Detailed License Usage dialog box on the license server.

    The license can be used locally for the duration specified when it was extracted. Once that duration has expired, the license will no longer be available locally and is recovered on the license server.

    Information about license expiry dates and the remaining validity duration is available using a color code:

    • green means more than 7 days before expiration
    • yellow means less than 7 days before expiration
    • red means already expired
    • gray means invalid.

    Details are displayed in the status bar.

    Note: If the license file is removed, moved or renamed on the disk, the licenses will have a gray status in the upper pane. If so, the offline license cannot be restituted before the end of the extraction period.

  7. Disconnect the laptop from the network, then use the licenses away from the office by connecting to a 3DEXPERIENCE platform.

    Only the named user specified in the Named User column can now use the licenses. If this column is empty, this means the extracted license is not named user but concurrent user.

  8. To restitute the license before the expiry date, reconnect the laptop to the network, then make sure that it is still correctly configured and points to the machine running the license server from which you extracted the license, displayed in the Server column.

    To restitute the license, right-click the license and select the Restitute command.

  9. Select the Start > All Programs > Dassault Systemes 3DEXPERIENCE R2021x > Tools > Local Key Management command, then select the command Offline Named User > Logon to 3DEXPERIENCE platformand log on again.

    The license you extracted is listed.

  10. Select the command Offline Named User > Return Named User Licenses.

    The following message appears:

    Are you sure you want to extract all named user licenses 
previously extracted for this logon?

    Click Yes.

    You will be prompted to confirm the restitution of the extracted licenses. Click OK.

    The licenses are returned and disappear from the upper pane.

  11. If you have installed both the 3DEXPERIENCE platform and native apps on your laptop, and you want to work wherever you want (you do not need to connect to a remote 3DEXPERIENCE platform), you must extract all licenses assigned to you, so select the command Offline Named User > Extract All Assigned Licenses.

    The following message appears:

    Are you sure you want to extract all named user licenses 
granted by the server for this logon?

    Click Yes.

    The license duration slider appears, allowing you to set the extraction duration.

    Click OK several times to extract the licenses. The extracted licenses appear in the upper pane, this time with the 3DEXPERIENCE platform license.

    Note: The Extract All Assigned Licenses command does not extract the IFW license if the IFW license is assigned "silently" (without having being previously assigned explicitly to the user). If this is the case, you must first explicitly assign the IFW license to the user on the 3DEXPERIENCE platform to enable the IFW license to be extracted.