OCC Befehle
Nextcloud OCC ist das Nextcloud eigene Befehlszeilen Tool (OCC steht für “ownCloud Console”). Sie können Ihre Instanz mit dem OCC Feature per Befehlszeile administrieren und erweitern. Es gibt Befehle für die Verwaltung von Benutzern und Apps, LDAP Einstellungen und mehr. Die OCC Befehle können auch genutzt werden, um im Fehlerfall die Instanz zu reparieren, oder nach einem Update den Wartungsmodus zu beenden.
OCC Befehle aufrufen
- Loggen Sie sich in der konsoleH ein.
- Wählen Sie den Storage Share aus, für welchen Sie einen OCC Befehl ausführen wollen.
- Klicken Sie nun links auf den Punkt Einstellungen; Konfiguration; OCC
Wie werden OCC Befehle ausgeführt
Sie können den Befehl, welchen Sie ausführen wollen, aus einem Dropdown Menü wählen.
Manche OCC Befehle benötigen weitere Parameter zur Ausführung. Sollten Sie zum Beispiel
eine App deaktivieren wollen, so würde als zusätzlicher Parameter der Name der App benötigt
werden.
Zusätzliche Informationen zu den einzelnen OCC Befehlen finden Sie unterhalb des Dropdown
Menüs. Dort sind alle verfügbaren OCC Befehle mit einer Kurzbeschreibung und der Anzahl der
benötigten Parameter aufgelistet.
Manche OCC Befehle, zum Beispiel file:scan --all, benötigen einige Zeit um beendet zu
werden. Für solche Befehle empfehlen wir Ihnen, die Ergebnisausgabe via Mail zu wählen.
Warnhinweis
Wenn Sie einen OCC Befehl ausführen wollen, welcher eine App, Daten oder Konfiguration
ändert bzw. löscht, wird Ihnen folgende Warnung angezeigt:
Das Ausführen des Befehls kann die Funktion des Storage Share einschränken oder Daten dauerhaft löschen. Möchten Sie diesen Befehl wirklich ausführen?
Dieser Hinweis soll daran erinnern, dass es immer ein Restrisiko bei der Ausführung von OCC
Befehlen gibt. Diese sollten nur bei Bedarf angewandt werden. Es ist extrem selten, dass ein
OCC Befehl eine Instanz oder die darin enthaltenen Daten unerwünschter Weise beschädigt.
Sollte es dazu kommen, so haben Sie die Möglichkeit eines der automatisch erstellten Backups
einzuspielen. Siehe Backup.
Storage Share nicht erreichbar
Bitte überprüfen Sie als erstes, ob für Ihre Instanz keine Wartungsarbeiten seitens Hetzner
angekündigt wurden oder aktuell durchgeführt werden.
Es kann passieren, dass der Storage Share aufgrund von fehlerhaften Apps, Daten oder
Konfigurationen in den Wartungsmodus wechselt und nicht mehr erreichbar ist.
Sie können mit dem OCC Befehl status herausfinden, worin genau das Problem besteht.
Meldungen können sein:
"Maintenance mode"
Die Instanz befindet sich im Wartungsmodus. Verantwortlich dafür kann eine App oder ein
fehlgeschlagener OCC Befehl sein. Dieser Wartungsmodus kann mit dem OCC Befehl
maintenance:mode --off abgeschalten werden.
"Update needed"
Sollten Sie eine App installieren oder updaten, kann es passieren, dass der Prozess nicht
korrekt beendet wird und die Instanz nicht mehr nutzbar ist. Hier wird Ihnen der OCC Befehl
upgrade weiterhelfen. Sollte die Instanz anschließend noch immer im Wartungsmodus
stehen, führen Sie bitte den Befehl maintenance:mode --off aus.
"Internal server error"
In diesem Fall gibt es ein Problem mit einer installierten App oder einem eingebundenden externen Speicher. Sollte die Ausführung der OCC Befehle keinen Erfolg erzielen, bitten wir Sie ein Ticket zu eröffnen. Unser Supportteam wird Ihnen gern bei der Lösung des Problems behilflich sein.
Benötigter OCC Befehl ist nicht verfügbar
Wir prüfen OCC Befehle, die für die Administration und Erweiterung der Storage Share geeignet sind. Diese Befehle dürfen keine unerwarteten Probleme verursachen und damit die Funktion des Storage Share oder dessen Daten gefährden. Wenn Sie einen Befehl ausführen wollen, welcher nicht in der Liste enthalten ist, können Sie sich an den Hetzner Support wenden. Dieser wird prüfen, ob der Befehl für Ihre Storage Share geeignet ist und führt diesen gegebenenfalls für Sie aus.