Overview CodeMeter

Overview CodeMeter

Copyright: 2010 PTV AG, Karlsruhe VISUM is a trademark of PTV AG PTV Vision is a trademark of PTV AG All brand or product names in this documentation are trademarks or registered trademarks of the corresponding companies or organizations. All rights reserved. Disclaimer: The information contained in this document is subject to change without notice and should not be construed as a commitment on the part of the vendor. This document may not be used for any other purpose than the personal use of the purchaser. No part of this handbook may be reproduced, stored in a retrieval system, or transmitted, in any form, or by any means, electronic, mechanical, photocopying, recording, or otherwise, edited or translated, except as permitted under the terms of the copyright, without the prior written permission of PTV AG. Impressum - legal notice: PTV AG Traffic Software Stumpfstrae 1 D - 76131 Karlsruhe Germany Phone +49 721 9651-300 Fax +49 721 9651-562 E-Mail: [email protected] www.ptvag.com www.ptv-vision.com

2010 PTV AG, Karlsruhe

2

Table of contentsCopyright: Disclaimer: Impressum - legal notice: PTV AG Traffic Software Table of contents 1 Preface 2 Update of the CodeMeter Runtime Kit 2.1 Which version is in use? 2.2 How to update the CodeMeter Runtime Kit? 3 Set up CodeMeter as dongle server 3.1 Conditions 3.2 Setting up the corresponding CodeMeter software 3.3 Start CodeMeter server 4 CodeMeter server 4.1 Conditions 4.2 Connecting one CodeMeter dongle 4.3 Connecting several CodeMeter dongles 4.4 Starting the PTV Vision software 5 Error handling 5.1 License key not found 5.2 CodeMeter error 6 Remote programming of the dongle 6.1 Creating a context file 2 2 2 2 2 3 5 6 6 6 7 7 7 10 15 15 15 15 16 19 19 19 21 21

6.2 Applying a context update file 24 6.2.1 Applying a context update file with control centerFehler! Textmarke nicht definiert. 6.2.2 Applying a context update file with Microsoft ExplorerFehler! Textmarke nicht definiert. 6.2.3 Update the firmware of the CodeMeter dongle 26 6.3 Update the CodeMeter Runtime Kit 7 Support 7.1 Direct Support 7.2 Indirect Support Fehler! Textmarke nicht definiert. 27 27 27

Overview CodeMeter, v2.0 PTV AG

3

4


Preface

1

PrefaceDear PTV Vision customer, Many thanks for having purchased a PTV Vision software license. We wish you successful working with our software! Supplementary to the dongle information provided on the installation DVD, we would like to inform you of the use of your CodeMeter dongle. This documentation applies to version 4.20 of the CodeMeter Runtime Kit. In case you are using an earlier version, please update it as described in chapter 2.

Notes for PTV America customers: Most, but not all, of this document applies to PTV Vision licensing in North America. Contact PTV America for more details under [email protected]

Trademark details: All names and labels of company and products mentioned in this document are registered trademarks of the companies. CodeMeter is a registered trademark of WIBU-SYSTEMS AG, Germany. Hardlock is a registered trademark of Aladdin Knowledge Systems Ltd., Israel. PTV Vision is a registered trademark of PTV AG, Germany. Windows is a registered trademark of Microsoft Corp., USA.

5

2

Update of the CodeMeter Runtime KitWith the introduction of PTV Vision VISUM 11.5 and VISSIM 5.30 respectively, we have introduced a new version of the CodeMeter Runtime Kit. The PTV Vision software now require version 4.20 of the Runtime Kit.

2.1

Which version is in use?To be able to find our the currently used version of the Runtime Kit, there are several ways to proceed: 1. Make a right click on the CodeMeter symbol in Windowss system tray in the lower right corner of the screen. Select the entry About of the context menu. The following dialog shows the version number of the currently used Runtime Kit. 2. Open up the CodeMeter Control Center from the start menu: Start -> Programs -> CodeMeter -> CodeMeter Control Center In the menu Help chose the entry About. The following dialog shows the version number of the currently used Runtime Kit. 3. Open up the CodeMeter WebAdmin, e.g. from the CodeMeter Control Center, Button WebAdmin in the lower right corner or from the CodeMeter symbol in Windowss system tray in the lower right corner of the screen. Make a right click on it and select WebAdmin. In the Home section of the WebAdmin, the Server version will be displayed. 4. Create a so called CmDust report, see chapter 7.1 and send it to the Traffic Customer Service under: [email protected]

