Skip to main content
Blackboard Help

Release Notes: Mac 1.6

About Blackboard Drive for Mac

Blackboard Drive (1.6.15648) allows OS X applications to operate directly on documents stored in Blackboard Learn Content System servers. Blackboard Drive differs significantly from the native Mac OS X ability to connect to WebDAV servers in the following ways:

  1. Blackboard Drive for Mac OS X helps to prevent such issues using "Application Filters", which compensate for the unwanted default behaviors of specific Mac OS X applications.  A list of these applications is provided in Application Filters.
  2. Typical OS X applications are not designed to work properly with document management systems such as Blackboard Learn Content System.  This means that when using the native Mac OS X WebDAV functionality, you will likely encounter a variety of problems such as:
    • Unintended proliferation of unwanted files on the server (e.g. .DS_Store files)

    • Loss of file properties, tags, prior versions, workflow data, and other critical data when files are updated by Mac OS X applications.

  3. Blackboard Drive caches files locally and synchronizes changes in the background.  This means that when saving a large document in an OS X application, you do not have to wait for the entire document to be uploaded to the server before continuing with your work.  Caching also greatly improves performance when applications repeatedly access the same file to read data.
  4. Blackboard Drive provides a Status Monitor that allows you to monitor the progress of file transfers and other operations between your Mac and the Blackboard Learn server.

Release Highlights


  • Files stored in Content Management for Blackboard Learn can be easily shared with peers, colleagues, or anybody by sharing the link to the file (for users who have permission to access the file).  Or, files can be shared by creating a Content Pass, a special link that is good for a set number of days that will allow anyone to access the file, even if they don't have a Blackboard Learn account or appropriate permissions. The Intellittach feature (short for "intelligently attach") allows the user to generate this link or a Content Pass right from their desktop via Blackboard Drive.


  • One of the powerful features of Content Management for Blackboard Learn is the ability to manage multiple versions of a file and have access to any of those older versions. In the past, Blackboard Drive only provided access to the most recent version of a file in the Content Collection. With version 1.6 of Blackboard Drive, the Content Management versioning feature comes to the desktop. Users can enable/disable versions and access past versions from the desktop volume in Blackboard Drive.


  • Menu Bar Icon: With the release of version 1.6 of Blackboard Drive, the Blackboard Drive icon has moved to the OS X Menu Bar.
  • Animated Blackboard Drive Icons: The Blackboard Drive icon in the menu bar will now show an animation, a pulsing green LED light, when files are being processed (i.e. uploaded, downloaded, etc.) to give a visual indicator that activity is taking place.
  • Status Monitor Access: The “Status Monitor” is a feature of Blackboard Drive that shows a log of all the completed and pending activity since the last time Blackboard Drive was started. With this release users will now see the Status Monitor by just right-clicking on the Blackboard Drive icon in the Menu Bar and choosing Show Status Monitor.
  • View Settings for Mounted Volumes: Previously, to view the setting of volume a user had to disconnect from the volume Blackboard Learn web server. This enhancement provides the ability to view, but not change the setting of a volume, without having to disconnect it.
  • Show Local Mount Path: Previously, the mount path (i.e. the disk name in Mac) was not shown in the Blackboard Drive application window. Users had to check the OS X Finder to figure out that information. Now the drive letter or name will be shown in the Blackboard Drive application window.

Supported Platforms

Blackboard Drive for Mac (1.6.15648) supports the following Mac OS X versions;
  • Mac OS X® v 10.6.8 (Snow Leopard) 32-bit and 64-bit
  • Mac OS X® v 10.7 (Lion) 32-bit and 64-bit
  • Mac OS X® v 10.8 (Mountain Lion) 64-bit

Application Filters

Application Filters compensate for potentially destructive behaviors of typical OS X programs which are not designed for use with WebDAV.  For example, when updating a file, many programs may inadvertently cause the loss of file properties, tags, versions, workflow data, and other critical data associated with the original file on the WebDAV server.   This release provides filters for the following applications:
  • Microsoft Word
  • Microsoft Excel
  • Microsoft PowerPoint 
  • Apple iWork Pages
  • Apple iWork Numbers
  • Apple iWork Keynote
  • Finder
Additionally, Blackboard Drive has a "generic" filter which attempts to correct for common destructive behaviors of other applications.  As a result, there may be a noticeable delay before some changes are propagated to the server.  Although this filter has been tested with common applications, it is impossible for Blackboard to test compatibility with all applications.  Please report any unusual application behaviors to Blackboard Support as soon as possible.

