Install NextCloud on Ubuntu Server 16.04 - Revision history

Ebarrier at 07:22, 7 April 2017

2017-04-07T07:22:14Z

← Older revision		Revision as of 10:22, 7 April 2017
Line 2:		Line 2:

	==Preliminary notes==		==Preliminary notes==
	This tutorial shows how to install ~~NextCloud~~ on Ubuntu 16.04 LTS Server, using MariaDB (as for database) and Apache 2 (as for web server).		This tutorial shows how to install Nextcloud on Ubuntu 16.04 LTS Server, using MariaDB (as for database) and Apache 2 (as for web server).

	This tutorial does NOT show:		This tutorial does NOT show:
	* how to install/configure databases other than MariaDB (although MySQL can be considered the same)		* how to install/configure databases other than MariaDB (although MySQL can be considered the same)
	* how to install/configure web servers other than Apache2 (for example Nginx)		* how to install/configure web servers other than Apache2 (for example Nginx)
	* how to use ~~NextCloud~~		* how to use Nextcloud

Ebarrier: /* Enable caching */

2017-04-07T06:58:02Z

Enable caching

← Older revision		Revision as of 09:58, 7 April 2017
Line 374:		Line 374:


	[[FILE:Nextcloud_cacheMissing.png\|border\|~~600px~~\|center]]		[[FILE:Nextcloud_cacheMissing.png\|border\|900px\|center]]

Ebarrier at 06:56, 7 April 2017

2017-04-07T06:56:45Z

