This commit is contained in:
André Duffeck
2025-01-20 11:18:12 +01:00
parent 7ba860ce20
commit 77a618a4ee
+13 -13
View File
@@ -1,6 +1,6 @@
# ocis # opencloud
The ocis package contains the Infinite Scale runtime and the commands for the Infinite Scale CLI. The opencloud package contains the OpenCloud runtime and the commands for the OpenCloud CLI.
## Service Registry ## Service Registry
@@ -15,26 +15,26 @@ To configure which registry to use, you have to set the environment variable `MI
## Memory limits ## Memory limits
oCIS will automatically set the go native `GOMEMLIMIT` to `0.9`. To disable the limit set `AUTOMEMEMLIMIT=off`. For more information take a look at the official [Guide to the Go Garbage Collector](https://go.dev/doc/gc-guide). OpenCloud will automatically set the go native `GOMEMLIMIT` to `0.9`. To disable the limit set `AUTOMEMEMLIMIT=off`. For more information take a look at the official [Guide to the Go Garbage Collector](https://go.dev/doc/gc-guide).
## CLI Commands ## CLI Commands
The ocis package offers a variety of cli commands to monitor or repair ocis installations. All these commands have a common mandatory parameter: `--basePath` (or `-p`) which needs to point to a storage provider. Example paths are: The opencloud package offers a variety of cli commands to monitor or repair OpenCloud installations. All these commands have a common mandatory parameter: `--basePath` (or `-p`) which needs to point to a storage provider. Example paths are:
```bash ```bash
.ocis/storage/users # bare metal installation .opencloud/storage/users # bare metal installation
/var/tmp/ocis/storage/users # docker installation /var/tmp/opencloud/storage/users # docker installation
... ...
``` ```
These paths can vary depending on your ocis installation. These paths can vary depending on your OpenCloud installation.
### Backup CLI ### Backup CLI
The backup command allows inspecting the consistency of an ocis storage: The backup command allows inspecting the consistency of an OpenCloud storage:
```bash ```bash
ocis backup consistency -p /base/path/storage/users opencloud backup consistency -p /base/path/storage/users
``` ```
This will check the consistency of the storage and output a list of inconsistencies. Inconsistencies can be: This will check the consistency of the storage and output a list of inconsistencies. Inconsistencies can be:
@@ -64,7 +64,7 @@ Exits with non-zero exit code if inconsistencies are found. Useful for automatio
When a shared space or directory got deleted, use the `shares cleanup` command to remove those share orphans. This can't be done automatically at the moment. When a shared space or directory got deleted, use the `shares cleanup` command to remove those share orphans. This can't be done automatically at the moment.
```bash ```bash
ocis shares cleanup opencloud shares cleanup
``` ```
### Revisions CLI ### Revisions CLI
@@ -72,7 +72,7 @@ ocis shares cleanup
The revisions command allows removing the revisions of files in the storage. The revisions command allows removing the revisions of files in the storage.
```bash ```bash
ocis revisions purge -p /base/path/storage/users opencloud revisions purge -p /base/path/storage/users
``` ```
It takes the `--resource-id` (or `--r`) parameter which specify the scope of the command: It takes the `--resource-id` (or `--r`) parameter which specify the scope of the command:
@@ -97,7 +97,7 @@ Prints additional information about the revisions that are removed.
The trash cli allows removing empty folders from the trashbin. This should be used to speed up trash bin operations. The trash cli allows removing empty folders from the trashbin. This should be used to speed up trash bin operations.
```bash ```bash
ocis trash purge-empty-dirs -p /base/path/storage/users opencloud trash purge-empty-dirs -p /base/path/storage/users
``` ```
This command provides additional options: This command provides additional options:
@@ -110,7 +110,7 @@ Do not remove any empty folders but print the empty folders that would be remove
This command simplifies the process of finding out which UID belongs to which role. The command is: This command simplifies the process of finding out which UID belongs to which role. The command is:
```bash ```bash
ocis graph list-unified-roles opencloud graph list-unified-roles
``` ```
The output of this command includes the following information for each role: The output of this command includes the following information for each role: