Overview CodeMeter - PTV Group
Transcription
Overview CodeMeter - PTV Group
OVERVIEW CODEMETER www.ptvgroup.com Copyright: © 2014 PTV AG, Karlsruhe PTV Visum® is a trademark of PTV AG PTV Vissim® is a trademark of PTV AG PTV Viswalk® is a trademark of PTV AG PTV Vistro® 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 Haid-und-Neu-Straße 15 D - 76131 Karlsruhe Germany Tel. +49 721 9651-300 Fax +49 721 9651-562 E-Mail: info@vision.ptvgroup.com www.ptvgroup.com www.vision-traffic.ptvgroup.com/ © 2014 PTV AG, Karlsruhe Overview CodeMeter © PTV AG 2 1 Table of Content 1 Table of Content 3 2 Update of the CodeMeter Runtime Kit 4 2.1 Which version is in use? 4 2.2 How to update the CodeMeter Runtime Kit? 4 3 Set up CodeMeter as dongle server 5 3.1 Conditions 5 3.2 Setting up the corresponding CodeMeter software 5 3.3 Starting the CodeMeter server 8 4 CodeMeter server 13 4.1 Conditions 13 4.2 4.3 Connecting one CodeMeter dongle Connecting several CodeMeter dongles 13 13 4.4 Starting the Vision Traffic software 14 4.5 Reliable check of connection between Client and Server 17 5 Error handling 18 “Licence key not found” CodeMeter error 18 18 6 Remote programming of the dongle 20 5.1 5.2 6.1 Creating a context file 20 6.2 Applying a context update file 23 6.3 Update the firmware of the CodeMeter dongle 24 6.4 Proxy Settings 25 7 Support 27 7.1 Direct Support 27 7.2 Indirect Support 27 Overview CodeMeter © PTV AG 3 Update of the CodeMeter Runtime Kit 2 Update of the CodeMeter Runtime Kit With the introduction of PTV Visum 14 and PTV Vissim 7 respectively, we have introduced a new version of the CodeMeter Runtime Kit. The software now requires version 5.10c of the Runtime Kit. 2.1 Which version is in use? To find out the currently used version of the Runtime Kit, use one of the following options: 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: customerservice@vision.ptvgroup.com 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://www.codemeter.com In the “Downloads” section, the manufacturer provides the latest installers of the Runtime Kit for free. There are installers for Windows, 32bit and 64bit operating system, Linux and Mac OS X. Linux and Mac OS X can only be used for dongle servers. The choice of 32bit or 64bit depends on the operating system and not on the edition of the Vision Traffic software. After the installation of a new version of the Runtime Kit, it is required to reboot the computer. We do not recommend to use the latest version of the CodeMeter Runtime Kit. Instead, we strongly recommend the use of version 5.10c of the Runtime Kit. You can download it from our web server. Overview CodeMeter © PTV AG 4 Set up CodeMeter as dongle server 3 Set up CodeMeter as dongle server In this chapter, we would like to inform you of the requirements 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 CodeMeter1. The ‘CodeMeter Runtime Kit’ software is available for 32bit and 64bit architectures. Usually, this software will be installed during the default Vision Traffic software setup process. During the default installation of a Vision Traffic 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 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 Vision Traffic software and can be installed on any computer (see chapter 3.2). The computer which shall serve as a dongle server must have an 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 active on your PC (this is by default the case for Microsoft Windows XP and other operating systems), you have to check whether or not it permits incoming and outgoing access on port 22350 for all clients on which the Vision Traffic 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 software The ‘CodeMeter Runtime Kit’ which is required for use of the CodeMeter dongle is usually installed during the Vision Traffic software setup process. If you wish to run the CodeMeter dongle on another computer, where the Vision Traffic software is not installed (e.g. a server), simply install the corresponding CodeMeter software manually. This software is independent from the use of any Vision Traffic software. Just navigate to the directory Installers\win32x64\wibu on the installation DVD included in your delivery. Start the setup of the software by a double-click. Alternatively, visit the web site of the manufacturer 1 and download the corresponding version of the software. Double-click the CodeMeterRuntime.exe file to start the installation process.. Then click the 1 www.codemeter.com Overview CodeMeter © PTV AG 5 Set up CodeMeter as dongle server “Next” button. Independent on how much CodeMeter dongles will be plugged to the server, the software has to be installed just once. Figure 1: CodeMeter setup process, dialog 1 Figure 2: CodeMeter setup process, dialog 2 Please accept the license agreement shown in Figure 2. Then click the “Next” button again. Overview CodeMeter © PTV AG 6 Set up CodeMeter as dongle server Figure 3: CodeMeter setup process, dialog 3 In the window shown in Figure 3, please enter your name and the name of your organization. You can choose to install the software for an individual or anyone using the machine. It is recommended to choose the option for anyone. Then, click the “Next” button again. Figure 4: CodeMeter setup process, dialog 4 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. Overview CodeMeter © PTV AG 7 Set up CodeMeter as dongle server Figure 5: CodeMeter setup process, dialog 5 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 Starting the CodeMeter server After you have successfully installed the CodeMeter software and restarted your computer, a new grey symbol will appear in the Windows status bar, on the bottom right of the desktop. This means the software has been started, but has not yet found a valid CodeMeter dongle. As soon as you plug in the 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. Servers which are not configured reduce the performance of your computer network! To set up the dongle server, right-click the “CodeMeter” symbol on the status bar, on the bottom right of the desktop. A context menu will be shown. Choose the “WebAdmin” entry (see Figure 6). Figure 6: CodeMeter context menu, WebAdmin“ This opens the web browser (for Windows XP, this is Internet Explorer by default). The web site as shown in Figure 7 is displayed. Overview CodeMeter © PTV AG 8 Set up CodeMeter as dongle server Figure 7: CodeMeter WebAdmin Please take note of 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 (see 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: http://<name_or_IP_addresse_of_the_server>:22350/Configuration.html 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. As you can see in Figure 8, the server is not started yet because the checkbox “Run Network Server” is not activated. To activate the server next time the CodeMeter software is started, please select the checkbox as marked in Figure 8. To apply the changes, click the “Apply” button. Overview CodeMeter © PTV AG 9 Set up CodeMeter as dongle server Figure 8: CodeMeter WebAdmin, configuration network Now, the dongle server will be started the next time the CodeMeter software is started. To activate the changes now, restart the CodeMeter software. 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 the bottom right of the desktop. Figure 9: CodeMeter context menu: “Show” A context menu will be displayed (see Figure 9). Click “Show” to open the CodeMeter Control Center. Overview CodeMeter © PTV AG 10 Set up CodeMeter as dongle server Figure 10: CodeMeter Control Center, stop service To stop the CodeMeter software, choose “Process” on the menu bar, then select “Stop CodeMeter Service” (see Figure 10). All buttons in the control center disappear. The “CodeMeter” symbol on the status bar changes its color to grey. The software is now stopped, which can be seen in the status bar on the bottom right of the CodeMeter control center (see Figure 11). Figure 11: CodeMeter control center, service stopped To start the CodeMeter software again, click “Process”. Select the entry “Start CodeMeter Service”, (see Figure 12) Overview CodeMeter © PTV AG 11 Set up CodeMeter as dongle server Figure 12: CodeMeter control center, start service As seen before, the controls of the current window are activated 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 informs you that the CodeMeter has been started (see Figure 13). Figure 13: Overview CodeMeter © PTV AG CodeMeter control center, service started 12 CodeMeter server 4 CodeMeter server This chapter describes the requirements for use of your CodeMeter dongle as a dongle server in your network. 4.1 Conditions As described in chapter 3.3, 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): http://<name_or_IP_addresse_of_the_server>:22350/Configuration.html 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 (see Figure 7), the accessibility check was successful! 4.2 Connecting one CodeMeter dongle The 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 Figure 14). Figure 14: Microsoft Windows, “Autoplay” Please do not cancel this process. 4.3 Connecting several CodeMeter dongles It is possible to plug in several CodeMeter dongles to one server. This is necessary when different Vision Traffic software configurations are in use (e.g. two versions of PTV Visum with different network sizes). For several CodeMeter dongles the small icon on the bottom right of the window will change its status into Overview CodeMeter © PTV AG . 13 CodeMeter server If more than one dongle is plugged into the server, make sure that you have selected the correct dongle (see Figure 15),. Figure 15: 4.4 CodeMeter control center , selection of dongle serial number Starting the Vision Traffic software Now you can start your Vision Traffic 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 occur that the Vision Traffic 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 settings in the CodeMeter WebAdmin application of the PC on which you want to use the Vision Traffic software. It has to be specified, where the CodeMeter software has to search for a valid CodeMeter dongle. Click the “add” button (see Figure 17). Overview CodeMeter © PTV AG 14 CodeMeter server Figure 17: WebAdmin, Setup Server Search List A new dialog is displayed. Enter an IP address or server name (see 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. Then, click “Apply” to activate your changes to the server search list. 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 Vision Traffic software. Overview CodeMeter © PTV AG 15 CodeMeter server Figure 19: WebAdmin, Changed Server Search List As shown in Figure 19, the checkbox “Run Network Server” must not be selected. The CodeMeter software searches exclusively on the servers in the server search list for a valid CodeMeter dongle. You may now start the Vision Traffic software. The license window provides more information about the license and the dongle used, (see Figure 20). Figure 20: Overview CodeMeter © PTV AG Example PTV Visum license overview 16 CodeMeter server 4.5 Reliable check of connection between Client and Server The following chapter describes how the connection between the client and your license server can be checked. There are two preconditions: The license server where the CodeMeter software has been started as service must be accessible over the computer network. In addition, the server and the client have to be in the same subnet. Otherwise, the server name or its IP address has to be added to the server search list on the client side. If all preconditions have been checked, proceed as follows. Right click on the CodeMeter icon on the status bar and select WebAdmin. In the following dialog click ”Home”, and then on the green button with the “Host Name” of the computer. This opens a second small Browser windows (see Figure 21). Figure 21: Result of Server search This window contains a drop down box with all CodeMeter license servers available in the network. By default, your own computer, localhost, is selected. In addition, the list should include the license servers which have been added to your server search list. If available, the list shows computer name and IP address of all availabe license servers. Select your license server in the list of available servers and click the “Select” button. This will close the small windows and you will return to the WebAdmin user interface. Check the host name in the menu “Home” of this WebAdmin and the web address shown in the Browser’s address field. The host name should be the one of your license server. And the web address should be the name or IP address of your license server. If this is correct, you have successfully and reliably checked the connection between your client and the license server. This ensures that the PTV software will be able to establish the connection as well. Overview CodeMeter © PTV AG 17 Error handling 5 Error handling Before and while working with your software protected by a dongle, you may encounter some error messages . The following sections list errors and their solutions when working with a CodeMeter dongle. 5.1 “Licence key not found” If the error message as shown in Figure 16 appears while starting your software, a valid CodeMeter dongle could not be found. Please check the following issues and correct as required: 5.2 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 corresponding CodeMeter symbol in the status bar on the 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 to permit access to port 22350 (this can be checked by typing in the corresponding URL into your web browser, (see chapter 3.3))? CodeMeter error If you are using your Vision Traffic software as network version, i.e. the CodeMeter dongle is not plugged into your local machine, you have to make sure that the connection to the CodeMeter dongle is never interrupted. If the connection is interrupted, an error message is displayed, (see Fehler! Verweisquelle konnte nicht gefunden werden.). 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 Overview CodeMeter © PTV AG 18 Error handling Figure 22: CodeMeter error The CodeMeter error message will be followed by another error message shown in Figure 23. Please check whether the connection has been lost and try to reconnect. Figure 23: CodeMeter, execution error Please press the “Retry” button in any case to reconnect! Otherwise, the software will be shut down and you will not be able to save your work. Check the possible reasons listed above and correct as required to reconnect. Alternatively, you can proceed as follows in order to continue working with your 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 (see chapter 4.4)). If you have plugged the CodeMeter dongle into your or another machine please click the “Retry” Button. Now, the CodeMeter software is searching for a valid CodeMeter dongle again. In case of success, you can continue working with your Vision Traffic software. Otherwise, the error message shown in Figure 23 appears again. Overview CodeMeter © PTV AG 19 Remote programming of the dongle 6 Remote programming of the dongle 6.1 Creating a context file To exchange the key file of your software licence, 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 licence overview and the serial number. Please start the CodeMeter control center (see chapter 3.3, Figure 12). Then, navigate to the Licence tab as shown in Figure 24. Please note that the CodeMeter dongle must be plugged into your local machine. Click the “License Update” button, a new window with the ‘CmFAS Assistant’ will open up (see Figure 25). Click “Next”. Figure 24: 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 26). On page 3, select option “Extend existing license” and then “Next” (see Figure 27). On the next page, keep the selected entry ‘PTV AG (100321)’ and click “Next” (see Figure 28). Overview CodeMeter © PTV AG 20 Remote programming of the dongle Overview CodeMeter © PTV AG Figure 25: ‚CmFAS Assistent‘, page 1 Figure 26: ‚CmFAS Assistent‘, page 2 Figure 27: ‚CmFAS Assistent‘, page 3 21 Remote programming of the dongle Figure 28: ‘CmFAS Assistant’, page 4 In order to save the context file, click the “Commit” button (see Figure 29). You may change the directory in which you save the file. Please do not change the name of the file! (ex. 11059512.WibuCmRaC). The extension ‘WibuCmRaC’ identifies the file as a context file. Figure 29: ‚CmFAS Assistant’, page 5 Figure 30: ‚CmFAS Assistant’, page 6 Go to the directory as shown in Figure 29 and send us the context file you created with the file extension WiBuCmRaC. Overview CodeMeter © PTV AG 22 Remote programming of the dongle 6.2 Applying a context update file 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 (see chapter 3.3, Figure 12). Then, click the License Update button, a dialog is shown (see Figure 31). Click “Next”. The CodeMeter dongle must be plugged into your local machine. Then, as shown in Figure 32, select the Import Licence Update radio button and click “Next”. Now, select the CodeMeter update file (with file extension WiBuCmRaU), which you received (see Figure 33). Then click “Commit” to apply the update to the dongle. Figure 34 indicates that this process has been successful. Overview CodeMeter © PTV AG Figure 31: ‚CmFAS Assistent‘, page 1 Figure 32: ‚CmFAS Assistent‘, page 2 23 Remote programming of the dongle 6.3 Figure 33: ‚CmFAS Assistent‘, page 3 Figure 34: ‚CmFAS Assistent‘, page 4 Update the firmware of the CodeMeter dongle 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 the context update file provided. The process to update the firmware requires a valid internet connection. In some cases, this requires to have configured the proxy settings of the CodeMeter Runtime Kit. Check the proxy settings under: http://localhost:22350/ConfigProxy.html To do so, please start the CodeMeter control center (Figure 35). In tab “Licence”, click the icon” “ on the right side of the control center. Please note that the CodeMeter dongle must be plugged into your local machine. This may require the password ‘CodeMeter’. Overview CodeMeter © PTV AG 24 Remote programming of the dongle Figure 35: CodeMeter control center Do not unplug the dongle until the update process has been finished (see Figure 36). Figure 36: Do not unplug CodeMeter At the end of the update process a message will be displayed. Figure 37 shows the message if the update has been successful. Otherwise, an error message is shown. Figure 37: 6.4 Firmware successfully updated Proxy Settings In some companies and organizations, your computer is able to connect to the internet but this is not a direct connection but it is redirected through a proxy. The CodeMeter Runtime Kit requires this information as well. There are two ways to do this: You can try to find out the correct proxy settings automatically, or You can change the proxy configuration manually Automatically you can identify the proxy settings: Go to Start -> All programs -> CodeMeter -> Tools -> CodeMeter Command Prompt. This Overview CodeMeter © PTV AG 25 Remote programming of the dongle opens the MS DOS box. Please insert the command: cmu32 --detect-proxy --write --force Hit the Enter key to confirm the command. The output looks like this: Figure 38: Output of Command Prompt Change the proxy settings manually: Instead of working with the Command Prompt, you can do the required changes directly in the WebAdmin user interface under menu “Configuration”, sub menu “Proxy”. Your IT department will help you to get all required information. See the following link: http://localhost:22350/ConfigProxy.html Overview CodeMeter © PTV AG 26 Support 7 Support This chapter deals with the two support possibilities for Vision Traffic customers who are using CodeMeter dongles. 7.1 Direct Support Please feel free to contact our 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 (see chapter 6.3). 3. Then, create the “context file” of the dongle under consideration (see chapter 6.1). 4. Finally, we need the CmDust report. To create this report go to the start menu. Navigate to “All programs” and then “CodeMeter”. Under the ‘CodeMeter’ entry, gclick “Tools”, and then the “CmDust” entry. This will create the report file ‘CmDustResult.log’. In case of the use of a network dongle, please provide CmDust reports of both, the server and all clients for which problems with the CodeMeter dongle are encountered. 5. For an efficient support, please send us also the installation log files from the installation of the Vision Traffic software named ‘Setup Log **.txt’ which can be found in the directory: ‘%tmp%’ (enter without ‘ in address line of the Windows Explorer) Please send us all these files including your PTV customer ID to the e-mail address customerservice@vision.ptvgroup.com 7.2 Indirect Support 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.de Phone: +49 721-93172-15 Overview CodeMeter © PTV AG 27 PTV AG Haid-und-Neu-Straße 15 76131 Karlsruhe Germany Telefon +49 (0) 721 9651-300 Fax +49 (0) 721 9651-562 E-Mail: info@vision.ptvgroup.com www.ptvgroup.com www.vision-traffic.ptvgroup.com