Product SiteDocumentation Site

ZCP 7.0 (build 28890)

Plataforma de Colaboração Zarafa

Manual do Administrador

Edição 7.0

The Zarafa Team

Nota Legal

Copyright © 2011 Zarafa BV.
The text of and illustrations in this document are licensed by Zarafa BV under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at the website. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
All trademarks are the property of their respective owners.
Disclaimer: Although all documentation is written and compiled with care, Zarafa is not responsible for direct actions or consequences derived from using this documentation, including unclear instructions or missing information not contained in these documents.
The Zarafa Collaboration Platform (ZCP) combines the usability of Outlook with the stability and flexibility of a Linux server. It features a rich web-interface, the Zarafa WebAccess, and provides brilliant integration options with all sorts of clients including all most popular mobile platforms.
Most components of ZCP are open source, licensed under the AGPLv3, can therefore be downloaded freely as ZCP's Community Edition.
Several closed source components exist, most notably:
  • the Zarafa Windows Client providing Outlook integration,
  • the Zarafa BES Integration providing Blackberry Enterprise Server connectivity,
  • the Zarafa ADS Plugin providing Active Directory integration, and
  • the Zarafa Backup Tools.
These components, together with several advanced features for large setups and hosters, are only available in combination with a support contract as part of ZCP's Commercial Editions.
Alternatively there is a wide selection of hosted ZCP offerings available.
This document, the Administrator Manual, describes how to install, upgrade, configure and maintain ZCP on your Linux server. In addition various advanced configurations and integration options are discussed.

