3.5. virtual ECUs for automotive control development. Silver Installation Guide

Transcription

1 3.5 virtual ECUs for automotive control development Copyright QTronic GmbH Silver Guide QTronic GmbH Alt-Moabit 92 D Berlin

2

3 Table of Contents Using a Silver license... 2 Computer-bound licenses... 2 Dongle-bound licenses... 5 Network licenses... 8 License options Troubleshooting a license problem Running CodeMeter as a service Checking active licenses from command line Silver Runtime licenses Updating to a new version of Silver Installing a C/C++ compiler Installing prerequisite software Installing Silver from command line ii

4 Chapter 1. This manual will guide you through the installation of the following QTronic software products: Silver - the full product version Silver Runtime - runtime license for Silver modules or Silver-generated modules QTronic Network License Server - required to serve network licenses for the QTronic products. In general, the QTronic products can run with three types of licenses: Computer-bound licenses Dongle-bound licenses Network licenses (floating licenses and also "borrowable" licenses). After installation you can do the first steps by: browsing the user guide using: Help User guide starting delivered examples using: File Open demo projects watching the introductory videos from our web page: Silver has been tested on Windows Vista, 7, 8, 8.1 and 10. In order to install and run Silver on your computer you must have obtained a valid license from QTronic or its distributors. Please store the license ID that you will be using: it will be required for the interaction with our license servers and for the interaction with the QTronic product support. You can download the latest installers from if you already have a valid license ID. Start the installer - the setup program will guide you through the installation. Figure 1.1. The Silver installer 1

5 does not require administrator rights, unless you want to make the installation available for all users of your computer, or the computer configuration denies read and write access to removable disks and you have a dongle-bound license (see Running CodeMeter as a service), or some prerequisite software is missing (see Installing prerequisite software). The Silver installer has two side effects on the environment variables of your computer. Firstly, it defines the environment variable SILVER_HOME that contains the full path to your Silver installation. Secondly, it adds the directory %SILVER_HOME%/bin to your PATH variable. The latter may fail, because Windows limits the size of the value of the PATH variable to 1023 or 2047, depending on the service pack your are using. If there is not enough space left to add to the PATH variable, the Silver installer pops up a warning message asking you to cleanup your PATH variable and to add %SILVER_HOME%/bin manually. When selecting the components to be installed, you have to first choose between the full product option and the Silver Runtime product option - see Figure Using a Silver license At the end of the installation process a window with the license management dialog will be shown. This allows you to view, update or acquire a license from the license server. If you already have a valid license (for instance: you are using a computer-bounded license from a previous installation, or you already have a dongle with a valid license, or you are using a network license), you can close this dialog. Even after installation you can at any time open the license management dialog from the main application menu using: Help Manage licenses... Depending on the type of license you have acquired, you are expected to use one of the three available tabs in the dialog: computer-bound license - this type of license is bound to a single machine and does not require the use of a dongle dongle-bound license - this type of license is written on a dongle (CodeMeter stick) and can be used on any machine in which the dongle is plugged in network license - the licenses are managed by a local server. This option allows the concurrent use of licenses for a specified number of clients. It also allows for clients to borrow a license for a limited time and use the borrowed license even when their machine is disconnected from the network where the license server resides. Please read the section corresponding to the type of license you want to obtain or update. If the wrong tab was selected by default, please switch to the other one before proceeding. Computer-bound licenses Obtaining a computer-bound license The tab for obtaining a computer-bound license file will be similar to the image below. 2

