docs: Stop replaces Pause for taking a server offline - #16
Open
MorningLightMountain713 wants to merge 1 commit into
Open
docs: Stop replaces Pause for taking a server offline#16MorningLightMountain713 wants to merge 1 commit into
MorningLightMountain713 wants to merge 1 commit into
Conversation
Pause and Unpause are being removed from FluxOS. Docker reports a paused container as running, so the network could not see the state at all: the load balancer kept routing players to a server whose processes were frozen and which could never answer, monitoring charts flatlined with no explanation, and the reconciler saw a perfectly healthy app. Nothing could release one either - unpause went with it - so a paused container stayed frozen and unrecoverable. Stop does the same job for every procedure documented here. It releases the files, it is visible everywhere as stopped, and it can always be started again. The one thing Pause did that Stop did not - keep the load balancer pointing at this instance so the server comes back on the same node with the same data - now holds for Stop as well. Six world-upload guides said to pause the container before uploading and restart afterwards: terraria, valheim, projectzomboid, minecraftbedrock, windrose and vrising. They now say stop and start. The Control reference drops the two rows and explains why, the management overview no longer lists pause among the per-node actions, and the container status list no longer offers "paused" as a state a container can be in. Left alone deliberately - these are not the FluxOS control: satisfactory's in-game auto-pause setting, Project Zomboid's PauseEmpty= config, Don't Starve Together's "Sim paused" log line, the three MaxGCPauseMillis Java flags, the billing FAQ's pause question, and the ArcaneOS note about services pausing during setup. DEPENDS ON the flux-domain-manager change that keeps an operator-stopped master named as primary. Without it deployed, stopping a g: server drops it out of the load balancer and the primary can move to another node's copy of the data on the next start - which would make the "comes back on the same node" promise above false on the fleet even though it is true in the code. Do not publish ahead of that deploy. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Pause and Unpause are being removed from FluxOS. Seven live pages on docs.runonflux.com currently tell customers to use them.
Why pause went
Docker reports a paused container as running. That one fact meant the network could not see the state at all:
Stop does the same job, and does it better
Pause never kept the server playable. The one thing it did that Stop did not was hold the load-balancer primary designation, and that gap is closed by the FDM change this depends on.
What changed
Six world-upload guides — terraria, valheim, projectzomboid, minecraftbedrock, windrose, vrising — said pause the container, upload, restart. They now say stop, upload, start, with a note that a
g:server can take up to a minute to come back.Three reference pages — the Control table drops the Pause/Unpause rows and explains why, the management overview no longer lists pause among per-node actions, and the container status list no longer offers "paused" as a state.
Deliberately left alone
I swept all 33 occurrences of "pause" in
docs/, not just the Pause control. These are not ours and are unchanged: satisfactory's in-game auto-pause setting, Project Zomboid'sPauseEmpty=config, Don't Starve Together'sSim pausedlog line, threeMaxGCPauseMillisJava flags, the billing FAQ's "can I pause my subscription", and the ArcaneOS note about services pausing during setup.Merge dependencies
Do not publish before both of these are live:
RunOnFlux/flux#1777RunOnFlux/flux-domain-manager#154— merged AND deployedg:server drops it out of the load balancer and the primary can move to another node's copy of the data on the next start — making the "comes back on the same node" promise above true in the code and false on the fleetRelated:
RunOnFlux/fluxos-frontend#140removes the buttons from the UI, andRunOnFlux/fluxdocs#50is the matching API-reference change.