Owncloud Server Administration Manual Release 9.1
Total Page:16
File Type:pdf, Size:1020Kb
ownCloud Server Administration Manual Release 9.1 The ownCloud developers July 18, 2016 CONTENTS 1 ownCloud 9.1 Server Administration Manual Introduction1 1.1 Introduction...............................................1 1.2 ownCloud Videos and Blogs.......................................1 1.3 Target Audience.............................................1 2 ownCloud 9.1 Release Notes 3 2.1 Changes in 9.0..............................................3 2.2 Enterprise 9.0...............................................3 2.3 Changes in 8.2..............................................3 2.4 Changes in 8.1..............................................4 2.5 Enterprise 8.1 Only............................................5 2.6 ownCloud 8.0...............................................5 2.7 Enterprise 8.0 Only............................................7 2.8 ownCloud 7 Release Notes........................................7 2.9 Enterprise 7 Only.............................................9 3 What’s New for Admins in ownCloud 9.1 11 3.1 Enterprise Only.............................................. 11 4 Installation 13 4.1 System Requirements.......................................... 13 4.2 ownCloud Deployment Recommendations............................... 14 4.3 Preferred Linux Installation Method................................... 21 4.4 Installation Wizard............................................ 23 4.5 Installing ownCloud From the Command Line............................. 28 4.6 Changing the web route......................................... 29 4.7 Installing and Managing Apps...................................... 29 4.8 Supported Apps in ownCloud...................................... 32 4.9 Manual Installation on Linux...................................... 33 4.10 ownCloud Community Appliance.................................... 39 4.11 Installing PHP 5.4 on RHEL 6 and CentOS 6.............................. 41 4.12 Installing PHP 5.5 on RHEL 7 and CentOS 7.............................. 42 4.13 SELinux Configuration.......................................... 44 4.14 Nginx Example Configurations..................................... 45 4.15 Nginx Configuration for the ownCloud 9.x Branches.......................... 50 5 ownCloud Server Configuration 55 5.1 Warnings on Admin Page........................................ 55 5.2 Using the occ Command......................................... 57 5.3 Configuring the Activity App...................................... 77 5.4 Configuring the ClamAV Antivirus Scanner............................... 78 i 5.5 Configuring Memory Caching...................................... 81 5.6 Defining Background Jobs........................................ 85 5.7 Config.php Parameters.......................................... 86 5.8 Email Configuration........................................... 105 5.9 Linking External Sites.......................................... 112 5.10 Custom Client Download Repositories................................. 114 5.11 Knowledge Base Configuration..................................... 116 5.12 Language Configuration......................................... 116 5.13 Logging Configuration.......................................... 116 5.14 Hardening and Security Guidance.................................... 117 5.15 Reverse Proxy Configuration....................................... 120 5.16 Using Third Party PHP Components................................... 121 5.17 JavaScript and CSS Asset Management................................. 122 5.18 Automatic Configuration Setup..................................... 122 5.19 ownCloud Server Tuning......................................... 124 6 User Management 127 6.1 User Management............................................ 127 6.2 Resetting a Lost Admin Password.................................... 131 6.3 Resetting a User Password........................................ 132 6.4 User Authentication with IMAP, SMB, and FTP............................ 132 6.5 User Authentication with LDAP..................................... 134 6.6 LDAP User Cleanup........................................... 148 6.7 User Provisioning API.......................................... 149 7 File Sharing and Management 163 7.1 File Sharing............................................... 163 7.2 Configuring Federation Sharing..................................... 166 7.3 Uploading big files > 512MB...................................... 170 7.4 Configuring the Collaborative Documents App............................. 173 7.5 Providing Default Files.......................................... 175 7.6 Configuring External Storage (GUI)................................... 177 7.7 Configuring External Storage (Configuration File)........................... 196 7.8 External Storage Authentication mechanisms.............................. 197 7.9 Encryption Configuration........................................ 197 7.10 Transactional File Locking........................................ 205 7.11 Previews Configuration......................................... 207 7.12 Controlling File Versions and Aging................................... 208 8 Database Configuration 211 8.1 Converting Database Type........................................ 211 8.2 Database Configuration......................................... 212 9 Mimetypes Management 219 9.1 Mimetype Aliases............................................ 219 9.2 Mimetype mapping............................................ 219 9.3 Icon retrieval............................................... 220 10 Maintenance 221 10.1 Maintenance Mode Configuration.................................... 221 10.2 Backing up ownCloud.......................................... 221 10.3 How to Upgrade Your ownCloud Server................................. 222 10.4 Upgrade ownCloud From Packages................................... 223 10.5 Upgrading ownCloud with the Updater App............................... 225 10.6 Manual ownCloud Upgrade....................................... 228 ii 10.7 Restoring ownCloud........................................... 230 10.8 Migrating to a Different Server..................................... 231 11 Operations 233 11.1 Considerations on Monitoring...................................... 233 11.2 Scaling Across Multiple Machines.................................... 234 11.3 Theming ownCloud........................................... 238 12 Issues and Troubleshooting 239 12.1 General Troubleshooting......................................... 239 12.2 Code Signing............................................... 244 13 Enterprise Edition Only 249 13.1 Enterprise Edition Installation...................................... 249 13.2 Creating Branded ownCloud Clients (Enterprise only)......................... 255 13.3 Enterprise Server Branding (Enterprise only).............................. 256 13.4 External Storage (Enterprise only).................................... 258 13.5 User Management (Enterprise only)................................... 278 13.6 Enterprise File Management (Enterprise Only)............................. 287 13.7 Enterprise Logging Apps (Enterprise only)............................... 294 13.8 Enterprise Firewall (Enterprise only).................................. 295 13.9 Enterprise Troubleshooting....................................... 299 iii iv CHAPTER ONE OWNCLOUD 9.1 SERVER ADMINISTRATION MANUAL INTRODUCTION 1.1 Introduction Welcome to the ownCloud Server Administration Guide. This guide describes administration tasks for ownCloud, the flexible open source file synchronization and sharing solution. ownCloud includes the ownCloud server, which runs on Linux, client applications for Microsoft Windows, Mac OS X and Linux, and mobile clients for the Android and Apple iOS operating systems. Current editions of ownCloud manuals are always available online at doc.owncloud.org and doc.owncloud.com. ownCloud server is available in three editions: • The free community-supported Server. This is the core server for all editions. • The Standard Subscription for customers who want paid support for the core Server, without Enterprise appli- cations. • The Enterprise Subscription provides paid support for the Enterprise Edition. This includes the core Server and Enterprise apps. See What’s New for Admins in ownCloud 9.1 for more information on the different ownCloud editions. 1.2 ownCloud Videos and Blogs See the official ownCloud channel and ownClouders community channel on YouTube for tutorials, overviews, and conference videos. Visit ownCloud Planet for news and developer blogs. 1.3 Target Audience This guide is for users who want to install, administer, and optimize their ownCloud servers. To learn more about the ownCloud Web user interface, and desktop and mobile clients, please refer to their respective manuals: • ownCloud User Manual • ownCloud Desktop Client • ownCloud Android App • ownCloud iOS App 1 ownCloud Server Administration Manual, Release 9.1 2 Chapter 1. ownCloud 9.1 Server Administration Manual Introduction CHAPTER TWO OWNCLOUD 9.1 RELEASE NOTES 2.1 Changes in 9.0 9.0 requires .ico files for favicons. This will change in 9.1, which will use .svg files. See Changing favicon in the Developer Manual. Home folder rule is enforced in the user_ldap application in new ownCloud installations; see User Authentication with LDAP. This affects ownCloud 8.0.10, 8.1.5 and 8.2.0 and up. The Calendar and Contacts apps have been rewritten and the CalDAV and CardDAV backends of these apps were merged into ownCloud core. During the upgrade existing Calendars