3.4 Systematic Test Generation, Automation, Coverage

Transcription

1 3.4 Systematic Test Generation, Automation, Coverage Copyright QTronic GmbH Test Weaver Guide QTronic GmbH Alt-Moabit 92 D Berlin

2

3 Table of Contents Updating to a new version of TestWeaver... 3 Using a TestWeaver license... 3 Computer-bound licenses... 4 Dongle-bound licenses... 6 Network licenses License options Troubleshooting a license problem Running CodeMeter as a service Checking active licenses from command line Installing prerequisite software Installing TestWeaver from the command line ii

4 Chapter 1. This manual will guide you through the installation of the following QTronic software products: TestWeaver - the full product version TestWeaver LIGHT - a subset of the full product version, integrated in the TestWeaver installer 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 Demo projects watching the introductory videos from our web page: TestWeaver has been tested on Windows XP, Vista, 7, 8, 8.1 and 10. In order to install and run TestWeaver 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. 1

5 Figure 1.1. The TestWeaver installer When selecting the components to be installed, you have to first choose between the full product option and the LIGHT product option - see. Figure 1.2. TestWeaver LIGHT offers a subset of the functionality of TestWeaver at a fraction of its price: with TestWeaver LIGHT you will be able to replay and browse scenarios generated by TestWeaver. Moreover, you will be able to use classical test automation based on user-defined test scripts. the full product option includes also the automatic generation of scenarios and the automated search for critical situations - not included in the LIGHT product version. 2

6 Figure 1.2. Selecting the application type 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 the section called Running CodeMeter as a service ), or some prerequisite software is missing (see the section called Installing prerequisite software ). The TestWeaver installer has just one side effect on the environment variables of your computer: it defines the environment variable WEAVER_HOME that contains the full path to your TestWeaver installation. Updating to a new version of TestWeaver In case you already have an old version of TestWeaver 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. Using a TestWeaver 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 3

7 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. Figure 1.3. 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. TestWeaver will try to connect via internet to the QTronic license server and retrieve your new license file. If successful, it will save it in 4

8 the install directory, if possible, %WEAVER_HOME%\TestWeaver.lic, and also in %APPDATA% \QTronic\TestWeaver\TestWeaver.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 TestWeaver 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 TestWeaver 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, %WEAVER_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 TestWeaver. 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. 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 TestWeaver installer and is located in the TestWeaver installation directory (%WEAVER_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 TestWeaver.lic and copy the file to either the TestWeaver installation directory or%appdata%\qtronic\testweaver\. You should now be able to run TestWeaver and to use all the features listed in your license file. 5

9 Figure 1.4. The activation page for computer-bound licenses If you cannot access the activation page or if checking out the license file fails, write to 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 TestWeaver 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 TestWeaver installation. you have purchased additional TestWeaver options, and want to activate these options in your current TestWeaver installation. you have modified your computer that much that TestWeaver 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 %WEAVER_HOME%\TestWeaver.lic and %APPDATA%\QTronic\TestWeaver\TestWeaver.lic. Your TestWeaver 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 the section called 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. 6

10 Figure 1.5. 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 TestWeaver; 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. TestWeaver 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. 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 TestWeaver to reread the dongle information. in case the activation fails due to firewall-related restrictions which prevent TestWeaver 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 7

11 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.6) and press Apply Update. These options can be performed from any PC or laptop, not necessarily the one on which you installed TestWeaver, 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.6. 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. 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 TestWeaver and to use all the features listed in your dongle license. 8

12 Figure 1.7. 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.6) and press Apply Update. Updating a dongle-bound license TestWeaver 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 TestWeaver installation. you have purchased additional TestWeaver options, and want to activate these options in your current TestWeaver installation. 9

13 For dongle-bound license, the license update process replaces the information on the dongle. Your TestWeaver 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 the section called 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.8. Usage of network licenses There are 2 types of licenses supported by the network license server: floating: TestWeaver automatically acquires and releases floating licenses if a valid network license configuration is found (e.g. opening TestWeaver acquires a floating license from the pool of available licenses, while closing TestWeaver 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: TestWeaver 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 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 10

14 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. 11

15 Figure 1.9. 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. 12

16 Figure 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. 13

17 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. 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 the section called 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. 14

18 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 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 the section called License options for more details). 15

19 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 the section called 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 the section called 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 TestWeaver a TestWeaver 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. TestWeaver 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 the section called 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: 16

20 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 the section called 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 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. 17

21 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. 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. 18

22 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 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. 19 Return in order to put

23 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? 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 TestWeaver.lic file is present in one of the following locations: %WEAVER_HOME or %APPDATA%\QTronic\TestWeaver. If the file is not there, update the license: see the section called Obtaining a computer-bound license. Notes: use Help Show licenses to see all the discovered licenses by TestWeaver. Symptom: dongle-bound license was not found 20

24 Resolution: allow up to 1 minute for TestWeaver 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: %WEAVER_HOME%\common\ext-tools\CodeMeter\bin\CodeMeterCC.exe. Write the license to dongle if not done yet; see the section called 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 TestWeaver. 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). Are you using the borrow license functionality? Make sure that CodeMeter.exe is running as a service; see the section called 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\TestWeaver\log\TestWeaver.log 21

25 %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 run the following command using administrator rights: codemeter-service-installer.exe, or %WEAVER_HOME%/common/bin/ run the following command using administrator rights: tools/codemeter/bin/codemeter.exe -I %WEAVER_HOME%/common/ext- Checking active licenses from command line It is possible to check available (active) licenses for selected components of TestWeaver from command line, i.e. without opening TestWeaver'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: checktestweaverlicense.bat {component_name} where component_name string, which describes licensed component to be checked, e.g. "TestWeaver", "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: checktestweaverlicense.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 checktestweaverlicense.bat... if errorlevel 1 ( echo Failure, License missing... exit /b %errorlevel% ) 22

26 Installing prerequisite software In order to install TestWeaver, 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 TestWeaver installation fails with error code 14001), you can find the redistributable package plus installation instructions at Installing TestWeaver from the command line If you want to install TestWeaver from the command line, you can use the options and syntax from Some (additional) 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 installation of Testweaver /DEMOFOLDER="x:\dirname" Set the default directory for installation of 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