Zextras Drive

To upload a file to Drive v2, either click on the "Upload" button above the file list or drag and drop any number of files from your computer to the main Drive window.

To download a file from Drive v2, right-click on it and select "Download":

Any file and folder in Drive v2 can be renamed by right-clicking on it and selecting the "Rename" option in the context menu.

Briefcase items are part of the mailbox’s folder and item hierarchy, while Drive v2 has its own internal folder structure and navigation. Navigating through Drive v2 folders is done through the Navigation Bar on top of the UI instead of through a tree view and folders are visible in the main section of the UI above files.

On top of the standard folder-based navigation, a "Quick Access" menu is available on the left side of the UI, which allows to quickly view the following types of items: • "Preferred Items" – items marked with the "Star" option available in the right-click context menu; • "Recently Edited" – items edited recently, sorted from the most recently edited; • "Shared with me" – items shared by other users • "Shared by me" – items shared to other users • "Marked for deletion" – items marked for deletion

To create a folder in Drive v2, click on the "New" button above the file list and select "Folder":

The following characters cannot be used in Drive folders and files:

Being separated from the mailbox’s item hierarchy, Drive v2 files and folders can be shared independently. Sharing permissions can be chosen among 3 options: "View", "Edit" and "Edit and Share" – the latter two options include the "View" right by default.

To share a file or a folder, right-click on it and select "Edit Shares". After entering the email address of the destination user and selecting the sharing permissions, click the (+) button to add the share to the list:

To edit or delete a share, simply click on the dropdown permission selector to change the sharing permissions of the file/folder or click the trash bin icon to delete the share:

In Drive v2 sharing rights are only "positive", so it’s not possible to share an item with a lower permission than its parent, e.g. if a folder is shared with "Edit" permissions it’s not possible to share one of its items with "View" rights with the same person.

When deleted, Drive v2 items are not put into the Trash like every other item type in Zimbra, as such items are marked for deletion instead. To mark a file or a folder for deletion, right-click on it and select "Mark for Deletion":

Items marked for deletion are displayed on the bottom of the file list with a strikethrough line and can be deleted permanently clicking on the "Delete Permanently" entry within the right-click context menu of a file marked for deletion while the "Restore" entry will unmark the file:

While any user with "Edit" or "Edit and Share" rights on an item or folder can mark it for deletion, only the original owner can delete it permanently.

Items marked for deletion cannot be accessed, so should a user try to do so a pop-up message will ask whether to restore the item and access it or to stop the attempt and leave it as marked for deletion.

The InfoBox is a collapsible element that contains all information and controls for the selected file or folder, as well as a preview of the file itself if in a compatible format (pictures, PDFs and more).

To display the Infobox, click on the "(i)" button on the top-right of the Drive v2 UI:

The infobox will appear on the right side of the screen:

Top-to-bottom, the InfoBox contains:

While Briefcase files are stored as mail-like items within the mailbox’s folder tree, Drive v2 features a detached folder hierarchy based on nodes: thus, Drive v2 folders do not appear as mailbox folders (e.g. in the output of zmmailbox getAllFolders). Drive v2 metadata are stored in a dedicated HSQL Database while all files (including previous file versions and file previews) are stored in a dedicated folder within a volume’s root. File naming is now hash-based instead of id-based to achieve native deduplication, compression rules follow the volume’s settings

e.g. Filesystem path for a briefcase file: /opt/zimbra/store/0/[mID]/msg/0/[itemid]-[revision].msg Filesystem path for a Drive v2 file: /opt/zimbra/store/drive/[hash]-[revision].[extension]

As of this release, Drive v2 files are stored in the Current Primary volume as any other item.

Integration with Zimbra Docs If the Zimbra Docs zimlet is correctly installed, dedicated document options will appear in the "New" button above the file list:

When right-clicking on a compatible file, an "Open with Docs" option will also appear:

Furthermore, Zimbra Docs will also allow for previews of compatible document formats to be displayed in the InfoBox.

To build URLs and links (e.g. for External Shares) Zextras Drive uses the default Zimbra settings for the domain of the account in use - the zimbraPublicServiceHostname property is used for the URL itself while the zimbraPublicServicePort property is used for the port.

Should any of the two not be set up, the system will always fall back to the zimbraServiceHostname and zimbraMailPort or zimbraMailSSLPort server-level properties.

Drive V2 files are included in Backup NG, and both the RealTime Scanner and the SmartScan are aware of those and no additional actions must be taken in order to ensure the files' safety.

The Restore on New Account and External Restore modes will also restore Drive V2 files, while other restore modes such as the Undelete Restore do not operate on such files.

Drive V2 can store its data on a different volume than the default Current Primary one, and HSM policies can move Drive V2 files onto a different volume than the Current Secondary one, thus effectively allowing independent storage management for Drive V2 files.

When an HSM policy is applied, Drive V2 files will be handled under the "document" item type.

This setting is applied at the server level so that different mailbox servers can use different volumes.

To set the Drive Primary volume, first find out the volumeID of the target volume by running zxsuite hsm getAllVolumes.

Once the volumeID has been identified, simply run

(where [volumeID] is the ID found with the previous command)

To set the Drive Secondary volume, find out the volumeID of the target volume as described in the previous paragraph and then run the following command