Difference between revisions of "Zimbra Drive/How to Install Zimbra Drive"
m (→How to install Zimbra Drive app on the ownCloud/nextCloud server) |
m (→ZCS 8.7.6 only) |
||
Line 144: | Line 144: | ||
====ZCS 8.7.6 only==== | ====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 | vi /opt/zimbra/lib/ext/zimbradrive/zimbradrive-extension.conf | ||
Revision as of 15:20, 6 October 2017
Contents
How to Install Zimbra Drive
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:
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
Zimbra Drive
Zimbra Drive Resources
Here you can find useful resources for your Zimbra Drive environment
- What is Zimbra Drive?
- FAQs
- Downloads (included in ZCS 8.7.6 and above)
- Zimbra Drive Installation Guide
- Known Issues
- How to report a Zimbra Drive Issue
- Zimbra Drive Forums