Truedoc

NextcloudConfig » Cronologia » Versione 3

Versione 2 (Chiara Barbucci, 16-10-2018 13:09) → Versione 3/5 (Simone Piccardi, 16-10-2018 13:13)

h1. Installare Nextcloud 14 su Debian Stretch 

 Nextcloud è una applicazione web che consente di creare su un proprio server un cloud personale su cui mantenere contatti, calendari, file, senza doversi appoggiare a servizi di terzi. É una soluzione ideale che consente di mantenere privati i propri dati e non perderne il controllo, fornendo al contempo un'ampia gamma di servizi via web, compresa una funzionale piattaforma di videoconferenza. 

 Si prenderanno in esame tutti i passi necessari per installare l'ultima versione di Nextcloud (la 14) su una Debian Stretch. 

 h2. Operazioni preliminari 

 Prima di installare Nextcloud devono essere installati i servizi da cui esso dipende. Benché sia possibile usarlo in fase di test con @sqlite@ viene comunque consigliato di utilizzare in produzione un database server esterno.    Nel nostro caso utilizzeremo MySQL (o meglio MariaDB) per la cui installazione dovremo eseguire: 

 <pre> 
 apt-get install mysql-server || apt-get install mariadb-server 
 </pre> 

 (i due comandi sono equivalenti, da Debian Stretch MariaDB sostituisce in maniera trasparente MySQL). 

 L'installazione di default di MySQL/MariaDB usa però il supporto standard UTF8 di MySQL, che è un UTF8 finto a 3 byte che crea problemi non appena si userà uno qualunque dei caratteri UTF8, assolutamente legali, che non rientrano nella versione ridotta (ad esempio le emoticon). 

 Per questo motivo, per poter usare davvero UTF8, occorre riconfigurare opportunamente il server. Questo può essere fatto aggiungendo sotto 
 @/etc/mysql/mariadb.conf.d@ un ulteriore file di configurazione (ad esempio @60-nextcloud-mysqld.cnf@) contenente: 

 <pre> 
 [mysqld] 
 character-set-server = utf8mb4 
 collation-server = utf8mb4_general_ci 
 transaction_isolation = READ-COMMITTED 
 binlog_format = ROW 
 innodb_large_prefix = on 
 innodb_file_format = barracuda 
 innodb_file_per_table = 1 
 </pre> 

 Si riavvii poi il servizio (con @service mysql restart@) prima di creare qualunque database. Una volta creato il database di Nextcloud (argomento 
 trattato più avanti), si controlli dalla console di MySQL con:  

 <pre> 
 MariaDB [(none)]> SELECT NAME, SPACE, FILE_FORMAT FROM INFORMATION_SCHEMA.INNODB_SYS_TABLES WHERE NAME like "nextcloud%"; 
 </pre> 

 che tutte le tabelle abbiano @Barracuda@ come valore della colonna @FILE_FORMAT@. Qualora questo non accadesse (ma se si esegue la configurazione 
 indicata prima di creare il database questo non avverrà) si può consultare https://docs.nextcloud.com/server/14/admin_manual/configuration_database/mysql_4byte_support.html per maggiori dettagli su come risolvere la questione. 


 Nextcloud è supportato da diversi web server, nel nostro caso utilizzeremo come server Apache2 con @mod_php@, pertanto occorrerà installare anche: 

 <pre> 
 apt-get install apache2 libapache2-mod-php 
 </pre> 

 Si tenga presente che il default di Debian per Apache è l'MPM event, ma PHP necessita del worker, ma questo viene installato e configurato solo          se si installa Apache insieme a PHP, se l'installazione di Apache è già stata fatta il modulo di PHP potrebbe non venire configurato, in tal caso occorrerà forzare l'uso del worker effettuando la riconfigurazione di Apache con: 

 <pre> 
 a2dismod mpm_event 
 a2enmod mpm_prefork 
 a2enmod php7.0 
 </pre> 

 Inoltre per poter utilizzare le varie funzionalità di Nextcloud serviranno inoltre gli ulteriori pacchetti PHP: 

 <pre> 
 apt-get install php-gd php-json php-mysql php-curl php-intl php-mcrypt \ 
   php-imagick php-xml php-zip php-bz2 php-gmp php-mbstring 
 </pre> 

 se oltre alle funzionalità di base servono è necessario collegarsi a IMAP e LDAP (come backend di autenticazione) occorreranno anche: 

 <pre> 
 apt-get install php-imap php-ldap 
 </pre> 

 h2. Installazione di Nextcloud 

 Per l'installazione occorre scaricare i sorgenti che si possono ottenere direttamente sul sito del progetto a partire dall'indirizzo 
 https://nextcloud.com/install (utilizzare il pulsante per il download per ottenere la pagina con i link). Si scarichi l'archivio della versione più recente e la relativa checksum dai collegamenti indicati nella pagina, alla stesura di queste note si è eseguito: 

 <pre> 
 wget https://download.nextcloud.com/server/releases/nextcloud-14.0.2.tar.bz2 
 wget https://download.nextcloud.com/server/releases/nextcloud-14.0.2.tar.bz2.sha256 
 </pre> 

 e si ricordi di verificare l'autenticità della checksum con la chiave GPG del progetto, dopo di che si potrà verificare la correttezza del download eseguendo nella directory dove si sono scaricati i file: 

 <pre> 
 root@nextcloud:~# sha256sum -c nextcloud-14.0.2.tar.bz2.sha256  
 nextcloud-14.0.2.tar.bz2: OK 
 </pre> 

 a questo punto si potranno scompattare i sorgenti ed installarli nella directory di destinazione con: 

 <pre> 
 tar -xvjf nextcloud-14.0.2.tar.bz2 
 mv nextcloud /var/www/ 
 </pre> 

 Si consiglia inoltre, per semplificarsi la vita durante gli aggiornamenti, di spostare la directory dei dati al di fuori di quella di installazione, per questo la si crei con: 

 <pre> 
 mkdir -p /srv/nextcloud/data  
 chown www-data:www-data /srv/nextcloud/data 
 chmod 750 /srv/nextcloud/data 
 </pre> 

 Per impostare i permessi si può anche usare lo script @nextcloudperm.sh@ allegato a questa pagina. Lo script è stato creato per gestire gli 
 aggiornamenti, e consente di portare i permessi del codice ad uno stato in cui Apache può scrivere sui file, in modo da poter effettuare direttamente dall'interfaccia web gli aggiornamenti o le eventuali installazioni delle apps, per poi tornare ad una situazione, più sicura, in cui il server web non può più modificare il codice dell'applicativo. 

 In generale, a parte le directory in cui è necessario il permesso di scrittura, file e directory devono appartenere a @root@ ed al gruppo @www-data@ e non essere accessibili dagli altri (con permessi rispettivamente 640 e 750). 

 Lo script prevede come primo argomento uno fra i valori di @start@ o @stop@ che rispettivamente attivano la scrivibilità generale o la rimuovono 
 riportandola ai soli file necessari. Pertanto per impostare i permessi ai valori corretti per la produzione basterà eseguire: 

 <pre> 
 ./nextcloudperm.sh stop 
 ./nextcloudperm.sh start 
 </pre> 

 Lo script assume come directory per il codice @/var/www/nextcloud@ e @/srv/nextcloud/data@ per i dati, se si esegue l'installazione altrove lo si modifichi opportunamente. 


 h2. Configurazione di Apache per Nextcloud 

 Una volta installato il software occorrerà creare un virtual host dedicato (ad esempio in @/etc/apache2/sites-available/nextcloud.conf@) con qualcosa del tipo: 

 <pre> 
 <VirtualHost *:80> 
         ServerName nextcloud.truelite.it 
         DocumentRoot /var/www/nextcloud 
         AddDefaultCharset utf-8 
	 Redirect permanent / https://nextcloud.truelite.it/ 
 </VirtualHost> 
 <VirtualHost *:443> 
         ServerName nextcloud.truelite.it 
         DocumentRoot /var/www/nextcloud 
         AddDefaultCharset utf-8 
         <Directory /var/www/nextcloud/> 
              AllowOverride All 
         </Directory> 
	 # use your preferred SSL setup with your certificates 
         SSLEngine on 
         SSLProtocol all -SSLv2 -SSLv3 
         SSLHonorCipherOrder on 
	 ... 
         SSLCertificateFile /etc/letsencrypt/live/truelite.it/fullchain.pem 
         SSLCertificateKeyFile /etc/letsencrypt/live/truelite.it/privkey.pem 
         SetEnvIf User-Agent ".*MSIE.*" nokeepalive ssl-unclean-shutdown 
	
	 LogLevel warn 	
	 ErrorLog ${APACHE_LOG_DIR}/nextcloud-error.log 	
	 # Possible values include: debug, info, notice, warn, error, crit, 
	 # alert, emerg. 
	 CustomLog ${APACHE_LOG_DIR}/nextcloud-access.log combined 
 </VirtualHost> 
 </pre> 

 ed abilitarlo con: 

 <pre> 
 a2ensite nextcloud 
 </pre> 

 Dovranno inoltre essere abilitati vari moduli di apache che vengono utilizzati da Nextcloud: 

 <pre> 
 a2enmod rewrite 
 a2enmod ssl 
 a2enmod headers 
 a2enmod env 
 a2enmod dir 
 a2enmod mime 
 </pre> 

 conclusa la configurazione si riavvi il servizio con: 

 <pre> 
 service apache2 restart 
 </pre> 

 h2. Preparazione del database con MySQL/MariaDB 

 Si dovrà poi predisporre il database per l'applicazione, per cui occorre creare un database dedicato con: 

 <pre> 
 mysqladmin create nextcloud 
 </pre> 

 ed un utente per il relativo accesso: 

 <pre> 
 echo "grant all privileges on nextcloud.* to 'nextcloud'@'localhost' identified by 'passwordcomplicata';" | mysql 
 </pre> 


 h2. Configurazione iniziale 

 Benché sia possibile effettuare la configurazione iniziale del servizio (con creazione della struttura delle tabelle sul database) direttamente 
 dall'interfaccia web, che richiederà tutti i dati necessari ed avviserà degli eventuali problemi riscontrati. In particolare occorrerà inserire un utente di amministrazione e relativa password, il pathname della directory dei dati (nel caso @/srv/nextcloud/data@ e non quella proposta sotto @/var/www/nextcloud/@) e le credenziali di accesso al database (utente, password e nome del database). 

 Se si sono eseguiti direttamente i passi precedenti sarà possibile effettuare la configurazione iniziale direttamente dalla riga di comando utilizzando il programma di gestione @occ@. Dato che questo viene installato senza permesso di esecuzione il primo passo sarà: 

 <pre> 
 cd /var/www/nextcloud 
 chmod ug+x occ 
 </pre> 

 dopo di che si potrà effettuare la configurazione eseguendo il comando: 

 <pre> 
 sudo -u www-data ./occ maintenance:install --database "mysql" \ 
   --database-name "nextcloud" --database-user "nextcloud" \ 
   --database-pass "passwordcomplicata" \ 
   --admin-user "admin"    --admin-pass "passwordlungaedifficile" \ 
   --data-dir "/srv/nextcloud/data/" 
 </pre> 

 dove l'uso di @sudo@ è necessario (pertanto se non disponibile lo si installi con @apt-get install sudo@) per far eseguire il comando per conto dell'utente @www-data@ (altrimenti il programma si rifiuterà di proseguire suggerendo di aggiungerlo).  


 Per consentire l'accesso occorrerà comunque abilitare il nome a dominio con cui si contatta il server con un comando analogo a:  

 <pre> 
 sudo -u www-data ./occ    config:system:set trusted_domains 1 \ 
    --value=nextcloud.truelite.it 
 </pre> 

 che inserisce il nome a dominio fra quelli abilitati, se se ne usano altri occorrerà eseguire di nuovo il comando passando un numero progressivo diverso (il comando crea automaticamente nel file di configurazione di Nextcloud (@/var/www/nextcloud/config/config.php@) le voci in un array di cui il numero indicato è l'indice, il valore 0 è inserito all'installazione e fa riferimento al localhost e non deve essere cambiato), dopo il comando si otterrà la presenza all'interno del file di una voce del tipo: 

 <pre> 
   'trusted_domains' =>  
   array ( 
     0 => 'localhost', 
     1 => 'nextcloud.truelite.it', 
   ), 
 </pre> 

 h2. Configurazioni specifiche 

 Per abilitare l'autenticazione via IMAP occorre aggiungere al file di configurazione (@/var/www/nextcloud/config/config.php@): 

 <pre> 
   'user_backends' => array ( 
     0 => array ( 
       'class' => 'OC_User_IMAP', 
       'arguments' => array ( 
         0 => '{localhost:143/imap/novalidate-cert}', //questo 
	 1 => '{localhost:993/imap/ssl/novalidate-cert}', //oppure questo 
       ), 
     ), 
   ), 
 </pre>