This guide will show you how to install and configure WebDAV on Microsoft Windows – Internet Information Service for use with WorkBook.
This guide is for self service, WorkBook Software will NOT configure this for you or provide support when configuring it.
We will however be more then willing to provide you with details on private contractors that are able to help you.
- Windows Server 2008
- The Default Web Site that is created by the IIS 7.0 installation must still exist.
- Windows Server 2008 R2, 2012 or 2012 R2
Enabling the feature WebDAV feature on Internet Information Service is the first step.
Microsoft has made a brilliant guide on how to enable this, follow the installation instructions but ignore the configuration steps.
Create a new WebSite, ensure that it creates its own Application Pool as this is required later.
Point the “Physical Path” to the directory that you wish WorkBook to Access.
Configuration the Authentication methods is the next step, WorkBook only supports Basic Authentication there for your required to disable all other authentication methods.
Select the website
Enabled “Basic Authentication” and disable all others
WorkBook works best with Depth Infinity and in some cases not at all without.
Open “WebDAV Authoring Rules”
Open the menu “WebDAV Settings”
Enabled “Allow Property Queries with Infinity Depth”
For special characters to function to work, double escaping of characters must be allowed.
Open “Request Filtering”
Open the menu “Edit Feature Settings”
Check “Allow double escaping”
You can also increase the “Maximum allowed content length” to allow the upload of large files, the default is 30 mb, we recommend that you increase it to 100 mb (100000000 bytes)
Step 5 – Alternative
If the “Request Filtering” menu should be missing, even if the role feature is installed, copy the content from below to the site “web.config” located in the root of the website.
<?xml version="1.0" encoding="UTF-8"?>
<requestLimits maxAllowedContentLength="100000000" />
Now comes the user authentication, you can either create a local user or a domain user, depending on your setup different options may be required.
The user you create must have modify rights on the file area and if its located on a share it must also be able to access this.
- Domain user account
- If your share is placed on another server
- Local user account
- When your share is placed locally on the server
Open “WebDAV Authoring Rules”
Click the menu “Add Autoring Rule”
Specify the Username and set the permissions to Read, Source and Write.
The application pool must have access to the file system as well. One way of doing this is setting the Application Pool user to the user from Step 6.
In most cases this is the easiest way to manage and way we recommend. You can also choose to use the “Local System” user if the share is located locally or the Computer Account has access to the remote share.
Open “Application Pools”, select the correct application pool and finally open the menu “Advance Settings”
Set the “Process Model -> Identity” to the account from Step 7
And now your ready to use your WebDAV Server in conjunction with WorkBook, see the article “WebDAV integration” on how to configure WorkBook.
You should consider configuring the Web site with HTTPS for secure encrypted communication.
Most of the time the Internet Information Service will log any errors to the Event Log, a good idea is always to check the Application Log for errors.
The Application Pool wont start or stops right away
Check the Application Pool Identity from Step 7
The Storage Provider Test is unable to use special characters
Check Step 5