Nextcloud OCC ist das Nextcloud eigene Befehlszeilen Tool (OCC steht für “ownCloud Console”). Du kannst deine 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
- Logge dich in der konsoleH ein.
- Wähle den Storage Share aus, für den du einen OCC Befehl ausführen möchtest.
- Klicke nun links auf den Punkt Einstellungen; Konfiguration; OCC
Wie werden OCC Befehle ausgeführt
Du kannst den Befehl, welchen du ausführen möchtest, aus einem Dropdown Menü wählen.
Manche OCC Befehle benötigen weitere Parameter zur Ausführung. Solltest du 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 findest du 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 dir, die Ergebnisausgabe via Mail zu wählen.
Warnhinweis
Wenn du einen OCC Befehl ausführen möchtest, welcher eine App, Daten oder Konfiguration
ändert bzw. löscht, wird dir folgende Warnung angezeigt:
Das Ausführen des Befehls kann die Funktion des Storage Share einschränken oder Daten dauerhaft löschen. Möchten du 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 hast du die Möglichkeit eines der automatisch erstellten Backups
einzuspielen. duhe Backup.
Storage Share nicht erreichbar
Bitte überprüfe als erstes, ob für deine 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.
Du kannst 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"
Solltest du eine App installieren oder updaten, kann es passieren, dass der Prozess nicht
korrekt beendet wird und die Instanz nicht mehr nutzbar ist. Hier wird dir der OCC Befehl
upgrade weiterhelfen. Sollte die Instanz anschließend noch immer im Wartungsmodus
stehen, führe 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 dich ein Ticket zu eröffnen. Unser Supportteam wird dir 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 du einen Befehl ausführen möchtest, welcher nicht in der Liste enthalten ist, kannst du dich an den Hetzner Support wenden. Dieser wird prüfen, ob der Befehl für deine Storage Share geeignet ist und führt diesen gegebenenfalls für du aus.