add a maintainance command overview#1004
Conversation
|
cli commands:
|
There was a problem hiding this comment.
In the recommended Docker Compose stack, we use posix by default, but some commands do not work with posix.
We need to decide what to do: either fix the commands (which I think is the right approach) or remove them from the documentation.
clicommand tests we run only on decomposed storage
in posix we cannot do some important commands like: deleting version, backup consistency, etc (need double check)
| Example: | ||
|
|
||
| ```bash | ||
| docker compose exec opencloud opencloud backup consistency -p /var/lib/opencloud/storage/users |
There was a problem hiding this comment.
Sorry Anja, that was bad suggestion from me. I tested it and it works only for decomposed storage
$ opencloud backup consistency -p /var/lib/opencloud/storage/users
💚 No inconsistency found. The backup in '/var/lib/opencloud/storage/users' seems to be valid.
in posix (default storage) it doesn't work, we get:
~ $ opencloud backup consistency -p /var/lib/opencloud/storage/users no backup found. Double check storage path Error: no backup found. Double check storage path
so I think we should remove it
| ### Check storage consistency | ||
|
|
||
| Checks the storage for inconsistencies such as orphaned blobs, missing blobs, missing nodes, missing links, missing files, missing or malformed metadata, and invalid parent-child relationships. | ||
|
|
||
| ```bash | ||
| opencloud backup consistency -p /var/lib/opencloud/storage/users | ||
| ``` | ||
|
|
||
| To return a non-zero exit code when inconsistencies are found: | ||
|
|
||
| ```bash | ||
| opencloud backup consistency -p /var/lib/opencloud/storage/users --fail | ||
| ``` |
| ### Purge file revisions | ||
|
|
||
| By default, the command runs as a dry-run and prints which revisions would be removed without deleting anything. Review the output before running with `--dry-run=false`. | ||
|
|
||
| List revisions that would be purged: | ||
|
|
||
| ```bash | ||
| opencloud revisions purge -p /var/lib/opencloud/storage/users | ||
| ``` | ||
|
|
||
| Purge revisions for all spaces: | ||
|
|
||
| ```bash | ||
| opencloud revisions purge -p /var/lib/opencloud/storage/users --dry-run=false | ||
| ``` | ||
|
|
||
| Purge revisions for a specific space (pass the space ID as `--resource-id`): | ||
|
|
||
| ```bash | ||
| opencloud revisions purge -p /var/lib/opencloud/storage/users --resource-id '<space-id>' --dry-run=false |
There was a problem hiding this comment.
same here. doesn't work on posixfs
decomposed:
~ $ opencloud revisions purge -p /var/lib/opencloud/storage/users --dry-run=false
✅ Deleted 2 revisions (6 files / 2 blobs)
~ $ opencloud revisions purge -p /var/lib/opencloud/storage/users --dry-run
👉 Would delete 1 revisions (3 files / 1 blobs)
~ $ opencloud revisions purge -p /var/lib/opencloud/storage/users
👉 Would delete 1 revisions (3 files / 1 blobs)
posix:
opencloud revisions purge -p /var/lib/opencloud/storage/users --dry-run no nodes found. Double check storage path ❎ No revisions found. Storage provider is clean.
| By default, the command runs as a dry-run and prints which empty folders would be removed. | ||
|
|
||
| ```bash | ||
| opencloud trash purge-empty-dirs -p /var/lib/opencloud/storage/users |
There was a problem hiding this comment.
seems doesn't work on decomposed
- create empty dir1
- create and remove empty dir2
- opencloud trash purge-empty-dirs -p /var/lib/opencloud/storage/users
result: both dir still exist
No description provided.