How to Install Zimbra Drive

KB 23159	Last updated on 2017-10-06	Last updated by Jorge de la Cruz	0.00 (0 votes)	Verified in: ZCS 8.7
- This is certified documentation and is protected for editing by Zimbra Employees & Moderators only.

KB 23159	Last updated on 2017-10-6
0.00 (0 votes)
- This is certified documentation and is protected for editing by Zimbra Employees & Moderators only.

Zimbra Drive is a server extension which inter-connect Zimbra Collaboration an a WebDAV product like ownCloud/nextCloud, so for the Zimbra users it's transparent, but they can have all the benefits of such products as: Desktop or mobile clients, third party integrations in ownCloud/nextCloud, etc.

In minimal installation, Zimbra Drives requires a Zimbra Collaboration environment and a single additional server (the ownCloud/nextCloud server) are required.

How it works

Zimbra Drive includes multiple components which make it work for the user without notice it, while the Zimbra Drive server extension and the Zimbra Drive app on ownCloud/nextCloud do all the rest of the work. Here is a list of the components:

• Zimbra Drive Zimlet: This is the Zimlet which the user sees on the top navigation bar, this zimlet shows the user the functionalities, icons, etc. And provides the javascript work which is sent back to the Server Extension. It comes inside Zimbra Collaboration 8.7.6 and above.
• Zimbra Drive Extension: This server extensions has the mission of establish a communication with the ownCloud/nextCloud, and it's on charge of transform all the operations using the ownCloud/nextCloud API to Zimbra and vice-versa. It comes inside Zimbra Collaboration 8.7.6 and above.
• Zimbra Drive App for ownCloud/nextCloud: This app role is to do the Zimbra authentication from ownCloud/nextCloud to Zimbra and vice-versa, also the app is in charge to provision the users in an automated manner first time the log-in inside Zimbra Collaboration.

Topology with usual scenarios of Zimbra Drive

On this example, the scenario includes a Zimbra Collaboration Server in a local Data Center, and the ownCloud/nextCloud in another different location on Internet, Amazon, Digitalocean, or another external Data Center

On this example, the scenario includes a Zimbra Collaboration Server and the ownCloud/nextCloud the same local Data Center

Installation Prerequisites

Before performing an installation these prerequisites must be fulfilled:

• A working Zimbra Collaboration 8.7.6 or higher version Environment
• A dedicated server for ownCloud/nextCloud. ownCloud/nextCloud can't be installed on the same server as Zimbra Collaboration
• Knowledge and understanding of your network infrastructure setup, especially in regard to your Firewall and DNS settings
• Access to DNS management to create the required DNS settings
• Access to Firewall management to enable required communication between Zimbra server/s and ownCloud/nextCloud server/s
• Optional - A commercial certificate matching the certificate requirements described below
• Root access to the Zimbra Collaboration and the ownCloud/nextCloud Server.

• Zimbra-Proxy must be installed and running on the Zimbra server

Certificate Requirements

Zimbra Drive supports self-signed certificate for Zimbra Collaboration, and even no SSL Certificate on the ownCloud/nextCloud server, but as usual: we strongly recommend you to protect all the servers with a valid SSL Certificate, Let's Encrypt or another Commercial one you can choose from here.

System Requirements

Zimbra Drive relies on a third party product like ownCloud/nextCloud, so for better system requirements and sizing for this product, please visit their official website:

• NextCloud Deployment Recommendations

How to install Zimbra Drive

To successfully install Zimbra Drive we need to configure two different components: the Zimbra Collaboration server and the ownCloud/nextCloud server.

How to install Zimbra Drive extension

Remember that we need Zimbra Collaboration 8.7.6 or above, if you are running a previous version, or running a new installation from 8.7.6, while installing Zimbra, the installer will ask you about the components to install, select Drive, the last one:

Select the packages to install
Install zimbra-ldap [Y] 
Install zimbra-logger [Y] 
Install zimbra-mta [Y] 
Install zimbra-dnscache [Y] n
Install zimbra-snmp [Y] 
Install zimbra-store [Y] 
Install zimbra-apache [Y] 
Install zimbra-spell [Y] 
Install zimbra-memcached [Y] 
Install zimbra-proxy [Y] 
Install zimbra-chat [Y] 
Install zimbra-drive [Y]

The installer will continue and it will show the next details, which means the components are being installed, Drive included:

Installing:
    zimbra-core
    zimbra-ldap
    zimbra-logger
    zimbra-mta
    zimbra-snmp
    zimbra-store
    zimbra-apache
    zimbra-spell
    zimbra-memcached
    zimbra-proxy
    zimbra-chat
    zimbra-drive

The system will be modified.  Continue? [N] y

