[2026-07-03] eagle: family/how-to/htpc-system.md family/how-to/openmediavault-rpi5.md

family/how-to/openmediavault-rpi5.md

@@ -171,6 +171,52 @@ sudo update-initramfs -u -k all < /dev/null
 
 > ⚠️ Не монтировать вручную через fstab — OMV должен управлять монтированием сам
 
+### CLI-альтернатива: регистрация диска в OMV через config.xml
+
+Если Web UI недоступен, можно зарегистрировать диск через прямой редактор config.xml и deploy:
+
+```bash
+# 1. Добавить mntent в /etc/openmediavault/config.xml через Python
+sudo python3 -c "
+import xml.etree.ElementTree as ET, uuid
+tree = ET.parse('/etc/openmediavault/config.xml')
+fstab = tree.find('.//fstab')
+if fstab is None:
+    fstab = ET.SubElement(tree.find('system'), 'fstab')
+mntent = ET.SubElement(fstab, 'mntent')
+ET.SubElement(mntent, 'uuid').text = str(uuid.uuid4())
+ET.SubElement(mntent, 'fsname').text = '/dev/disk/by-uuid/<UUID>'
+ET.SubElement(mntent, 'dir').text = '/srv/dev-disk-by-uuid-<UUID>'
+ET.SubElement(mntent, 'type').text = 'ext4'
+ET.SubElement(mntent, 'opts').text = 'defaults,nofail,user_xattr,usrquota,grpquota,acl'
+ET.SubElement(mntent, 'freq').text = '0'
+ET.SubElement(mntent, 'passno').text = '2'
+ET.SubElement(mntent, 'hidden').text = '0'
+ET.SubElement(mntent, 'usagewarnthreshold').text = '85'
+ET.SubElement(mntent, 'comment').text = ''
+tree.write('/etc/openmediavault/config.xml', encoding='utf-8', xml_declaration=True)
+print('OK')
+"
+
+# 2. Применить через salt
+sudo omv-salt deploy run fstab
+
+# 3. Диск автоматически примонтируется
+```
+
+### Сохранение обратной совместимости при замене диска
+
+Если старый HDD заменяется на новый с другим UUID, а все сервисы привязаны к старому UUID в путях (`/srv/dev-disk-by-uuid-<STARAYUUID>/...`), можно создать симлинк:
+
+```bash
+# Удалить старую папку от OMV (там только bind-mount точки, не реальные данные)
+sudo rm -rf /srv/dev-disk-by-uuid-<СТАРЫЙ_UUID>
+# Создать симлинк на новый диск
+sudo ln -s /srv/dev-disk-by-uuid-<НОВЫЙ_UUID> /srv/dev-disk-by-uuid-<СТАРЫЙ_UUID>
+```
+
+Это позволяет избежать правок во всех docker-compose, smb.conf, fstab и скриптах.
+
 ---
 
 ## Шаг 7 — omv-extras + Docker