pool

Обзор

Описание

Управлять пулами.

Синтаксис

pool COMMAND [ARGS]...

Команды

create — создать пул;
destroy — удалить пул;
list — просмотреть список пулов;
modify — изменить параметры пула:
- show — просмотреть текущую конфигурацию пула;
- replace — заменить диск в пул;
- add — добавить диски определенного типа в пул:
  - add cache — добавить кеш-диск;
  - add drives — добавить диски для данных;
  - add log — добавить диски журналирования;
  - add spare — добавить диски горячей замены;
- remove — удалить диск из пула;
scrub — запустить или остановить проверку целостности;
status — просмотреть статус всех пулов.

pool create

Описание

Создать пул.

Синтаксис

pool create [OPTIONS] <POOL_NAME>

Опции

-t,--pool_type <mirror|raidz1|raidz2|raidz3> — тип пула. Обязательный параметр;
-d, --devices <IND_DISK_LIST> — список порядковых номеров дисков. Обязательный параметр;
-n, --disks_per_vdev <INTEGER> — количество дисков на виртуальном дисковом устройстве. Тип данных — INTEGER.

Аргументы

<POOL_NAME> — имя пула.

Пример

HOSTNAME> pool create -t raidz1 -d 1,2,3 -n 3 mypool

pool destroy

Описание

Удалить пул.

Синтаксис

pool destroy <POOL_NAME>

Аргументы

<POOL_NAME> — имя пула.

Пример

HOSTNAME> pool destroy mypool

pool list

Описание

Просмотреть список пулов.

Синтаксис

pool list [OPTIONS]

Опции

-v, --verbose — просмотреть подробную информацию о пулах.

Пример

HOSTNAME> pool list -v

pool modify

Описание

Перейти в режим изменения пула.

Режимы управления пулом описаны ниже:

show — просмотреть текущую конфигурацию пула;
replace — заменить диск в пуле;
add — добавить диски в пул:
- add cache — добавить кеш-диск;
- add drives — добавить диски для данных;
- add log — добавить диски журналирования;
- add spare — добавить диски горячей замены;
remove — удалить диск из пула.

Синтаксис

pool modify <POOL_NAME>

Аргументы

<POOL_NAME> — имя пула.

Дополнение

Чтобы перейти в режим управления пулом, введите
```
HOSTNAME> pool modify <POOL_NAME>
```

Sharx Storage отобразит свойства пула. Свободным дискам пула присвоены порядковые номера (строки 15-22). Приглашение для ввода команд в рамках указанного пула выведено в строке 26.

Свойства пула. Пример из терминала
s01> pool modify mypool
NAME                                                               RAW SIZE HEALTH    
mypool                                                                24.0T ONLINE    
 raidz1-0                                                             12.0T ONLINE    
     wwn-0x5000c500ef45578f                                            4.0T ONLINE    
     wwn-0x5000c500ef45440f                                            4.0T ONLINE    
     wwn-0x5000c500ef4544e3                                            4.0T ONLINE    
 raidz1-1                                                             12.0T ONLINE    
    wwn-0x5000c500ef455cff                                             4.0T ONLINE    
    wwn-0x5000c500ef4455a3                                             4.0T ONLINE    
    wwn-0x5000c500ef445f23                                             4.0T ONLINE    
 spare:
    wwn-0x5000c500eeda4457                                              4.0T AVAIL     
    wwn-0x5000c500ef2e4a03                                              4.0T AVAIL     
1:HDD/12.0T/wwn-0x5000cca2913ef66c
2:HDD/4.0T/wwn-0x5000c500eeda41db
3:HDD/4.0T/wwn-0x5000c500eeda4a3b
4:SSD/960.2G/wwn-0x5002538b72cf5010
5:SSD/960.2G/wwn-0x5002538b72cf5030
6:SSD/960.2G/wwn-0x5002538b72cf5040
7:SSD/800.2G/wwn-0x5002538b7331ba00
8:SSD/800.2G/wwn-0x5002538b7331bdd0

--- Pool modification ---

mypool%

Чтобы выйти из пула, введите
```
POOL_NAME% quit
```

show

Описание

Просмотреть текущую конфигурацию пула.

Синтаксис

show

Пример

 POOL_NAME% show

replace

Описание

Заменить диск в пуле.
В команде укажите имя старого диска, затем имя нового диска.

Важно

Данная операция не применяется к дискам горячей замены (hot-spare) и кеш-дискам

Синтаксис

replace <OLD_DISK> <NEW_DISK>

Аргументы

<OLD_DISK> — имя старого диска;
<NEW_DISK> — имя нового диска.

Пример

POOL_NAME% replace wwn-0x5000c500ef45635f wwn-0x5000c500ef458077

add

Описание

Добавить диски определенного типа в пул.
Возможно добавить диски для данных, диски горячей замены, кеш-диски, диски журналирования

Синтаксис

add COMMAND [ARGS]...

Команды

cache — добавить кеш-диск;
drives — добавить диски для данных;
log — добавить диски журналирования;
spare — добавить диски горячей замены.

add cache

Описание

Добавить кеш-диски в пул.

