Zimbra Drive/How to Install Zimbra Drive


How to Install Zimbra Drive

   KB 23159        Last updated on 05/10/2017  




0.00
(0 votes)
Article-check.png  - This is certified documentation and is protected for editing by Zimbra Employees & Moderators only.
 - This article is a Work in Progress, and may be unfinished or missing sections.


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

At the moment, and meanwhile Zimbra works into add this configuration on a LDAP attribute, 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 by following the next steps:

cd /tmp
wget https://download.zextras.com/drive/zimbradrive.tar.gz
tar xzvf zimbradrive*
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:

  • 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
  • Disable 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

Zimbra-drive-004.png

How to Edit the Zimbra Drive configuration on ownCloud/nextCloud

This step might be not necessary on the future, but for now you need to edit manually the next file /var/www/nextcloud/config/config.php and add at the end, for example: 'instanceid' => 'XXXXXXXX', add this:

  'user_backends' => array (
   0 => array (
     'class' => 'OC_User_Zimbra',
     'arguments' => array(),
    )
  )
);

It's really important that the config file looks like the example with all the commas and so on

Now it's time to restart the apache, or nginx service, you can always restart the ownCloud/nextCloud server as well

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: 05/10/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 Mingo
Jump to: navigation, search