Suggested topic (maybe): Switching off dynamic updates
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 35/100
- Issue type
- Documentation
- Clarity
- Mostly clear
- Activity status
- Stale
- Domain
- documentation
Research direction
Start by reviewing the KC topic on switching off dynamic updates, the generated server config reference, and the updateTrigger reference linked in the issue. Confirm prioritisation and relevance for containerised apps with Alasdair. Done means the topic clearly explains when and how to turn off dynamic updates, includes the two XML configuration pieces, and removes duplicated or unnecessary sections.
Written by the indexing model from the issue text.
Description
From reviewing the KC (check with Alasdair for prioritisation).
This topic in the KC:
https://www.ibm.com/support/knowledgecenter/SSAW57_liberty/com.ibm.websphere.wlp.nd.multiplatform.doc/ae/twlp_setup_dyn_upd.html
It makes it seem far more complicated than it is and isn't really relevant to containerised apps (hence the low priority). It's also a badly structured topic (see Alasdair's comments below) that frames the need badly and then duplicates a load of the generated server config info for no real reason. When you take out all that, there's no much left of it. So then the important question is "Do users need to know how to turn off dynamic updates?" If so, that should be what the topic is answering (maybe with a useful config example).
Alasdair's comments as I noted them down when discussing the KC topic:
"Ops[Scenario 3]. Is this relevant to containerised apps? Mostly not because general advice would be to just redeploy docker containers. 90% of the time you probably don’t need dynamic config. however if you change a config map in kube and the configmap contains server config if you turn dynamic behaviour off you need to redeploy the docker containers
I kind of switch on whether that is a good thing or not. 12-factor would say don’t do it. Most people and 12-factor would suggest redeploying docker container. The KC topic includes how to stop doing dynamic updates because you don't need that if you're redeploying a container (also relevant in security hardening context). I wouldn't have the Notes box and instead link to the updateTrigger topic; also don't need the Procedure section because the preamble tells you all you need to know. The Restriction box should be removed. Just simplify this and say if you need to turn off dynamic updates (don't say "default settings"), this is how you'd do it, and show the two pieces of XML. (currently KC gives a lot of words for very little info - makes it feel complicated when it's not)."
- Dominant language
- No language data
- Stars
- 14
- Forks
- 58
- Avg merge
- 1h 4m
- Merged PRs (30d)
- 21
Getting set up
- No Dockerfile or Docker Compose file
- No pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from OpenLiberty/docs
-
source mismatchOpen
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
OpenLiberty/docs#8579 ·
Maintainers usually reply within 1 day
-
Jandex extended pathOpen
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
OpenLiberty/docs#8451 · 1 comment ·
Maintainers usually reply within 1 day
-
CVE update for 26.0.0.10Possibly taken @ramkumar-k-9286 claimed this 18 days ago. Open26.0.0.10
OpenLiberty/docs#8563 · 5 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
26.0.0.11
Difficulty 5/5 Over a week Newbie friendliness 25/100
OpenLiberty/docs#8548 ·
Maintainers usually reply within 1 day
-
26.0.0.12
Difficulty 4/5 3-5 days Newbie friendliness 45/100
OpenLiberty/docs#8529 · 1 comment ·
Maintainers usually reply within 1 day
All issues in OpenLiberty/docs
Similar issues
-
documentation good first issue help wanted
Difficulty 2/5 1-3 hours Newbie friendliness 90/100
eugenioenko/ttt#1000 ·
Maintainers usually reply within 1 day
-
documentation v2
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
modelcontextprotocol/servers#5170 ·
Maintainers usually reply within 1 day
-
Difficulty 1/5 Under an hour Newbie friendliness 82/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
SwiftKickMobile/skai#83 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 86/100
Maintainers usually reply within 1 day