← Older revision		Revision as of 09:56, 7 April 2017
Line 373:		Line 373:
	On a clean Nextcloud installation the following admin screen is visible.		On a clean Nextcloud installation the following admin screen is visible.

	~~IMAGE cacheMissing~~
			[[FILE:Nextcloud_cacheMissing.png\|border\|600px\|center]]


	Different caching solutions and configurations can be used depending on type of server implementation. We only show how to install and configure caching for a small organization architecture with a single Nextcloud server. For more architecture examples, see [https://docs.nextcloud.com/server/11/admin_manual/configuration_server/caching_configuration.html Nextcloud's official documentation].		Different caching solutions and configurations can be used depending on type of server implementation. We only show how to install and configure caching for a small organization architecture with a single Nextcloud server. For more architecture examples, see [https://docs.nextcloud.com/server/11/admin_manual/configuration_server/caching_configuration.html Nextcloud's official documentation].

Ebarrier: /* Enable caching */

2017-04-05T14:42:06Z

Enable caching

← Older revision		Revision as of 17:42, 5 April 2017
Line 377:		Line 377:
	Different caching solutions and configurations can be used depending on type of server implementation. We only show how to install and configure caching for a small organization architecture with a single Nextcloud server. For more architecture examples, see [https://docs.nextcloud.com/server/11/admin_manual/configuration_server/caching_configuration.html Nextcloud's official documentation].		Different caching solutions and configurations can be used depending on type of server implementation. We only show how to install and configure caching for a small organization architecture with a single Nextcloud server. For more architecture examples, see [https://docs.nextcloud.com/server/11/admin_manual/configuration_server/caching_configuration.html Nextcloud's official documentation].

	We use APCu <ref>[http://php.net/manual/en/book.apcu.php] PHP.net official documentation - APCu cache system</ref> as the cache system and Redis ~~<ref>[https://redis.io] Redis official documentation</ref>~~ as the file locking system.		We use APCu <ref>[http://php.net/manual/en/book.apcu.php] PHP.net official documentation - APCu cache system</ref> as the cache system and Redis as the file locking system.

	First install APCu:		First install APCu:
Line 401:		Line 401:

	After refreshing Nextcloud page, check that the cache warning message disappeared.		After refreshing Nextcloud page, check that the cache warning message disappeared.


	===Enable transactional file locking===		===Enable transactional file locking===

Ebarrier at 13:40, 5 April 2017

2017-04-05T13:40:40Z

← Older revision		Revision as of 16:40, 5 April 2017
Line 434:		Line 434:
	$ mv redis-stable redis		$ mv redis-stable redis
	</syntaxhighlight>		</syntaxhighlight>


	Compile Redis and test it:		Compile Redis and test it:
Line 441:		Line 442:
	$ make test ## This will take time		$ make test ## This will take time
	</syntaxhighlight>		</syntaxhighlight>


	If all the tests are successful, install Redis:		If all the tests are successful, install Redis:
Line 538:		Line 540:
	),		),
	</syntaxhighlight>		</syntaxhighlight>


	==Troubleshoot==		==Troubleshoot==

	While on <nowiki>http://</nowiki>''yourDomainOrIp''/nextcloud, there can be errors. Here the most probable ones with their fix.		While on <nowiki>http://</nowiki>''yourDomainOrIp''/nextcloud, there can be errors. Here the most probable ones with their fix.


	===Database access denied===		===Database access denied===

Ebarrier: /* Enable transactional file locking */

2017-04-05T08:43:26Z

Enable transactional file locking

← Older revision		Revision as of 11:43, 5 April 2017
Line 412:		Line 412:

	The commands below mostly rely on the [https://www.techandme.se/install-redis-cache-on-ubuntu-server-with-php-7-and-owncloud/ following tutorial.]		The commands below mostly rely on the [https://www.techandme.se/install-redis-cache-on-ubuntu-server-with-php-7-and-owncloud/ following tutorial.]


			====Install Redis====

	First install the packages we will need to install Redis (GNU C and C++ compilers, etc.):		First install the packages we will need to install Redis (GNU C and C++ compilers, etc.):
Line 480:		Line 483:
	</syntaxhighlight>		</syntaxhighlight>


			====Install Redis PHP module====

	Now we install the Redis PHP 7 module. This module provides an API to PHP to communicate with a Redis server.		Now we install the Redis PHP 7 module. This module provides an API to PHP to communicate with a Redis server.

Ebarrier: /* Enable transactional file locking */

2017-04-05T08:42:19Z

Enable transactional file locking

← Older revision		Revision as of 11:42, 5 April 2017
Line 484:		Line 484:

	'''''Note:''' The <code>php-redis</code> package from [http://packages.ubuntu.com/xenial Ubuntu Xenial (16.04) repository] is of version 2.2.x which only works with PHP 5.6.x <ref>[https://docs.nextcloud.com/server/11/admin_manual/configuration_server/caching_configuration.html#additional-redis-installation-help] Nextcloud's official documentation - Additional Redis Installation Help</ref>''.		'''''Note:''' The <code>php-redis</code> package from [http://packages.ubuntu.com/xenial Ubuntu Xenial (16.04) repository] is of version 2.2.x which only works with PHP 5.6.x <ref>[https://docs.nextcloud.com/server/11/admin_manual/configuration_server/caching_configuration.html#additional-redis-installation-help] Nextcloud's official documentation - Additional Redis Installation Help</ref>''.


	PHP 7 needs the Redis PHP module 3.1.x or higher. We use the latest stable version of the module directly from its [https://pecl.php.net/package/redis PECL repository].		PHP 7 needs the Redis PHP module 3.1.x or higher. We use the latest stable version of the module directly from its [https://pecl.php.net/package/redis PECL repository].

	'''''Note:''' [https://www.techandme.se/install-redis-cache-on-ubuntu-server-with-php-7-and-owncloud this tutorial] installs Redis PHP 7 module directly from the module's git repository<ref>[https://github.com/phpredis/phpredis] PHPRedis module official Git repository</ref>. But ~~doing~~ using this method does not install the latest version of the module that can be found on [https://pecl.php.net/package/redis PECL repository].''
			'''''Note:''' [https://www.techandme.se/install-redis-cache-on-ubuntu-server-with-php-7-and-owncloud this tutorial] installs Redis PHP 7 module directly from the module's git repository<ref>[https://github.com/phpredis/phpredis] PHPRedis module official Git repository</ref>. But using this method does not install the latest version of the module that can be found on [https://pecl.php.net/package/redis PECL repository].''


	First install the PHP development tools ("phpize" which will be used later), the Pear PHP extension repository tools:		First install the PHP development tools ("phpize" which will be used later), the Pear PHP extension repository tools:

Ebarrier: /* Improve Nextcloud */

2017-04-05T08:38:27Z

Improve Nextcloud

← Older revision		Revision as of 11:38, 5 April 2017
Line 522:		Line 522:


	Finally add the following ~~line to~~ Nextcloud's config ~~file~~:		Finally add the following lines in the <code>config.php</code> file of your Nextcloud installation (''/var/www/nextcloud/config/config.php'' in our example):
	<~~pre~~>		<syntaxhighlight lang="php">
	'memcache.locking' => '\OC\Memcache\Redis',		'memcache.locking' => '\OC\Memcache\Redis',
	'redis' => array(		'redis' => array(
Line 529:		Line 529:
	'port' => 6379,		'port' => 6379,
	),		),
	</~~pre~~>		</syntaxhighlight>

	==Troubleshoot==		==Troubleshoot==

Ebarrier: /* Enable transactional file locking */

2017-04-05T08:37:25Z

Enable transactional file locking

@@ Line 520: / Line 520: @@
 $ php --ri redis
 </syntaxhighlight>
 ==Troubleshoot==

Ebarrier: /* Enable transactional file locking */

2017-04-05T08:32:36Z

Enable transactional file locking

← Older revision		Revision as of 11:32, 5 April 2017
Line 485:		Line 485:
	'''''Note:''' The <code>php-redis</code> package from [http://packages.ubuntu.com/xenial Ubuntu Xenial (16.04) repository] is of version 2.2.x which only works with PHP 5.6.x <ref>[https://docs.nextcloud.com/server/11/admin_manual/configuration_server/caching_configuration.html#additional-redis-installation-help] Nextcloud's official documentation - Additional Redis Installation Help</ref>''.		'''''Note:''' The <code>php-redis</code> package from [http://packages.ubuntu.com/xenial Ubuntu Xenial (16.04) repository] is of version 2.2.x which only works with PHP 5.6.x <ref>[https://docs.nextcloud.com/server/11/admin_manual/configuration_server/caching_configuration.html#additional-redis-installation-help] Nextcloud's official documentation - Additional Redis Installation Help</ref>''.

	PHP 7 needs the Redis PHP module 3.1.x or higher. We use the latest stable version of the module directly from its ~~git repository <ref>~~[https://~~github~~.~~com~~/~~phpredis~~/~~phpredis~~] ~~PHPRedis module official Git repository</ref>~~.		PHP 7 needs the Redis PHP module 3.1.x or higher. We use the latest stable version of the module directly from its [https://pecl.php.net/package/redis PECL repository].

	First install the PHP development tools ("phpize" which will be used later) ~~and git (if not already installed)~~:		'''''Note:''' [https://www.techandme.se/install-redis-cache-on-ubuntu-server-with-php-7-and-owncloud this tutorial] installs Redis PHP 7 module directly from the module's git repository<ref>[https://github.com/phpredis/phpredis] PHPRedis module official Git repository</ref>. But doing using this method does not install the latest version of the module that can be found on [https://pecl.php.net/package/redis PECL repository].''

			First install the PHP development tools ("phpize" which will be used later), the Pear PHP extension repository tools:
	<syntaxhighlight lang="bash">		<syntaxhighlight lang="bash">
	$ apt install php7.0-dev ~~git~~		$ apt install php7.0-dev php-pear
	</syntaxhighlight>		</syntaxhighlight>

	~~'''SAVED URL: https://community.openenergymonitor.org/t/php-redis-3-1-1/3124/11'''~~

	~~We clone~~ the ~~git~~ repository:		Install the nodule from PECL repository:
	<syntaxhighlight lang="bash">		<syntaxhighlight lang="bash">
	$ ~~git clone https://github.com/phpredis/phpredis.git~~		$ pecl install redis
	</syntaxhighlight>		</syntaxhighlight>


	~~Move~~ the ~~directory ''phpredis''~~ to ~~''/etc/'' and we <code>cd</code> into~~ it:		For the web server to use the module, add it to php.ini:
	<syntaxhighlight lang="bash">		<syntaxhighlight lang="bash">
	$ ~~mv phpredis~~/ /~~etc~~/		$ touch /etc/php/7.0/mods-available/redis.ini
	$ cd /etc/~~phpredis~~		$ echo 'extension=redis.so' > /etc/php/mods-available/redis.ini
	</syntaxhighlight>		</syntaxhighlight>
			'''''Note:''' the above can be achieved by adding the line "extension=redis.so" directly into the php.ini file which is situated at /etc/php/7.0/apache2/php.ini.''


	~~Install PHPRedis ([https://github.com/phpredis/phpredis#installation as per~~ the ~~installation instructions])~~:		Enable the module and restart the web server:
	<syntaxhighlight lang="bash">		<syntaxhighlight lang="bash">
	$ ~~phpize~~		$ phpenmod redis
	$ ~~./configure~~		$ service apache2 restart
	~~$ make~~
	~~$ make install~~
	</syntaxhighlight>		</syntaxhighlight>

	~~For~~ the ~~web server to use~~ the module~~, add it to php.ini~~:
			Check the version of the module:
	<syntaxhighlight lang="bash">		<syntaxhighlight lang="bash">
	$ ~~touch /etc/~~php~~/7.0/mods~~-~~available/redis.ini~~		$ php --ri redis
	~~$ echo 'extension=redis.so' > /etc/php/mods~~-~~available/~~redis~~.ini~~
	</syntaxhighlight>		</syntaxhighlight>
	~~'''''Note:''' the above can be achieved by adding the line "extension=redis.so" directly into the php.ini file which is situated at /etc/php/7.0/apache2/php.ini.''~~

	==Troubleshoot==		==Troubleshoot==