occ Befehle verwenden¶

ownCloud’s occ Befehle (ownCloud console) ist die Schnittstelle für ownCloud Kommandozeile. Viele gängige Server-Operationen können mit occ Befehlen ausgeführt werden:

* Apps verwalten
* Aktualisieren der ownCloud Datenbank
* Zurücksetzen von Kennwörtern, einschließlich der Administratorkennwörter
* Konvertieren Sie die ownCloud Datenbank SQLite in eine leistungsfähigere DB
* Abfrage und Änderungen der LDAP-Einstellungen

occ befindet sich in dem owncloud/ Verzeichnis; zum Beispiel /var/www/owncloud unter Ubuntu Linux. occ ist ein PHP Script. Sie müssen als HTTP-Benutzer sicherzustellen, dass die richtigen Berechtigungen für Ihre ownCloud Dateien und Verzeichnisse gesetzt sind.

Hinweis

Der HTTP-Benutzer ist unter den verschiedenen Linux-Distributionen nicht gleich. Sehen Sie dazu unter der Einstellen der starken Verzeichnisberechtigung Abschnitt im Installations-Assistenten nach, um zu lernen, wie Sie Ihren HTTP-Benutzer finden.

Starten Sie ohne Optionen, werden alle Befehle und Optionen, wie in diesem Beispiel unter Ubuntu, aufgelistet:

$ sudo -u www-data php occ

Das ist das gleiche wie sudo -u www-data php occ list.

Führen Sie es mit der Option -h aus, dann erhalten Sie eine Syntaxhilfe.

$ sudo -u www-data php occ -h

Zeigen Sie Ihre ownCloud-Version an:

$ sudo -u www-data php occ -V
  ownCloud version 7.0.4

Abfragen des ownCloud Server-Status:

$ sudo -u www-data php occ status
  Array
  (
   [installed] => true
   [version] => 7.0.4.2
   [versionstring] => 7.0.4
   [edition] =>
  )

occ verfügt über Optionen, Befehle und Argumente. Optionen und Argumente sind optional, während Befehle unbedingt erforderlich sind. Die Syntax lautet:

occ [options] command [arguments]

Detaillierte Informationen über einzelne Befehle erhalten Sie mit dem help Kommando, so wie für dieses Beispiel mit dem maintenance:mode Kommando:

$ sudo -u www-data php occ help maintenance:mode
  Usage:
  maintenance:mode [--on] [--off]

  Options:
  --on                  enable maintenance mode
  --off                 disable maintenance mode
  --help (-h)           Display this help message.
  --quiet (-q)          Do not output any message.
  --verbose (-v|vv|vvv) Increase the verbosity of messages: 1 for normal
  output, 2 for more verbose output and 3 for debug
  --version (-V)        Display this application version.
  --ansi                Force ANSI output.
  --no-ansi             Disable ANSI output.
  --no-interaction (-n) Do not ask any interactive question.

Wartungsbefehle¶

Diese drei Wartungsbefehle stellen Ihren ownCloud Server in den Wartungs- und Einzelbenutzermodus um, und führet Reparaturschritte bei Updates durch.

Sie müssen Ihren ownCloud-Server in den Wartungsmodus versetzten, wenn Sie eine Aktualisierung durchführen wollen. Das sperrt die Sitzungen aller angemeldeten Benutzer, einschließlich der Administratoren, und zeigt einen Statusbildschirm mit Warnung an, dass sich der Server im Wartungsmodus befindet. Benutzer, die nicht angemeldet sind können sich nicht anmelden, bis der Wartungsmodus ausgeschaltet ist. Wenn Sie an dem Server eine Wartung durchführen, müssen angemeldete Benutzer ihren Web-Browser aktualisieren, um weiter arbeiten zu können:

$ sudo -u www-data php occ maintenance:mode --on
$ sudo -u www-data php occ maintenance:mode --off

Stellen Sie Ihren ownCloud Server in den Einzelbenutzermodus um, so ermöglicht das, das sich Administratoren einzuloggen und arbeiten können, aber normale Benutzer nicht. Dies ist nützlich bei der Durchführung von Wartungsarbeiten und bei der Fehlersuche an einem laufenden Server:

$ sudo -u www-data php occ maintenance:singleuser --on
  Single user mode enabled

Und schalten Sie das wieder aus, wenn Sie fertig sind:

$ sudo -u www-data php occ maintenance:singleuser --off
  Single user mode disabled

Das maintenance:repair Befehl wird automatisch ausgeführt, um bei Upgrades die Datenbank zu bereinigen. Es ist in der Regel nicht notwendig, das Sie diesen Befehl manuell laufen lassen müssen, es sein denn Sie wollen Folgendes reparieren:

$ sudo -u www-data php occ maintenance:repair
  - Repair mime types
  - Repair config

Befehle der Benutzer¶

Der user Befehle setzt Passwörter zurück, zeigt einen übersichtlichen Bericht an, wie viele Benutzer Sie haben, und wann ein Benutzer sich zuletzt angemeldet hat.

Sie können das Kennwort eines Benutzers zurückzusetzen, einschließlich das der Administratoren (siehe unter Zurücksetzen eines verloren gegangenen Administratorkennworts). In diesem Beispiel ist der Benutzername layla:

