Skip to main content
pdf?stylesheet=default
Blackboard Help

Configuration Examples

Below are several examples configuration files. It depends on you how you distribute them. You can copy them directly to an installed instance, use them to create customized package or publish them on a server and access them through remote configuration. To try it out, save an example to xdconfig_customer.xml and copy it to the config folder of the installed Drive instance as described in Configuring Drive.

Change Default Cache Size

View example

Create volume with disabled icon previews in Windows Explorer

Windows Explorer tries to improve user experience by displaying additional information, such as file-specific icons, which causes performance problems when using network drives. Using this configuration you can block these Explorer extensions. To learn more, see the description of the configuration values in Description of Configurable Attributes.

View example

Create Volume with Preset Username, No Parameters Locked

View example

Create Volume with Automatically Expanded Username in URL, No Parameters Locked

In this example, a new volume is created with no username preset. The user will be asked to enter a username and password during connect. The username is used to replace the #U in the server URL from the configuration file. For example, if the username is "testuser1," the server URL from the configuration file will be expanded to: http://learnserver:8080/bbcswebdav/users/testuser1

View example

Create Volume with Automatically Expanded Path, No Parameters Locked

This example is similar to the previous one. The user will be asked to enter username and password during connect, but instead of expanding only the username, it shows more general way to expand any part of URL path using principal properties defined on server. The string in the form #{principal_property} is replaced by the value of principal_property returned by server. Particularly, the property http://www.xythos.com/namespaces/StorageServer:homedirectory is one such property and its value is the home directory of the user.

View example

Create Volume with Empty Username, User is Not Allowed to Remove the Volume or Change Volume URL

In this example, a new volume is created with no username preset. The user will be asked to enter a username and password during connect. The volume has a "deleteItem" lock, so it cannot be deleted by a user. The volume URL cannot be changed by a user because of the "edit" lock, but all other parameters (such as sharing level) can be modified.

View example

"Computer lab" Configuration - One Fixed Volume that Cannot be Changed or Deleted, Clear Data on Disconnect

This is an example configuration for use in computer labs. It creates a single volume without a preset username. The user cannot change any volume settings. After disconnect, the username, password, and file content are removed so that next user cannot access previous user's credentials or data.

Known limitation: Blackboard Drive is not able to successfully detect system restart/shutdown/logout before it kills the Java Virtual Machine (JVM), so the cache is NOT cleared when running Blackboard Drive with connected volume is terminated by system restart, shutdown, or logout. The cache is only cleared when you manually quit the connected Blackboard Drive (it also disconnects the volumes) or when you manually disconnect the volume.

View example

Changing default settings for existing sharing levels (None, Light, Medium and Heavy)

This is an example configuration for changing default values of checkBeforeOpen, autoLocks, cachedListings, refreshTimeout or checkBeforeOpenTimeout for existing sharing levels.
This example changes “None” sharing level to use auto locking (it is turned off for this sharing level by default).

View example

Changing user cache directory

This is an example configuration for changing default user cache directory.

Note: in older Drive versions prior 1.6 in macros  "%Documents%" has to be replaced with path.

View example

Changing default operation timeouts

This is an example configuration for changing timeouts for remote operations.
Note: by default, the timeout for connection, PROPFIND and DELETE methods are set in the xdconfig.xml (Drive's top-level configuration file), so the defaultMethodTimeout is the timeout for all other methods except these named. For example, changing the defaultMethodTimeout influences the timeout value for PUT operation, but not for PROPFIND, so to change the value for PROPFIND, you must explicitly set the value for this method as shown in the example below.

View example

Disable the one-time cookie usage information dialog shown at startup

To comply with EU privacy policy, Drive shows at first startup after the installation a one-time message informing about the cookie usage and privacy policy. Once confirmed, this dialog will be never shown again unless you fully reinstall the product. This dialog is enabled by default for all customers. If you do not wish to show this information at all, you can use the following config to customize the installation package.

Note: the example is valid since versions 1.5.14474 SP1 HF#1531 Win and 1.5.14472 SP1 HF#1607 Mac.

View example

Disable icon previews in Windows Explorer for all volumes, both existing and newly created

This is a variation of Example 2, but this time, by modifying the template for all volumes, the Explorer extensions are blocked for all volumes in the volume list, both existing and those created later on.

View example