WebDAV Access

You are reading the CRX 2.3 version of WebDAV Access.
This documentation is also available for the following versions: CRX 2.2  CRX 2.1  CRX 2.0 (for CQ 5.3) 

CRX and CQ come with WebDAV support that lets you display and edit the repository content. Setting up WebDAV gives you direct access to the content repository through your desktop. Office and PDF files that are dropped into the repository through the WebDAV connection are automatically full-text indexed and can be searched with the standard search interfaces through the standard Java APIs.

Note

The instructions for using WebDAV for CRX and CQ are identical. The only difference is that CQ generally runs on port 4502 by default. Also see instructions for uploading digital assets. 

Connecting to WebDAV

Detailed Windows and MacOS instructions are included in this section, but essentially to connect to the default workspace of your repository using the WebDAV protocol, you point your WebDAV client to the following location:

http://localhost:7402/content/dam
        
file

CRX displays the repository content as follows:  

  • A node of the type nt:folder is displayed as a folder. Nodes below the nt:folder node are displayed as the folder content.
  • A node of the type nt:file is displayed as a file. Nodes below the nt:file node are not displayed, but form the content of the file.

When you use WebDAV to create and edit folders and files, CRX creates and edits the necessary nt:folder and nt:file nodes. If you plan to use WebDAV to import and export content, try to work with nt:file and nt:folder node types as much as possible.

Note

Before setting up WebDAV, please check the Technical Requirements as appropriate - CRX and CQ.

Note

In CRX, you can also find instructions for setting up WebDAV on Windows and MacOS by launching CRX and clicking Work with content from desktop on the CRX Launchpad.

WebDAV URLs

The URL for the WebDAV server has the following structure:

URL part http://<host>:<port> /<crx-webapp-path> /repository /<workspace>
Example http://localhost:7402 /crx /repository /crx.default
Description Host and port, on which CRX runs Path for the CRX repository webapp Path to which WebDAV servlet is mapped Name of the workspace mapped throught this path.
By changing the workspace element in the path, you can map workspaces other than the default one (crx.default); for example, to map a workspace named staging, use the following URL:
http://localhost:7402/crx/repository/<b>staging</b>
        

Additionally, when the CRX Launchpad module is installed and enabled, CRX provides an additional, simplified WebDAV URL to connect to:

http://localhost:7402/
        
This URL, when mounted from the operating system level, provides WebDAV access to the default workspace (crx.default). While being simpler for the user, it does not give them the additional flexibility of specifying workspace names.

Note

The simplified CRX Launchpad URL (for example, http://localhost:7402/) is mapped to the WebDAV server module from the CRX Launchpad application. While this module is served by the same underlying WebDAV server implementation as the one in CRX repository, it might be configured slightly differently (for example, with regard to how JCR nodes are mapped to files and folders while copying content from and to the repository). These differences should not impact the majority of use cases.

Setting up WebDAV for Windows

If you are using WebDav on Windows, there are special considerations for Windows 7, Windows 8, Windows 2003, and Windows Vista. Please see the following notes before proceeding with the instructions.

Windows Vista

If you are setting up WebDAV for Windows Vista, WebDAV requires Service Pack 2 and some modifications to the registry. See CRX WebDAV client technical requirements or CQ WebDAV client technical requirements for detailed instructions.

Windows 2003

Windows 2003 running SP2 requires manual configuration in order for WebDAV to function. See CRX WebDAV client technical requirements or CQ WebDAV client technical requirements for more information.

Windows 7

For Windows 7: Basic authentication for WebDav is disabled by default. To enable it, the following entry in the registry has to be updated to 2 or greater in the web client:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters\BasicAuthLevel

Possible values: 2 or greater - Basic authentication for SSL shares and non-SSL shares.

You need to reboot after changing the registry. See http://support.microsoft.com/kb/841215/en-us for more information.

In addition, you need to have a Windows user with the same credentials as the repository user, otherwise you will get permission problems.

Windows 8

For Windows 8: You also need to change the registry entry as described for Windows 7; however, you need to enable the Desktop Experience in order to see this registry entry. To enable the Desktop Experience, open Server Manager, then Features, then Add Features, thenDesktop Experience.

After rebooting, the HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters\BasicAuthLevel registry entry is available. Modify it to 2 to map to a drive or http://localhost:<port>/crx/repository/crx.default.

See http://support.microsoft.com/kb/841215/en-us for more information.

Setting up WebDav

To set up WebDAV in a Windows environment:

  1. In My Computer, click My Network Places.

    file
  2. Click Add a Network Place to start the wizard.

  3. Select Choose another network location and click Next.

    file
  4. Type http://localhost:7402/crx/repository/crx.default and click Next.

    Note

    If CRX is located on another port, use that port number instead of 7402. Also, if you are not running the content repository on your local machine, replace localhost with the respective DNS or IP address.

    file
  5. Enter username admin and password admin. Initially, Day recommends that you use the pre-configured admin account for testing.

    file
  6. Enter a name for the connection and click Next.

    file
  7. Windows indicates that you have successfully added the network place. Open the network place to access your CRX repository.

    file

Setting up WebDAV for MacOS

To set up WebDAV with MacOS:

  1. Navigate to any Finder window and click Go and Connect to Server, or press Apple+k.

  2. In the Connect to Server window, type

    http://localhost:4502

    CRX prompts you for authentication.

    Note

    If CRX is located on another port, use that port number instead of 4502. Also, if you are not running the content repository on your local machine, replace localhost with the respective DNS or IP address.

  3. Enter username admin and password admin. Initially, Day recommends that you use the pre-configured admin account for testing.

MacOSX has now mounted CRX as a volume and you can use it like any other drive.

Setting up WebDAV for Linux

To set up WebDAV with Linux (Gnome):

  1. In Nautilus (file explorer), select Places and select Connect to Server.

  2. In the Connect to Server window, select WebDAV (HTTP) in Service Type.

  3. In Server, type http://localhost:7402/crx/repository/crx.default.

    Note

    If CRX is located on another port, use that port number instead of 7402. Also, if you are not running the content repository on your local machine, replace localhost with the respective DNS or IP address.

  4. In Folder, type /dav.

  5. Enter your username admin. Initially, Day recommends that you use the pre-configured admin account for testing.

  6. Leave the port blank and enter any name for your connection.

  7. Click Connect. CRX prompts you for your password.

  8. Enter the password and click Connect. Linux GNOME has now mounted CRX as a volume and you can use it like any other drive.

To set up WebDAV with Linux (KDE):

  1. Open the Network Folder wizard.

  2. Select WebFolder (webdav) and click Next.

  3. In Name, type a connection name.

  4. In User, type admin. Initially, Day recommends that you use the pre-configured admin account.

  5. In Server, type http://localhost:7402/crx/repository/crx.default.

    Note

    If CRX is located on another port, use that port number instead of 7402. Also, if you are not running the content repository on your local machine, replace localhost with the respective DNS or IP address

  6. In Folder, type dav.

  7. Click Save and Connect. CRX prompts you for your password.

  8. Enter the password and click Connect. Linux KDE has now mounted CRX as a volume and you can use it like any other drive.