Configuring WebDAV Access

A complete set of document management functionality is accessible directly from the Microsoft Office toolbar and the Microsoft Windows Explorer using the WebDAV protocol. CodeBeamer enables WebDAV access to its repository using the following URL:

<CodeBeamer URL>/cb/webfolder

For example, to access a CodeBeamer installation on the local host, use the following WebDAV URL:

http://localhost:8080/cb/webfolder
or
https://codebeamer.com/cb/webfolder

WebDAV rejects HTTPS connection on sites with invalid certificate.

Enable WebDAV access on Windows XP

1. Open the My Network Places dialog from the Control Panel,
2. In the wizard, press Next,
3. From the Service Providers list select the Choose another network location entry and press Next,
4. Enter the WebDAV URL of the CodeBeamer server and press Next,
5. You will be prompted for a user name and password. Use your CodeBeamer user name and password.
6. Enter a name for the newly created connection and press Next,
7. Press Finish to close the wizard and open the location.

Enable WebDAV access on Windows 7

To enable WebDAV access

• From the Windows Start menu, click Computer.
• Within the Computer window that appears, click Map network drive.

• Within the Map Network Drive dialog, enter your WebDAV address: https://yourcodebeamerdomain/cb/webfolder (eg.: https://codebeamer.com/cb/webfolder or http://localhost:8080/cb/webfolder ) and check the two check boxes at the bottom. Click Finish.

• On the next dialog enter your codeBeamer account/password.

Enable WebDAV access on MAC OS

1. Go to Finder
2. Click Go -> Connect to Server...
3. Enter the WebDAV URL i.e. https://codebeamer.com/cb/webfolder

To prevent .DS_Store file creation Open Terminal and execute the command:

defaults write com.apple.desktopservices DSDontWriteNetworkStores true

Either restart the computer or log out and back in to the user account.

See more to prevent .DS_Store file creation over WebDav connections on http://support.apple.com/kb/ht1629

Keeping Document History

WebDAV doesn't support update operation, therefore editing a document over WebDAV connection equals to a delete-and-create operation sequence. Because delete operation eliminates version history the following experimental feature has been introduced since codeBeamer 7.1.3. If a document is deleted and recreated by the same user in a certain period of time the deleted document is restored and the created one is regarded as a new version. This feature can be enabled and configured in general.xml file by the auto_restore_from_trash property in <document>XML tag, where the property value is the time period. An example for setting it to 30 seconds (XML fragment):

<document auto_restore_from_trash="30s"

Trobleshooting

Map Network drive fails with "Windows cannot access ... " - network name cannot be found

When connecting from Windows-based OS, the webdav connection is handled by the standard windows service "WebClient".

Please ensure the service is running and set to "Automatic" in services:

If the folder cannot be reached, please restart this service.

Server port configuration check

Webdav uses the codeBeamer port. Default is 8080 that can be configured in /install_dir/tomcat/conf/server.xml as below:

<Connector
   port="8080"
   protocol="HTTP/1.1"
   redirectPort="8443"
   URIEncoding="UTF-8"
   acceptCount="200"
   maxPostSize="-1"
   maxThreads="250"
   enableLookups="false"
   connectionTimeout="80000"
   maxHttpHeaderSize="16384"
   maxSwallowSize="-1">
</Connector>

In case using codeBeamer via eg. apache the connector below should be configured:

    <Connector port="8009"
            acceptCount="100"
            maxPostSize="0"
            maxThreads="100" minSpareThreads="4" maxSpareThreads="10"
               enableLookups="false" redirectPort="8443" protocol="AJP/1.3"
               connectionTimeout="80000"
            request.registerRequests="false"
            disableUploadTimeout="true"
            useBodyEncodingForURI="true"
        ></Connector>

A useful external link about how to configure WebDAV clients: https://doc.owncloud.org/server/9.1/user_manual/files/access_webdav.html