1. Introduction
1.1. Intended Audience
1.2. Architecture
1.3. Components
1.4. Protocols and Connections
1.4.1. SOAP
1.4.2. Secure HTTP (HTTPS)
1.5. ZCP Editions and Licensing
1.5.1. The evaluation subscription
1.5.2. The ZCP Community Edition
1.5.3. Commercial Editions of ZCP
1.5.4. Active and non-active users
2. Installing
2.1. System Requirements
2.1.1. Hardware Recommendations
2.1.2. Supported Platforms
2.1.3. Dependencies
2.2. Installation
2.2.1. Installing ZCP with a Package Manager
2.2.2. Installing with the Install Script
2.2.3. Manually Installing Packages
2.3. Troubleshooting Installation Issues
2.3.1. Server processes
2.3.2. WebAccess
3. Upgrading
3.1. Preparing
3.2. Creating backups
3.3. ZCP7 dependencies
3.4. Performing the Upgrade on RPM based distributions
3.5. Performing the Upgrade on Debian based distributions
3.5.1. Pre 6.40 upgrade steps
3.5.2. From 6.40 to 7.0.0 and higher
3.6. Finalizing the upgrade
4. Configure ZCP Components
4.1. Configure the Zarafa Server
4.2. Configure language on RPM based distributions
4.3. Configure language on Debian based distributions
4.4. User Authentication
4.4.1. The DB Authentication Plugin
4.4.2. The Unix Authentication Plugin
4.4.3. The LDAP Authentication Plugin
4.5. Autoresponder
4.6. Storing attachments outside the database
4.7. SSL connections and certificates
4.8. Configure the License Manager
4.9. Configure the Zarafa Spooler
4.9.1. Configuration
4.10. Configure Zarafa Caldav
4.10.1. SSL/TLS
4.10.2. Calendar access
4.11. Configure Zarafa Gateway (IMAP and POP3)
4.11.1. SSL/TLS
4.11.2. Important notes
4.12. Configure Zarafa Quota Manager
4.12.1. Setup server-wide quota
4.12.2. Setup quota per user
4.12.3. Monitoring for quota exceeding
4.12.4. Quota warning templates
4.13. Configure Zarafa Indexer
4.13.1. Enabling indexing service
4.13.2. Users, companies and servers
4.13.3. Indexer configuration
4.13.4. CLucene configuration
4.13.5. Attachments
5. Configure 3rd Party Components
5.1. Configure the Webserver
5.1.1. Configure PHP
5.1.2. Configure Apache
5.1.3. Apache as a HTTP Proxy
5.2. Configure ZCP OpenLDAP integration
5.2.1. Configuring OpenLDAP to use Zarafa schemas
5.2.2. Configuring ZCP for OpenLDAP
5.2.3. User configuration
5.2.4. Group configuration
5.2.5. Addresslist configuration
5.2.6. Testing LDAP configuration
5.3. Configure ZCP Active Directory integration
5.3.1. Installing the Zarafa ADS Plugin and schema files
5.3.2. Configuring ZCP for ADS
5.3.3. User configuration
5.3.4. Group configuration
5.3.5. Addresslist configuration
5.3.6. Testing Active Directory configuration
5.4. ZCP Postfix integration
5.4.1. Configure ZCP Postfix integration with OpenLDAP
5.4.2. Configure ZCP Postfix integration with Active Directory
5.4.3. Configure ZCP Postfix integration with virtual users
5.5. Configure Z-Push (Remote ActiveSync for Mobile Devices)
5.5.1. Compatibility
5.5.2. Security
5.5.3. Installation
5.5.4. Mobile Device Management
5.5.5. Upgrade
5.5.6. Troubleshooting
6. Advanced Configurations
6.1. Running ZCP components beyond localhost
6.2. Multi-tenancy configurations
6.2.1. Support user plugins
6.2.2. Configuring the server
6.2.3. Managing tenant (company) spaces
6.2.4. Managing users and groups
6.2.5. Quota levels
6.3. Multi-server setup
6.3.1. Introduction
6.3.2. Prepare / setup the LDAP server for multi-server setup
6.3.3. Configuring the servers
6.3.4. Creating SSL certificates
6.4. Zarafa Windows Client Updater
6.4.1. Server-side configuration
6.4.2. Client-side configuration
6.4.3. MSI Options
6.5. Running ZCP Services with regular user privileges
6.6. Single Instance Attachment Storage
6.6.1. Single Instance Attachment Storage and LMTP
6.7. Single Sign On with ZCP
6.7.1. NTLM SSO with ADS
6.7.2. NTLM SSO with Samba
6.7.3. SSO with Kerberos
6.7.4. Up and running
6.8. Tracking messages with Zarafa Archiver
6.8.1. Archive on delivery
6.8.2. Archive on send
7. Managing ZCP Services
7.1. Starting the services
7.1.1. Stopping the services
7.1.2. Reloading service configuration
7.2. Logging options
7.3. Security logging
7.3.1. Logging items
7.3.2. Configuration
7.4. Zarafa statistics monitoring
7.5. Soft Delete system
8. User Management
8.1. Public folder
8.2. General usage of Zarafa-admin tool
8.3. Users management with DB plugin
8.3.1. Creating users with DB plugin
8.3.2. Non-active users
8.3.3. Updating user information with DB plugin
8.3.4. Deleting users with DB plugin
8.3.5. Configuring ‘Send as’ permissions
8.3.6. Groups
8.4. Users management with UNIX plugin
8.4.1. Creating users with Unix plugin
8.4.2. Non-active users
8.4.3. Updating user information with Unix plugin
8.4.4. Deleting users with Unix plugin
8.4.5. Configuring ‘Send as’ permissions
8.4.6. Groups with Unix plugin
8.5. User Management with LDAP or Active Directory
8.5.1. The Zarafa user synchronization principle
8.5.2. User management from ADS
8.5.3. User management from OpenLDAP
8.6. LDAP Condition examples
8.7. Zarafa Feature management
8.7.1. Globally enabling features
8.7.2. Per-user en- or disabling features
8.8. Resource configuration
8.9. Mailbox Storage Relocator
8.9.1. Prerequisites
8.9.2. Invokation
8.9.3. Updating LDAP/ADS
8.9.4. Configuration
9. Performance Tuning
9.1. Hardware Considerations
9.1.1. Memory usage
9.1.2. Hardware considerations
9.1.3. More Memory is More Speed
9.1.4. RAID 1/10 is faster than RAID 5
9.1.5. High rotation speed (RPMs) for better database performance
9.1.6. Hardware RAID
9.2. Memory Usage setup
9.2.1. Zarafa’s Cell Cache (cache_cell_size)
9.2.2. Zarafa’s object cache (cache_object_size)
9.2.3. Zarafa’s indexedobject cache (cache_indexedobject_size)
9.2.4. MySQL innodb_buffer_pool_size
9.2.5. MySQL innodb_log_file_size
9.2.6. MySQL innodb_log_buffer_size
9.2.7. MySQL query_cache_size
9.3. Setup of modules on different servers
10. Backup & Restore
10.1. Softdelete cache
10.2. Full database dump
10.2.1. SQL dump through mysqldump
10.2.2. Binary data dump via LVM Snapshotting
10.2.3. Attachments backup
10.3. Brick-level backups
10.3.1. Backup format
10.3.2. Backup process
10.3.3. Restore process
11. BlackBerry Enterprise Server
11.1. Prerequisites
11.1.1. Software
11.1.2. Authentication Preparation
11.2. Installation steps
11.3. BES Errors
12. Appendix A; Pre-5.2x upgrade strategies
12.1. Database upgrades from 4.1 or 4.2
12.2. Upgrades from 5.0 to 5.1x and up
12.3. Important changes since 4.x and 5.x
13. Appendix B; LDAP attribute description