Man:Man8/drbdsetup.8
Матеріал з docs.linux.org.ua — збірника документації з Unix/Linux українською мовою.
DRBD - кластер дисків (v 0.7.* переклад: альфа версія)
Зміст |
ІМ'Я
drbdsetup - інструмент для встановлення DRBD
СИНТАКСИС
drbdsetup device disk lower_dev meta_data_dev meta_data_index [ -d size ] [ -e err_handler ] drbdsetup device net local_addr [ :port ] remote_addr [ :port ] protocol [ -c time ] [ -i time ] [ -t val ] [ -S size ] [ -k count ] [ -d discon_handler ] drbdsetup device syncer [ -k ] [ -g group ] [ -r rate ] [ -e extents ] drbdsetup device disconnect drbdsetup device detach drbdsetup device down drbdsetup device primary [ -h ] [ -t ] [ -d ] drbdsetup device secondary drbdsetup device on_primary [ -h ] [ -t ] drbdsetup device invalidate drbdsetup device invalidate_remote drbdsetup device wait_connect [ -t wfc_timeout ] [ -d degr_wfc_timeout ] drbdsetup device wait_sync [ -t wfc_timeout ] [ -d degr_wfc_timeout ] drbdsetup device state drbdsetup device cstate drbdsetup device resize [ -d size ] drbdsetup device show
ОПИС
drbdsetup використовується для встановлення асоціації між DRBD пристроєм та його низькорівневими блочним пристроєм, для встановлення пар DRBD пристроїв, щоб здійснювати дзеркальне відображення їх низькорівневих блочних пристроїв і для перевірки налаштування працюючого DRBD кластеру.
ПРИМІТКА
drbdsetup є низькорівневий інструмент до DRBD кластеру. Він використовується datadisk, drbdadm та drbd скриптом для зв'язку з драйвером пристрою.
КОМАНДИ
Кожна підкоманда drbdsetup потребує аргументів і має свою власну порцію опцій. Усі значення мають свою розмірність по замовчуванню, яку можна змінити суфіксами K, M or G. Їх розмірність визначається звичним шляхом (тобто: K = 2^10 = 1024)
|
DISK |
Зв'язує пристрій з низькорівневим пристроєм для збереження на ньому блоків даних. Опція -d (чи --disk-size) повинна вживатись тільки тоді коли не бажаєте використовувати максимально можливий розмір зумовлений розміром низькорівневих дисків. Якщо не вживати -d пристрій буде готовий до використання одразу після під'єднання до свого партнера. (Дивіться команду NET.)
|
|
NET |
Встановлює пристрій для прослуховування local_addr:port очікуючи з'єднання і для намагання встановити зв'язок з remote_addr:port. Якщо порт пропущений по замовчуванню використовується 7788. Протокол А: операція запису вважається завершеною, якщо дані досягли локального диску та локальної вихідної черги tcp. Протокол В: операція запису вважається завершеною, якщо дані досягли локального диску та віддаленої вхідної черги. Протокол С: операція запису вважається завершеною, якщо дані досягли локального та віддаленого диску.
|
|
SYNCER |
Змінює синхронізаційні параметри сервісу пристрою під час роботи. Не міняє mentioned параметрів.
|
|
PRIMARY |
Встановлення пристрою в основний стан, що означає можливість відкриття його програмами (чи файловими системами) для читання та запису. Дані, що пишуться на пристрій в основному стані дзеркально відображаються на пристрій в другорядному стані. Не можливо встановити обидва пристрої з'єднаної DRBD пари в основний стан.
|
|
SECONDARY |
Встановлює пристрій в другорядний стан. Ця команда не виконається коли хоча б одна програма (чи файлова система) має відкритий доступ на запис на цей пристрій. Однак можливо, що обидва пристрої з'єднані в DRBD пару є в другорядному стані. |
|
ON_PRIMARY |
Це встановлює додаткову опцію, що приводить до наступного переходу в основний стан. Опція дійсна тільки поки пристрій не зв'яжеться з своїм партнером. Можливі опції: --inc-human та --inc-timeout-expired. Ця команда є для зручності. Ефект від неї той же, як би вказати цю опцію до команди primary напряму. Для детального опису двох опцій дивіться команду primary. |
|
NVALIDATE |
Насильно переводить локальний пристрій, пари пристроїв підключених до DRBD в стані їх партнерської синхронізації, що означає копіювання всіх блоків даних з партнера на локальний пристрій. Ця команда не виконається, коли пристрої не є частиною пари з'єднаних пристроїв. |
|
INVALIDATE_REMOTE |
Насильно переводить локальний пристрій DRBD пристроїв в стан джерела їх синхронізації, що означає копіювання всіх блоків даних з локального пристрою до партнера. |
|
WAIT_CONNECT |
Продовжує тоді коли пристрій може зв'язуватись з своїм партнерським пристроєм.
Команда видасть помилку, коли пристрій не зможе зв'язатись з своїм партнером на протязі timeout секунд. Якщо партнер працював перед перевантаженням вузла, використовується wfc_timeout. Якщо партнер відключивсь перед перевантаженням вузла, використовується degr_wfc_time-out. По замовчуванню значення wfc_timeout рівне 0, що значить чекати вічно. Значення по замовчуванню для degr_wfc_timeout рівне 120 секунд. |
|
WAIT_SYNC |
Продовжує тоді коли пристрій виходить з будь-якого синхронізаційного стану, і повертається в стан зв'язку. Опції такі ж, як з командою wait_connect. |
|
DISCONNECT |
Видаляє інформацію встановлену командою NET з пристрою. Тобто переводить пристрій в від'єднаний стан, що означає не прослуховування більше мережі. |
|
DETACH |
Видаляє інформацію встановлену командою DISK з пристрою. Це приводить до від'єднання пристрою від низькорівневого пристрою. |
|
DOWN |
Видаляє всю конфіґураційну інформацію з пристрою і переводить його назад в не налаштований стан. |
|
STATE |
Показує поточний стан пристрою і його партнера (local/peer). |
|
CSTATE |
Показує поточний стан зв'язку пристрою. |
|
RESIZE |
Це приведе до перевірки розміру низькорівневих дисків. Щоб здійснити збільшення диску робочої системи потрібно розширити низькорівневі диски на обох пристроях та викликати команду resize на обох вузлах. |
|
SHOW |
Показує всю доступну конфіґураційну інформацію пристрою. |
ПРИКЛАДИ
ВСТАНОВЛЕННЯ ПАРИ ПРИСТРОЇВ
В цьому прикладі комп'ютери, tc1 і tc2, сполучені прямим кабелем через інтерфейс 192.168.37.2 (tc1) і 192.168.37.3 (tc2). Включимо /dev/hda6 у віртуальний диск.
На tc1 виконуємо
$ drbdsetup /dev/drbd0 disk /dev/hda6
$ drbdsetup /dev/drbd0 net 192.168.37.2 192.168.37.3 B
На tc2 виконуємо:
$ drbdsetup /dev/drbd0 disk /dev/hda6
$ drbdsetup /dev/drbd0 net 192.168.37.3 192.168.37.2 B
$ drbdsetup /dev/drbd0 primary
$ cat /proc/drbd
version: 0.7.0 (api:xx/proto:yy)
0: cs:Connected st:Primary/Secondary ns:0 nr:0 dw:0 dr:0 of:0
1: cs:WFConnection st:Secondary/Unknown ns:0 nr:0 dw:0 dr:0 of:0
Через /proc/drbd ми можемо бачити, що наша пара пристроїв є з'єднана та пристрій є готовий до використання на tc2.
Тепер можна запускати програми поверху віртуального диску:
$ mkfs -b 4096 /dev/drbd0
$ mount /dev/drbd0 /mnt/mountpoint
ЗНІМОК ДИСКУ ЗАПИСАТИ НА ТРЕТЮ МАШИНУ
В цьому прикладі комп'ютер, tc1 і tc2, є з'єднані і tc2 є основним вузлом пристрою /dev/drbd0 Знімок цього пристрою потрібно записати на tc3, /dev/hda6.
Нам потрібно підготувати tc3:
$ drbdsetup /dev/drbd0 disk /dev/hda6
$ drbdsetup /dev/drbd0 net tc3 tc2 B
На tc2 ми виконуємо
$ drbdsetup /dev/drbd0 disconnect
$ drbdsetup /dev/drbd0 net tc2 tc3 B --sync-rate 4M
$ drbdsetup /dev/drbd0 replicate
$ drbdsetup /dev/drbd0 wait_sync
$ drbdsetup /dev/drbd0 disconnect
$ drbdsetup /dev/drbd0 net tc2 tc1 B
$ drbdsetup /dev/drbd0 replicate
Так як знімок диску береться без переведення диску в стабільний стан, потрібно виконати на tc3:
$ drbdsetup /dev/drbd0 down
$ fsck /dev/hda6
$ mount /dev/hda6 /some/mountpoint
ВЕРСІЯ
Цей документ коректний для версії 0.7.* пакету DRBD.
АВТОРИ
Написаний Пилипом Рейзнером (Philipp Reisner) <philipp.reisner@linbit.com>.
ПОВІДОМЛЕННЯ ПОМИЛОК
Повідомляйте про помилки на <drbd-user@lists.linbit.com>.
АВТОРСЬКІ ПРАВА
Copyright (c) 2001 Philipp Reisner. Це вільні програми; дивіться джерельні коди для встановлення прав копіювання. Нема ніяких гарантій; навіть для зручності використання в конкретному випадку.
ПОДІБНІ ТЕМИ
drbd - кластер дисків, drbdadm(8), drbd.conf(5), drbd(8), datadisk(8)
