Swap cli.en.md and cli.ru.md contents O_o
parent
e20cdd13b6
commit
c10c90f620
|
|
@ -38,9 +38,9 @@ Global options:
|
||||||
|
|
||||||
`vitastor-cli status`
|
`vitastor-cli status`
|
||||||
|
|
||||||
Показать состояние кластера.
|
Show cluster status.
|
||||||
|
|
||||||
Пример вывода:
|
Example output:
|
||||||
|
|
||||||
```
|
```
|
||||||
cluster:
|
cluster:
|
||||||
|
|
@ -65,9 +65,9 @@ Global options:
|
||||||
|
|
||||||
`vitastor-cli df`
|
`vitastor-cli df`
|
||||||
|
|
||||||
Показать список пулов и занятое место.
|
Show pool space statistics.
|
||||||
|
|
||||||
Пример вывода:
|
Example output:
|
||||||
|
|
||||||
```
|
```
|
||||||
NAME SCHEME PGS TOTAL USED AVAILABLE USED% EFFICIENCY
|
NAME SCHEME PGS TOTAL USED AVAILABLE USED% EFFICIENCY
|
||||||
|
|
@ -76,27 +76,26 @@ size1 1/1 32 199.9 G 10 G 121.5 G 39.23% 100%
|
||||||
kaveri 2/1 32 0 B 10 G 0 B 100% 0%
|
kaveri 2/1 32 0 B 10 G 0 B 100% 0%
|
||||||
```
|
```
|
||||||
|
|
||||||
В примере у пула "kaveri" эффективность равна нулю, так как все OSD выключены.
|
In the example above, "kaveri" pool has "zero" efficiency because all its OSD are down.
|
||||||
|
|
||||||
## ls
|
## ls
|
||||||
|
|
||||||
`vitastor-cli ls [-l] [-p POOL] [--sort FIELD] [-r] [-n N] [<glob> ...]`
|
`vitastor-cli ls [-l] [-p POOL] [--sort FIELD] [-r] [-n N] [<glob> ...]`
|
||||||
|
|
||||||
Показать список образов, если переданы шаблоны `<glob>`, то только с именами,
|
List images (only matching `<glob>` pattern(s) if passed).
|
||||||
соответствующими этим шаблонам (стандартные ФС-шаблоны с * и ?).
|
|
||||||
|
|
||||||
Опции:
|
Options:
|
||||||
|
|
||||||
```
|
```
|
||||||
-p|--pool POOL Фильтровать образы по пулу (ID или имени)
|
-p|--pool POOL Filter images by pool ID or name
|
||||||
-l|--long Также выводить статистику занятого места и ввода-вывода
|
-l|--long Also report allocated size and I/O statistics
|
||||||
--del Также выводить статистику операций удаления
|
--del Also include delete operation statistics
|
||||||
--sort FIELD Сортировать по заданному полю (name, size, used_size, <read|write|delete>_<iops|bps|lat|queue>)
|
--sort FIELD Sort by specified field (name, size, used_size, <read|write|delete>_<iops|bps|lat|queue>)
|
||||||
-r|--reverse Сортировать в обратном порядке
|
-r|--reverse Sort in descending order
|
||||||
-n|--count N Показывать только первые N записей
|
-n|--count N Only list first N items
|
||||||
```
|
```
|
||||||
|
|
||||||
Пример вывода:
|
Example output:
|
||||||
|
|
||||||
```
|
```
|
||||||
NAME POOL SIZE USED READ IOPS QUEUE LAT WRITE IOPS QUEUE LAT FLAGS PARENT
|
NAME POOL SIZE USED READ IOPS QUEUE LAT WRITE IOPS QUEUE LAT FLAGS PARENT
|
||||||
|
|
@ -113,94 +112,85 @@ bench-kaveri kaveri 10 G 10 G 0 B/s 0 0 0 us 0 B/s 0
|
||||||
|
|
||||||
`vitastor-cli create -s|--size <size> [-p|--pool <id|name>] [--parent <parent_name>[@<snapshot>]] <name>`
|
`vitastor-cli create -s|--size <size> [-p|--pool <id|name>] [--parent <parent_name>[@<snapshot>]] <name>`
|
||||||
|
|
||||||
Создать образ. Для размера `<size>` можно использовать суффиксы K/M/G/T (килобайт-мегабайт-гигабайт-терабайт).
|
Create an image. You may use K/M/G/T suffixes for `<size>`. If `--parent` is specified,
|
||||||
Если указана опция `--parent`, создаётся клон образа. Родитель `<parent_name>[@<snapshot>]` должен быть
|
a copy-on-write image clone is created. Parent must be a snapshot (readonly image).
|
||||||
снимком (или просто немодифицируемым образом). Пул обязательно указывать, если в кластере больше одного пула.
|
Pool must be specified if there is more than one pool.
|
||||||
|
|
||||||
```
|
```
|
||||||
vitastor-cli create --snapshot <snapshot> [-p|--pool <id|name>] <image>
|
vitastor-cli create --snapshot <snapshot> [-p|--pool <id|name>] <image>
|
||||||
vitastor-cli snap-create [-p|--pool <id|name>] <image>@<snapshot>
|
vitastor-cli snap-create [-p|--pool <id|name>] <image>@<snapshot>
|
||||||
```
|
```
|
||||||
|
|
||||||
Создать снимок образа `<name>` (можно использовать любую форму команды). Снимок можно создавать без остановки
|
Create a snapshot of image `<name>` (either form can be used). May be used live if only a single writer is active.
|
||||||
клиентов, если пишущий клиент максимум 1.
|
|
||||||
|
|
||||||
## modify
|
## modify
|
||||||
|
|
||||||
`vitastor-cli modify <name> [--rename <new-name>] [--resize <size>] [--readonly | --readwrite] [-f|--force]`
|
`vitastor-cli modify <name> [--rename <new-name>] [--resize <size>] [--readonly | --readwrite] [-f|--force]`
|
||||||
|
|
||||||
Изменить размер, имя образа или флаг "только для чтения". Снимать флаг "только для чтения"
|
Rename, resize image or change its readonly status. Images with children can't be made read-write.
|
||||||
и уменьшать размер образов, у которых есть дочерние клоны, без `--force` нельзя.
|
If the new size is smaller than the old size, extra data will be purged.
|
||||||
|
You should resize file system in the image, if present, before shrinking it.
|
||||||
Если новый размер меньше старого, "лишние" данные будут удалены, поэтому перед уменьшением
|
|
||||||
образа сначала уменьшите файловую систему в нём.
|
|
||||||
|
|
||||||
```
|
```
|
||||||
-f|--force Разрешить уменьшение или перевод в чтение-запись образа, у которого есть клоны.
|
-f|--force Proceed with shrinking or setting readwrite flag even if the image has children.
|
||||||
```
|
```
|
||||||
|
|
||||||
## rm
|
## rm
|
||||||
|
|
||||||
`vitastor-cli rm <from> [<to>] [--writers-stopped]`
|
`vitastor-cli rm <from> [<to>] [--writers-stopped]`
|
||||||
|
|
||||||
Удалить образ `<from>` или все слои от `<from>` до `<to>` (`<to>` должен быть дочерним
|
Remove `<from>` or all layers between `<from>` and `<to>` (`<to>` must be a child of `<from>`),
|
||||||
образом `<from>`), одновременно меняя родительские образы их клонов (если таковые есть).
|
rebasing all their children accordingly. --writers-stopped allows merging to be a bit
|
||||||
|
more effective in case of a single 'slim' read-write child and 'fat' removed parent:
|
||||||
`--writers-stopped` позволяет чуть более эффективно удалять образы в частом случае, когда
|
the child is merged into parent and parent is renamed to child in that case.
|
||||||
у удаляемой цепочки есть только один дочерний образ, содержащий небольшой объём данных.
|
In other cases parent layers are always merged into children.
|
||||||
В этом случае дочерний образ вливается в родительский и удаляется, а родительский
|
|
||||||
переименовывается в дочерний.
|
|
||||||
|
|
||||||
В других случаях родительские слои вливаются в дочерние.
|
|
||||||
|
|
||||||
## flatten
|
## flatten
|
||||||
|
|
||||||
`vitastor-cli flatten <layer>`
|
`vitastor-cli flatten <layer>`
|
||||||
|
|
||||||
Сделай образ `<layer>` плоским, то есть, скопировать в него данные и разорвать его
|
Flatten a layer, i.e. merge data and detach it from parents.
|
||||||
соединение с родительскими.
|
|
||||||
|
|
||||||
## rm-data
|
## rm-data
|
||||||
|
|
||||||
`vitastor-cli rm-data --pool <pool> --inode <inode> [--wait-list] [--min-offset <offset>]`
|
`vitastor-cli rm-data --pool <pool> --inode <inode> [--wait-list] [--min-offset <offset>]`
|
||||||
|
|
||||||
Удалить данные инода, не меняя метаданные образов.
|
Remove inode data without changing metadata.
|
||||||
|
|
||||||
```
|
```
|
||||||
--wait-list Сначала запросить полный листинг объектов, а потом начать удалять.
|
--wait-list Retrieve full objects listings before starting to remove objects.
|
||||||
Требует больше памяти, но позволяет правильно печатать прогресс удаления.
|
Requires more memory, but allows to show correct removal progress.
|
||||||
--min-offset Удалять только данные, начиная с заданного смещения.
|
--min-offset Purge only data starting with specified offset.
|
||||||
```
|
```
|
||||||
|
|
||||||
## merge-data
|
## merge-data
|
||||||
|
|
||||||
`vitastor-cli merge-data <from> <to> [--target <target>]`
|
`vitastor-cli merge-data <from> <to> [--target <target>]`
|
||||||
|
|
||||||
Слить данные слоёв, не меняя метаданные. Вливает данные из слоёв от `<from>` до `<to>`
|
Merge layer data without changing metadata. Merge `<from>`..`<to>` to `<target>`.
|
||||||
в целевой образ `<target>`. `<to>` должен быть дочерним образом `<from>`, а `<target>`
|
`<to>` must be a child of `<from>` and `<target>` may be one of the layers between
|
||||||
должен быть одним из слоёв между `<from>` и `<to>`, включая сами `<from>` и `<to>`.
|
`<from>` and `<to>`, including `<from>` and `<to>`.
|
||||||
|
|
||||||
## alloc-osd
|
## alloc-osd
|
||||||
|
|
||||||
`vitastor-cli alloc-osd`
|
`vitastor-cli alloc-osd`
|
||||||
|
|
||||||
Атомарно выделить новый номер OSD и зарезервировать его, создав в etcd пустой
|
Allocate a new OSD number and reserve it by creating empty `/osd/stats/<n>` key.
|
||||||
ключ `/osd/stats/<n>`.
|
|
||||||
|
|
||||||
## simple-offsets
|
## simple-offsets
|
||||||
|
|
||||||
`vitastor-cli simple-offsets <device>`
|
`vitastor-cli simple-offsets <device>`
|
||||||
|
|
||||||
Рассчитать смещения для простого и тупого создания OSD на диске (без суперблока).
|
Calculate offsets for simple&stupid (no superblock) OSD deployment.
|
||||||
|
|
||||||
Опции (см. также [Дисковые параметры уровня кластера](../config/layout-cluster.ru.md)):
|
Options (see also [Cluster-Wide Disk Layout Parameters](../config/layout-cluster.en.md)):
|
||||||
|
|
||||||
```
|
```
|
||||||
--object_size 128k Размер блока хранилища
|
--object_size 128k Set blockstore block size
|
||||||
--bitmap_granularity 4k Гранулярность битовых карт
|
--bitmap_granularity 4k Set bitmap granularity
|
||||||
--journal_size 32M Размер журнала
|
--journal_size 32M Set journal size
|
||||||
--device_block_size 4k Размер блока устройства
|
--device_block_size 4k Set device block size
|
||||||
--journal_offset 0 Смещение журнала
|
--journal_offset 0 Set journal offset
|
||||||
--device_size 0 Размер устройства
|
--device_size 0 Set device size
|
||||||
--format text Формат результата: json, options, env или text
|
--format text Result format: json, options, env, or text
|
||||||
```
|
```
|
||||||
|
|
|
||||||
|
|
@ -39,9 +39,9 @@ vitastor-cli - интерфейс командной строки для адм
|
||||||
|
|
||||||
`vitastor-cli status`
|
`vitastor-cli status`
|
||||||
|
|
||||||
Show cluster status.
|
Показать состояние кластера.
|
||||||
|
|
||||||
Example output:
|
Пример вывода:
|
||||||
|
|
||||||
```
|
```
|
||||||
cluster:
|
cluster:
|
||||||
|
|
@ -66,9 +66,9 @@ Example output:
|
||||||
|
|
||||||
`vitastor-cli df`
|
`vitastor-cli df`
|
||||||
|
|
||||||
Show pool space statistics.
|
Показать список пулов и занятое место.
|
||||||
|
|
||||||
Example output:
|
Пример вывода:
|
||||||
|
|
||||||
```
|
```
|
||||||
NAME SCHEME PGS TOTAL USED AVAILABLE USED% EFFICIENCY
|
NAME SCHEME PGS TOTAL USED AVAILABLE USED% EFFICIENCY
|
||||||
|
|
@ -77,26 +77,27 @@ size1 1/1 32 199.9 G 10 G 121.5 G 39.23% 100%
|
||||||
kaveri 2/1 32 0 B 10 G 0 B 100% 0%
|
kaveri 2/1 32 0 B 10 G 0 B 100% 0%
|
||||||
```
|
```
|
||||||
|
|
||||||
In the example above, "kaveri" pool has "zero" efficiency because all its OSD are down.
|
В примере у пула "kaveri" эффективность равна нулю, так как все OSD выключены.
|
||||||
|
|
||||||
## ls
|
## ls
|
||||||
|
|
||||||
`vitastor-cli ls [-l] [-p POOL] [--sort FIELD] [-r] [-n N] [<glob> ...]`
|
`vitastor-cli ls [-l] [-p POOL] [--sort FIELD] [-r] [-n N] [<glob> ...]`
|
||||||
|
|
||||||
List images (only matching `<glob>` pattern(s) if passed).
|
Показать список образов, если переданы шаблоны `<glob>`, то только с именами,
|
||||||
|
соответствующими этим шаблонам (стандартные ФС-шаблоны с * и ?).
|
||||||
|
|
||||||
Options:
|
Опции:
|
||||||
|
|
||||||
```
|
```
|
||||||
-p|--pool POOL Filter images by pool ID or name
|
-p|--pool POOL Фильтровать образы по пулу (ID или имени)
|
||||||
-l|--long Also report allocated size and I/O statistics
|
-l|--long Также выводить статистику занятого места и ввода-вывода
|
||||||
--del Also include delete operation statistics
|
--del Также выводить статистику операций удаления
|
||||||
--sort FIELD Sort by specified field (name, size, used_size, <read|write|delete>_<iops|bps|lat|queue>)
|
--sort FIELD Сортировать по заданному полю (name, size, used_size, <read|write|delete>_<iops|bps|lat|queue>)
|
||||||
-r|--reverse Sort in descending order
|
-r|--reverse Сортировать в обратном порядке
|
||||||
-n|--count N Only list first N items
|
-n|--count N Показывать только первые N записей
|
||||||
```
|
```
|
||||||
|
|
||||||
Example output:
|
Пример вывода:
|
||||||
|
|
||||||
```
|
```
|
||||||
NAME POOL SIZE USED READ IOPS QUEUE LAT WRITE IOPS QUEUE LAT FLAGS PARENT
|
NAME POOL SIZE USED READ IOPS QUEUE LAT WRITE IOPS QUEUE LAT FLAGS PARENT
|
||||||
|
|
@ -113,85 +114,94 @@ bench-kaveri kaveri 10 G 10 G 0 B/s 0 0 0 us 0 B/s 0
|
||||||
|
|
||||||
`vitastor-cli create -s|--size <size> [-p|--pool <id|name>] [--parent <parent_name>[@<snapshot>]] <name>`
|
`vitastor-cli create -s|--size <size> [-p|--pool <id|name>] [--parent <parent_name>[@<snapshot>]] <name>`
|
||||||
|
|
||||||
Create an image. You may use K/M/G/T suffixes for `<size>`. If `--parent` is specified,
|
Создать образ. Для размера `<size>` можно использовать суффиксы K/M/G/T (килобайт-мегабайт-гигабайт-терабайт).
|
||||||
a copy-on-write image clone is created. Parent must be a snapshot (readonly image).
|
Если указана опция `--parent`, создаётся клон образа. Родитель `<parent_name>[@<snapshot>]` должен быть
|
||||||
Pool must be specified if there is more than one pool.
|
снимком (или просто немодифицируемым образом). Пул обязательно указывать, если в кластере больше одного пула.
|
||||||
|
|
||||||
```
|
```
|
||||||
vitastor-cli create --snapshot <snapshot> [-p|--pool <id|name>] <image>
|
vitastor-cli create --snapshot <snapshot> [-p|--pool <id|name>] <image>
|
||||||
vitastor-cli snap-create [-p|--pool <id|name>] <image>@<snapshot>
|
vitastor-cli snap-create [-p|--pool <id|name>] <image>@<snapshot>
|
||||||
```
|
```
|
||||||
|
|
||||||
Create a snapshot of image `<name>` (either form can be used). May be used live if only a single writer is active.
|
Создать снимок образа `<name>` (можно использовать любую форму команды). Снимок можно создавать без остановки
|
||||||
|
клиентов, если пишущий клиент максимум 1.
|
||||||
|
|
||||||
## modify
|
## modify
|
||||||
|
|
||||||
`vitastor-cli modify <name> [--rename <new-name>] [--resize <size>] [--readonly | --readwrite] [-f|--force]`
|
`vitastor-cli modify <name> [--rename <new-name>] [--resize <size>] [--readonly | --readwrite] [-f|--force]`
|
||||||
|
|
||||||
Rename, resize image or change its readonly status. Images with children can't be made read-write.
|
Изменить размер, имя образа или флаг "только для чтения". Снимать флаг "только для чтения"
|
||||||
If the new size is smaller than the old size, extra data will be purged.
|
и уменьшать размер образов, у которых есть дочерние клоны, без `--force` нельзя.
|
||||||
You should resize file system in the image, if present, before shrinking it.
|
|
||||||
|
Если новый размер меньше старого, "лишние" данные будут удалены, поэтому перед уменьшением
|
||||||
|
образа сначала уменьшите файловую систему в нём.
|
||||||
|
|
||||||
```
|
```
|
||||||
-f|--force Proceed with shrinking or setting readwrite flag even if the image has children.
|
-f|--force Разрешить уменьшение или перевод в чтение-запись образа, у которого есть клоны.
|
||||||
```
|
```
|
||||||
|
|
||||||
## rm
|
## rm
|
||||||
|
|
||||||
`vitastor-cli rm <from> [<to>] [--writers-stopped]`
|
`vitastor-cli rm <from> [<to>] [--writers-stopped]`
|
||||||
|
|
||||||
Remove `<from>` or all layers between `<from>` and `<to>` (`<to>` must be a child of `<from>`),
|
Удалить образ `<from>` или все слои от `<from>` до `<to>` (`<to>` должен быть дочерним
|
||||||
rebasing all their children accordingly. --writers-stopped allows merging to be a bit
|
образом `<from>`), одновременно меняя родительские образы их клонов (если таковые есть).
|
||||||
more effective in case of a single 'slim' read-write child and 'fat' removed parent:
|
|
||||||
the child is merged into parent and parent is renamed to child in that case.
|
`--writers-stopped` позволяет чуть более эффективно удалять образы в частом случае, когда
|
||||||
In other cases parent layers are always merged into children.
|
у удаляемой цепочки есть только один дочерний образ, содержащий небольшой объём данных.
|
||||||
|
В этом случае дочерний образ вливается в родительский и удаляется, а родительский
|
||||||
|
переименовывается в дочерний.
|
||||||
|
|
||||||
|
В других случаях родительские слои вливаются в дочерние.
|
||||||
|
|
||||||
## flatten
|
## flatten
|
||||||
|
|
||||||
`vitastor-cli flatten <layer>`
|
`vitastor-cli flatten <layer>`
|
||||||
|
|
||||||
Flatten a layer, i.e. merge data and detach it from parents.
|
Сделай образ `<layer>` плоским, то есть, скопировать в него данные и разорвать его
|
||||||
|
соединение с родительскими.
|
||||||
|
|
||||||
## rm-data
|
## rm-data
|
||||||
|
|
||||||
`vitastor-cli rm-data --pool <pool> --inode <inode> [--wait-list] [--min-offset <offset>]`
|
`vitastor-cli rm-data --pool <pool> --inode <inode> [--wait-list] [--min-offset <offset>]`
|
||||||
|
|
||||||
Remove inode data without changing metadata.
|
Удалить данные инода, не меняя метаданные образов.
|
||||||
|
|
||||||
```
|
```
|
||||||
--wait-list Retrieve full objects listings before starting to remove objects.
|
--wait-list Сначала запросить полный листинг объектов, а потом начать удалять.
|
||||||
Requires more memory, but allows to show correct removal progress.
|
Требует больше памяти, но позволяет правильно печатать прогресс удаления.
|
||||||
--min-offset Purge only data starting with specified offset.
|
--min-offset Удалять только данные, начиная с заданного смещения.
|
||||||
```
|
```
|
||||||
|
|
||||||
## merge-data
|
## merge-data
|
||||||
|
|
||||||
`vitastor-cli merge-data <from> <to> [--target <target>]`
|
`vitastor-cli merge-data <from> <to> [--target <target>]`
|
||||||
|
|
||||||
Merge layer data without changing metadata. Merge `<from>`..`<to>` to `<target>`.
|
Слить данные слоёв, не меняя метаданные. Вливает данные из слоёв от `<from>` до `<to>`
|
||||||
`<to>` must be a child of `<from>` and `<target>` may be one of the layers between
|
в целевой образ `<target>`. `<to>` должен быть дочерним образом `<from>`, а `<target>`
|
||||||
`<from>` and `<to>`, including `<from>` and `<to>`.
|
должен быть одним из слоёв между `<from>` и `<to>`, включая сами `<from>` и `<to>`.
|
||||||
|
|
||||||
## alloc-osd
|
## alloc-osd
|
||||||
|
|
||||||
`vitastor-cli alloc-osd`
|
`vitastor-cli alloc-osd`
|
||||||
|
|
||||||
Allocate a new OSD number and reserve it by creating empty `/osd/stats/<n>` key.
|
Атомарно выделить новый номер OSD и зарезервировать его, создав в etcd пустой
|
||||||
|
ключ `/osd/stats/<n>`.
|
||||||
|
|
||||||
## simple-offsets
|
## simple-offsets
|
||||||
|
|
||||||
`vitastor-cli simple-offsets <device>`
|
`vitastor-cli simple-offsets <device>`
|
||||||
|
|
||||||
Calculate offsets for simple&stupid (no superblock) OSD deployment.
|
Рассчитать смещения для простого и тупого создания OSD на диске (без суперблока).
|
||||||
|
|
||||||
Options (see also [Cluster-Wide Disk Layout Parameters](../config/layout-cluster.en.md)):
|
Опции (см. также [Дисковые параметры уровня кластера](../config/layout-cluster.ru.md)):
|
||||||
|
|
||||||
```
|
```
|
||||||
--object_size 128k Set blockstore block size
|
--object_size 128k Размер блока хранилища
|
||||||
--bitmap_granularity 4k Set bitmap granularity
|
--bitmap_granularity 4k Гранулярность битовых карт
|
||||||
--journal_size 32M Set journal size
|
--journal_size 32M Размер журнала
|
||||||
--device_block_size 4k Set device block size
|
--device_block_size 4k Размер блока устройства
|
||||||
--journal_offset 0 Set journal offset
|
--journal_offset 0 Смещение журнала
|
||||||
--device_size 0 Set device size
|
--device_size 0 Размер устройства
|
||||||
--format text Result format: json, options, env, or text
|
--format text Формат результата: json, options, env или text
|
||||||
```
|
```
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue