Nous allons voir comment, en ligne de commande nous pouvons administrer une instance Owncloud. Le projet owncloud fourni pour cela la commande occ.
Lancer la commande
Une première chose est de se trouver dans le répertoire de l'installation d'owncloud. Par exemple : /var/www/owncloud/www
De plus c'est une commande php donc il faut l'exécuter comme ceci :
# php occConsole has to be executed with the user that owns the file config/config.php
Current user: root
Owner of config.php: demo
Et donc il faut l'exécuter sous l'utilisateur possédant le fichier config/config.php dans mon cas l'utilisateur demo.
On arrive donc à ceci :
# cd /var/www/owncloud/www
#sudo -u demo php occ
Ce qui nous liste toutes les commandes disponibles
Donc par exemple pour obtenir le status de notre installation owncloud :
# sudo -u demo php occ status
- installed: true
- version: 8.1.3.0
- versionstring: 8.1.3
- edition:
Pour passer l'instance d'owncloud en maintenance :
# sudo -u demo php occ maintenance:mode --on
Maintenance mode enabled
Gestion des applications
Une commande très utile je penses est la gestion des applications avec la commande occ app.
Imaginons que vous avez téléchargé et installé le code d'une nouvelle application dans le répertoire apps.
Le premier réflexe est de lister si l'application est bien prise en compte :
# sudo -u demo php occ app:list
Enabled:
- activity: 2.0.2
- calendar: 0.7.3
- contacts: 0.4.0.0
- documents: 0.10.2
- encryption: 1.0.0
- files: 1.1.10
- files_locking:
- files_pdfviewer: 0.7
- files_sharing: 0.6.2
- files_texteditor: 0.4
- files_trashbin: 0.6.3
- files_versions: 1.0.6
- firstrunwizard: 1.1
- gallery: 0.6.0
- provisioning_api: 0.2
- tasks: 0.8
- templateeditor: 0.1
- updater: 0.6
Disabled:
- bookmarks
- external
- files_external
- files_videoviewer
- mail
- user_external
- user_ldap
- user_webdavauth
On peut ensuite activer l'application :
# sudo -u demo php occ app:enable mail
mail enabled
De même on peut désactiver une application :
# sudo -u demo php occ app:disable mail
mail disabled
Gestion des caches de fichiers
On reverra plus tard la gestion des caches mais avec la commande occ files on peut :
Vider le cache
# sudo -u demo php occ files:cleanup
0 orphaned file cache entries deleted
Pour scanner les nouveaux fichiers et mettre à jour le cache pour tout le monde :
# sudo -u demo php occ files:scan --all
Pour un utilisateur spécifique :
# sudo -u demo php occ files:scan guillaume
Gestion des utilisateurs
Lister le nombre d'utilisateurs :
# sudo -u demo php occ user:report
+------------------+----+
| User Report | |
+------------------+----+
| Database | 3 |
| LDAP | 7 |
| | |
| total users | 10 |
| | |
| user directories | 6 |
+------------------+----+
Ajouter un utilisateur :
# sudo -u demo php occ user:add --display-name="Mathieu" --group="test" mathieu
Enter password:
Confirm password:
The user "mathieu" was created successfully
Display name set to "Mathieu"
User "mathieu" added to group "test"
Changer un mot de passe :
# sudo -u demo php occ user:resetpassword mathieu
Warning: Resetting the password when using encryption will result in data loss!
Do you want to continue?y
Enter a new password:
Confirm the new password:
Successfully reset password for mathieu
On verra plus tard le pourquoi de l'alerte sur l'encryptage.
Commandes ldap
Si le backend ldap est activé.
Voir la config ldap :
# sudo -u demo php occ ldap:show-config
Chercher les utilisateurs dont le nom commence par gui
# sudo -u demo php occ ldap:search gui
Guillaume Chéramy (guillaume.cheramy@************)
Il existe d'autres commandes utiles, voir la doc officielle. On verra dans un prochain article comme scripter notre installation.