admin: add note about clock synchronization

[garlick]

Problem: Flux requires local clocks to be synchronized across the cluster, but this is not mentioned in the Admin Guide.

For example

• job-ingest sets t_submit to the local time
• flux_job_timeleft() returns expiration relative to the local time
• Flux logs are time stamped at origin

Add a note to the section on prerequisites.

[garlick]

Drat:

Initializing Spelling Checker 8.0.0
Could not import `keymap_db` module from `pymdownx` package.
    Please ensure `pymdown-extensions` is installed.
    The `:keys:` role has no default key map.

[grondo]

Hm, maybe need to pin some dependency in requirements.txt?

[vsoch]

Oh I've seen this: https://github.com/sphinx-doc/sphinx/issues/11479. Resolution at the last comment!

For passersby, this is a duplicate of https://github.com/jbms/sphinx-immaterial/issues/268 which was resolved and released in sphinx-immaterial v0.11.5.

[garlick]

Thanks @vsoch! Hmm, except now I get

ERROR: Ignored the following versions that require a different python version: 0.11.1 Requires-Python >=3.8; 0.11.2 Requires-Python >=3.8; 0.11.3 Requires-Python >=3.8; 0.11.4 Requires-Python >=3.8; 0.11.5 Requires-Python >=3.8
ERROR: Could not find a version that satisfies the requirement sphinx-immaterial>=0.11.5 (from versions: 0.1, 0.2, 0.3, 0.3.1, 0.4.0, 0.4.1, 0.5.0, 0.6.0, 0.6.1, 0.7.0, 0.7.1, 0.7.2, 0.7.3, 0.8.0, 0.8.1, 0.9.0, 0.9.1, 0.10.0, 0.11.0)
ERROR: No matching distribution found for sphinx-immaterial>=0.11.5

[vsoch]

I didn’t test that suggested fix (we should let them know) but instead I pinned pydantic: https://github.com/flux-framework/flux-operator/blob/59bfeab688588d89242c9d4d7f9645204d20876c/docs/requirements.txt

[vsoch]

Noice! 🙌

[garlick]

That worked! Oof I had forgotten I had set MWP earlier so - it's merged!

Many thanks @vsoch! I really did not want to dig into that.

[vsoch]

Many thanks @vsoch! I really did not want to dig into that.

Always really glad when I can help. <3