6 Figure 1.2. Obtaining a computer-bound license If you already have a computer-bound license (e.g., from a previous installation), it is possible that a license ID will already be filled in. Otherwise, the license ID field will be empty. Please fill in your license ID or, if it is already filled in, check that the one already filled in matches the one you want to install or update. The other fields of the dialog are already prepared for use with default values and usually do not require editing. For special cases, you may modify them if needed. If you do not have a direct internet connection, you will need to specify a proxy server to use, either by typing an address (such as or by choosing one from the drop-down list. If you do not know the address of your proxy server, check the settings of other internet tools installed on your computer. For example, in Internet Explorer 7 & 8, the proxy servers are configured using Tools Internet options Connections LAN settings. Press the Get License button after completing these steps. Silver will try to connect via internet to the QTronic license server and retrieve your new license file. If successful, it will save it in the install directory, if possible, %SILVER_HOME%\Silver.lic, and also in %APPDATA%\QTronic\Silver\Silver.lic. The license file you obtain is bound to the hardware profile of the PC or laptop that runs the installer. In this way, your Silver installation is bound to your PC or laptop. If obtaining a license fails, you will be informed about this and about the cause of the failure. If this happens, you may proceed in one of three ways: in case it is possible to fix the cause of the error, it is recommended that you do so and retry obtaining a license by pressing the Get License button. in case the activation fails due to firewall-related restrictions which prevent Silver from reaching the QTronic licensing server, we offer the option of obtaining a license manually, via a web browser. Please skip to the next section for instructions on how you can do that. if all methods of obtaining a license fail, please write to support@qtronic.de, mention your license ID and attach the hardware key file (by default, %SILVER_HOME%\hwkey.txt). You will then receive your license file by . The second and third option can be performed from any PC or laptop, not necessarily the one on which you installed Silver. Of course, the hardware key file still needs to be the one generated on the PC or laptop on which you want to use the license. 3

7 Manual activation of a computer-bound license To obtain the license file from QTronic manually, perform the following steps In the dialog, click on the link "manual activation" or manually open the web page activation.qtronic.de/activation_page in your browser. On the page, enter your license ID and upload the hardware key. The hardware key is a small text file called hwkey.txt. This file is generated by the Silver installer and is located in the Silver installation directory (%SILVER_HOME%). Push the Activate button. Your license is checked out from the QTronic license server. If successful, a text editor with the content of your license file appears. Copy the content of that editor into a text file named Silver.lic and copy the file to either the Silver installation directory or%appdata %\QTronic\Silver\. You should now be able to run Silver and to use all the features listed in your license file. Figure 1.3. The activation page for computer-bound licenses If you cannot access the activation page or if checking out the license file fails, write to support@qtronic.de. This mail should contain your license ID and have the file hwkey.txt as an attachment. You will then receive your license file by . Updating a computer-bound license Silver helps you to update your computer-bound license via the internet. This is for example required after: your license has expired, and you have purchased a new license to continue work with your current Silver installation. you have purchased additional Silver options, and want to activate these options in your current Silver installation. 4

8 you have modified your computer that much that Silver refuses to work (remember that your license is bound to a specific hardware). Contact QTronic in this case and ask to reset the hardware profile associated with your license ID. The license update process just replaces the files %SILVER_HOME%\Silver.lic and %APPDATA%\QTronic\Silver\Silver.lic. Your Silver installation itself is not updated in any way. Use Help Manage licenses... to start the License Management dialog. This is the same dialog you have seen during installation. Please refer to the Obtaining a computer-bound license for instructions how to use it. Dongle-bound licenses Obtaining a dongle-bound license The tab for obtaining a dongle-bound license file will be similar to the image below. Figure 1.4. Obtaining a dongle-bound license If you already have an existing dongle license, it is possible that a license ID will already be filled in. Otherwise, the license ID field will be empty. You should have received a license ID when you purchased Silver; please fill it in or - if it is already filled in - check that the one already filled in matches the one you have received. If you do not have a direct internet connection, you will need to specify a proxy server to use, either by typing an address (such as or by choosing one from the dropdown list. If you do not know the address of your proxy server, check the settings of other internet tools installed on your computer. For example, in Internet Explorer 7 & 8, the proxy servers are configured using Tools Internet options Connections LAN settings. Press the Get License button after completing these steps. Silver will try to connect via internet to the QTronic license server and retrieve your new license. If successful, it will write it to your dongle. 5

9 Since the license is on the dongle and does not include any information about the hardware profile of the PC or laptop from which it was obtained, it is usable with on any other PC or laptop as well. If obtaining a license fails, you will be informed about this and about the cause of the failure. If this happens, you may proceed in one of three ways: in case it is possible to fix the cause of the error, it is recommended that you do so and retry obtaining a license by pressing the Get License button. To this end, if you need to make any adjustments to the plugged-in dongles, please press the Refresh button after you do this in order for Silver to reread the dongle information. in case the activation fails due to firewall-related restrictions which prevent Silver from reaching the QTronic licensing server, we offer the option of obtaining a license manually, via a web browser. Please skip to the next section for instructions on how you can do that. if all methods of obtaining a license fail, please write to support@qtronic.de, mention your license ID and attach the CodeMeter Remote Context file (to obtain this file, please follow the first step for manual activation, i.e., click on the link "manual activation" in the dialog, and obtain the path to the file on your system from the browser that opens). You will then receive a so-called CodeMeter Remote Update file by . This file needs to be "applied" to the stick. To do so, when you have the file, open the License Management dialog ( Help Manage licenses... ), click on the "manual activation" link, ignore (close) the web browser that is opened, copy/paste the contents of the file into the text field that appears (see Figure 1.5) and press Apply Update. These options can be performed from any PC or laptop, not necessarily the one on which you installed Silver, as long as you plug the dongle into that PC or laptop. Manual activation of a license To obtain the dongle license from QTronic manually, perform the following steps In the dialog, click on the link "manual activation". At this point, the dialog will change to show a single text editor as in the image below and your default web browser will be started. Do not close the dialog, you will need to use it again in the final steps. Figure 1.5. The dialog, ready to apply a CodeMeter Remote Update file On the web page that opens in the browser, enter your license ID and follow the instructions there to upload the CodeMeter Remote Context file and the CodeMeter info file. 6

10 Push the Get License button. Your license is checked out from the QTronic license server and written in a form that can be "applied" to the dongle, called a CodeMeter Remote Update file. If successful, a text editor with the content of this Remote Update file appears. Copy/paste the contents of the browser text editor (i.e., the Remote Update file) into the dialog text editor and press Apply Update. You should now be able to run Silver and to use all the features listed in your dongle license. Figure 1.6. The activation page for dongle-bound licenses If you cannot access the activation page or if you fail to obtain a CodeMeter Remote Update file, write to support@qtronic.de. This mail should contain your license ID and have the CodeMeter Remote Context file as an attachment (to obtain this file, please follow the first step for manual activation, i.e., click on the link "manual activation" in the dialog, and obtain the path to the file on your system from the browser that opens). You will then receive a so-called CodeMeter Remote Update file by . This file needs to be "applied" to the stick. To do so, when you have the file, open the License Management dialog ( Help Manage licenses... ), click on the "manual activation" link, ignore (close) the web browser that is opened, copy/paste the contents of the file into the text field that appears in the dialog (seefigure 1.5) and press Apply Update. 7

11 Updating a dongle-bound license Silver helps you to update your computer-bound license via the internet. This is for example required after: your license has expired, and you have purchased a new license to continue work with your current Silver installation. you have purchased additional Silver options, and want to activate these options in your current Silver installation. For dongle-bound license, the license update process replaces the information on the dongle. Your Silver installation itself is not updated in any way. Use Help Manage licenses... to start the License Management dialog. This is the same dialog you have seen during installation. Please refer to the Obtaining a dongle-bound license for instructions how to use it. Network licenses In case of network licenses, the license is centrally provided by a local network license server and allows the concurrent use of licenses for a specified number of clients. It also allows for clients to borrow a license for a limited time and to use the borrowed license even when their computer is disconnected from the network where the license server resides. Figure 1.7. Usage of network licenses There are 2 types of licenses supported by the network license server: floating: Silver automatically acquires and releases floating licenses if a valid network license configuration is found (e.g. opening Silver acquires a floating license from the pool of available licenses, while closing Silver will release the acquired license). The client machine must not leave the network where the license server resides while using the license, otherwise the license is automatically released. borrowed: Silver does NOT automatically acquire or release such a license. The client needs to specify a valid network license configuration and then to specify a period of time for which they 8

12 need the borrowed license. The borrowed license (if successfully acquired) will be available even when the client will disconnect from the network where the license server resides. Both types of licenses require the installation of a network license server in the customer's local network. As the network licenses concept was non-existent before the release of version 3.2, make sure all your Silver's project modules have been re-compiled using the 3.2 (or newer) libraries. Older libraries know to detect only the computer-bound and dongle-bound licenses. Installing and updating a Network License Server A local network license server is installed at the customer's site and will provide licenses for all the PC clients within his network. The customer licenses are in a first step acquired from the remote QTronic license server via Internet. These are then installed in the customer's local license server, and then distributed within his local network. Here are the steps necessary to install and configure the network license server: 1. Download QTronicNetworkLicenseServerSetup.exe from 2. Install the QTronicNetworkLicenseServerSetup.exe while having Administrator privileges. These privileges are required for installing CodeMeter.exe as a service, where CodeMeter.exe is the actual software that enables our license management (see CodeMeter.exe needs to run as a service as the licenses that it gets from the QTronic License Server are not stored on a physical dongle but on a software dongle. The creation of a software dongle means that CodeMeter.exe will hide parts of the license everywhere on the System, which requires the rights to write in those places, hence we need to have the rights to install it as a service. 3. Open the "QTronic Network License Server Management" and edit the "License ID" field. 4. Press the "Get a new license" button to receive the network license from activation.qtronic.de. This operation requires internet access. If you do not have a direct internet connection, you will need to specify a proxy server to use, either by typing an address (such as or by choosing one from the drop-down list. If you do not know the address of your proxy server, check the settings of other internet tools installed on your computer. For example, in Internet Explorer 7 & 8, the proxy servers are configured using Tools Internet options Connections LAN settings. 9

13 Figure 1.8. Installing a license on a network license server You can install more than one license. All the installed licenses will be accessible to all computers from your local network. The licensing software uses TCP/IP network protocol for communication and the port is This network port is registered at IANA (Internet Assigned Numbers Authority) and uniquely assigned for the CodeMeter communication. Make sure your firewall or any other software you might have installed does not block this port, and that this port is available for CodeMeter. After successfully installing a license, the license will appear in the "Current licenses" section of the "QTronic Network License Server Management" application. There you will be able to see how many clients can use the license, how many are already using it, and what options does the license enable. 10

14 Figure 1.9. Browsing the currently installed network licenses A network license has the following properties: number of clients: the maximum number of clients that can use the license in either floating or borrow mode; number of borrowable licenses: the maximum number of clients that can borrow a license. This value is less or equal to the number of clients. A client can always use a license in floating mode, but it can borrow a license only if the number of clients has not reached the maximum allowed and if the number of already borrowed licenses has not reached the maximum allowed. maximum borrow duration: the maximum period of time for which a license can be borrowed. After this period of time elapses, the borrowed license is returned to the pool of available licenses of the network license server. In order to see the current users for a specific network license, select the network license from the list of Current licenses and then click the Show current license users button. 11

15 Figure Viewing the current network license users In order to update a network license (the license has expired, or you have purchased additional license options), select the network license from the list of Current licenses and then click the Update license button. As in the case of getting a new license, the update of a license requires internet access: the local license server needs to contact the QTronic license server ( in order to obtain the latest license details. Manual activation of a network license If your server does not have internet access you can still activate your license by following these steps: step 0: you let QTronic know that you require a manual license activation; step 1: we send you an empty software dongle file; step 2: you import the empty software dongle file; step 3: you create a license request file, and then you send us this file; step 4: we generate a license file and we send it back to you; step 5: you import the license file. Steps from 3 to 5 will also be used when you need to update an already activated license. Details for step 2, importing of an empty software dongle file: after installing the QTronic Network License Server Management application on your server, go to the following directory: %QTRONIC_NETWORK_LICENSE_SERVER_HOME%/common/exttools/CodeMeter/bin, and there open the CodeMeterCC.exe application; in the window that opens (the title of the window is CodeMeter Control Center), select the License tab, and drag-and-drop the.wbb file you got from QTronic; a dongle named Empty virtual QTronic dongle should appear in the list of dongles. Details for step 3, creation of a license request file: 12

16 in the CodeMeter Control Center, select the Empty virtual QTronic dongle (or the actual dongle in case this is an update and not an activation), and click on the Activate License (or License Update) button (bottom central of the window); in the dialog that appears click Next, then select Create license request, click Next, select a destination file and click Commit. Details for step 5, importing the license file: in the CodeMeter Control Center, select the Empty virtual QTronic dongle (or the actual dongle in case this is an update and not an activation), and click on the Activate License (or License Update) button (bottom central of the window); in the dialog that appears click Next, select Import license update, click Next, select the.wibucmrau file that you received from QTronic, and then click Commit Install client-side licenses Open Silver or TestWeaver installed on the client computer and navigate to Help Manage licenses... to start the License Management dialog. Then select the Network-based tab and configure the local network server address and the usable license IDs. After successfully configuring the previous steps, the available network licenses should appear in the bottom-right table, and you should be able to start using the floating or borrowable licenses. 1. Edit the local network server address (IP or name) configured in the previous help section (see Installing and updating a Network License Server). This is necessary in order to tell the client application how to find your local network server. Figure Edit the network license server address Press the Set button in order for the edited address to be saved. Figure Set the network license server address 2. Now you need to add a license ID. This is a required step as a network license server might serve multiple network licenses to multiple teams and those teams might not want their licenses to be used by others. Figure Add a new license ID 13

17 Add the license ID in the Add license dialog that appears and then click Add. The license ID should then appear in the Use only these licenses list. Figure Edit the license ID 3. After completing the above steps, the network license should appear in the right side table called Network licenses. There you can start exploring the available license options (see License options for more details). Figure View the available network licenses If the configured license does not appear in the Network licenses table, click Refresh, and if that does not make the network license appear please consult the troubleshooting section (see Troubleshooting a license problem). Using a floating license Floating licenses are acquired on demand and released automatically when the client application is closed. They are acquired only if a valid network license configuration is found and if other licensing options have been exhausted (computer-bound or dongle licenses). After configuring a network license (see Install client-side licenses), the floating license is not acquired right away; our software searches for licenses only when they are needed as different license types are needed at different points in time: when starting Silver a Silver license is needed, and later during run it might be that you need a HIL Support license as well. When a client application searches for a valid license, it first tries to get a local license (computer-bound, dongle or an already borrowed license), and only afterwards it will try to acquire a floating license. 14

18 Silver can also try to get a new network license if the currently used license is maxed-out: the maximum number of processes has been reached (the default is 4; see License options for more details). In order to allow the usage of a new instance we try to acquire an additional floating license. There can be only one floating license acquired on a computer for a specific license ID, so the previously presented use-case works only if the maxed-out license is a local one (computer-bound, dongle or an already borrowed license). You can check if a floating license is in use by either going to: Help Show licenses, or Help Manage licenses..., select the Network-based tab from the top tab folder, and then the Floating tab from the bottom tab folder. Here is how a floating license looks like in the License Management dialog: Figure A floating license is in use The client machine must not leave the network where the license server resides while using the license, otherwise the license is automatically released. Also, the release of an acquired floating license is also done when the client application is closed. Using a borrowable license The necessity of borrowing a license appears when the client needs to move away from the local network but still needs to have the client application running. A prerequisite for borrowing is a valid network license configuration. The borrowing is achieved by creating a software dongle (as opposed to a physical one) on the client's computer. This virtual dongle is created only when the client is borrowing the license for the first time. Afterwards, the subsequent borrow operations performed from the same machine and for the same network license will re-use the afore created virtual dongle. In order for CodeMeter to be able to create your software, dongle, CodeMeter.exe needs to be run as a service. CodeMeter.exe needs Administrative rights as it hides parts of the software dongle everywhere in the System, which requires the rights to write in these places. See Running CodeMeter as a service for more details about getting CodeMeter.exe run as a service. Creating or updating the software dongle requires an active internet connection as the create and update operations can be done only via the QTronic License Server ( The 15

19 creation is done only once, as discussed in the previous paragraph, but the update decision is taken at every borrow operation based on the differences between the local software dongle license and the network license present on the network license server. Though the borrow cannot be done without a successful software dongle creation, but the borrow can continue without the software dongle update. That means that the active network connection is optional after the software dongle was created. If the update cannot be done, the client will borrow an older version of the license, possibly without having its latest options applied (such as, newly added license components, changed expiration dates, etc.). The number of software dongle creations is limited for each license, so please do not delete these dongles from your system. You could do that from the CodeMeter Control Central for example, or by reinstalling your operating system. The following steps are required in order to borrow a network license. We'll presume that you already configured your network license server, so open your application and then navigate to Help Manage licenses... to start the License Management dialog. Then select the Network-based tab and the Borrow tab from the bottom tab folder. In case CodeMeter.exe was not installed as a service, then you will get a tooltip alerting you of this situation. Click "Install CodeMeter.exe as a service (needs admin rights)". Figure Install CodeMeter.exe as a service After installing CodeMeter.exe as a service, the previous "Install" button should become disabled and its text should change to "CodeMeter.exe is running as a service". Browse the correct network license from the right table (there can be multiple licenses displayed in there), and make sure it has free borrowable licenses. Then click the Borrow button. 16

20 Figure Borrow license Each borrowed license has a maximum borrow duration which can be customised at the borrow time, where the customised borrow time can be only a smaller value than that maximum set on the license server. Within this borrow period, you can return the license to the server whenever you want to. It might be the case that you get the license for 2 days, but later you realise that you won't come to work tomorrow and decide to return it so that other colleagues of yours can use the license. If you do not return the license back to the server within the borrow period, the license is returned automatically at the end of the borrowed duration. The following dialog appears just after pressing the Borrow button. Figure Customising the borrow period and notification The above dialog also lets you customise a notification for when the borrow expires. It might be helpful in situations like when you get close to the expiration time and you know you need the license for a 17

21 few more days and you would like to secure it now, so you do not end up with an expired borrowed license and no possibility of getting a new one as somebody else from your team took it. After successfully borrowing a license, that license will appear in the left table called "Local licenses". You will be able to see the borrow end date as well. Also, the right side table called "Network licenses" should show a refreshed network license where the number of available licenses was decreased by one (the number of available licenses varies all the time as there usually are multiple clients using the license at the same time). You can see the actual license users by clicking on the Find all users that are currently locking a network license button. Figure A borrowed license You can select the borrowed license from the left table at any time and click the borrowed license back to the available network licenses pool. Return in order to put If you chose to be notified prior to borrow expiration, a taskbar notification icon and a balloon tooltip will appear at the customised time before the actual expiration. Figure Borrowed license notification License options When you purchase a QTronic license, you actually purchase a customized subset of QTronic license options: What QTronic software components are licensed for you: Silver, TestWeaver, HiL Support, Simulink export, etc. Can it run on a Terminal Server? Can it run in a virtual machine? How many instances of an application can I run on a client computer? 18

22 After acquiring a license on your computer, you can see its options by going to Help Show licenses. maximum processes - the number of application instances that can run in parallel with the current license in the current user session. The next one you open after hitting this maximum will not get a valid license and will not be able to run. maximum concurrent user sessions - the number of users that can run the application in parallel with the current license on the same machine. Terminal Server - tells the user if he can run the application with the current license within a Terminal Server (Terminal Services provides the ability to host multiple, simultaneous client sessions on a Windows Server). virtualization - tells the user if he can run the application with the current license in a Virtual Machine. Troubleshooting a license problem Symptom: computer-bound license was not found... Symptom: dongle-bound license was not found... Symptom: network-based license was not found... Symptom: your anti-virus software has blocked the QTronic Licensor Symptom: right clicking Windows explorer in order to create a New Folder crashes with: WibuShellExt64: fatal error W86 - Undocumented/internal (6) Symptom: computer-bound license was not found Resolution: make sure the Silver.lic file is present in one of the following locations: %SILVER_HOME or %APPDATA%\QTronic\Silver. If the file is not there, update the license: see Obtaining a computer-bound license. Notes: use Help Show licenses to see all the discovered licenses by Silver. Symptom: dongle-bound license was not found Resolution: allow up to 1 minute for Silver to refresh its available licenses. Make sure the dongle is plugged into the machine and that you can see it in the list presented by the CodeMeter Control Center application: %SILVER_HOME%\common\ext-tools\CodeMeter\bin\CodeMeterCC.exe. Write the license to dongle if not done yet; see Obtaining a dongle-bound license. Open Windows Task Manager and end processes QTronic Licensor v1.5.exe and CodeMeter.exe as there might be an internal issue in either one of those two applications. Notes: use Help Show licenses to see all the discovered licenses by Silver. Symptom: network-based license was not found Resolution: make sure that the correct network server address was entered and Set. Make sure that the license ID has been added to the list of usable license IDs (Use only these licenses). Make sure that the network server is accessible (e.g. ping) and the local port is available for CodeMeter to use (e.g. check firewall, AntiVirus, open in a browser, telnet to localhost on port should work). 19

23 Are you using the borrow license functionality? Make sure that CodeMeter.exe is running as a service; see Running CodeMeter as a service. Make sure all your Silver project's modules have been re-compiled using the 3.2 (or newer) libraries. The network licenses concept was non-existent before the release of version 3.2. Open Windows Task Manager and end processes QTronic Licensor v1.5.exe and CodeMeter.exe as there might be an internal issue in either one of those two applications. Notes: use Help Manage licenses... to start the License Management dialog, and then navigate to the Network-based tab, and click on Refresh to see if the resolution worked. Symptom: your anti-virus software has blocked the QTronic Licensor Resolution: there are some anti-virus programs that do not like the way we start our QTronic Licensor. If this is the case, configure your anti-virus software to allow the execution of "QTronic Licensor v1.5.exe". Some of the programs that seldom do that are Microsoft's Security Essentials and Windows Defender (starting from Windows 8). Symptom: right clicking Windows explorer in order to create a New Folder crashes with: WibuShellExt64: fatal error W86 - Undocumented/internal (6) Resolution: this can happen when a Wibu product was incorrectly installed or uninstalled on your PC. Here are a few steps that might solve your issue: start Windows' Registry Editor (run regedit in a Command Prompt) and delete key HKEY_CLASSES_ROOT\.wbc; then navigate to C:\Program Files\WIBU-SYSTEMS\System (if it exists), right click on WibuShellExtRepair.cmd and select Run as administrator. Notes: this is not an issue created by a QTronic installation, as QTronic is not installing Wibu products (QTronic is shipping Wibu's CodeMeter application by simply copying its necessary components). If none of the above resolution worked, please contact QTronic and send us the following files: %LOCALAPPDATA%\QTronic\Silver\log\Silver.log %LOCALAPPDATA%\QTronic\common\log\license.log Running CodeMeter as a service In the following cases you will need to run CodeMeter.exe as a service: your computer configuration denies read and write access to removable disks and you have a dongle-bound license, or you want to borrow a license from your local network license server. Here are some ways in which you can get CodeMeter.exe to run as a service: while installing our application make sure you check the "Install CodeMeter as a service (requires admin privileges)" option, or after installation, open our application and go to Help Manage licenses... to start the License Management dialog, and then navigate to the Network-based tab, and click on "Install CodeMeter.exe as a service (needs admin rights)", or 20

24 run the following command using administrator rights: codemeter-service-installer.exe, or %SILVER_HOME%/common/bin/ run the following command using administrator rights: tools/codemeter/bin/codemeter.exe -I %SILVER_HOME%/common/ext- Checking active licenses from command line It is possible to check available (active) licenses for selected components of Silver from command line, i.e. without opening Silver's GUI. This functionality may be used, for instance, in automated build process or within test scripts. License information will be printed to the standard output (stdout) and respective exit code value will be set. To run license check from command line, please use command: checksilverlicense.bat {component_name} where component_name string, which describes licensed component to be checked, e.g. "Silver", "Simulink Export Tool", "C Export Tool", etc. (do not forget quotation marks, if the component name contains any whitespaces), For example, to check if your license enables usage of "C Export Tool", you may call: checksilverlicense.bat "C Standalone Export" If the respective license option is active return code will be set to 0, otherwise to 1. To check error code in Windows command line you may call echo Exit Code is %errorlevel% or use within BAT off checksilverlicense.bat... if errorlevel 1 ( echo Failure, License missing... exit /b %errorlevel% ) Silver Runtime licenses The Silver Runtime installer is included in the Silver installer. On the "Select Components" page select the "Silver Runtime" component. Silver Runtime allows the execution of Silver generated artifacts, for instance virtual ECUs exported as S-functions or FMUs, without a local Silver installation. Installing Silver Runtime will actually deploy the QTronic License Manager on your machine, creating an environment for adding, updating and checking your QTronic licenses. Normally this is automatically deployed with any Silver installation, but when the full Silver functionality is not required, opting for just a Silver Runtime license will save you money. 21

25 Figure Silver Runtime installation After installing the Silver Runtime, start the Silver Runtime from the shortcut available on your Desktop or Start Menu (if selected during installation), or by running %SILVER_RUNTIME_LICENSE_HOME%\bin\runtime-license-manager.bat. The QTronic License Manager window will start. This allows you to manage your licenses as described in Using a Silver license. The Silver Runtime also installs a CodeMeter environment that is required if you are using dongle-bound or the network-based licenses. Updating to a new version of Silver In case you already have an old version of Silver installed on your computer, you can just start the installer of the new version: the installer will automatically detect the previously installed product version and will propose you to uninstall it before the new version will be installed. Uninstallation will not remove your old license. Therefore the new installation can reuse it - and you do not need to (re-)acquire it during the new installation. Installing a C/C++ compiler To create Silver modules, e.g. from a Modelica or a Simulink model, you need to install a C/C++ compiler. Silver currently requires a Microsoft Visual Studio compiler, one of VC 8.0: Visual Studio 2005 VC 9.0: Visual Studio 2008 VC 10.0: Visual Studio 2010 VC 11.0: Visual Studio 2012 VC 12.0: Visual Studio

26 NOTE: Visual Studio 2010 is known to contain bugs, which can lead to errors in Silver modules. Errors are probable to occur when third party libraries are used by linker (.lib files) or during A2L conversion with the use of A2LConvert tool. Therefore it is not recommended to use Visual Studio 2010, if you can choose another version. However, if you must use Visual Studio 2010, do not forget to install Visual Studio 2010 Service Pack 1 (or newer, if available). There is a free version called 'Visual Studio 2005 Express Edition' available from You must also install the 'Microsoft Platform SDK' (PSDK), available from the same location. The Platform SDK contains libraries and header files such as Windows.h needed to develop Windows-based applications. requires administrator rights. After installation of the PSDK and the Express Edition 2005, you need to configure your Express Edition such that it knows about the PSDK. Search the internet for hints on how to do this. You may also use the free 'Visual Studio 2008 Express Edition' available from Unlike Visual C Express, Visual C Express ships with the Microsoft Platform SDK, also known as the Win32 SDK. This means you don't have to install the SDK separately, and you don't have to modify any files to get Win32 support. If you have installed more than one compiler, Silver uses the latest compiler version by default. Silver detects the installed compiler by checking for the environment variables VS80COMNTOOLS, VS90COMNTOOLS etc. To force Silver to use an older compiler, undefine the variable of the newer compiler, e.g. by running 'set VS90COMNTOOLS=' before you run the export tool. Installing prerequisite software In order to install Silver, you need the Visual C Redistributable Package. On most machines it is already present and there's no need to do anything; should you need to install it (e.g. the Silver installation fails with error code 14001), you can find the redistributable package plus installation instructions at In order to run Silver you need the NET Framework version 2.0 or newer. Normally this is already installed on most machines, if you don't have it you can install it after completing the Silver installation by running %SILVER_HOME%/common/ext-tools/VS_redist/ dotnetfx_2.0_redist_x86.exe with administrator privileges. Installing Silver from command line If you want to install Silver from command line, you can use the options and syntax from Some options are listed below. The syntax is installer.exe [options]. /VERYSILENT Don't show regular graphical interfaces /SUPPRESSMSGBOXES Suppress message boxes and use the default response /DIR="x:\dirname" Set the default directory for the installation of Silver /DEMOFOLDER="x:\dirname" Set the default directory for the installation of the demos /REMOVEDEMOS Remove previously installed demos (if existing) /INSTALLCMSERVICE Force installation of codemeter as service (for borrowed network licenses), if root privileges are available /DONOTINSTALLCMSERVICE Do not install codemeter as service 23