Important Notes

  1. Installation of Blackboard Drive requires administrative rights and will require the user to log out of their account at the end of the installation.
  2.  Upon installation, Blackboard Drive will be set to open at login for existing OS X users.  New OS X users created after the installation will not have this option set automatically.  Any user can change this setting for their account by right-clicking on the Blackboard Drive icon in the Dock, and choosing Options->Open at Login.
  3. If a proxy requires authentication, the user will be prompted for a username and password when first attempting to connect to the proxy.  Valid credentials will then be stored in Keychain and used for future connections to the proxy.  Stored credentials can be managed via the OS X Keychain Access application.
  4. In the event of an unexpected system outage, files that were in the process of being uploaded to the server at the time of the outage will be copied to a "DriveRecovery" folder in the user's OS X home folder when Blackboard Drive is restarted.
  5. Upgrades from the evaluation version of Blackboard Drive to the standard version are not supported in this release.   Please uninstall the evaluation version of Blackboard Drive before attempting to install the standard version.
  6. While browsing folders, Finder may attempt to read information from files in those folders, triggering the download of those files.  To minimize the number of files automatically downloaded by Finder, we recommend that the following options are unchecked in Finder's "View Options" window:
    • Calculate all sizes
    • Show icon preview
    • Show Columns: Version
  7. The .DS_STORE files remain in the cache, but are not uploaded to the server. So changes are maintained locally until the cache is cleared.

Known Limitations

  1. When saving a document in iWork08 format to a document with the same name in iWork09 format, the file save operation on the Blackboard Drive may fail. When converting the documents between these formats, the iWork application will remove the original folder and replace it with a single file with the same name, so be aware that the original document (folder) will be removed during this process and any classification data or other metadata associated with it will be lost. Make sure to save the file when iWork application prompts to do so.
  2. The uninstallation utility is only able to remove startup items, programs settings, and cache data for the user who runs the utility.   Other users can manually remove these items.
  3. In some cases, Finder may return its focus to the server root after deleting a file or folder. This behavior is independent from the Drive being running or not.
  4. When moving a file or folder via the command line, or when renaming or moving a file in Finder, it may take several seconds for the operation to be propagated to the server.   Further operations that alter the state of that file or folder before the completion of the original operation may cause synchronization problems, possibly resulting in data loss.  When using the command line to move a file or folder, or when using Finder to move or rename a file, please check the Status Monitor to ensure that the operation has been completed before performing additional operations that alter the state of that file or folder.
  5. Renaming a folder while files in that folder are being uploaded to the server may cause inconsistent errors depending on the versions of Mac OS X and Blackboard Learn server.  The Blackboard Drive status monitor can be used to check to see if any uploads are in progress. 
  6. Whenever Microsoft PowerPoint opens a ".ppt" file, it immediately attempts to write information to that file.  Because of this Microsoft PowerPoint behavior, you may observe an upload of the file to the server when you open a ".ppt" file.
  7. When you save changes to a Microsoft Word file and close that file, you may not be able to reopen that file until the upload of the file to the server is complete.
  8. The mechanism to block the downloads triggered by Finder to download file metadata (e.g. icons and mp3 info) is not implemented on Mac. The icon previews cannot be turned off using a setting in Blackboard Drive configuration on Mac (as opposed to Windows). The workaround is to go to View->Show View Options in Finder and uncheck the "Show icon preview".
  9. On Mac OS X 10.7 (Lion) and later versions, the Java runtime is not installed by default. In order to use Blackboard Drive you either need to install Java runtime manually or to run Blackboard Drive and follow the prompt asking for Java runtime installation. Visit to install Java runtime manually.
  10. The use of xlsx file stored on a Blackboard Drive volume is not supported when using the mail merge function in Microsoft Word.
  11. When editing a document using TextEdit on Mac OS X 10.7, TextEdit may complain that a document cannot be saved in some scenario. In such case, you need to use "Save Anyway" several times to save the document.
  12. A problem can be encountered when extracting some kind of zip files that contain files with relative paths, but the folders are not explicitly listed, e.g. a zip file that contains just "folder/file.txt" rather than both "folder" and "folder/file.txt". This is not a common problem since zip files created using Finder, Total Commander and 7zip work fine. The workaround is to extract the zip file on a local volume.
  13. Opening a .docx file in Word 2008 from a mounted volume with Light Sharing level could lead to freezing Word application if the file has been changed from another computer and gets downloaded. The workaround is to use Heavy sharing level or Word 2011.
  14. Blackboard Drive for Mac does not allow authentication using client certificate when there are multiple private keys in the login Keychain. This is caused by a bug in Mac Java runtime.
  15. Do not use Drive to create password-protected passes on Learn servers. The Learn server does not support opening password-protected passes; even though the operation to create a password-protected pass is possible using Drive, there is currently no way to open such pass.
  16. When using SaveAs in PowerPoint to save to an existing file with .pptx extension, the operation fails and an error message is displayed. The workaround is to save the document under a different filename and replace the document using a file manager or through upload in WebUI.
  17. In Keynote'08, when trying to save to the same file as the one you are currently editing, the save operation succeeds but the file is deleted and created again on the server, resulting in the loss of versions and metadata. Instead the file should be saved using the Save (or SaveAs) operation to a different filename.
  18. When exporting a document in MS Excel using SaveAs to a format other than xls or xlsx, the output files may not get automatically unlocked until you disconnect the volume. A similar problem may occur in Powerpoint and ppt and pptx.
  19. A serious bug in Word 2011 prevents from saving files on a share or disk which name contains the string "file". The latest Office 2011 patch (SP3-14.3.0) does not include a fix for this issue. 
  20. A similar issue affecting all Office 2011 applications is preventing from saving files on a volume named "home".