Webservice installation fails - Function AddVDir failed
First published: 21. February 2024 (cf)
Last updated: 22. February 2024 (cf)
Summary
In specific circumstances the Fabasoft Folio Webservices or Conversion Services installation fails under Microsoft Windows. Analyzing the fscsetup-msi-install_*.log file, the error Function AddVDir failed shows up.
This may be caused by missing or corrupted IIS machine keys.
Information
Microsoft IIS protects its configuration with so-called machine keys. Missing or corrupted machine keys prevents software like PowerShell, or the Fabasoft Setup, to automatically add configurations, as the Virtual Directory (VDir).
Machine keys may get corrupted for example by:
- On a system crash
- On an improper shutdown
- When the machine got cloned (e.g. Virtual Machines)
Errors regarding this issue:
- Fabasoft Setup immediately fails when reaching the Web Services or Conversion Services task.
- The fscsetup-msi-install_*.log logfile, located in C:\Program Files\Fabasoft\Components\Setup, shows the error CallWebCA - Function AddVDir failed (Error: 0)
- The Windows Eventlog may show an error Keyset does not exist ( exception from HRESULT : 0x8009000D)
Reseting the machine keys will solve this issue.
Solution
Move or remove machine key files
Open the directory C:\ProgramData\Microsoft\Crypto\RSA\MachineKeys\
Rename or delete these files:
- 6de9cb26d2b98c01ec4e9e8b34824aa2_* (iisConfigurationKey)
- d6d986f09a1ee04e24c949879fdb506c_* (NetFrameworkConfigurationKey)
- 76944fb33636aeddb9590521c2e8815a_* (iisWasKey)
Delete machine keys from applicationHost.config
Open the directory C:\Windows\System32\inetsrv\Config
Edit the applicationHost.config file with an editor.
Search for the XML tag <configProtectedData> / <providers>
Remove the content between the <providers> and </providers> tag.
Recreate machine keys
Open a command prompt – make sure you’re in Administrator mode.
Run the following command:
%windir%\system32\inetsrv\iissetup.exe /install SharedLibraries
If the error appears like in the screenshot, you can ignore this.
Double-check your applicationHost.config file that the <providers> tag got refilled with entries.
Restart IIS by executing iisreset. The Fabasoft Folio Webservice and Conversion Service now should be installable.
References
Microsoft Tech Community: https://techcommunity.microsoft.com/t5/iis-support-blog/keyset-does-not-exist-exception-from-hresult-0x8009000d-or-or/ba-p/342955
Applies to
- Fabasoft Folio Webservices and Conversion Services under Microsoft Windows