codeBeamer ALM
Tags:  WebDAV Webfolder

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.
On the next dialog enter your codeBeamer account/password. WedDAV access on Windows XP is not supported by Intland since Microsoft has discontinued official support for Windows XP

Enable WebDAV access on Windows 7


To enable WebDAV access Windows Vista and Windows 7 you should resolve know configuration issues on these operating systems: Please note that there are known problems with Windows 7 and WebDav. If you ecounter problems connecting to codeBeamer's webfolder, please try the steps descriped on the following page:

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


To enable WebDAV access
  1. Go to Finder
  2. Click Go -> Connect to Server...
  3. Enter the WebDAV URL i.e. https://codebeamer.com/cb/webfolder
On the next dialog enter your codeBeamer account/password.

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"
This is an experimental feature and currently not officially supported.

Trobleshooting

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"
        connectionTimeout="20000"
        redirectPort="8443"
        maxPostSize="5242880"
        enableLookups="false"
        URIEncoding="UTF-8"
        useBodyEncodingForURI="true"
         />

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"
        />