Zimbra Drive/How to Install Zimbra Drive


How to Install Zimbra Drive

   KB 23159        Last updated on 10/6/2017  




0.00
(0 votes)


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

Zimbra-drive-internet.png

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

Zimbra-drive-lan.png

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:

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:

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:

Zimbra-drive-001.png

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

Zimbra-drive-003.png

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

Zimbra-drive-002.png

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

Zimbra-drive2-001.png

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

Zimbra-drive2-002.png

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:

Zimbra-drive-005.png

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

Zimbra-drive-006.png

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

Zimbra-drive-007.png

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.

Zimbra-drive-008.png

Identified Support Issues

  • No reported issues at the moment

Zimbra Drive

800px-Zimbra-drive-logo.png

Latest Version: 8.7.6

  • Released on: Not released yet *early status*
  • Changelog
  • FAQ

Zimbra Drive Resources

Here you can find useful resources for your Zimbra Drive environment

Verified Against: Zimbra Collaboration Suite 8.7.6+ Date Created: 04/03/2017
Article ID: https://wiki.zimbra.com/index.php?title=Zimbra_Drive/How_to_Install_Zimbra_Drive Date Modified: 10/6/2017



Try Zimbra

Try Zimbra Collaboration with a 60-day free trial.
Get it now »

Want to get involved?

You can contribute in the Community, Wiki, Code, or development of Zimlets.
Find out more. »

Looking for a Video?

Visit our YouTube channel to get the latest webinars, technology news, product overviews, and so much more.
Go to the YouTube channel »


Wiki/KB reviewed by Jorge SME2 Copyeditor Last edit by Jorge de la Cruz
Jump to: navigation, search