2.2

How to update the CodeMeter Runtime Kit?The latest version of the CodeMeter Runtime Kit can be retrieved from the webpage of the manufacturer WIBU SYSTEMS AG under: http://codemeter.com In the Downloads section, the manufactuerer provides always the latest installers of the Runtime Kit for free. There are installers for Windows, 32bit and 64bit operating system, Linux and Mac OS X. The last two only applies for dongle servers. The choice of 32bit or 64bit depends on the operating system and NOT on the edition of the PTV Vision software. After the installation of a new version of the Runtime Kit, it is required to reboot the computer.

6


3

Set up CodeMeter as dongle serverIn this chapter, we would like to inform you of the requirements and software needed to run your CodeMeter dongle as a server dongle within your network.

3.1

ConditionsThe CodeMeter dongle requires the software CodeMeter Runtime Kit, which is available on the web site of CodeMeter 1 . The CodeMeter Runtime Kit software is available for 32bit and 64bit architectures. Usually, this software will be installed during the default PTV Vision software setup process. During the default installation of a PTV Vision product, a CodeMeter start menu entry will be created. The corresponding software is started each time you start up your Microsoft Windows operating system. The started CodeMeter software can be identified through a small icon in the Windows status bar, on bottom right of the desktop. The corresponding CodeMeter software is independent of the PTV Vision software and can be installed on any computer (cp. chapter 3.2). The computer which shall serve as a dongle server must have a USB interface and a Microsoft Windows operating system installed. It is not possible to virtualize the server! Usually, an operating system uses a so-called firewall to protect itself. It permits or denies network access according to certain rules. If a firewall is installed on your PC (this defaults to Microsoft Windows XP and other operating systems), you have to check whether it permits incoming and outgoing access on port 22350 for all clients on which the PTV Vision software will be run. Please note: it is a security issue to permit network access. If you are not sure what to do, please contact the administrator of the firewall or an IT specialist.

3.2

Setting up the corresponding CodeMeter softwareThe CodeMeter Runtime Kit which is required for use of the CodeMeter dongle is usually installed during the PTV Vision software setup process. If you wish to run the CodeMeter dongle on another computer, where the PTV Vision software is not installed (e.g. a server), simply install the corresponding CodeMeter software manually. It is independent of the PTV Vision software used. Just navigate to the directory Installers\win32x64\wibu on the installation DVD included in your delivery. Start the included setup by double-click on it. Otherwise visit CodeMeters web site1 and download the latest version of the software. Double-click the CodeMeterRuntime.exe file to start it. The CodeMeter Runtime Kit will be installed. Then click the Next button. Independent on how much CodeMeter dongles will be plugged to the server, the software has to be installed just once.1

www.codemeter.com


7

Figure 1 CodeMeter setup process, dialog 1


Please accept the license agreement shown in Figure 2. Then, click the Next button again.

8



In the window shown in Figure 3, please enter your name and the name of your organization. You can choose to install for an individual or anyone on the machine. It is recommended to choose the option for anyone. Then, click the Next button again.


In the window shown in Figure 4, please confirm the settings. Then click the Next button. The installation process may take a couple of minutes.


9


If the CodeMeter software is successfully installed, another window is opened (see Figure 5). After you click the Finish button, you might be asked to restart your computer.

3.3

Start CodeMeter serverAfter you have successfully installed the CodeMeter software and restarted your computer, a new grey symbol will appear in the Windows status bar, on bottom right of the desktop. This means the software has been started, but has not found a valid CodeMeter dongle. As soon as you plug in the delivered CodeMeter dongle, the corresponding software will recognize it and the status of the symbol changes to . By default, the CodeMeter software will not be set up for a server. Unconfigured servers reduce the performance of your computer network! To set up the dongle server, right-click the CodeMeter symbol on the status bar, on bottom right of the desktop. A context menu will be shown. Choose the WebAdmin entry, see Fehler! Verweisquelle konnte nicht gefunden werden..

