New Licensing for dSPACE Products · s New Licensing for dSPACE Products also store floatingt network licenses on them. 6 s December 2017. CmActLicense Software-based variant of the

New Licensing for dSPACEProducts

As of dSPACE Release 2017-B, the licensing technology for protectingdSPACE software changes. From that Release forward, dSPACElicensing is based on the CodeMeter licensing technology from Wibu-Systems.

What about?

Information in this section

Motivation and Benefits 2

Main Differences Between the Old and NewTechnologies

3

Basics on the CodeMeter Licensing Technology 6

New Setup Program for Software Installation 9

Details on License Activation 12

Dongle Migration 16

Requirements for Network Communication 17

How to Contact dSPACE Support 18

Change History 18

Where to go from here

Motivation and Benefits

The current licensing technologies, which are based on WibuKey (fordongle licenses) and FlexNet from Flexera (for floating networklicenses), have been used for 20 years without any modifications. As aresult, dSPACE licensing does not provide state-of-the-art licensemanagement. New business models and licensing features, such aslicense borrowing, cannot be supported due to technologicallimitations.

CodeMeter is a future-proof licensing technology from Wibu-Systems.It provides easy and more flexible license handling, and reduces themanual effort for customers as well as for dSPACE. To help customersfully benefit from these advantages, dSPACE also improves its licensepolicy and dSPACE software installation.

Motivation

The main benefits of using the CodeMeter license technology are:

n Easier and more flexible license management

n Central license management via dSPACE Installation Manager,for example, activating and deactivating licenses.

n Dongle licenses and floating network licenses are based on thesame licensing technology (one supplier instead of two).

n CodeMeter licenses are Release-independent and can be validfor various dSPACE Releases. As a result, the time-consuminglicense update process for customers with a SoftwareMaintenance Service (SMS) contract becomes much easier.

n License information for all dSPACE products and versions is nolonger distributed over many files on your PC, but stored in onelicense container (for example, in a CmDongle) and thus easilyportable.

n Licensing becomes more transparent because the symmetrybetween product information and licenses increases: Oneproduct in the dSPACE Catalog has only one license code. Inaddition, licenses are given traceable names related to theproduct.

n Planned for future Releases: Managing licenses via a webportal, for example, to obtain a clear overview of the licensesavailable in your department.

Benefits

s

New Licensing for dSPACE Products t

2s

December 2017

n License-independent software installation.

The software installation process is now license-independent andtherefore becomes simpler. No license files are required to installdSPACE software products.

n Support of new license features and business models.

Other features and models, such as license borrowing and pay-per-use, can be implemented with future dSPACE Releases. Theyare not yet available.

n The parallel use of old and new licensing technologies is possible.

You can use the WibuKey (or FlexNet) licensing technologyrequired for products from earlier dSPACE Releases in parallel withthe CodeMeter licensing technology on the same PC.

n Starting with dSPACE Release 2014-B, the new CmDongles wereshipped with new dSPACE systems, but they did not yet use theCodeMeter licensing technology. As of dSPACE Release 2017-B,they also support the CodeMeter licensing technology, afterupdating the CmDongles via dSPACE Installation Manager.

All CmDongles (Rev. 3-xxxx), including those shipped with Release2017-B and later, can still be used with dSPACE Releases 6.4 to2017-A because they can emulate WibuKeys.

Compatibility

Main Differences Between the Old and New Technologies

As of dSPACE Release 2017-B, the CodeMeter technology supportssingle-user licenses and floating network licenses.

Supported license types

s

Main Differences Between the Old and New Technologiest

December 2017 3t

Main changes in technology

dSPACE product

Up to dSPACE Release 2017-A

As of dSPACE Release 2017-B

Single-user (dongle) licenses

Single-user licenses

Floating network licenses

License handling

License.dsp

DSP

WibuKey technology

FlexNet technology

dSPACE License Server

License.dat

DAT

dSPACE product

Floating network licenses

License handling

CmContainer

CmActLicense

# 8899

CmDongle

CodeMeter technology

There are the following main technology changes:

n The WibuKey and FlexNet technologies are replaced by theCodeMeter technology.

n Release-dependent License.dsp files are not used anymore.

n The license information is Release-independent and stored in aCmContainer. A CmContainer can be a CmDongle or aCmActLicense (software license container).

dSPACE Release 2017-B provides single-user licenses only onCmDongles.

n License activation, deactivation, and license updates are carriedout via dSPACE Installation Manager in combination with adatabase (dSPACE License Central) on the basis of tickets.

s


4s

