Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

THIS ARTICLE IS A COPY FROM HELP.WORKBOOK.NET - NEEDS REWRITING & IMAGES

WebDAV is an RFC Standard for accessing and manipulating resource collections, in this case, it is used to manipulate a remote file system.
The advantage of user WebDAV is that a lot of systems implement it and on a wide variety of platforms.

WebDAV is secured by the use of passwords and can be encrypted using HTTPS.

WorkBook can store all your files on a third-party WebDAV server. This is often used to connect a hosted WorkBook with on-premises storage or storage in a branch officeWorkBook integrates to Google Drive and allows your WorkBook instance to automatically create folder structures and other folders directly from WorkBook. WorkBook can be used in combination with the existing Google Drive functions, such as synchronizing directly to your desktop.

ON THIS PAGE YOU WILL FIND:

Table of Contents

...

REQUIREMENTS

  • Google account with Google Drive

  • WorkBook

...

INSTALLATION & CONFIGURATION

Step 1 – Initial setup

First, you need to add the storage provider type called ‘WebDAV Storage Provider’ under Folders → Reports & Documents → Storage and Folders → Storage provider, and then insert the required configuration values.

The required values are:

  • ServerRootPath: the full address including subdirectory that WorkBook should connect to (http://yourwebdav.tld/subfolder)

  • WebDavUsername: User name for the WebDAV connection (this user MUST have full access to the share in question)

  • WebDavPassword: The password for the WebDAV user

  • DisableDepthInfinity: if you already know that the property ‘Depth Infinity’ is disabled, set this to True.

Step 2 – Test the connection

Just type a random folder name and click ‘Test’

...

If the WebDAV configuration is correct, all boxes in the column ‘Success’ will be ticked off.
Otherwise, see below for troubleshooting of general error message, or check the platform-specific installation instructions for troubleshooting information.

  • If the test fails, you probably need to open up for one of our IP addresses in your firewall to make sure the connection is opened from our servers. These IP addresses are in use. Contact us if you’re uncertain which hosting location applies to your WorkBook.

    • Australia East: 13.70.109.18

    • East Asia: 23.100.93.179

    • Southeast Asia: 52.148.79.254

    • East US: 13.72.75.199

    • Northern Europe: 13.74.176.41

Step 3 – Test from outside your network

Confirm that the WebDAV settings work from a third-party client like Cyberduck or BitKinex.

You need the following information to connect:

  • Server Address (http:// or https://)

  • Server Port (80, 443, etc)

  • Username

  • Password (*********)

Confirm that you can do the following actions:

  • List content

  • Create directory

  • Delete directory

  • Upload file

  • Delete file

Known limitations: WorkBook does not support directories with leading or trailing white spaces.

TROUBLESHOOTING

...

List folder content returns 400 Bad Request or 403 Forbidden

...

These status codes will normally indicate that we tried to use Depth Infinity but that was not allowed.
On Apache, it might indicate that the WebDAV User lacks permissions to one or more files/folders.

...

401 Unauthorized

...

Ensure that the Username and Password are correct, note that the password often comes before username in the setup grid.

Make sure that the server is actually requesting basic authentication, you can see this by looking at the authentication respond a WebDAV client sends.
The header should look like this: “Authorization: Basic…”

...

When uploading a receiving a 404 Not Found

...

If you are using Internet Information Service this error indicates that you are trying to upload a file that is larger than the maximum allowed size.
The default limit is 30 megabytes, see Internet Information Service Step 5 for information on how to modify the limit.

If you’re using Apache with mod_dav try and enable “UseStreamingUpload” on the storage provider, this will allow WorkBook to upload the file in multiple chunks.

...

Nothing happens when I change the setting

...

See Common Known Issues for more information.

...

Could not create SSL/TLS secure channel

If WorkBook reports the error ‘Could not create SSL/TLS secure channel’ when attempting to connect with the WebDAV storage, it is most likely because the server and client is unable to negotiate an SSL/TLS Session.

...

  • Navigate to the Settings module > Folders, reports & documents > Storage and folders

  • Go to the storage provider tab

  • Click the create storage provider icon

...

  • Select Google Drive in the dropdown menu then click OK

  • Enable the new Google Drive storage provider by selecting the checkbox under column “Enabled”

  • Then click on the Authenticate button from the Sub-grid (the little key icon).

Make sure you have pop ups enabled in your browser

  • In the pop-up window, sign in to your Google account. (click on ‘Use another account’ to sign in if you can’t find your account listed)

...

  • Click show advanced

The reason for this action is that WorkBook has not yet verified the application. This step will be obsolete once it has been verified.

  • Click go to WorkBook (unsafe)

...

  • On the next page loaded > click Allow

...

  • After clicking allow the last pop up will appear and this includes a code that you will need to copy (by either pressing Ctrl + c / Cmd + C from your keyboard)

...

  • Navigate back into WorkBook > paste the code into the Google drive value field

...

Once the code has been input, you’re done with the installation of Google Drive!

You can now enable the new storage and run the test to ensure there is no error and the integration has been successfully set up.

...

TROUBLESHOOTING

MY STORAGE IS SLOW

Yes, unfortunately using Google storage might be slower at generating folders when creating jobs. This is something your the team needs to be aware off. We recommend not using Google Drive if you feel the solution is too slow.

...

Related articles

Filter by label (Content by label)
cqllabel = "storage-providers" and space = currentSpace ( )