Files
napalm-openmediavault/tests/test_set_hostname.py
T
Christian Manivong de8f041100
driver / standard (pull_request) Successful in 17s
driver / lint (pull_request) Successful in 15s
driver / types (pull_request) Successful in 1m7s
driver / test (3.13) (pull_request) Successful in 1m0s
driver / lowest (pull_request) Successful in 26s
driver / security (pull_request) Successful in 1m9s
driver / build (pull_request) Successful in 31s
driver / test (3.12) (pull_request) Successful in 1m9s
CI / driver (pull_request) Successful in 1m9s
driver / publish (pull_request) Skipped
feat: set_hostname through OMV's own database
napalm-linux now renames a host through hostnamectl, /etc/hostname and
/etc/hosts (NAPALM/napalm-linux#45). OMV regenerates those files from
conf.system.network.dns on its next apply, so the inherited rename would
not last.

set_hostname() goes where OMV's web UI goes: Network.setGeneralSettings
(an FQDN sets the domain too, a bare name keeps it), then
Config.applyChanges with an explicit module list -- the modules the
rename made dirty, plus the hostname modules that already were. Changes
someone left pending in the web UI stay pending. Checked against the RPC
sources of OMV 8.6 (rpc/network.inc, rpc/config.inc).
2026-10-29 23:11:04 +01:00

155 lines
5.0 KiB
Python

"""OpenMediaVault renames itself through its own database, not through /etc.
The rename napalm-linux offers (``hostnamectl``, ``/etc/hosts``) would be taken
back by the next apply of OMV's settings, which regenerates both from
``conf.system.network.dns``. So the name goes where OMV's web UI puts it:
``Network.setGeneralSettings``, then ``Config.applyChanges`` -- for the modules
the rename made dirty only, so changes someone left pending in the web UI
(here ``apt`` and ``rsyslog``) are not deployed along with it.
"""
from __future__ import annotations
import json
import shlex
import pytest
from napalm_openmediavault.openmediavault import OpenMediaVaultDriver
_RENAME_DIRTIES = ["hostname", "hosts", "postfix", "avahi", "samba", "systemdnetworkd"]
class Omv:
"""The NAS as ``_sudo_status`` sees it: omv-rpc calls and the dirty-modules file."""
def __init__(self, *, dirty=("apt", "rsyslog"), fail=""):
self.settings = {"hostname": "nas", "domainname": "home.example"}
self.dirty = list(dirty)
self.fail = fail
self.calls: list[tuple[str, str, object]] = []
self.commands: list[str] = []
def __call__(self, command: str, read_timeout: float = 100) -> tuple[str, int | None]:
self.commands.append(command)
if command.startswith("cat /var/lib/openmediavault/dirtymodules.json"):
return json.dumps(self.dirty), 0
argv = shlex.split(command)
assert argv[:3] == ["omv-rpc", "-u", "admin"], command
service, method = argv[3], argv[4]
params = json.loads(argv[5]) if len(argv) > 5 else None
self.calls.append((service, method, params))
if f"{service}.{method}" == self.fail:
return '{"response":null,"error":{"message":"boom"}}', 1
if (service, method) == ("Network", "getGeneralSettings"):
return json.dumps(self.settings), 0
if (service, method) == ("Network", "setGeneralSettings"):
self.settings = params
self.dirty += [m for m in _RENAME_DIRTIES if m not in self.dirty]
return json.dumps(params), 0
if (service, method) == ("Config", "applyChanges"):
self.dirty = [m for m in self.dirty if m not in params["modules"]]
return "null", 0
raise AssertionError(command)
def call(self, method: str):
return [params for s, m, params in self.calls if f"{s}.{m}" == method]
def _driver(omv: Omv) -> OpenMediaVaultDriver:
driver = OpenMediaVaultDriver("nas", "admin", "p")
driver._sudo_status = omv # type: ignore[method-assign]
return driver
def test_bare_name_keeps_the_domain():
omv = Omv()
_driver(omv).set_hostname("nas2")
assert omv.call("Network.setGeneralSettings") == [
{"hostname": "nas2", "domainname": "home.example"}
]
def test_fqdn_sets_the_domain_too():
omv = Omv()
_driver(omv).set_hostname("nas2.lab.example")
assert omv.call("Network.setGeneralSettings") == [
{"hostname": "nas2", "domainname": "lab.example"}
]
def test_only_what_the_rename_made_dirty_is_applied():
omv = Omv()
_driver(omv).set_hostname("nas2")
assert omv.call("Config.applyChanges") == [{"modules": sorted(_RENAME_DIRTIES), "force": False}]
assert omv.dirty == ["apt", "rsyslog"]
def test_a_hostname_module_already_dirty_is_applied_as_well():
omv = Omv(dirty=("apt", "samba"))
_driver(omv).set_hostname("nas2")
(apply,) = omv.call("Config.applyChanges")
assert "samba" in apply["modules"]
assert "apt" not in apply["modules"]
def test_nothing_dirty_nothing_applied():
omv = Omv()
omv.settings = {"hostname": "nas2", "domainname": "home.example"}
driver = _driver(omv)
driver._sudo_status = _no_new_dirt(omv) # type: ignore[method-assign]
driver.set_hostname("nas2")
assert omv.call("Config.applyChanges") == []
def _no_new_dirt(omv: Omv):
"""OMV marks nothing dirty when the settings did not change."""
def status(command: str, read_timeout: float = 100):
if "setGeneralSettings" in command:
omv.calls.append(("Network", "setGeneralSettings", json.loads(shlex.split(command)[5])))
return json.dumps(omv.settings), 0
return omv(command, read_timeout)
return status
@pytest.mark.parametrize("name", ["", "nas_2", "-nas", "nas.", "a" * 64, "nas;reboot", "$(id)"])
def test_invalid_name_runs_nothing(name):
omv = Omv()
with pytest.raises(ValueError):
_driver(omv).set_hostname(name)
assert omv.commands == []
def test_unreadable_settings_change_nothing():
omv = Omv(fail="Network.getGeneralSettings")
with pytest.raises(RuntimeError, match="getGeneralSettings"):
_driver(omv).set_hostname("nas2")
assert omv.call("Network.setGeneralSettings") == []
def test_failed_apply_raises():
omv = Omv(fail="Config.applyChanges")
with pytest.raises(RuntimeError, match="applyChanges"):
_driver(omv).set_hostname("nas2")
def test_offered_as_a_capability():
assert callable(getattr(OpenMediaVaultDriver, "set_hostname", None))