December 2017

License Central

PC

Internet

CmDongle or CmActLicense

dSPACE License Central is hosted by dSPACE GmbH and is securedagainst unauthorized access by a web gateway.

New workflow

Downloador DVD

Software Installation

No dongle & license information required

Via dSPACE Installation Manager

License Activation

Decryption Use

DAT

As shown above, the software installation process is now license-independent. No license information and/or dongles are requiredduring the installation. This simplifies the installation processsignificantly.

As a consequence, you can now install dSPACE software without anylicense. However, specific parts of dSPACE software, thedocumentation, demo models, .NET code, etc. are installed inencrypted archives on the end user's PC.

After software installation, license activation is necessary to runlicense-protected dSPACE software. Refer to Details on LicenseActivation on page 12.

To use the full functionality of the installed dSPACE software, youhave to decrypt the files which are installed in encrypted archives. Youcan only decrypt parts of the dSPACE installation for which you havelicenses. Use dSPACE Installation Manager for decrypting them.

s

Main Differences Between the Old and New Technologiest

December 2017 5t

Basics on the CodeMeter Licensing Technology

The CodeMeter Runtime software provides the basic functionality ofthe CodeMeter licensing technology. It is installed automatically withthe dSPACE software installation.

CodeMeter Runtime

CmContainers are basic components of CodeMeter, and the licenseinformation is stored in them. A CmContainer can be a CmDongle(hardware-based) or a CmActLicense container (software-based). EachCmContainer can contain multiple licenses.

A CmContainer can store licenses of different license types, forexample, single-user licenses and floating network licenses.

A license entry in a CmContainer can be viewed as a data record withvarious entries, such as the license name, license type, licensequantity, and maintenance period. dSPACE Installation Managershows this information as follows:

CmContainer

CmDongle Hardware-based variant of the CodeMeter protectionand licensing technology. The complete license information is safelystored on a smart card chip in the CmDongle. With CmDongles, youcan move the license information between PCs by plugging thedongle into the PC you want to use. License files are no longerneeded.

Single-user licenses are typically stored on CmDongles, but you canalso store floating network licenses on them.

s


6s

December 2017

CmActLicense Software-based variant of the CodeMeter protectionand licensing technology. A CmActLicense container is bound to aspecific PC. It cannot be transferred to another PC.

dSPACE Release 2017-B provides CmActLicenses only in combinationwith floating network licenses.

With the CodeMeter licensing technology, license handling becomeseasier because license validity is independent from a specific dSPACERelease.

Thus, you can install a new dSPACE Release as soon as it is released.Each dSPACE software product is stamped with its release date. Youcan execute every Release of the product whose release date lieswithin the maintenance period of the license.

Release-independentlicense validity

Release date01.11.2017





Release 2017-B Release 2018-A Release 2018-B Release 2019-A Release 2019-B

25.06.2017 (delivery date) 24.06.2019

Maintenance period

Maintenance period The time period limiting the usable versionsof a software product. Software Releases whose release date lieswithin the maintenance period can be executed indefinitely. The initialmaintenance period ends six months after the delivery date but canbe extended by purchasing SMS periods.

SMS period The SMS period defines the duration of the optionalSoftware Maintenance Service (SMS) contract. During this time, thecustomer automatically receives all updates and enhancements forthe software products included in the SMS contract.

After software installation, license activation via dSPACE InstallationManager is necessary to run license-protected dSPACE software.License activation is done via a database (dSPACE License Central) anduses a ticket-based system. Refer to Details on License Activationon page 12.

License activation

s

Basics on the CodeMeter Licensing Technology t

December 2017 7t

If the maintenance period is extended, for example, because youpurchased an SMS contract, you have to update your licenses.

License updates are carried out via dSPACE Installation Manager.

dSPACE informs you when the SMS order has been processed for acertain CmContainer number. You only have to make theCmContainer accessible in dSPACE Installation Manager and clickUpdate Licenses. dSPACE Installation Manager then automaticallyperforms the update. Already activated licenses can be updatedalmost automatically without having to consider ticket IDs.

License updates

The CodeMeter technology is also used for floating network licenses.Floating network licenses are typically stored in CmActLicensecontainers, but they can also be stored in CmDongles. An importantattribute of floating network licenses is the license quantity, whichdefines the number of licenses that can be used in parallel on clientPCs.

Setting up license server and clients The CodeMeter technologydoes not need special license servers. Every PC with CodeMeterRuntime software, can be configured as a license server. The clients toconnect to a license server are configured in CodeMeter WebAdmin,which is a web-browser-based configuration utility installed togetherwith CodeMeter Runtime. All client PCs that use floating networklicenses have a search list with the IP addresses of the PCs that areconfigured as license servers. The search list has to be set up by theuser.