Figure 6 CodeMeter context menu, WebAdmin

Now, your web browser will pop up (for Windows XP, this is Internet Explorer by default). It will show you the web site shown in Figure 6.

10


Figure 7 CodeMeter WebAdmin

Please note: the URL of the browser shown in Figure 7. The name localhost determines the computer itself on which you have opened the browser window. The number 22350 specifies the network port which must be accessible (cp. chapter 3.3). In order to be able to use the CodeMeter WebAdmin properly, your browser must accept JavaScript. By using the WebAdmin user interface, the CodeMeter server can be configured remotely with the following URL: Fehler! Hyperlink-Referenz ungltig. Please replace by the name or IP address of the server. If necessary, ask your local network administrator.


11

As you can already see, the server is not started, the according checkbox is not activated. In order to activate the server next time the CodeMeter software is started, please select the checkbox (cp. Figure 8). To apply your changes, click the Apply button.

Figure 8 CodeMeter WebAdmin, configuration network

Now, the dongle server will be started the next time the CodeMeter software is started. In order to activate the changes, the CodeMeter software has to be restarted now. The simplest way to restart it is to open the CodeMeter control center. Please right-click the CodeMeter symbol again, on the status bar, on bottom right of the desktop.

Figure 9 CodeMeter context menu, Show

A context menu will be displayed, cp.Figure 9, Click Show to open the CodeMeter Control Center.

12


Figure 10 CodeMeter Control Center, stop service

To stop the CodeMeter software, at the top of the window, on the menu bar, choose Process, then select Stop CodeMeter Service, see Figure 10. All buttons in the control center disappear. The CodeMeter symbol, on the status bar, on bottom right of the desktop, changes its color to grey. The software is now stopped, which can be seen in the status bar, on bottom right of the CodeMeter control center (cp.Figure 11).

Figure 11 CodeMeter control center, service stopped

To start the CodeMeter software again, click File. Select the entry Start CodeMeter, see Figure 12.


13

Figure 12 CodeMeter control center, start service

As could be seen before, the controls of the current window are now colored again. And the CodeMeter symbol, on the status bar, on bottom right of the desktop, changes its color to green. Again, the status bar of the CodeMeter control center, on the bottom right of the window, informs you that the CodeMeter has been started (cp. Figure 13).

Figure 13 CodeMeter control center, service started

14


4

CodeMeter serverThis chapter describes the requirements for use of your CodeMeter dongle as a dongle server in your network.

4.1

ConditionsAs already described in chapter 2, the CodeMeter server has to be started and must be accessible via your computer network. You can check the accessibility of the server by typing the following URL in your web browser (e.g. Microsoft Internet Explorer): Fehler! Hyperlink-Referenz ungltig. Please replace by the name or IP address of that PC, which will act as a CodeMeter dongle server. Contact your administrator in order to find out the name or IP address. If the CodeMeter WebAdmin window is displayed (cp. Figure 7), the accessibility check was successful!

4.2

Connecting one CodeMeter dongleThe PTV CodeMeter dongle provides a built-in Flash memory. Usually, Microsoft Windows operating systems recognize it as a mass storage device and assign a new disc drive letter. In some cases this leads to the start of the Microsoft Windows AutoPlay functionality. Then, the following dialog is displayed, see Fehler! Verweisquelle konnte nicht gefunden werden..

Figure 14 Microsoft Windows, Autoplay

Please do not cancel this process.

4.3

Connecting several CodeMeter donglesIt is possible to plug in several CodeMeter dongles to one server. This can be necessary in order to be able to provide several different software settings (e.g. two versions of VISUM with different network sizes). If doing like this, the small icon on bottom right of the window will change its status into


15

If more than one dongle is plugged to the server, take care when dealing with one determined dongle. As shown in Fehler! Verweisquelle konnte nicht gefunden werden., be always sure that you have chosen the right dongle.

Figure 15 CodeMeter control center , Selection of dongle serial number

4.4

