Professional Documents
Culture Documents
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.
2
Table of contents
Copyright: 2
Disclaimer: 2
PTV AG 2
Traffic Software 2
Table of contents 3
1 Preface 5
7 Support 27
7.1 Direct Support 27
7.2 Indirect Support 27
1 Preface
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 Kit
With 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.
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 Windows’s 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
Windows’s 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: traffic.customerservice@ptv.de
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.
In 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 Conditions
The 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.
The ‘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 CodeMeter’s 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
Please accept the license agreement shown in Figure 2. Then, click the Next button again.
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.
After 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..
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.
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 ungültig.
Please replace <name or IP address of the server> by the name or IP address of the
server. If necessary, ask your local network administrator.
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.
A context menu will be displayed, cp.Figure 9, Click Show to open the CodeMeter Control
Center.
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).
To start the CodeMeter software again, click File. Select the entry Start CodeMeter, see
Figure 12.
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).
This chapter describes the requirements for use of your CodeMeter dongle as a dongle
server in your network.
4.1 Conditions
As 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 ungültig.
Please replace <name or IP address of the server> 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!
The 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..
It 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
Now 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.
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.
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.
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.
Before 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:
If 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
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.
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.
In 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.
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.
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.
Usually, 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.
It 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
License, click the icon on the right side of the control center. Please note that the
CodeMeter dongle must be plugged into your local machine. The possibly required
password is ‘CodeMeter’.
Notice, do not unplug the dongle until the update process has been finished, cp. Figure 35.
The end of the update process will be displayed by either an error or a success message
as shown in Figure 36.
This chapter deals with the two support possibilities for PTV Vision customers who are
using CodeMeter dongles.
Please 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:
Please send us all above mentioned files including your PTV customer ID to the e-mail
address traffic.customerservice@ptv.de
By 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: http://support.codemeter.de/en/
E-Mail: support@codemeter.com
Phone: +49 721-93172-15