Searching licenses Floating network licenses can be used locally onthe PC hosting the floating network licenses (= license server) and byclient PCs connected via LAN. dSPACE software products first searchfor a local CmContainer with the required license. If they do not finda relevant local CmContainer, they search for CmContainers that arestored on the license servers available on the search list.

Floating network licenses stored on CodeMeter dongles It ispossible, to store floating network licenses on CodeMeter dongles. Incase of a defect or a planned upgrade of the license server, theCodeMeter dongle only needs to be plugged into the new licenseserver. Users can immediately work with the licenses again.

Compatibility with FlexNet technology (in earlier releases) Forfloating network licenses, the CodeMeter licensing technology cannotprovide downward compatibility with Releases earlier than dSPACERelease 2017-B. If you need to use product versions of dSPACEReleases earlier than dSPACE Release 2017-B, you have to keep your

Specifics on using floatingnetwork licenses

s


8s

December 2017

FlexNet License Server running in parallel. Both FlexNet andCodeMeter floating network servers can be hosted on the same PC.

Note

The dSPACE EULA does not allow FlexNet and CodeMeter licenseservers to provide the same floating network license in parallel. Ifyou have any questions or encounter any problems, contactdSPACE Support.

New Setup Program for Software Installation

In dSPACE Release 2017-B, the setup program is redesignedcompletely to simplify the installation process.

Introduction

The new setup program, dSPACE Setup, provides the following mainbenefits:

n dSPACE Release Setup is the central setup program for mostdSPACE software products.

n It supports removing product sets, removing a complete dSPACERelease, as well as modifying or repairing an existing installation.

n No license information and/or dongles are required during theinstallation.

n The installation is more transparent. dSPACE software is installedin larger units, called product sets. Each set contains all softwarecomponents and options that are typically used together.

You can install and uninstall software only on the product set level.It is not possible to add or remove single products. Working withproduct sets is easy because they have descriptive names andprovide a good balance between disk space requirements andusability.

n The installation is now performed without any user interactionduring the installation process.

The new setup collects all required information before theinstallation starts. You can specify to shut down your PC after theinstallation. This lets you complete dSPACE software installationwithout having to be physically present.

Main benefits

s

New Setup Program for Software Installationt

December 2017 9t

n dSPACE Release Setup provides an automatic installation featurefor unattended installations.

You can record an initial interactive installation and store yourinstallation configuration to a configuration file. Later, you can usethis file to install dSPACE software on multiple PCs automatically inunattended mode.

Note

You can install only one instance of a product set (for example,ControlDesk, AutomationDesk, ModelCompare, ECU InterfaceSoftware, VEOS, TargetLink) on your PC. Multiple installation ofthe same Release is not supported by the new setup. However,you can install different Releases of a product set on your PC.

Multiple installations

dSPACE Setup has a modern, clean user interface:User interface

Checkbox display:

To be installed

To be removed

Already installed

As shown above, product selection becomes much easier because youcan select product sets from a flat list. There is no longer a complextree of installable software components you can or must select from,requiring intimate knowledge about which component is locatedwhere.

s


10s

December 2017

With the new setup, you can now install the complete dSPACERelease without any license. However, specific parts of dSPACEsoftware, documentation, demo models, .NET code, etc. are installedin encrypted archives on the end user's PC.

To work with the installed dSPACE software, you have to activatelicenses and decrypt the encrypted parts of the installed products youhave licenses for. This is performed with dSPACE Installation Manager,which is always installed with dSPACE software.

After initial decryption, all files remain decrypted, but only on the PCwith the required licenses.

Tip

Decryption does not require administrator rights, so the endusers can perform this step themselves.

For more information on activating licenses, refer to Details on LicenseActivation on page 12.

Decryption of encryptedparts

You can use the record mode of dSPACE Release Setup to record theinstallation configuration of dSPACE software and use the generatedconfiguration file to install the software on other PCs automatically inthe setup's unattended mode. This mode does not require anymanual input.

Note

In record mode no software is installed on your host PC. Youonly save your settings to a configuration file.

Recorded configuration file

Installation on one PC

Record

Automatic installation in unattended mode

Installation on multiple PCs

INI

Unattended installations

s

New Setup Program for Software Installationt

December 2017 11t

Details on License Activation