$ sudo -u www-data php occ user:resetpassword layla
  Enter a new password:
  Confirm the new password:
  Successfully reset password for layla

Informieren Sie sich über die letzten Anmeldungen eines Benutzers:

$ sudo -u www-data php occ user:lastseen layla
layla's last login: 09.01.2015 18:46

Generieren Sie einen einfachen Bericht, der für alle Benutzer gilt, einschließlich der Nutzer auf einem externen Benutzer-Authentifizierungsserver wie LDAP:

$ sudo -u www-data php occ user:report
+------------------+----+
| User Report      |    |
+------------------+----+
| Database         | 12 |
| LDAP             | 86 |
|                  |    |
| total users      | 98 |
|                  |    |
| user directories | 2  |
+------------------+----+

Befehle von Apps¶

Das app Kommands liste auf, ob Apps aktiviert oder deaktiviert sind. Hier werden alle Ihre installierten Anwendungen angezeigt, ob sie aktiviert oder deaktiviert sind:

$ sudo -u www-data php occ app:list

Aktivieren einer App:

$ sudo -u www-data php occ app:enable external
  external enabled

Deaktivieren einer App:

$ sudo -u www-data php occ app:disable external
  external disabled

Upgrade Befehle¶

Wenn Sie eine Aktualisierung oder ein Upgrade auf Ihrem ownCloud-Server ausführen (siehe unter dem Abschnitt Wartung in diesem Handbuch), ist es besser occ zu verwenden, um die Datenbank-Upgrade Schritte durchzuführen, anstatt das Web-GUI zu verweden, um Timeouts zu vermeiden. Die PHP Skripte die von der Web-Schnittstelle aufgerufen werden, sind auf 3600 Sekunden begrenzt. In größeren Umgebungen kann dies nicht genug sein, so dass das System in einem inkonsistenten Zustand verharrt. Verwenden Sie diesen Befehl, um Ihre Datenbanken zu aktualisieren:

$ sudo -u www-data php occ upgrade

Vor dem Upgrade führt ownCloud zuerst eine Simulation durch und kopiert aller Datenbanktabellen in ein temporäres Verzeichnis, dann erst wird das Upgrade ausgeführt, um sicherzustellen, dass die Aktualisierung ordnungsgemäß abgeschlossen werden kann. Das benötigt doppelt so viel Zeit, was bei großen Anlagen viele Stunden betragen kann, so dass Sie diesen Schritt durch das weglassen der --skip-migration-test Option überspringen können:

$ sudo -u www-data php occ upgrade --skip-migration-test

Sie können diese Simulation manuell mit der --dry-run Option durchführen:

$ sudo -u www-data php occ upgrade --dry-run

Datenbank umwandeln¶

Die SQLite-Datenbank ist gut für Tests und für ownCloud Servern mit einer kleinen Arbeitsbelastung, aber Produktivservern mit mehreren Benutzern sollten MariaDB verwenden, MySQL, oder PostgreSQL. Sie können mit occ von SQLite, diese in eine der anderen Datenbanken konvertieren. Sie benötigen dazu:

  • Ihr installiert Wunsch-Datenbank und ihre PHP-Anschluss
  • Das Login Passwort un den Datenbank admin Bneutzer
  • Die Datenbank-Port-Nummer, wenn es sich um einen nicht-Standard-Port handelt

Das ist beispielsweise eine Konvertierung auf MySQL / MariaDB:

$ sudo -u www-data php occ db:generate-change-script
$ sudo -u www-data php occ db:convert-type mysql oc_dbuser 127.0.0.1
oc_database

Für eine detailliertere Erklärung dazu sehen Sie unter Konvertieren des Datenbanktyps nach.

LDAP Befehle¶

Sie können die folgenden LDAP-Befehle mit occ ausführen.

Die Suche nach einem LDAP-Benutzer erfolgt mit der folgenden Syntax:

$ sudo -u www-data php occ ldap:search [--group] [--offset="..."]
[--limit="..."] search

In diesem Beispiel wird nach einem Benutzernamen gesucht, der "rob" beinhaltet:

$ sudo -u www-data php occ ldap:search rob

Überprüfen Sie, ob ein LDAP-Benutzer existiert. Dies funktioniert nur, wenn der ownCloud-Server mit einem LDAP-Server verbunden ist:

$ sudo -u www-data php occ ldap:check-user robert

Sie können Ihre gesamte LDAP-Konfiguration oder die Konfiguration für eine einzelnen configID anzeigen lassen:

$ sudo -u www-data php occ ldap:show-config
$ sudo -u www-data php occ ldap:show-config s01

Das ldap:set-config Kommando ist für die Manipulation von Konfigurationen, wie in diesem Beispiel, das setzen der Suchattribute zuständig:

$ sudo -u www-data php occ ldap:set-config s01 ldapAttributesForUserSearch
"cn;givenname;sn;displayname;mail"

ldap:test-config testet, ob die Konfiguration korrekt ist, um den Server entsprechend verbinden zu können:

$ sudo -u www-data php occ ldap:test-config ""
The configuration is valid and the connection could be established!

Dateien scannen¶

Der files:scan Befehl sucht nach neuen Dateien für den Datei-Cache und sollte nicht manuell ausgeführt werden.