README: Add special note on NTP setting change
Systemd timedated from v236 to v239 introduces a behavior change related
to setting time while NTP setting is changed.
This change causes phosphor-time-manager automation test failure.
Add a special note in README to describe the issue, and the test case
will be updated.
Partially resolves openbmc/openbmc#3459
Change-Id: I8ee31e8de95d8b110bf9cbee7973c377a6d4330a
Signed-off-by: Lei YU <mine260309@gmail.com>
diff --git a/README.md b/README.md
index 3fefe12..a3fea5e 100644
--- a/README.md
+++ b/README.md
@@ -101,6 +101,19 @@
https://${BMC_IP}/xyz/openbmc_project/time/owner/attr/TimeOwner
```
+### Special note on changing NTP setting
+Starting from OpenBMC 2.6 (with systemd v239), systemd's timedated introduces
+a new beahvior that it checks the NTP services' status during setting time,
+instead of checking the NTP setting:
+
+* When NTP server is set to disabled, and the NTP service is stopping but not
+ stopped, setting time will get an error.
+
+In OpenBMC 2.4 (with systemd v236), the above will always succeed.
+
+This results in [openbmc/openbmc#3459][1], and the related test cases are
+updated to cooperate with this behavior change.
+
### Special note on host on
When the host is on, the changes of the above time mode/owner are not applied but
deferred. The changes of the mode/owner are saved to persistent storage.
@@ -110,3 +123,6 @@
Note: A user can set the time mode and owner in the settings daemon at any time,
but the time manager applying them is governed by the above condition.
+
+
+[1]: https://github.com/openbmc/openbmc/issues/3459