CodeMeter licenses are made available via CmContainers (CmDonglesor CmActLicense containers) on user PCs. After software installation,license activation via dSPACE Installation Manager is needed to runlicense-protected dSPACE software.

Introduction

License activation uses a ticket-based system. dSPACE GmbH hosts alicense database: dSPACE License Central. Depending on your order,dSPACE selects characteristics for each license and provides thisinformation to the database. dSPACE License Central then generatesa ticket ID for each license.

The ticket ID is a unique alphanumeric string of characters. The ticketID of a license remains unchanged as long as the license exists, butthe license information related to it can be updated, for example, incase the maintenance period of a license is extended with an SMSorder.

This ticket ID is sent to you by e-mail. You have to enter the IDs indSPACE Installation Manager and start the activation process. Duringthis process, specific license activation files are transferred betweendSPACE Installation Manager and dSPACE License Central.

Activation principle

CmDongle (via mail)

Ticket ID(via e-mail)

Web Gateway

Data exchange via Internet

Activation files

Customer

License Central

CmContainer

Installation Manager

RUC

RAC

License A:License B:License C: ...

Ticket IDs

279025066734502422931662 ...

Activate

s


12s

December 2017

License activation and maintenance requires an Internet connectionbetween dSPACE Installation Manager and dSPACE License Central.The most convenient method is online activation with a PC that hasaccess to the Internet and the local CmContainers. dSPACErecommends using online activation whenever possible. If a PC withlocal CmContainers does not have Internet access, licenses can beactivated in different ways. However, at least one PC with Internetaccess and dSPACE Installation Manager must be available at yoursite.

Online activation differs depending on how dSPACE InstallationManager can access the CmContainer.

Online activation with local access of dSPACE Installation Manager tothe CmContainer is the only convenient way to activate licenses.

dSPACE Installation Manager has to be running on the PC with localaccess to the CmContainer. dSPACE Installation Manager lists theCmContainers it finds on the PC (CmActLicense) and that areconnected to it (CmDongles).

You have to select the desired CmContainer and enter the ticket ID ofthe license to activate. Clicking Activate starts the activation process.dSPACE Installation Manager then automatically performs theactivation and data exchange with dSPACE License Central.

Local access to CmContainer

License Central

Data exchange

via Internet


Activate

CmContainer

You can use this activation method if one of the following casesapplies:

n Your PC does not have an Internet connection but is connected toother PCs via LAN.

n Your PC acts as a license server and is running with a non-Windows operating system and can therefore not run dSPACEInstallation Manager.

For these cases, dSPACE provides a remote access functionality.dSPACE Installation Manager must run on a PC that is connected toyour LAN. This PC must also be connected to dSPACE License Centralvia the Internet.

LAN access to CmContainer

s

Details on License Activationt

December 2017 13t

dSPACE Installation Manager can then access remote CmContainersvia LAN and automatically performs the activation and data exchangewith dSPACE License Central via Internet.

License Central



LAN

Remote access

LAN

LAN connection

CmContainer

You have to use this access method if dSPACE Installation Managercannot access the CmContainer at all.

On the PC with the CmContainer, CodeMeter Control Center can beused to create the files required for license activation, update, anddeactivation. These files must be transferred between the PC and thePC on which dSPACE Installation Manager is installed. Do this with aUSB stick or via a network folder, for example.

On another PC, dSPACE Installation Manager must be installed andconnected to dSPACE License Central via the Internet. dSPACEInstallation Manager exchanges data (reads and sends the activationfiles) with dSPACE License Central online.


Manual transfer of activation files

File-based accessCodeMeter

Control Center

CmContainer

RUC

RAC

License Central


File-based access toCmContainer

s


14s

December 2017

Activation files The files to transfer contain a fingerprint of theCmContainer contents. There are two types of files:

n Remote activation context (RAC) files. These files are created byCodeMeter Control Center and have to be sent to dSPACE LicenseCentral via dSPACE Installation Manager.

n Remote activation update (RAU) files. These files are created bydSPACE License Central and are used to update CmContainers.

This method also uses manual file transfer, but CodeMeter ControlCenter on the PC with the CmContainer is operated from a remotePC. You can use a remote desktop tool to access the PC with theCmContainer. This tool can be installed on the PC with dSPACEInstallation Manager or on any other PC in the LAN to controlCodeMeter software and to transfer files manually between the PCs.

Remote access is useful if you want to access multiple CmContainersand work with CodeMeter software installed on the PCs from onlyone administrator PC. Another use case is to manage single-userlicenses that are not accessible directly in a LAN.

File-based remote access toCmContainer

License Central


Administrator PCRemote PC


Manual transfer of activation files

Remote desktop connection

LAN

LAN connection

CodeMeter Control Center

CmContainer

RUC

RAC

As shown above, CodeMeter Control Center can be started on aremote PC to generate the files required for license activation. Thesefiles must be transferred between the remote PC and an administratorPC. On the administrator PC, dSPACE Installation Manager reads andsends activation files from the remote PC. dSPACE InstallationManager also exchanges data with dSPACE License Central via theInternet.

s

Details on License Activationt

December 2017 15t

Dongle Migration

Dongles delivered for earlier Releases are not prepared to be usedwith the new CodeMeter license technology. Therefore, donglemigration is required for these dongles. Depending on which dongleyou already use (for installations of dSPACE Release 2017-A andearlier), one of the described scenarios applies (see below).

CmDongles shipped for dSPACE Release 2017-B and later supportCodeMeter licensing without modifications.

Motivation

WibuKey dongles must be replaced and the license ID stored on aWibuKey dongle must be migrated to a CmDongle.

CmDongles are automatically delivered with dSPACE Release 2017-Bto owners of WibuKey dongles with licenses covered by a SoftwareMaintenance Service (SMS) contract. When shipped, the newCmDongles do not contain any license information.

Migrate from WibuKeydongle

License

Central


License code

MigratedCmDongle

# 8899

WibuKey dongle


License code

# 8899

During migration, the WibuKey dongle is disabled and can no longerbe used. After migration, the CmDongle is prepared to use theCodeMeter license technology. Additionally, the CmDongle containsthe WibuKey ID of the WibuKey dongle. This ID is required to use theCmDongle with dSPACE Release 2017-A and earlier.

CmDongles delivered for dSPACE Release 2014-B up to dSPACERelease 2017-A are not prepared to use the CodeMeter licensingtechnology. They must be migrated to use dSPACE Release 2017-Band later.

Migrate from old CmDongle

License

Central


License code

MigratedCmDongle


License code

CmDongle Rev. 3-xxx

s


16s

December 2017

During migration the license information is modified. After migration,the CmDongle is prepared to use the CodeMeter license technology.Migrated CmDongles still contain the embedded WibuKey ID. This IDis required to use the CmDongle with dSPACE Release 2017-A andearlier.

Requirements for Network Communication

To communicate with dSPACE License Central (via web gateway),with CodeMeter tools from Wibu-Systems or other PCs in a LAN, yourPC must be able to establish a TCP/IP connection.

Purpose

To access dSPACE License Central from your PC, you need an Internetconnection. dSPACE Installation Manager connects tohttps://licensing.dspace.de/gateways, HTTPS, Port 443. dSPACEInstallation Manager can work with proxy servers that you might use.It can also handle proxy servers with authentication (user name,password).

Tip

dSPACE Installation Manager uses the same settings forcommunication as Microsoft Internet Explorer. Therefore, youcan change the setting in Internet Explorer to solve anycommunication problems. In addition, you can check the Internetconnection to dSPACE License Central by entering the followingaddress in Internet Explorer: https://licensing.dspace.de

Local firewalls and IT appliances must be configured accordingly togrant dSPACE Installation Manager access to the Internet.

Communication withdSPACE License Central

For internal LAN communication between CodeMeter software ondifferent PCs, for example, for connections between floating networklicense servers and clients, a standard TCP/UDP protocol is required.The default port number is 22350, which is an officially registeredport number (IANA). If needed, you can change the port number.

For communication with CmContainers on remote PCs in a LAN,dSPACE Installation Manager uses CodeMeter functionality. Thus, theconnected PCs require the same open TCP/IP network port: 22350(TCP and UDP).

Internal LANcommunication

s

Requirements for Network Communicationt

December 2017 17t

For general communication and transferring attached files, an internaland external e-mail client is required.

Communication via e-mailclient

How to Contact dSPACE Support

Mail: dSPACE GmbHRathenaustraße 2633102 PaderbornGermany

Tel.: +49 5251 1638-941(General Technical Support)

Fax: +49 5251 16198-0

E-mail: [email protected]

Web: http://www.dspace.com

Change History

Date Changes

March 20, 2017 Initial revision

October 15, 2017 Description of automatic selection of product sets removed.

December 20, 2017 General update

s


18s

December 2017

mailto:[email protected]

http://www.dspace.com

Documents

New Licensing for dSPACE Products · s New Licensing for dSPACE Products also store floatingt network licenses on them. 6 s December 2017. CmActLicense Software-based variant of the