Frequently Asked Questions
Share:
Installation and Uninstallation
- There is the possibility to run the WibuKey installer on Windows in a silent mode and with customized settings. To do so, please follow this short instruction:
- Unpack the WibuKey Runtime Kit you want to use with e.g. WinZip.
- Adapt the setup.ini like you want. It is well documented inline. To run the setup "silent", you should change the values
ForceOverwrite=1
Gui=0
ErrorMessages=0
Additional informations can be found in \DevKit\help\RunTimeSetupUS.pdf.
- To adapt some settings for the driver you can also edit the wibukey.ini file. E.g. if you want to disable all interfaces except USB you've to make the following settings:
WkLpt=/D,/D,/D,/D
WkCom=/D,/D,/D,/D
WkPcCard=0
WkUsb=1
WkPort=Usb
If you only want to allow local subsystem you can set it this way:
SubSystem=Kernel
To ensure that an adapted Setup.ini (from a formerly installed version) works with WIBU-KEY Version 5.00 -> 5.10, a developer must include the following in the section [Files]:
wkext32.dll=1,wkext32.dl_
To ensure that an adapted Setup.ini (from a formerly installed version) works also with WIBU-KEY Version 5.20, a developer must include the following in the section [Files]:
WkStartCpl32.exe=1,WkStartCpl32.ex_
WkSvCtrl.dll=1,WkSvCtrl.dl_
WkSvMgr.exe=1,WkSvMgr.ex_
A current Setup.ini can be found in \WIBUKEY\DevKit\Runtime when devKit is installed.
Now you can place the complete directory on your CD and start the setup32.exe e.g. during your setup. Then the driver is installed with your customized settings. Please keep in mind, that silent setup gives you a feedback of its work by setting a value in the registry. By this you can determine if you need to reboot or if any errors occured. The values are described in the mentioned document RunTimeSetupUS.pdf. - Problem
Your firm license file wkfirm.wbc or wkfirm.dat has been overwritten.
Solution
Copy your firm license file (youir own License file) wkfirm.wbc into the directory
[..\WIBUKEY\Devkit\bin]. - Please proceed as follows:
1. Remove all WibuBoxes
2. Open the WibuKey Tool in the Control Panel and switch to "Installation“
3. Open the Control Panel and uninstall the WibuKey driver.
4. Open [%systemroot%\inf] (usually C:\Windows\inf).
5. Search for all oem*.inf files with the name containing "WIBU". Delete all *.pnf files with the same name and then the *.inf files.
For Windows 7 Users: if there is no other file besides wibukeyPCMCIA.inf, refine your search options.
6. Check in C:\Windows\System32\drivers or C:\Windows\SysWOW64\drivers, if the Wibukey*.sys was removed; if not delete it.
7. Delete the following registry entries, if they are still there. Open registry via Windows button in task bar and type regedit.
a) HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services - search for "WIBUKEY" and/or "WibuKey2" and delete, if found.
b) HKEY_LOCAL_MACHINE\SOFTWARE\WIBU-SYSTEMS - delete directory, if found.
c) KEY_CURRENT_USER\Software\WIBU-SYSTEMS - delete directory, if found.
9. Restart your computer.
Now you can start reinstalling WibuKey:
1. Run the WibuKey Driver setup with administrative privileges. Make sure that no WibuBox is attached yet!
2. After the setup is completed, attach your WibuBox.
3. Windows should automatically install all hardware drivers since Wibu-Systems drivers since Version 5.0 are Microsoft certified..
After Windows recognizes the WibuBox correctly you can start the WibuKey-Software. You are able to test this via the WibuKey Tool in the Control Panel using page "Tests". - There exist a couple of setup options you are able to customize.
As a result you then have a setup tailored to your requirements. The files you customized can be used anytime for new versions of WibuKey drivers, i.e. the customization is one-time..
For customizing the setup, please proceed as follows:
- Unpack the matching WibuKey Runtime Kit in an empty directory.
Use any tool able to unpack self-extracting Zip archives.
- Customize the included Setup.ini file.
The Setup.ini file is well documented. For example to, switch the setup to \"Silent\", the
following customizing is sufficient:
ForceOverwrite=1
Gui=0
ErrorMessages=0
For a more detailed description see the CD \DevKit\help\RunTimeSetupDE.pdf.
- If you want to customize the settings of the WibuKey driver, you must now also
customize the also included file Wibukey.ini. For example, for deactivating all
interfaces except USB, you must set up as follows:
WkLpt=/D,/D,/D,/D
WkCom=/D,/D,/D,/D
WkPcCard=0
WkUsb=1
WkPort=Usb
In order, for example, to address the local subsystem only you must additionally set:
SubSystem=Kernel
WibuKey Version 5.00 -> 5.10
To ensure that your customized Setup.ini also works with WibuKey Version 5.00 -> 5.10
you must add the following line in the section [Files]:
wkext32.dll=1,wkext32.dl_
WibuKey with Version 5.20
To ensure that your customized Setup.ini also works with WibuKey Version >= 5.20,
you must add the following lines in the section [Files]:
WkStartCpl32.exe=1,WkStartCpl32.ex_
WkSvCtrl.dll=1,WkSvCtrl.dl_
WkSvMgr.exe=1,WkSvMgr.ex_
Please find a current Setup.ini for the installed DevKit in \WIBUKEY\DevKit\Runtime.
- Burn the complete subdirectory to your CD and while your setup process call
setup32.exe.The an installation of the driver according to your settings
is performed. Please note that in the case of a silent setup respective return values
are entered into the registry (see RunTimeSetupDE.pdf).
There, for example, a respective entry is et, if a system restart is required. - Problem
The programming signature for the WibuBox is wrong, because you are using an "old" signature of the WibuKey Development Kit (Version 4.10 or older).
Solution
Install the current version of the WibuKey Development Kit (Version 5.0 and higher). With this version you can program all variants of WibuBoxes. - Problem
When installing the German Development Kit (SetupDE.exe) this error message displays, if in the Regional Options the location is not set to "Deutsch (Deutschland)", but to "Deutsch (Österreich)" oder "Deutsch (Schweiz)".
Solution
Set the location to "Deutsch (Deutschland)" during the installation. After the successful installation, you can change again the location to the required setting. - Problem
Some notebooks and newer PCs do not supply the required LPT interface providing enough power. This can cause a timeout problem.
Solution
A timeout occurs, if the WibuKey driver cannot access the WibuBox within the expected time interval. The time interval can be increased by using a so-called 'DelayFactor'. The 'DelayFactor' is a usual registry extension.
Syntax:
[HKEY_LOCAL_MACHINE\SOFTWARE\WIBU-SYSTEMS\WIBU-KEY\Driver\CurrentVersion] "DelayFactor"="4"
- Here you can download a ZIP archive containing various 'DelayFactors': DelayFactor.zip.
- Unpack the archive.
- Double-click to activate the 'DelayFactor'.
- After having changed the 'DelayFactor' enter the command [..\wibukey\bin] wku32.exe.
- Reset all or restart your PC.
Only this way it is guaranteed that all WibuKey specific registry entries will be reread.
Note: For the first time, try always a slow 'DelayFactor' (such as 4), because it influences the WibuKey processes and can therefore slow down the protected application. - Problem
You try to program a "new generation" WibuBox with an "old" WibuKey license file (wkfirm.wbc or wkfirm.dat).
Solution
You need to perform a license update.
For this, please send your WibuKey license file "wkfirm.wbc" or "wkfirm.dat" [.\wibukey\devkit\bin] to license(at)wibu.com.
We will send you a new (updated) license file (version 4) as soon as possible. - Problem
When installing, the interface communication settings are reset to default, if not otherwise required.
Solution
- Check on page "Setup" of WibuKey control panel applet (Start - Settings - Control Panel - WibuKey), if the respective interface is activated.
- If necessary, check then the address area to be found in "Location". The address should correspond with the interface. You can check this in the Device Manager of your system. - This error occurs because WibuKey version 6.40 conflicts with software that is protected with AxProtector version 9.0. You need to perform a clean uninstall of WibuKey and a subsequent reinstall of WibuKey version 6.32 available for download from the Wibu-Systems website. Please proceed as follows:
Clean uninstall of WibuKey:
- Remove all WibuBoxes.
- Open "Control Panel | Programs and Features" and uninstall WibuKey.
- Open [%systemroot%\inf] (usually C:\Windows\inf).
- Search for all 'oem*.inf' file with the name containing 'WIBU'.
- Delete - if displayed - all '*.pnf' files with the same name.
- Delete the '*.inf files' (for Windows 7 Users: If there is no other file except
'wibukeyPCMCIA.inf', please refine you search options).
- Check in directory C:\Windows\System32\drivers or C:\Windows\SysWOW64\drivers, if the
'Wibukey*.sys' file was removed, if not delete it. (If you cannot delete it, because it is in use
rename it and after the restart you can delete it).
- Delete - if still existing - the following registry entries, if they are still there (open regedit.exe to manipulate
the registry)
-> HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services
-> HKEY_LOCAL_MACHINE\SOFTWARE\WIBU-SYSTEMS
-> HKEY_CURRENT_USER\Software\WIBU-SYSTEMS
- Restart your computer.
Reinstall WibuKey:
- Download WibuKey version 6.32 from the Wibu-Systems website.
- Run the setup with administrative privileges.
Please make sure, that there is no WibuBox attached yet!
- After completed setup, attach your WibuBox.
Windows should install all the hardware drivers.
After Windows recognizes the WibuBox correctly, you can start WibuKey. - In case of trouble with the WibuKeyShellExtension there might also be other difficulties. Therefore, we recommend a clean uninstall and reinstall as described in KB-0016.
If the difficulties refer exclusively to the WibuShellExtension, a repair can be attempted by executing the supplied script "WibuShellExtRepair.cmd" at (Programs x86)\WIBU-SYSTEMS\System. Then you have to restart the system.
The last possibility is to uninstall the WibuShellExtension. The functions like right-click in Windows Explorer to create a context file or double-click on a WibuKey remote update file are then no longer available. You can still create and/or import these remote files using the WibuKey tool in the Control Panel.
To uninstall, you can execute the following command via a command line (with administrator rights): regsvr32 /u (Programs)\WIBU-SYSTEMS\System\WibuShellExt(64).dll.
Now the WibuShellExt.dll is no longer loaded after the restart of the computer and there should be no more difficulties with it.