| | 1 | = nextcloud = |
| | 2 | |
| | 3 | Our [wiki:owncloud nextcloud] installation is running on lucius, which is currently running Debian jessie. The nextcloud application is instatlled from source. |
| | 4 | |
| | 5 | == Important details == |
| | 6 | |
| | 7 | * The application runs as the www-data user |
| | 8 | * Directories: |
| | 9 | * The code is in /var/www/nextcloud. |
| | 10 | * The data (files) are in /var/lib/nextcloud/data. |
| | 11 | * Our configuratio is in /etc/nextcloud (symlinked from /var/www/nextcloud/config) |
| | 12 | * We're using the postgres package not the mysql package. If you want to muck around in the database: `su - www-data` and then `psql nextcloud` |
| | 13 | * We're authenticating using the [wiki:login-service login-service] (web api). |
| | 14 | * That happens via our own mfplauth app, which depends on the [https://github.com/nextcloud/apps/tree/master/user_external external user auth app] |
| | 15 | * The admin username (mfpl-admin) and password are in [wiki:keyringer keyringer]. However, try to avoid logging in as mfpl-admin, and if you change any configuration options, /etc/nextcloud/config.php will get overwritten |
| | 16 | * A 5GB per user quota is set. This is configured by logging in as mfpl-admin and then clicking to administer users. Quotas can be changed on a per user basis. |
| | 17 | * To fix #8125, we've added our own custom theme called "mayfirst", which is in lucius.mayfirst.org:/var/lib/nextcloud/themes and it is activated via the theme => "mayfirst" line in lucius.mayfirst.org:/etc/nextcloud/config.php. Currently, it only adds a style sheet that simply hides the password change form. |
| | 18 | * We have committed to maintaining four extra apps, which are installed in /var/lib/nextcloud/apps-local: |
| | 19 | * [https://apps.owncloud.com/content/show.php/Documents?content=168711 Documents] |
| | 20 | * [https://apps.owncloud.com/content/show.php/Calendar?content=168707 Calendar] |
| | 21 | * [https://apps.owncloud.com/content/show.php/Contacts?content=168708 Contacts] |
| | 22 | * [https://apps.owncloud.com/content/show.php/grauphel+-+Tomboy+sync+server?content=166654 Grauphel] (see #10305) |
| | 23 | * [https://apps.owncloud.com/content/show.php/Bookmarks?content=168710 Bookmarks] (see #10696) |
| | 24 | |
| | 25 | |
| | 26 | == Upgrading == |
| | 27 | |
| | 28 | Steps to upgrade from source: |
| | 29 | |
| | 30 | * Visit https://nextcloud.org/changelog/ and download the appropriate version to /root using wget and unpack |
| | 31 | * Create symlinks that mirror the symlinks in /var/www/nextcloud |
| | 32 | * If upgrading a major version, backup /var/lib/nextcloud/apps-local and download new versions of all apps in /var/lib/nextcloud/apps-local, replacing the existing apps with the new ones. |
| | 33 | * Copy /etc/nextcloud/config.php to /etc/nextcloud/config.php.bak |
| | 34 | * Enter maintenance mode (edit to /etc/nextcloud/config.php) |
| | 35 | * Backup the database with: |
| | 36 | {{{ |
| | 37 | su -c "pg_dump nextcloud" www-data | gzip - > nextcloud.pre.$(date +%Y.%m.%d).backup.sql.gz |
| | 38 | }}} |
| | 39 | * Ensure the dump completed successfully: |
| | 40 | {{{ |
| | 41 | tail nextcloud.sql |
| | 42 | }}} |
| | 43 | * Make a backup of the current nextcloud installation: |
| | 44 | {{{ |
| | 45 | mv /var/www/nextcloud /var/www/nextcloud.version.n.n.n |
| | 46 | }}} |
| | 47 | * Move the new copy in: |
| | 48 | {{{ |
| | 49 | mv /root/nextcloud /var/www/ |
| | 50 | }}} |
| | 51 | * Ensure all database udpates have been run, su to the www-data user and then: |
| | 52 | {{{ |
| | 53 | su - www-data |
| | 54 | cd /var/www/nextcloud |
| | 55 | php occ upgrade |
| | 56 | }}} |