Beginning Installation - see /tmp/install.log.uM1VDt2i for details...

                 zimbra-core will be installed.
      zimbra-core-components will be downloaded and installed.
                 zimbra-ldap will be installed.
      zimbra-ldap-components will be downloaded and installed.
               zimbra-logger will be installed.
                  zimbra-mta will be installed.
       zimbra-mta-components will be downloaded and installed.
                 zimbra-snmp will be installed.
      zimbra-snmp-components will be downloaded and installed.
                zimbra-store will be installed.
     zimbra-store-components will be downloaded and installed.
               zimbra-apache will be installed.
    zimbra-apache-components will be downloaded and installed.
                zimbra-spell will be installed.
     zimbra-spell-components will be downloaded and installed.
            zimbra-memcached will be downloaded and installed.
                zimbra-proxy will be installed.
     zimbra-proxy-components will be downloaded and installed.
                 zimbra-chat will be downloaded and installed.
                zimbra-drive will be downloaded and installed.

If you follow the installation progress, you are going to see as well the next:

Installing extra packages (2):
   zimbra-chat
   zimbra-drive
      ...done

The last steps during the installation are the ones about Zimlets, you can see here how the Zimbra Drive Zimlet is being deployed:

Installing common zimlets...
	com_zimbra_cert_manager...done.
	com_zimbra_adminversioncheck...done.
	com_zimbra_tooltip...done.
	com_zimbra_attachmail...done.
	com_zextras_chat_open...done.
	com_zimbra_phone...done.
	com_zimbra_webex...done.
	com_zimbra_viewmail...done.
	com_zimbra_attachcontacts...done.
	com_zimbra_clientuploader...done.
	com_zimbra_bulkprovision...done.
	com_zimbra_url...done.
	com_zimbra_email...done.
	com_zimbra_date...done.
	com_zimbra_mailarchive...done.
	com_zimbra_srchhighlighter...done.
	com_zextras_drive_open...done.
	com_zimbra_proxy_config...done.
	com_zimbra_ymemoticons...done.

How to configure Zimbra Drive extension

ZCS 8.7.7 and above

Starting ZCS 8.7.7 and above you need to configure the Nextcloud/Owncloud URL using the LDAP attribute like this

zmprov md dominio.com zimbraDriveOwnCloudURL 'http://nextcloud.dominio.com/index.php'
zmcontrol restart

And you can now go to the next step

ZCS 8.7.6 only

If you are running this Zimbra version, you need to create the next file manually:

vi /opt/zimbra/lib/ext/zimbradrive/zimbradrive-extension.conf

Inside this file you need to add the domain, or domains, which want from Zimbra to autopopulate the users inside ownCloud/nextCloud:

{
"domains": {
    "zimbra.com": "https://nextcloud.zimbra.com/index.php"
     }
}

How to install Zimbra Drive app on the ownCloud/nextCloud server

On the ownCloud/nextCloud you need to install the Zimbra Drive app from the Official Repository:

• You can find the Owncloud Application on the next Official URL
• You can find the Nextcloud Application on the next Official URL

Once you have downloaded to the server, follow the next steps:

cd /tmp
wget THE ARTIFACT FROM THE OFFICIAL REPOS
 tar xzvf zimbradrive*

For Owncloud

mv zimbradrive /var/www/owncloud/apps/

For Nextcloud

mv zimbradrive /var/www/nextcloud/apps/

How to configure Zimbra Drive app on ownCloud/nextCloud

Once the app has been installed, login as an admin on the ownCloud/nextCloud server:

Once logged in, move to the Apps section, and enable the new Zimbra Drive app, you might find it under the Not enabled section:

Move now to the top right menu, and select Admin:

You will need to configure the next fields on this view:

• Enable Zimbra authentication backend: If you want to enable the auth from Zimbra LDAP
• Allow Zimbra users to login: If you want to allow the Zimbra Users to login into the Nextcloud/Owncloud
• Zimbra Server: Zimbra FQDN, without the http or https
• Zimbra Port: Zimbra Port, usually is 443 if using SSL
• Use SSL: Check this mark if you are using HTTPS, you should be using HTTPS
• Enable certificate verification: Check this if you are using a self-signed SSL certificate
• Domain PreauthKey: This is optional, add it in case you want to login from ownCloud/nextCloud to a Zimbra server

And finally when ready, hit the Test Button

If everything it's correct, you will see a screenshot similar to this one:

Using Zimbra Drive - Web Client

Now that everything is up and running, it's time to log-in on the Zimbra Web Client, on my case I'm using the new Zimbra Universal UI:

Inside the UI, you can find the new tab called Drive, click on it:

Once in Zimbra Drive, you can perform all the next actions for now:

• Upload files to Drive
• Downloads files from Drive
• Create a new folder on Drive
• Delete files and folders
• Move files and folders
• Rename files and folders
• And of course, the auth is all automated and the server extension perform it against the ownCloud/nextCloud server

If you log-in directly into the ownCloud/nextCloud server, you are going to see the same files/folders, which means everything is on sync, and of course Drive gives the opportunity to the user to install and use the ownCloud/nextCloud desktop or Mobile apps and use all the Corporate Cloud File Sync and Sharing capabilities of this product, and keep seeing the files everywhere from anywhere at any time using Zimbra Collaboration Web Client.

Identified Support Issues

• No reported issues at the moment