mirror of
https://github.com/YunoHost-Apps/nextcloud_ynh.git
synced 2024-09-03 19:55:57 +02:00
Merge b243ad9ea5 into aca04bd274
This commit is contained in:
Alexandre Aubin
GitHub
commit
0b5e233312
2 changed files with 229 additions and 0 deletions
111
doc/ADDITIONAL_STORAGE.fr.md
Normal file
111
doc/ADDITIONAL_STORAGE.fr.md
Normal file
|
|
@ -0,0 +1,111 @@
|
|||
### Ajouter de l'espace à Nextcloud
|
||||
La solution I. permet d'ajouter un lien vers un dossier local ou distant.
|
||||
La solution II. permet de déplacer l'espace de stockage principal de Nextcloud.
|
||||
|
||||
#### I. Ajouter un espace de stockage externe
|
||||
|
||||
Paramètre => [Administration] Stockages externe.
|
||||
|
||||
En bas de la liste vous pouvez rajouter un dossier (Il est possible de définir un sous dossier en utilisant la convention `dossier/sousDossier`.)
|
||||
Sélectionner un type de stockage et indiquez les informations de connexion demandées.
|
||||
Vous pouvez restreindre ce dossier à un ou plusieurs utilisateurs nextcloud avec la colonne `Disponible pour`.
|
||||
Avec l'engrenage vous pouvez autoriser ou interdire la prévisualisation et le partage des fichiers.
|
||||
Enfin cliquer sur la coche pour valider le dossier.
|
||||
|
||||
#### II. Migrer les données de Nextcloud dans une partition plus grosse
|
||||
|
||||
**Remarque** : Ce qui suit suppose que vous avez un disque dur monté sur `/media/stockage`. Référez-vous à [cet article](/external_storage) pour préparer votre système.
|
||||
|
||||
**Remarque** : Remplacez `nextcloud` par le nom de son instance, si vous avez plusieurs apps Nextcloud installées.
|
||||
|
||||
Commencez par éteindre le serveur web avec la commande :
|
||||
```bash
|
||||
systemctl stop nginx
|
||||
```
|
||||
|
||||
##### Choix de l'emplacement
|
||||
|
||||
**Cas A : Stockage vierge, exclusif à Nextcloud**
|
||||
|
||||
Pour l'instant seul root peut y écrire dans `/media/stockage` ; ce qui signifie que NGINX et Nextcloud ne pourront donc pas l'utiliser.
|
||||
|
||||
```bash
|
||||
chown -R nextcloud:nextcloud /media/stockage
|
||||
chmod 775 -R /media/stockage
|
||||
```
|
||||
|
||||
**Cas B : Stockage partagé, données déjà présentes, données Nextcloud dans un sous-dossier**
|
||||
|
||||
Si vous souhaitez utiliser ce disque pour d'autres applications, vous pouvez créer un sous-dossier appartenant à Nextcloud.
|
||||
|
||||
```bash
|
||||
mkdir -p /media/stockage/nextcloud_data
|
||||
chown -R nextcloud /media/stockage/nextcloud_data
|
||||
chmod 775 -R /media/stockage/nextcloud_data
|
||||
```
|
||||
|
||||
##### Migrer les données
|
||||
|
||||
Migrez vos données vers le nouveau disque. Pour ce faire *(soyez patient, cela peut être long)* :
|
||||
|
||||
```bash
|
||||
Cas A : cp -ir /home/yunohost.app/nextcloud /media/stockage
|
||||
Cas B : cp -ir /home/yunohost.app/nextcloud /media/stockage/nextcloud_data
|
||||
```
|
||||
|
||||
L'option `i` permet de vous demander quoi faire en cas de conflit de fichier, notamment si vous écrasez un ancien dossier de données Owncloud ou Nextcloud.
|
||||
Pour vérifier que tout s'est bien passé, comparer ce qu'affichent ces deux commandes (le contenu doit être identique) :
|
||||
|
||||
```bash
|
||||
ls -la /home/yunohost.app/nextcloud
|
||||
|
||||
Cas A : ls -al /media/stockage
|
||||
Cas B : ls -al /media/stockage/nextcloud_data/nextcloud
|
||||
```
|
||||
|
||||
##### Configurer Nextcloud
|
||||
|
||||
Pour informer Nextcloud de son nouveau répertoire, modifiez le fichier `/var/www/nextcloud/config/config.php` avec la commande :
|
||||
|
||||
```bash
|
||||
nano /var/www/nextcloud/config/config.php
|
||||
```
|
||||
|
||||
Cherchez la ligne :
|
||||
|
||||
```bash
|
||||
'datadirectory' => '/home/yunohost.app/nextcloud/data',
|
||||
```
|
||||
|
||||
Que vous modifiez :
|
||||
|
||||
```bash
|
||||
CAS A : 'datadirectory' => '/media/stockage',
|
||||
CAS B : 'datadirectory' => '/media/stockage/nextcloud_data/nextcloud/data',
|
||||
```
|
||||
|
||||
Sauvegardez avec `ctrl+x` puis `y` ou `o` (dépend de la locale de votre serveur).
|
||||
|
||||
Relancez le serveur web :
|
||||
|
||||
```bash
|
||||
systemctl start nginx
|
||||
```
|
||||
|
||||
Ajouter le fichier .ocdata
|
||||
```bash
|
||||
CAS A : nano /media/stockage/.ocdata
|
||||
CAS B : nano /media/stockage/nextcloud_data/nextcloud/data/.ocdata
|
||||
```
|
||||
Ajouter un espace au fichier pour pouvoir le sauvegarder
|
||||
|
||||
Sauvegardez avec `ctrl+x` puis `y` ou `o` (dépend de la locale de votre serveur).
|
||||
|
||||
Lancez un scan du nouveau répertoire par Nextcloud:
|
||||
|
||||
```bash
|
||||
cd /var/www/nextcloud
|
||||
sudo -u nextcloud php8.1 --define apc.enable_cli=1 files:scan --all
|
||||
```
|
||||
|
||||
C'est terminé. À présent testez si tout va bien, essayez de vous connecter à votre instance Nextcloud, envoyer un fichier, vérifiez sa bonne synchronisation.
|
||||
118
doc/ADDITIONAL_STORAGE.md
Normal file
118
doc/ADDITIONAL_STORAGE.md
Normal file
|
|
@ -0,0 +1,118 @@
|
|||
### Adding storage space
|
||||
|
||||
Solution I. allows you to add a link to a local or remote folder.
|
||||
Solution II. allows to move the main storage space of Nextcloud.
|
||||
|
||||
#### I. Add an external storage space
|
||||
|
||||
Parameter =>[Administration] External storage.
|
||||
|
||||
At the bottom of the list you can add a folder (It is possible to define a subfolder using the `folder/subfolder` convention.)
|
||||
Select a storage type and specify the requested connection information.
|
||||
You can restrict this folder to one or more nextcloud users with the column `Available for`.
|
||||
With the gear you can allow or prohibit previewing and file sharing.
|
||||
Finally click on the check mark to validate the folder.
|
||||
|
||||
#### II. Migrate Nextcloud data to a larger partition
|
||||
|
||||
**Note**: The following assumes that you have a hard disk mounted on `/media/storage`. Refer to[this article](/external_storage) to prepare your system.
|
||||
|
||||
**Note**: Replace `nextcloud` with the name of its instance, if you have several Nextcloud apps installed.
|
||||
|
||||
First turn off the web server with the command:
|
||||
```bash
|
||||
systemctl stop nginx
|
||||
```
|
||||
|
||||
##### Choice of location
|
||||
|
||||
**Case A: Blank storage, exclusive to Nextcloud**
|
||||
|
||||
For the moment only root can write to it in `/media/storage`, which means that NGINX and Nextcloud will not be able to use it.
|
||||
|
||||
```bash
|
||||
chown -R nextcloud:nextcloud /media/storage
|
||||
chmod 775 -R /media/storage
|
||||
```
|
||||
|
||||
**Case B: Shared storage, data already present, Nextcloud data in a subfolder**
|
||||
|
||||
If you want to use this disk for other applications, you can create a subfolder belonging to Nextcloud.
|
||||
|
||||
```bash
|
||||
mkdir -p /media/storage/nextcloud_data
|
||||
chown -R nextcloud /media/storage/nextcloud_data
|
||||
chmod 775 -R /media/storage/nextcloud_data
|
||||
```
|
||||
|
||||
##### Migrate data
|
||||
|
||||
Migrate your data to the new disk. To do this *(be patient, it can take a long time)*:
|
||||
|
||||
```bash
|
||||
Case A: cp -ia /home/yunohost.app/nextcloud /media/storage
|
||||
Case B: cp -ia /home/yunohost.app/nextcloud /media/storage/nextcloud_data
|
||||
```
|
||||
|
||||
The `i` option allows you to ask yourself what to do if there is a file conflict, especially if you overwrite an old Owncloud or Nextcloud data folder.
|
||||
To check that everything went well, compare what these two commands display (the content must be identical):
|
||||
|
||||
```bash
|
||||
ls -la /home/yunohost.app/nextcloud
|
||||
|
||||
Case A: ls -al /media/storage
|
||||
Case B: ls -al /media/storage/nextcloud_data/nextcloud
|
||||
```
|
||||
|
||||
##### Configure Nextcloud
|
||||
|
||||
To inform Nextcloud of its new directory, modify the `/var/www/nextcloud/config/config.php` file with the command:
|
||||
|
||||
```bash
|
||||
nano /var/www/nextcloud/config/config.php
|
||||
```
|
||||
|
||||
Look for the line:
|
||||
|
||||
```bash
|
||||
'datadirectory' => '/home/yunohost.app/nextcloud/data',
|
||||
```
|
||||
|
||||
That you modify:
|
||||
|
||||
```bash
|
||||
CASE A:'datadirectory' =>'/media/storage',
|
||||
CASE B:'datadirectory' =>'/media/storage/nextcloud_data/nextcloud/data',
|
||||
```
|
||||
|
||||
Save it with `ctrl+x` then `y` or `o` (depending on your server locale).
|
||||
|
||||
Restart the web server:
|
||||
|
||||
```bash
|
||||
systemctl start nginx
|
||||
```
|
||||
|
||||
Add the.ocdata file
|
||||
```bash
|
||||
CASE A: nano /media/storage/.ocdata
|
||||
CASE B: nano /media/storage/nextcloud_data/nextcloud/data/.ocdata
|
||||
```
|
||||
Add a space to the file to be able to save it
|
||||
|
||||
Back up with `ctrl+x` then `y` or `o` (depending on your server locale).
|
||||
|
||||
Run a scan of the new directory by Nextcloud:
|
||||
|
||||
```bash
|
||||
cd /var/www/nextcloud
|
||||
sudo -u nextcloud php8.1 --define apc.enable_cli=1 files:scan --all
|
||||
```
|
||||
|
||||
Update the YunoHost setting, so automatic upgrades and backups know where the datadir is located:
|
||||
```bash
|
||||
Case A: yunohost app setting nextcloud datadir -v /media/storage
|
||||
Case B: yunohost app setting nextcloud datadir -v /media/storage/nextcloud_data/nextcloud/data/
|
||||
```
|
||||
|
||||
It's over now. Now test if everything is fine, try connecting to your Nextcloud instance, upload a file, check its proper synchronization.
|
||||
Loading…
Add table
Reference in a new issue