KC Administrator Manual Release 8.0.0
Total Page:16
File Type:pdf, Size:1020Kb
KC Administrator Manual Release 8.0.0 Kopano BV Jul 01, 2021 Contents 1 Abstract 2 2 Introduction 3 2.1 Intended Audience..........................................3 2.2 Architecture.............................................3 2.3 Components.............................................4 2.4 Protocols and Connections......................................5 3 Installing 6 3.1 System Requirements........................................6 3.2 Installation..............................................9 3.3 Troubleshooting Installation Issues................................. 11 3.4 SSL.................................................. 12 4 Upgrading 14 4.1 Preparing............................................... 14 4.2 Creating backups........................................... 15 4.3 KC 8 dependencies.......................................... 16 4.4 Performing the Upgrade on RPM based distributions........................ 16 4.5 Performing the Upgrade on Debian based distributions....................... 16 4.6 Finalizing the upgrade........................................ 18 5 Configure KC Components 20 5.1 Configure the Kopano Server.................................... 20 5.2 Configure Kopano Konnect..................................... 27 5.3 Configure Kopano Kraph....................................... 30 5.4 Configure the Kopano Spooler.................................... 31 5.5 Configure Kopano Caldav...................................... 32 5.6 Configure Kopano Gateway (IMAP and POP3)........................... 33 5.7 Configure Kopano Quota Manager.................................. 34 5.8 Configure Kopano Search...................................... 35 5.9 Configure Kopano WebApp..................................... 37 5.10 Configure Kopano for user management with LDAP (e.g. OpenLDAP/ADS)........... 38 5.11 Postfix integration.......................................... 46 5.12 Configure Z-Push (ActiveSync for Mobile Devices)........................ 51 6 Special KC Configurations 58 6.1 Running KC components beyond localhost............................. 58 6.2 Multi-tenancy configurations..................................... 59 6.3 Multi-server setup.......................................... 64 6.4 Single Instance Attachment Storage................................. 69 i 6.5 Single Sign On with KC....................................... 70 6.6 Tracking messages with Kopano Archiver.............................. 77 6.7 Kopano Python plugin framework.................................. 78 6.8 Running KC multi-server behind Reverse Proxy.......................... 81 6.9 Running KC with Active Directory in multi-forest environment.................. 84 6.10 Configuring kopano-spamd for automatic spam/ham learning................... 85 7 Managing KC Components 86 7.1 Starting the services......................................... 86 7.2 Logging options........................................... 87 7.3 Security logging........................................... 87 7.4 Kopano statistics monitoring..................................... 90 7.5 Soft Delete system.......................................... 91 8 User Management 92 8.1 Public folder............................................. 92 8.2 General usage of kopano-admin tool................................. 92 8.3 Users management with DB plugin................................. 94 8.4 Users management with UNIX plugin................................ 97 8.5 User Management with LDAP or Active Directory......................... 98 8.6 LDAP Condition examples...................................... 103 8.7 Kopano Feature management.................................... 103 8.8 Resource configuration........................................ 105 8.9 Out of office management...................................... 106 9 Performance Tuning 108 9.1 Hardware Considerations...................................... 108 9.2 Memory Usage setup......................................... 109 9.3 Setup of modules on different servers................................ 111 10 Backup & Restore 113 10.1 Softdelete restore........................................... 113 10.2 Full database dump.......................................... 114 10.3 Brick-level backups......................................... 115 11 High Availability 116 11.1 High Availability example setups.................................. 116 11.2 Installing............................................... 118 11.3 DRBD device initialization..................................... 121 11.4 Pacemaker configuration....................................... 123 11.5 Testing configuration......................................... 126 11.6 Testing a node failure........................................ 127 11.7 Testing a resource failure....................................... 127 11.8 Getting more information...................................... 127 12 Release Notes 128 12.1 Release notes for 8.5.0 (2018-02-05)................................ 128 12.2 Release notes for 8.4.7........................................ 129 12.3 Release notes for 8.4.6 (2018-02-02)................................ 129 12.4 Release notes for 8.4.5 (2017-12-15)................................ 129 12.5 Release notes for 8.4.4 (2017-11-23)................................ 129 12.6 Release notes for 8.4.3 (2017-11-07)................................ 130 12.7 Release notes for 8.4.2 (2017-11-02)................................ 130 12.8 Release notes for 8.4.1 (2017-11-01)................................ 130 12.9 Release notes for 8.4.0 (2017-10-30)................................ 130 12.10 Release notes for 8.3.5 (unreleased/state of 2017-10-31)...................... 132 12.11 Release notes for 8.3.4 (2017-09-01)................................ 132 12.12 Release notes for 8.3.3 (2017-08-09)................................ 133 12.13 Release notes for 8.3.2 [2017-07-06]................................ 133 ii 12.14 Release notes for 8.3.1 [2017-06-20]................................ 133 12.15 Release notes for 8.3.0 [2017-04-27]................................ 134 12.16 Release notes for 8.2.0 [2017-02-17]................................ 135 12.17 Kopano Core 8.1.0.......................................... 137 12.18 Kopano Core 8.0.1.......................................... 137 13 Compiling from source 139 13.1 Installing Kopano Core from Source................................. 139 13.2 Installing Kopano MMC Snap-in from Source........................... 139 14 Appendix A: Upgrade strategies 143 14.1 Upgrade from Zarafa Collaboration Platform............................ 143 15 Appendix B: LDAP attribute description 144 16 Appendix C: Example LDIF 150 17 Appendix D: Common MAPI Errors 152 18 Legal Notice 155 iii KC Administrator Manual, Release 8.0.0 Edition 8.3.0 - Kopano Team This document, the Kopano Core Administrator Manual, describes how to install, upgrade, configure and maintain KC on your system. In addition various advanced configurations and integration options are covered. Contents 1 CHAPTER 1 Abstract Kopano Core provides the core MAPI-enabled messaging stack with the stability and flexibility of the linux platform. Kopano Core acts as the solid foundation for groupware messaging based on MAPI and enabling rich web clients such as Kopano WebApp or Kopano DeskApp as well as mobile and sync clients. With the modular architecture, Kopano Core hereby allows a variety of setup scenarios, scalable from a very low powered system to a multi-datacenter setup providing messaging capabilities to tens of thousands of users. Kopano Core is entirely open source, licensed under the GNU Affero General Public License version 3, and can be downloaded from Kopano’s download servers. Kopano Core is provided in two ways: • Repositories, available to customers with a valid Kopano subscription. • Downloadable & installable packages for community usage. 2 CHAPTER 2 Introduction Kopano Groupware Core (KGC) is an open source software suite capable of providing a complete MAPI-based groupware stack with extensive interfacing capabilities. It’s architecture is very modular, makes use of standards wherever possible, and integrates with common open source components. This document explains how to perform the most common administrative tasks with KGC. Important: Although we, Kopano, try our best to keep the information in this manual as accurate as possible, we reserve the right to modify this information at any time, without prior notice. 2.1 Intended Audience This manual is intended for system administrators responsible for installing, maintaining, and supporting the KGC deployment. We assume readers of this manual will a thorough understanding of: • Linux system administration concepts and tasks • Email communication standards • Security concepts • Directory services • Database management 2.2 Architecture In accord with the UNIX philosophy, KGC consists of components that each take care of a well defined task. See the KGC Architecture Diagram which describes the relationships between the components and the protocols used. This diagram describes a simple setup as used by most of our customers. Only the most commonly used components are shown in the diagram. The top part of the diagram shows the clients: software appliances by which users access their data. Some of these appliances are desktop applications, some are mobile applications. 3 KC Administrator Manual, Release 8.0.0 In between “The Internet” and the “Kopano Server”, the infrastructure components of Kopano (blue) and some common infrastructure components (grey) can be found. These