Skip to content

Commit 6843824

Browse files
authored
[docs] expand ReplicatedStoragePool (#280)
Signed-off-by: v.oleynikov <[email protected]>
1 parent 8f2ed61 commit 6843824

File tree

2 files changed

+84
-0
lines changed

2 files changed

+84
-0
lines changed

docs/FAQ.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,48 @@ Add corresponding StorageClass name to `spec.settings.defaultClusterStorageClass
6464

6565
2. Specify this resource in the [ReplicatedStoragePool](./cr.html#replicatedstoragepool) parameters in the `spec.lvmVolumeGroups[].name` field (note that for the LVMThin pool, you must additionally specify its name in `spec.lvmVolumeGroups[].thinPoolName`).
6666

67+
## How to expand ReplicatedStoragePool to new cluster node?
68+
69+
To expand an existing ReplicatedStoragePool use new LVM Volume Group, follow these steps:
70+
71+
1. Create new LVMVolumeGroup with [sds-node-configurator](../../sds-node-configurator/stable/usage.html#creating-an-lvmvolumegroup-resource)
72+
73+
1. Add the new Volume Group to the existing ReplicatedStoragePool by editing the resource:
74+
75+
```shell
76+
kubectl edit replicatedstoragepool your-pool-name
77+
```
78+
79+
Add the new Volume Group to the `spec.lvmVolumeGroups` section:
80+
81+
```yaml
82+
spec:
83+
lvmVolumeGroups:
84+
- name: existing-vg-name
85+
- name: new-vg-name # Add this line
86+
```
87+
88+
1. For LVMThin pools, additionally specify the thin pool name:
89+
90+
```yaml
91+
spec:
92+
lvmVolumeGroups:
93+
- name: existing-vg-name
94+
thinPoolName: existing-thin-pool
95+
- name: new-vg-name
96+
thinPoolName: new-thin-pool # Add this line
97+
```
98+
99+
1. Save the changes. The controller will automatically create a Storage Pool in LINSTOR for the new Volume Group and add it to the existing ReplicatedStoragePool.
100+
101+
1. Check the expansion status:
102+
103+
```shell
104+
kubectl get replicatedstoragepool your-pool-name -o yaml
105+
```
106+
107+
Information about the new Volume Group should be displayed in the status.
108+
67109
## How to increase the limit on the number of DRBD devices / change the ports through which DRBD clusters communicate with each other?
68110

69111
To increase the limit on the number of DRBD devices / change the ports through which DRBD clusters communicate with each other, you can use the drbdPortRange setting. By default, DRBD resources use TCP ports 7000-7999. These values can be redefined using minPort and maxPort.

docs/FAQ_RU.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,48 @@ description: Диагностика проблем LINSTOR. Когда след
6464

6565
2. Полученный ресурс укажите в параметрах [ReplicatedStoragePool](./cr.html#replicatedstoragepool) в поле `spec.lvmVolumeGroups[].name` (для LVMThin-пула необходимо дополнительно указать имя в `spec.lvmVolumeGroups[].thinPoolName`).
6666

67+
## Как расширить ReplicatedStoragePool на новый узел кластера?
68+
69+
Для расширения существующего ReplicatedStoragePool используйте новый LVM Volume Group. Выполните следующие шаги:
70+
71+
1. Создайте новую LVMVolumeGroup с помощью модуля [sds-node-configurator](../../sds-node-configurator/stable/usage.html#creating-an-lvmvolumegroup-resource)
72+
73+
1. Добавьте новую Volume Group в существующий ReplicatedStoragePool, отредактировав ресурс:
74+
75+
```shell
76+
kubectl edit replicatedstoragepool your-pool-name
77+
```
78+
79+
Добавьте новую Volume Group в секцию `spec.lvmVolumeGroups`:
80+
81+
```yaml
82+
spec:
83+
lvmVolumeGroups:
84+
- name: existing-vg-name
85+
- name: new-vg-name # Добавьте эту строку
86+
```
87+
88+
1. Для LVMThin-пулов дополнительно укажите имя тонкого пула:
89+
90+
```yaml
91+
spec:
92+
lvmVolumeGroups:
93+
- name: existing-vg-name
94+
thinPoolName: existing-thin-pool
95+
- name: new-vg-name
96+
thinPoolName: new-thin-pool # Добавьте эту строку
97+
```
98+
99+
1. Сохраните изменения. Контроллер автоматически создаст Storage Pool в LINSTOR для новой Volume Group и добавит её в существующий ReplicatedStoragePool.
100+
101+
1. Проверьте статус расширения:
102+
103+
```shell
104+
kubectl get replicatedstoragepool your-pool-name -o yaml
105+
```
106+
107+
В статусе должна отобразиться информация о новой Volume Group.
108+
67109
## Как увеличить ограничение на количество DRBD-томов / изменить порты, по которым DRBD-кластера общаются между собой?
68110

69111
Воспользуйтесь настройкой `drbdPortRange`. По умолчанию для DRBD-ресурсов используются TCP-порты 7000-7999. С помощью `minPort` и `maxPort` эти значения можно переопределить.

0 commit comments

Comments
 (0)