Примечание

В Sharx Storage в качестве кеш-дисков возможно добавить только твердотельные носители информации

Синтаксис

add cache <IND_DEVICES_IN_POOL>

Аргументы

<IND_DEVICES_IN_POOL> - порядковый номер диска, полученный в результате команды POOL_NAME% show в рамках пула.
Вводите номера дисков через запятую, например 1,3. В пул в качестве добавятся первый и третий диски.
Чтобы добавить диапазон дисков, запишите их через дефис, например 2,5-7. Добавятся второй диск и диски с пятого по седьмой включительно.

Пример

POOL_NAME% add cache 1,3

add drives

Описание

Добавить диски для данных в пул.

Синтаксис

add drives <IND_DEVICES_IN_POOL>

Аргументы

<IND_DEVICES_IN_POOL> - порядковый номер диска, полученный в результате команды POOL_NAME% show в рамках пула.
Вводите номера дисков через запятую, например 1,3. В пул в качестве добавятся первый и третий диски.
Чтобы добавить диапазон дисков, запишите их через дефис, например 2,5-7. Добавятся второй диск и диски с пятого по седьмой включительно.

Пример

POOL_NAME% add drives 4,5,6

add log

Описание

Добавить диски журналирования.

Внимание

Добавляйте диски журналирования только парами.
Доступно только для SSD или NVMe-дисков.

Синтаксис

add log <IND_DEVICES_IN_POOL>

Аргументы

<IND_DEVICES_IN_POOL> - порядковый номер диска, полученный в результате команды POOL_NAME% show в рамках пула.
Вводите номера дисков через запятую, например 1,3. В пул в качестве добавятся первый и третий диски.
Чтобы добавить диапазон дисков, запишите их через дефис, например 2,5-7. Добавятся второй диск и диски с пятого по седьмой включительно.

Пример

POOL_NAME% add log 2,3

add spare

Описание

Добавить диски горячей замены.

Важно

Добавляемый диск должен быть бóльшего размера, чем самый большой диск в пуле

Синтаксис

add spare <IND_DEVICES_IN_POOL>

Аргументы

<IND_DEVICES_IN_POOL> - порядковый номер диска, полученный в результате команды POOL_NAME% show в рамках пула.
Вводите номера дисков через запятую, например 1,3. В пул в качестве добавятся первый и третий диски.
Чтобы добавить диапазон дисков, запишите их через дефис, например 2,5-7. Добавятся второй диск и диски с пятого по седьмой включительно.

Пример

POOL_NAME% add spare 6-7

remove

Описание

Удалить диск из пула.
Удалить диски из raidz невозможно.
При удалении дисков журналирования указывайте название группы этих дисков, так как диски журналирования всегда образуют пару.

Синтаксис

remove <DEVICES>...

Аргументы

<DEVICES> — имя диска. Чтобы удалить диски логирования, указывайте имя их группы, например mirror-1.

Пример

POOL_NAME% remove wwn-0x5000c500ef458077

Дополнение

Чтобы корректно удалить диски журналирования, выполните следующие действия:

В свойствах пула найдите группу дисков журналирования. В примере — это строки 12-14. Группа названа mirror-1.

Свойства пула. Пример из терминала
s01> pool modify mypool
NAME                                                               RAW SIZE HEALTH    
mypool                                                                24.0T ONLINE    
 raidz1-0                                                             12.0T ONLINE    
     wwn-0x5000c500ef45578f                                            4.0T ONLINE    
     wwn-0x5000c500ef45440f                                            4.0T ONLINE    
     wwn-0x5000c500ef4544e3                                            4.0T ONLINE    
 raidz1-1                                                             12.0T ONLINE    
    wwn-0x5000c500ef455cff                                             4.0T ONLINE    
    wwn-0x5000c500ef4455a3                                             4.0T ONLINE    
    wwn-0x5000c500ef445f23                                             4.0T ONLINE    
 mirror-1
    wwn-0x5002538b7331ba00                                           800.2G ONLINE     
    wwn-0x5002538b7331bdd0                                           800.2G ONLINE     
1:HDD/12.0T/wwn-0x5000cca2913ef66c
2:HDD/4.0T/wwn-0x5000c500eeda41db
3:HDD/4.0T/wwn-0x5000c500eeda4a3b
4:SSD/960.2G/wwn-0x5002538b72cf5010
5:SSD/960.2G/wwn-0x5002538b72cf5030
6:SSD/960.2G/wwn-0x5002538b72cf5040

--- Pool modification ---

mypool%

Удалите группу дисков журналирования командой
```
POOL_NAME% remove mirror-1
```
Подтвердите удаление.

pool scrub

Описание

Обслужить пул.
Команда позволяет запустить или остановить проверку целостности и ошибок на пуле.

Синтаксис

pool scrub [OPTIONS] <POOL_NAME>

Опции

-s, --stop — остановить операцию.

Аргументы

<POOL_NAME> — имя пула.

Пример

HOSTNAME> pool scrub mypool

pool status

Описание

Просмотреть статус всех пулов.

Синтаксис

pool status

Пример

HOSTNAME> pool status