Starting the PTV Vision softwareNow you can start now your PTV Vision software. If there is only one CodeMeter server in your network, the software is immediately started and you can begin your work. If there is more than one CodeMeter dongle server, it may happen that the PTV Vision software cannot find a valid dongle. In this case, the following error message is displayed, see Figure 16.

Figure 16 Dongle not found

In order to specify which CodeMeter dongle server has to be used, change the following in the CodeMeter WebAdmin application on the PC you want to use the PTV Vision software on. It has to be specified, where the CodeMeter software has to search for a valid CodeMeter dongle. Click the add button, see Figure 17.

Figure 17 WebAdmin, Setup Server Search List

16


Then a new dialog is displayed in you enter an IP address or server name, cp. Figure 18. Please enter a valid IP address or the server name of the PC that shall act as your CodeMeter dongle server. Note that the CodeMeter dongle has to be plugged into that PC.

Figure 18 WebAdmin, enter IP address

Click the OK button to confirm your entry and the window disappears. Then, click Apply to have your changes made to the server search list accepted. Please note that too many IP addresses in the server search list reduce the performance of the CodeMeter software and may prevent the start of your PTV Vision program.

Figure 19 WebAdmin, Changed Server Search List

As you can see in Figure 19, the checkbox Run Network Server does not have to be selected. From now on, the CodeMeter software searches exclusively on the servers in the server search list for a valid CodeMeter dongle. You may now start the PTV Vision software.

The license window provides more information about the license and the dongle used, see Figure 20.


17

Figure 20 PTV Vision VISUM 10 license overview

18


5

Error handlingBefore and while working with your PTV Vision software protected by a dongle, you may run into certain error situations. In case of a CodeMeter dongle, these are the following:

5.1

License key not foundIn case of the appearance of an error message shown in Fehler! Verweisquelle konnte nicht gefunden werden. while starting your PTV Vision software, a valid CodeMeter dongle could not be found. Please check and correct the following issues, if required: Did you plug in the correct CodeMeter dongle on your local machine or on a machine, which is accessible via the network? Did you start the CodeMeter software (can you see the relevant CodeMeter symbol in the status bar, on bottom right of the desktop)? If you have plugged the CodeMeter dongle into another machine, is this machine accessible via the network? If you have plugged the CodeMeter dongle into another machine, did you start the CodeMeter software on that machine?

If you have plugged the CodeMeter dongle into another machine, did you set up the firewall on that machine in order to permit access to port 22350 (this can be checked by typing in the corresponding URL into your web browser, see chapter 3.3)?

5.2

CodeMeter errorIf you are using your PTV Vision software as network version, i.e. the CodeMeter dongle is not plugged into your local machine, you have to guarantee that the connection to the CodeMeter dongle is never interrupted. If the connection is interrupted, an error message is displayed, cp. Figure 21. Possible reasons are: The CodeMeter dongle has been unplugged accidentally The network connection has been interrupted The CodeMeter software on the remote machine has been stopped The CodeMeter server has been turned off The CodeMeter software on the local machine has been stopped


19

Figure 21 CodeMeter error

The CodeMeter error message will be followed by another error message shown in Figure 22. Please try to check whether the connection has been lost and try to reconnect it.

Figure 22 CodeMeter, execution error

Please try to reconnect in any case! Otherwise, the PTV Vision software will be shut down and you will not be able to save your work.

Check the above given reasons to try to reconnect. Additionally, you can check the following issues in order to continue working with your PTV Vision software: You can plug the CodeMeter dongle into your local machine You can plug the CodeMeter dongle into another machine, which has to be accessible via the network (please change the server search list, if necessary, cp. chapter 4.4).

If you have checked the above given issues regarding the re-connectivity, then please click the Retry Button. Now, the CodeMeter software tries to find a valid CodeMeter dongle again. In case of success, you can continue working with your PTV Vision software. If no valid CodeMeter dongle could be found, the error message shown in Figure 22 appears again.

20


6

Remote programming of the dongleThis chapter deals with the remote programming

6.1

Creating a context fileIn order to exchange the key file of your PTV Vision license, we have to know which individual CodeMeter dongle you are using. Each CodeMeter dongle has its own serial number. Therefore, we need to have its individual context file, as this file contains a license overview and the serial number. Please start the CodeMeter control center, cp. chapter 3.3,Figure 12. Then, navigate to the License tab as shown in Figure 23. Pleas note that the CodeMeter dongle must be plugged into your local machine. Click the License Update button, whereupon a new window with the CmFAS Assistant will open up, see Figure 24. Click Next.

Figure 23 CodeMeter control center, License Update Button

On page 2 of the CmFAS Assistant, please click the radio button Create license request and then Next, see Figure 25. On page 3, select option Extend existing license and then Next, see Figure 26 On the next page, keep the selected entry PTV AG (100321) and click Next, see Figure 27.


21

Figure 24 CmFAS Assistent, page 1



22


In order to write the context file, click the Commit button (see Figure 28). Before, you may change the path of the newly created file as you wish. Please do not change the name of the file! (ex. 1-1059512.WibuCmRaC) At the extension WibuCmRaC of the file you can see it is a context file.


If the CodeMeter control center has been able to create the context file successfully, it will inform you about with the information dialog shown in Figure 29.



23


Go to the path shown in Figure 28 and send us the created context file with the file extension WiBuCmRaC.

6.2

Applying a context update fileUsually, we will send you a new context file for your CodeMeter dongle by e-mail. In order to import this context file and to extend your license, please open the CodeMeter control center again, cp. chapter 3.3, Figure 12. Then, click the License Update button, whereas a dialog is presented as shown in Figure 30. Click Next. The CodeMeter dongle must be plugged into your local machine. Then, as shown in Figure 31, select the Import License Update radio button and click Next. Now, point to the CodeMeter update file (with file extension WiBuCmRaU), which you have got from us, cp. Figure 32. Then click Commit to apply the update to the dongle. Figure 33 shows whether this process has been successful.


24






25

6.3

Update the firmware of the CodeMeter dongleIt might be necessary to update the firmware (the software which is installed on the dongle itself) of the CodeMeter dongle in order to be able to execute provided context update files. To do so, please start the CodeMeter control center, cp. chapter 3.3, Figure 34. In tab on the right side of the control center. Please note that the License, click the icon CodeMeter dongle must be plugged into your local machine. The possibly required password is CodeMeter.

Figure 34 CodeMeter control center

Notice, do not unplug the dongle until the update process has been finished, cp. Figure 35.

Figure 35 Do not unplug CodeMeter

The end of the update process will be displayed by either an error or a success message as shown in Figure 36.

Figure 36 Firmware successfully updated

26


7

SupportThis chapter deals with the two support possibilities for PTV Vision customers who are using CodeMeter dongles.

7.1

Direct SupportPlease feel free to contact Traffic Customer Service in case of problems regarding the CodeMeter dongle. To be able to provide fast and efficient support, we would like to ask you to do the following before contacting us: 1) Check the version of the CodeMeter Runtime Kit, see chapter 2.1 2) First, update the firmware of your CodeMeter dongle, refer to chapter 6.3. 3) Then, create the so called context file of the dongle under consideration, refer to chapter 6.1. 4) Finally, we need the so called CmDust report which can be find in the start menu. Navigate to All programs and then CodeMeter. Under the CodeMeter entry, there is a folder which says Tools. Please click the CmDust entry. This will create the report file CmDust-Result.log. In case of the use of a network dongle, please provide CmDust reports of both, the server and all clients which have problems with the CodeMeter dongle. 5) For providing a better and faster support, please send us also the regarding installation log files named Setup Log **.txt which can be found in the directory: %tmp% (enter without in the Explorer) Please send us all above mentioned files including your PTV customer ID to the e-mail address [email protected]

7.2

Indirect SupportBy purchasing a CodeMeter dongle, the user automatically has the right to contact the technical support of the manufacturer for free. The WIBU-Systems AG company provides excellent support. The company can be contacted as follows: Web: E-Mail: Phone: http://support.codemeter.de/en/ [email protected] +49 721-93172-15


27

Traffic Software Logistics Software Transport Consulting

PTV AG Stumpfstr. 1 D - 76131 Karlsruhe Germany

Phone +49 721 9651-300 Fax +49 721 9651-562 [email protected] www.ptvag.com www.ptv-vision.com

Documents

Overview CodeMeter